Skip to main content
GET
/
api
/
v1
/
markets
/
{market_id}
/
{instrument}
/
price
Get latest price
curl --request GET \
  --url https://api.allium.so/api/v1/markets/{market_id}/{instrument}/price \
  --header 'X-API-KEY: <api-key>'
{
  "data": {
    "market_id": "<string>",
    "as_of": "<string>",
    "mark": "<string>",
    "index": "<string>",
    "mid": "<string>"
  }
}
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:
  • perps — mark, index (oracle/index price the perp tracks), and mid.
  • spot — mid.
Snapshots are cached for ~60 seconds.

​
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