Help Center/Admin Operations/Price Engine: configure sources and safety limits
Admin Operations•Last updated: 2026-10-19•6 min read

Price Engine: configure sources and safety limits

Turn providers on or off and set the freshness limit, minimum sources, outlier, flash-move and depeg thresholds. Super Administrator only.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Open Configuration

On /admin/prices choose the Configuration tab.

2

Choose providers

Tick the providers to use: Binance, Coinbase, Kraken, CoinGecko. Two or more agreeing sources are needed for a MEDIAN price by default. CoinGecko works without a key; an optional key is set in the server environment (COINGECKO_API_KEY) and is never shown here.

3

Set freshness and agreement

Price freshness limit (TTL) is how old an observation may be. Minimum agreeing sources is normally 2. Outlier limit rejects a source that is further than this percent from the median. Allow a single source only if you accept lower confidence.

4

Set the safety rules

Flash-move halt threshold, window and confirmations decide when a sudden move freezes a pair (HALTED_DEVIATION) and when a persisting move is accepted. Stablecoin depeg alert raises an alert when USDT or USDC is measured further than this percent from 1.00.

5

Set the I8I market source

Choose None, Exchange pair (a known exchange and the listed symbol), Oracle URL (https, public host, JSON path of the USD price) or Manual only. There is no default. An oracle URL is checked for https, a public host and a public DNS answer before it is saved.

6

Save

Choose Save configuration. Errors are shown in red and nothing is saved until they are fixed. Every save is audited.

Expected Operational Outcome

The configuration is saved and the next refresh uses it.

Troubleshooting & Failure Modes

Symptom: Save says the oracle URL is refused
Likely Cause: The URL is not https, has credentials or a port, uses an IP address or an internal name, or resolves to a private address.
Resolution: Use a public https host name.

Was this guide helpful?

Help us refine our platform documentation