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

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

JSON Mark Price Response

JSONCode
{ "type": "mark_price_updates", "symbol": "BTCGUSDPERP", "changes": [ { "timestamp": 1673932381478308169, "mark_price": "21154.098", "spot_index": "21175.27333" } ] }
Last modified on