Market Price - Edel Developer Docs

market.price is a public market-scoped channel. Authentication: none. Payload schema: RealtimeMarketPricePayload. Source status: live. Send this exact JSON shape. requestId is required and there is no action field. The series field is not sent for this channel.

{
  "version": "realtime-subscribe/v1",
  "requestId": "subscribe-market-price",
  "channel": "market.price",
  "marketId": "BTC-USD"
}

Accepted frame

The subscription is active only after a matching realtime-subscription-accepted/v1 frame arrives.

{
  "version": "realtime-subscription-accepted/v1",
  "requestId": "subscribe-market-price",
  "channel": "market.price",
  "visibility": "public",
  "marketId": "BTC-USD",
  "nextSequence": 1,
  "heartbeatIntervalMs": 10000,
  "replay": {
    "mode": "latest",
    "gapErrorCode": "sequence_gap",
    "resyncErrorCode": "resync_required"
  }
}

Data frame

The envelope is realtime-stream/v1; its payload validates against RealtimeMarketPricePayload.

{
  "version": "realtime-stream/v1",
  "messageId": "messageid-example",
  "type": "data",
  "channel": "market.price",
  "sequence": 1,
  "occurredAtEpochMs": 1,
  "visibility": "public",
  "marketId": "BTC-USD",
  "checkpoint": {
    "kind": "system"
  },
  "payload": {
    "version": "market-price/v1",
    "marketId": "BTC-USD",
    "epoch": 0,
    "receivedAtEpochMs": 0,
    "indexPriceAtoms": "1",
    "markPriceAtoms": "1",
    "primaryPriceAtoms": "1",
    "comparatorPriceAtoms": "1",
    "primaryProvider": "primaryprovider-example",
    "comparatorProvider": "comparatorprovider-example",
    "confidenceBps": 0
  }
}

Worked example

Send the subscribe envelope with request id subscribe-market-price.
Wait for the accepted frame with the same request id; receiving any other frame does not prove this subscription.
Process the data frame at sequence 1 and validate its payload as RealtimeMarketPricePayload.