Get latest price
Market Data
Get latest price
Latest price snapshot for a market.
GET
Get latest price
Returns the latest price snapshot for a market. The
{instrument} path segment is perps or spot (and must be consistent with the market_id). The fields returned depend on the instrument class:
perps—mark,index(oracle/index price the perp tracks), andmid.spot—mid.
Freshness
A snapshot is served only if the market has ticked inside a per-venue window; otherwise the endpoint returns404. The window differs because venues publish
at very different cadences:
Venues such as dYdX mark positions at the oracle price and only publish when
that price moves, so a thinly traded market can go hours without a new tick
while still being fully active. A short window would make those markets
intermittently unavailable, so they get the wider one.
A
404 here means “no tick inside the window”, which is not the same as an
unknown market — use the market-detail endpoint to distinguish the two. A
malformed market_id returns 400.
Coming soon
The following price fields are not yet returned and will be added for both perp and spot markets. To request prioritization, reach out to your account manager.last— last traded pricebest_bid— top-of-book best bidbest_ask— top-of-book best ask
Authorizations
Path Parameters
Canonical market slug, {venue}:{instrument_type}:{pair}.
Instrument class: perps or spot. Must be consistent with the market_id.
Available options:
perps, spot Response
200 - application/json
Latest price snapshot.
- Option 1
- Option 2