Subscription Management
Public
WebSocket Only

Subscribe to one or more channels. This is the same method as /private/subscribe, but it can only be used for 'public' channels.

For a complete list of available subscription channels and their notification formats, see Notifications and Subscriptions.

Note - This method has distinct API rate limiting requirements: Sustained rate: ~3.3 requests/second. For more information, see Rate Limits.

📖 Related Articles:

Try in API console

get/public/subscribe

Request

  • Base URL
    https://test.deribit.com/api/v2
  • URL
    https://test.deribit.com/api/v2/public/subscribe
  • Auth
    none declared

Query parameters

channelsstring[] required

A list of channels to subscribe to. See Notifications and Subscriptions for all available channels.

[
  "deribit_price_index.btc_usd"
]

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

resultstring[] required

A list of subscribed channels.

Example response

{
  "result": [
    "deribit_price_index.btc_usd"
  ]
}

Changes

No recorded changes to this operation across all 11 revisions of this API.