Skip to main content
GET
Get latest price
Alpha — The Market Data API is in alpha. Schema and response format may change. To request access, contact us or reach out to your account manager.
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:
  • perpsmark, index (oracle/index price the perp tracks), and mid.
  • spotmid.
Snapshots are cached for ~60 seconds.

Freshness

A snapshot is served only if the market has ticked inside a per-venue window; otherwise the endpoint returns 404. 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 returned mark may therefore be up to 24 hours old on non-Hyperliquid venues. as_of is the only staleness signal — check it if freshness matters to your use case, rather than assuming the snapshot is current.
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 price
  • best_bid — top-of-book best bid
  • best_ask — top-of-book best ask

Authorizations

X-API-KEY
string
header
required

Path Parameters

market_id
string
required

Canonical market slug, {venue}:{instrument_type}:{pair}.

instrument
enum<string>
required

Instrument class: perps or spot. Must be consistent with the market_id.

Available options:
perps,
spot

Response

200 - application/json

Latest price snapshot.

data
object
required