Tickers

Tickers provide detailed trading pair data from specific markets, showing the exchange rate between two currencies (e.g., BTC/USD). They include granular market information like base/quote volumes, close price, and more.

The fastest way to get new tickers is to subscribe to them in real-time. You can request tickers through our markets endpoints too, but they will only update once a minute. A real-time connection pushes new tickers as soon as they are calculated, so you get the latest ticker data without polling.

Connection Setup

Professional Tickers require the professional plan or higher

Real-Time Dex DEX data requires the Real-time DEX data add-on.

Tickers are available over both transports, with the same query parameters and the same messages:

wss://api.coinranking.com/v2/real-time/tickers

https://api.coinranking.com/v2/real-time/sse/tickers

How to authenticate, connect, and reconnect is described on the WebSockets and Server-Sent Events pages. Not sure which one to use? See choosing a transport.

URL Query Parameters

Add the parameters to either URL, and optionally a throttle.

Important: You must choose only ONE of the following subscription parameters: market-uuids, exchange-uuids, currency-uuids, or list. You cannot mix different parameter types.

Parameter	Description
market-uuids[] `Array`	Subscribe to specific market pairs. Provide a list of market UUIDs to get ticker data for specific trading pairs. This allows you to get ticker data for specific market pairs across exchanges. You can find market UUIDs in our markets endpoint Note: Use array notation in the URL: `market-uuids[]=dj23kKgETIie` Size range: 1-100 Example: `?market-uuids[]=dj23kKgETIie`
exchange-uuids[] `Array`	Subscribe to all ticker data for specific exchanges. This will give you all ticker data available on the selected exchanges. Provide a list of exchange UUIDs to make your selection. You can find exchange UUIDs in our exchanges endpoint Note: Use array notation in the URL: `exchange-uuids[]=-zdvbieRdZ` Size range: 1-100 Example: `?exchange-uuids[]=-zdvbieRdZ`
currency-uuids[] `Array`	Subscribe to the tickers of all markets that have one of the selected currencies as base or quote, across all exchanges. Decentralized exchanges are only included with the Real-time DEX data add-on. Without the add-on, the subscription is accepted but carries centralized exchanges only. Provide a list of currency UUIDs to make your selection. You can find currency UUIDs in our reference currencies endpoint Note: Use array notation in the URL: `currency-uuids[]=Qwsogvtv82FCd` Size range: 1-100 Example: `?currency-uuids[]=Qwsogvtv82FCd`
list `String`	Subscribe to the tickers of all markets instead of a selection. This is a high-volume stream, so make sure your client keeps up with it. Decentralized exchanges are only included with the Real-time DEX data add-on. Without the add-on, the subscription is accepted but carries centralized exchanges only. Allowed values: all Example: `?list=all`
throttle (optional) `String`	With the throttle parameter, you prevent getting overloaded with ticker data. This is useful if performance is an issue, e.g. when streaming tickers to your frontend and you want to prevent straining your client's devices too much. Throttling works per market. If you select a throttle, this means ticker data for the same market will not be pushed more than once within the specified duration. Default value: 1s Allowed values: 1s 10s Example: `?market-uuids[]=dj23kKgETIie&throttle=10s`

Subscription Messages

WebSockets only. On an open WebSocket, you can change your subscription by sending a JSON message, without reconnecting. See subscription messages for how they work. A Server-Sent Events stream cannot be changed: close it and open a new stream with the new parameters instead.

Choose only ONE subscription type per message:

json
{
  "marketUuids": ["dj23kKgETIie", "ia4qVnkhIxcQ"],
  "throttle": "10s"
}

Or using exchange UUIDs:

json
{
  "exchangeUuids": ["-zdvbieRdZ"],
  "throttle": "10s"
}

Or using currency UUIDs:

json
{
  "currencyUuids": ["Qwsogvtv82FCd"],
  "throttle": "10s"
}

Code examples

More examples, including subscription messages and a fetch-based stream reader, are on the WebSockets and Server-Sent Events pages.

Responses

Data Messages

When subscribed to tickers, you receive detailed trading pair data including price, volume, and market statistics. Each ticker message contains comprehensive information about a specific market pair: the market UUID, exchange UUID, base currency UUID, and quote currency UUID. This granular data allows you to track individual trading pairs across different exchanges, monitor base and quote volumes separately, and analyze market-specific price movements.

json
{
  "type": "ticker",
  "marketUuid": "dj23kKgETIie",
  "exchangeUuid": "-zdvbieRdZ",
  "baseUuid": "Qwsogvtv82FCd",
  "quoteUuid": "cpjRxjFYD",
  "exchangeType": "cex",
  "close": "124590.91",
  "price": "124590.91",
  "baseVolume": "24290.53392",
  "quoteVolume": "3036047751.1820064",
  "volume": "3036047751.1820064",
  "filters": []
}

Confirmation Messages

A confirmation lists what you are subscribed to and with which throttle. A Server-Sent Events stream sends it as its first message; a WebSocket sends it in answer to a subscription message.

json
{
  "type": "confirmation",
  "topic": "ticker",
  "throttle": "10s",
  "subscriptions": ["market:dj23kKgETIie","market:ia4qVnkhIxcQ"]
}

Response Fields

When subscribed to tickers, you receive new ticker data whenever it is available. Each ticker includes the UUID of the market, exchange, base currency, and quote currency, which is especially useful when you are subscribed to multiple markets or exchanges. Tickers include the latest price, close price, and volume data, both in base and quote currencies, as well as in US dollars.

Unlike our market details endpoints, we do not support other reference currencies than US dollars in real-time. You can, however, subscribe to multiple markets and exchanges, which allows you to calculate them yourself.

Property	Description
type `String`	The kind of message. Always `ticker` for a data message on this topic.
marketUuid `String`	The market UUID of this ticker. Useful if you subscribed to multiple markets, in which case the UUID helps you determine which market the ticker belongs to.
exchangeUuid `String`	The exchange UUID of this ticker. Useful if you subscribed to multiple exchanges, in which case the UUID helps you determine which exchange the ticker comes from.
baseUuid `String`	The base currency UUID of this ticker.
quoteUuid `String`	The quote currency UUID of this ticker.
exchangeType `String`	The type of exchange: `cex` for Centralized Exchanges or `dex` for Decentralized Exchanges.
close `String`	The last price received from the market. For example in an ETH/BTC market the close price would be the ETH’s value in BTC
price `String`	The latest price of the base currency in US Dollar.
baseVolume `String`	The 24 hour volume in the base currency.
quoteVolume `String`	The 24 hour volume in the quote currency.
volume `String`	The 24 hour volume in US Dollar.
filters `String[]`	An array of filters that are applied to the market. Most of the filters will cause the market to not be included in the price calculation of the coins. Allowed values: PREV_FACTOR EXTERNAL_ZSCORE GEO OUTSIDE_TOP_20

Exchange Rates

Bulk coins