One Trading API
REST APIWebSocket API
REST APIWebSocket API
  1. Mark Price
  • Introduction
  • Authenticate
  • Subscribe
  • Ping / Pong
  • Trading
    • Introduction
    • Create Order
    • Cancel All Orders
    • Cancel Order by Client ID
    • Cancel Order by Order ID
    • Margin Update
    • Settlement
    • Funding Payment
    • Order Booked
    • Order Rejected
    • Order Closed
    • Trade Executed
    • Order Fully Filled
    • Move Order
    • Balance Adjustment
  • Orderbook
    • Introduction
    • Orderbook Snapshot
    • Orderbook Update
  • Price Ticks
    • Introduction
    • Price Tick
  • Book Ticker
    • Introduction
    • Book Tick
  • Mark Price
    • Mark Price Update
    • Introduction
  • Account
    • Introduction
    • Exotic Order Registered
    • Exotic Order Updated
    • Exotic Order Activated
    • Exotic Order Triggered
    • Exotic Order Executed
    • Exotic Order Cancelled
  1. Mark Price

Mark Price Update

You must be subscribed to the MARK_PRICE channel to receive mark price updates. You will only receive updates for the instruments you selected.
The MARK_PRICE_UPDATE message carries the mark price of one futures instrument. One is sent per instrument straight after you subscribe, then every 5 seconds.
An instrument whose mark price is missing, or more than 10 seconds old, gets no message until a current one is available.
{
    "channel_name": "MARK_PRICE",
    "time": 1762700000123456789,
    "type": "MARK_PRICE_UPDATE",
    "instrument_code": "BTC_USD_P",
    "data": {
        "time": 1762700000000000000,
        "mark_price": "101234.5",
        "index_price": "101230.1",
        "tier": "ANCHORED",
        "session": true
    }
}
FieldTypeDescription
channel_namestringMARK_PRICE.
timeintegerNanosecond timestamp of when the message was sent.
typestringMARK_PRICE_UPDATE.
instrument_codestringThe futures instrument, e.g. BTC_USD_P.
data.timeintegerNanosecond timestamp of when the mark price was calculated.
data.mark_pricestringThe mark price.
data.index_pricestring or nullThe index price behind the mark. null when no live index is available.
data.tierstringHow the mark was priced: ANCHORED, THIN or VENUE. A VENUE mark comes from the venue's own prices, with no index behind it.
data.sessionbooleanfalse while the underlying's primary market is outside its regular trading hours.
Previous
Book Tick
Next
Introduction
Built with