Gemini Crypto Exchange Logo
Version 2

Mark Price Feed

The Mark Price feed provides mark price updates for a subscribed perpetual instrument.

Subscribe

Send a JSON formatted message with following fields upon connecting to v2/marketdata:

Field NameTypeValues
typestringsubscribe
subscriptionsarray
-- namestringmark_price
-- symbolsarray["BTC-GUSD-PERP", ...]

Response

Field NameTypeValues
typestringmark_price_updates
symbolstringBTC-GUSD-PERP
changesarraychange to mark price

All elements of changes share the following fields:

Field NameTypeValues
timestampintegernanoseconds
mark_pricestringmark price
spot_indexstringspot index

Examples

JSON Mark Price Subscription Message

{
  "type": "subscribe",
  "subscriptions": [
    {
      "name": "mark_price",
      "symbols": ["BTC-GUSD-PERP"]
    }
  ]
}
json

JSON Mark Price Response

{
  "type": "mark_price_updates",
  "symbol": "BTCGUSDPERP",
  "changes": [
    {
      "timestamp": 1673932381478308169,
      "mark_price": "21154.098",
      "spot_index": "21175.27333"
    }
  ]
}
json