Subscribing to a Symbol

To start streaming prices, send a signed subscribe message on the prices topic identifying the symbol you want. On success the server returns a confirmation, then begins sending price-update messages for that symbol.

Use Listing Available Symbols first to get valid ASSET/QUOTE symbol strings.

Request

Every message must be authenticated — see Authentication. For the price feed, body is required and identifies the symbol.

Example request:

{
  "messageType": "subscribe",
  "topic": "prices",
  "key": "API_PUBLIC_KEY",
  "passphrase": "API_PASSPHRASE",
  "timestamp": "1720000000",
  "signature": "base64_encoded_hmac",
  "body": { "symbol": "BTC/USD" }
}

Response

On success the server returns a subscribe message confirming the symbol feed.

Example response:

{
  "messageType": "subscribe",
  "body": "successfully subscribed to the BTC/USD feed"
}

After this confirmation, price-update messages begin arriving for the symbol.

Subscribing to multiple symbols

Send one signed subscribe message per symbol — each with its own body (and therefore its own signature). All subscriptions share the same connection, and you keep them all alive with a single ping every 20 seconds.

Next steps

• Price Updates — the price-update message fields
• Listing Available Symbols — discover valid symbols
• Maintaining Subscription — the 20-second heartbeat