Crypto WebSocket API
Real-time prices for up to 100 coins per connection, pushed the moment they are calculated from 110+ exchanges. Delivered data messages use credits at your plan’s rate. The recommended transport for back ends; front ends use SSE.
10,000 credits a month, no credit card. WebSocket and SSE streaming are available on all plans.
All plans · 30-day trial on paid plans · wss://api.coinranking.com/v2/real-time
| Coin | Pollingonce a minute | Server-Sent Eventslive |
|---|---|---|
 BitcoinBTC | ||
 EthereumETH | ||
 BNBBNB | ||
 XRPXRP | ||
 SolanaSOL |
0
Price updates received
By plan
Delivered data uses credits at your plan’s message rate. Connection and update limits still apply.
Three Feeds on One Base URL
Aggregated rates per coin, rates per exchange, and full tickers per trading pair, all under wss://api.coinranking.com/v2/real-time.
- WS/rates
One consolidated price and 24-hour volume per coin across every exchange. Subscribe by
currency-uuids[], up to 100 per connection. A coin’s price and volume on one exchange, tagged
cexordex. Subscribe by exchange, by coin, or by exact pair.- WS/tickers
Trading-pair level: close price, base and quote volume, and the filters applied to the market. Subscribe by market, exchange or coin.
Eligible plans can access DEX markets through Real-Time DEX Data.
Prices Arrive as JSON, in a Few Lines of Code
One URL with your key and the coin UUIDs. Every message is a coin UUID, a price and a 24-hour volume in US dollars.
// Subscriptions in the connection URL
const socket = new WebSocket(
'wss://api.coinranking.com/v2/real-time/rates' +
'?x-access-token=YOUR_KEY' +
'¤cy-uuids[]=Qwsogvtv82FCd' + // Bitcoin
'¤cy-uuids[]=razxDUgYGNAdQ' // Ethereum
);
socket.onmessage = (event) => {
const rate = JSON.parse(event.data);
console.log(rate.currencyUuid, rate.price);
};Subscription messages, throttling and the full message reference are in the rates docs.
Request Usage and Update Frequency
REST and delivered streaming data share your credit balance. Stream setup and control messages cost no credits. Your plan controls message prices, update frequency and connections.
| Poll /coins every minute | Poll /coins every second | Coinranking WebSocket | |
|---|---|---|---|
| API requests per day | 1,440 | 86,400 | 1 to open; each reconnect adds a request |
| Update-frequency limit | Polled every 60s; REST data refreshes every minute | Polled every 1s; REST data refreshes every minute | 1s minimum interval on Professional; Enterprise limits follow your agreement. Updates are sent only when data changes, with no fixed freshness guarantee. |
| Messages per day | 1,440 responses | 86,400 responses | Up to 8,640,000 data messages at 1s per asset |
Compared with CoinGecko and CoinMarketCap WebSockets
WebSocket access is available on all plans.
| Coinranking | CoinGecko | CoinMarketCap | |
|---|---|---|---|
| Billing unit | Per delivered message | Per message | Per message |
| Cost of one stream | 0.0025–0.05 credits per message by plan | 0.1 credit per message | 0.025 credits per message |
| Status | Live | Beta | Beta |
| Covered by SLA | Available as an add-on | No | No |
Competitor figures from CoinGecko (docs.coingecko.com/websocket) and CoinMarketCap (coinmarketcap.com/api/documentation/pro-api-websocket/overview) documentation, verified September 2026. Both vendors negotiate separately at Enterprise.
Built for a Production Socket
What the server handles for you, and the one thing you keep server-side.
Confirmed Subscriptions
Every subscription message is answered with the accepted topics and throttle.
Simple Reconnect
Reopen the same URL to restore its subscriptions. Reconnecting costs no credits; newly delivered data is charged at your plan rate.
Throttle per Coin
The default is 1s on Professional; Enterprise limits follow your agreement. Supported intervals are 1s, 5s, 10s, 30s and 60s. Faster-than-plan requests are rejected.
99.9% Uptime
Historical uptime above 99.9%, published on the status page. A contracted SLA is available as a paid add-on.
Keep the key server-side: open the socket from a server and relay to browsers, or use Server-Sent Events behind your own endpoint.
What Developers Build on Coinranking WebSocket API
Four things a minute-old REST price cannot do.
Live Market Tables
The ranking your users keep open. One socket for a top-100, prices that move instead of jump.
Portfolio Trackers
Every holding revalued on every tick, with the 24-hour volume in the same message.
Alert Bots
Fire when the price crosses, not up to a minute later. Change the watchlist mid-stream.
Trading Dashboards
Tickers per pair with base and quote volume, on centralized exchanges and DEXs, subject to your plan’s access.
Other Ways to Stream the Same Data
One dataset, two transports, included DEX access.
Server-Sent Events
The same feeds as one HTTP response that never ends. Recommended for front ends: EventSource is built in and reconnects by itself.
Real-Time DEX Data
Every DEX Coinranking tracks, on the exchange-rates and tickers feeds. Access is available on all plans, with plan-specific message prices and limits.
WebSocket Access by Plan
WebSocket access is available on all plans.
| Free | Basic | Startup | Growth | Professional | |
|---|---|---|---|---|---|
| Monthly price | $0 | $24 | $49 | $99 | $199 |
| Monthly credits | 10,000 | 500,000 | 1,000,000 | 2,000,000 | 5,000,000 |
| REST rate limit | 5 / second | 1,000 / minute | 2,000 / minute | 4,000 / minute | 6,000 / minute |
| WebSocket and SSE access | Included | Included | Included | Included | Included |
| Credits per delivered message | 0.05 | 0.025 | 0.01 | 0.005 | 0.0025 |
| Minimum update interval | 60s | 10s | 5s | 1s | 1s |
| Shared streaming connections | 1 | 2 | 5 | 10 | 20 |
| API keys | 1 | 1 | 2 | 5 | Unlimited |
| Historical window, where supported | 1 year | 5 years | All time (from 2010) | All time (from 2010) | All time (from 2010) |
| Maximum results per response | 100 | 5,000 | 5,000 | 5,000 | 5,000 |
Streaming is also available on Enterprise. Endpoint-specific limits may be lower. Preview allowances are shared across every API key on your account. Every paid plan offers a 30-day free trial. Compare all features.
WebSocket Questions Developers Ask
WebSocket and SSE streaming are available on all plans. See plans and confirm streaming access in your account.
One connection accepts up to 100 explicit coin UUIDs in currency-uuids[]. You can also use supported list subscriptions. Delivered data messages use credits at your plan’s rate. Your plan's shared connection limit and minimum update interval apply. See the rates documentation.
REST and streaming share your account credit balance. Delivered WebSocket messages and SSE data events cost 0.05 credits on Free, 0.025 on Basic, 0.01 on Startup, 0.005 on Growth and 0.0025 on Professional. Connection setup, heartbeats, acknowledgements and errors cost no credits. Plan update intervals and connection limits still apply. See plans.
Authenticate Coinranking WebSocket with the x-access-token query parameter: wss://api.coinranking.com/v2/real-time/rates?x-access-token=YOUR_KEY. The WebSocket protocol does not carry custom HTTP headers, so the header used for REST calls cannot be used here. Keep the key server-side and proxy to browsers.
Streaming is available on all plans. Free has a 60s minimum interval, Basic 10s, Startup 5s, and Growth and Professional 1s; Enterprise limits follow your agreement. Omit throttle to use your plan minimum, or request a supported slower interval: 1s, 5s, 10s, 30s or 60s. A faster-than-plan interval is refused. Updates are sent when data changes; cadence is a minimum interval, not a promise of a message each time.
No. Every Coinranking WebSocket message carries price and 24-hour volume in US dollars only. To show another currency, convert client-side with a REST price in that currency: any coin endpoint with referenceCurrencyUuid, or the coin fiat prices endpoint.
More of Coinranking API
Same key, same base URL.
Stream Prices over WebSockets
Your first rate message arrives a few minutes after sign-up. Professional is free for 30 days.
10,000 credits a month, no credit card. WebSocket and SSE streaming are available on all plans.