Rates

Rates provide aggregated price and volume data for cryptocurrencies across all exchanges. They represent the consolidated market data that Coinranking calculates for each coin.

The fastest way to get new rates is to subscribe to them in real-time. You can request rates through our coins endpoints too, but they will only update once a minute. A real-time connection pushes new rates as soon as they are calculated, so you get the latest price and 24 hour volume without polling.

Connection Setup

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

wss://api.coinranking.com/v2/real-time/rates
 Copy

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

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. Choose one subscription parameter, currency-uuids[] or list, and optionally a throttle.

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.

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

Code examples

Javascript Copy code
const connection = new WebSocket(
  'wss://api.coinranking.com/v2/real-time/rates?x-access-token=your-api-key&currency-uuids[]=Qwsogvtv82FCd&currency-uuids[]=razxDUgYGNAdQ&throttle=10s'
);

connection.onmessage = (event) => {
  const rate = JSON.parse(event.data);
  console.log(rate);
};

curl Copy code
# -N disables output buffering, -g stops curl from interpreting the [] in the URL
curl -N -g 'https://api.coinranking.com/v2/real-time/sse/rates?currency-uuids[]=Qwsogvtv82FCd&currency-uuids[]=razxDUgYGNAdQ&throttle=10s' \
  -H 'x-access-token: your-api-key'

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 rates, you receive aggregated price and volume data for cryptocurrencies. Rates represent consolidated market data calculated by Coinranking across all exchanges, providing a single unified price and 24-hour volume for each coin. Each rate message includes the currency UUID to identify which cryptocurrency the data represents, making it easy to track multiple coins simultaneously.

json Copy code
{
  "type": "rate",
  "currencyUuid": "Qwsogvtv82FCd",
  "price": "125423.835504191964312353",
  "volume": "6270550403.287645846237386287"
}

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 Copy code
{
  "type": "confirmation",
  "topic": "rate",
  "throttle": "10s",
  "subscriptions": ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]
}

Response Fields

When subscribed to one or more coins, you receive new rates whenever they are available. Each of these rates includes the UUID of the coin the rate pertains to, which is especially useful when you are subscribed to multiple coins. Rates include the latest price and 24-hour moving volume, both in US dollars.

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