Account Fills - Edel Developer Docs

account.fills is a private account-scoped channel. Authentication: bearer account session. Payload schema: RealtimeAccountFillPayload. 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-account-fills",
  "channel": "account.fills",
  "accountId": "account-example"
}

Accepted frame

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

{
  "version": "realtime-subscription-accepted/v1",
  "requestId": "subscribe-account-fills",
  "channel": "account.fills",
  "visibility": "private",
  "accountId": "account-example",
  "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 RealtimeAccountFillPayload.

{
  "version": "realtime-stream/v1",
  "messageId": "messageid-example",
  "type": "data",
  "channel": "account.fills",
  "sequence": 1,
  "occurredAtEpochMs": 1,
  "visibility": "private",
  "accountId": "account-example",
  "checkpoint": {
    "kind": "system"
  },
  "payload": {
    "tradeId": "tradeid-example",
    "accountId": "account-example",
    "marketId": "marketid-example",
    "role": "maker",
    "feePaidAtoms": "1",
    "feeRole": "maker",
    "side": "buy",
    "priceAtoms": "1",
    "sizeAtoms": "1",
    "orderId": "orderid-example",
    "counterpartyOrderId": "counterpartyorderid-example"
  }
}

Worked example

Send the subscribe envelope with request id subscribe-account-fills.
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 RealtimeAccountFillPayload.