Price Feed Settlement

Price Feed settlement automatically resolves markets based on real-time cryptocurrency prices from CoinGecko.

Scope

Markets with outcomes objectively determined by cryptocurrency prices.

Currently supported assets:

Asset	CoinGecko ID	Symbol
Bitcoin	bitcoin	BTC
Ethereum	ethereum	ETH
Solana	solana	SOL
Ripple	ripple	XRP
Cardano	cardano	ADA

Configuration

Set at market creation:

Field	Description	Example
Asset	CoinGecko asset ID	bitcoin
Condition	Above or Below	above
Threshold	Target price in USD	100000

Flow

1. Market close date (closes_at) reached
2. System fetches current USD price from CoinGecko API (/simple/price)
3. Evaluates condition:
   • above: current price ≥ threshold → YES; otherwise → NO
   • below: current price ≤ threshold → YES; otherwise → NO
4. Positions auto-settled
5. Market status: active → resolved

Example

Market: "BTC breaks $100,000 by March 2026"
Config: bitcoin / above / $100,000
Close:  2026-03-31

At close, BTC = $105,000 → Settle YES
At close, BTC = $95,000  → Settle NO

Source Failure Handling

Scenario	Action
Temporary API outage	Settlement deferred; retried on next check
Extended outage (24h+)	Admin may intervene manually
Permanent data unavailability	Market voided (see Void & Cancel)