List markets

GET/markets

Lists the pairs a chain offers, with trading hours and limits.

Authentication

None.

Parameters

NameInTypeDescription
chain requiredquerystring

A chains[].key from GET /health, such as ethereum.

pairquerystring

USDBRL or USD/BRL.

Responses

200

OK.

FieldTypeDescription
markets requiredarray of object

One row per pair the chain offers.

markets[].pair requiredstring

Pair as BASE/QUOTE, such as USD/BRL. The notional is in the base currency.

markets[].tenor requiredobject

Allowed range for expiry on POST /rfqs, from now. POST /rfqs/{rfq_id}/accept needs at least min_secs + 38 s left before expiry; ask for an expiry at least min_secs + 38 s plus the quote window from now.

markets[].tenor.min_secs requiredinteger
markets[].tenor.max_secs requiredinteger
markets[].notional requiredobject

Allowed range for notional on POST /rfqs.

markets[].notional.min requiredstring

Minimum notional, at least 100 USD.

markets[].notional.max requiredstring

Decimal string.

markets[].max_premium_bps requiredinteger or null

Cap on premium_bps either way, in basis points (200 = 2 %). null if unknown.

markets[].session requiredobject

Current trading session.

markets[].session.open requiredboolean

true if the pair is in trading hours; false also if the calendar cannot be read.

markets[].session.next_boundary requiredobject or null

Next session open or close, or null if unknown.

markets[].session.next_boundary.kind requiredstring open close
markets[].session.next_boundary.at requiredintegerminimum 0

Unix time in milliseconds.

markets[].settlement requiredobject

Where and when the pair fixes, and the price it fixes on.

markets[].settlement.fixing requiredobject
markets[].settlement.fixing.city requiredstring or null

City the pair fixes in. null for a pair with no fixing city.

markets[].settlement.fixing.zone requiredstring

IANA time zone of city, or UTC for a pair with no fixing city.

markets[].settlement.fixing.time requiredstring or null

Benchmark fixing time in zone, as HH:MM. null for a pair with no fixing city.

markets[].settlement.fixing.next_at requiredinteger or null

First expiry at time that POST /rfqs accepts, in Unix time (milliseconds). null for a pair with no fixing city, or if none falls in the next 14 days.

markets[].settlement.reference requiredobject
markets[].settlement.reference.source requiredstring or null pyth null

pyth if the pair fixes on the Pyth price; otherwise null.

markets[].settlement.reference.feed_id requiredinteger or null

Pyth Pro feed ID, an integer. null if source is null.

markets[].settlement.window_secs requiredinteger

A trade fixes on the first reference price CRX publishes within this many seconds after its expiry. If there is none, or the market is closed at expiry, CRX sets the price.

markets[].next_long_closeobject

Current or next long close window. POST /rfqs refuses an expiry at or after starts_at and before ends_at, with 422 expiry_outside_hours. Present only if one is scheduled.

markets[].next_long_close.starts_at requiredinteger

First refused expiry. At or before now while the window is current.

markets[].next_long_close.ends_at requiredinteger

First accepted expiry after the window.

markets[].delisting_atintegerminimum 0

Scheduled delisting time. Omitted if none.

inactive_marketsarray of object

Paused and delisted pairs. Omitted if empty.

inactive_markets[].pair requiredstring
inactive_markets[].pair_status requiredstring paused delisted
inactive_markets[].delisting_atintegerminimum 0

Scheduled delisting time. Omitted if none.

400

bad_request: unknown chain or pair.

code bad_request

408

timeout: no answer within 30 seconds.

code timeout

409

market_paused: the pair is not offered on this chain.

code market_paused

429

rate_limited: retry after Retry-After seconds.

code rate_limited

HeaderTypeDescription
Retry-Afterinteger

Seconds until the next call is accepted.

ratelimit-limitinteger

Maximum calls in a burst.

ratelimit-remaininginteger

Calls remaining before the limit.

ratelimit-resetinteger

Seconds until the full limit is restored.

ratelimit-refillinteger

Calls restored per minute.