Crypto Price SSE API
Real-time prices for 2.4M+ coins as Server-Sent Events: one GET request that stays open, with credits charged per delivered data event. The recommended transport for front ends; back ends use WebSockets.
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 · https://api.coinranking.com/v2/real-time/sse
# -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¤cy-uuids[]=razxDUgYGNAdQ' \
-H 'x-access-token: YOUR_KEY'
# First line confirms the subscription, then one data: line per price update
# data: {"type":"rate","currencyUuid":"Qwsogvtv82FCd","price":"125423.83","volume":"6270550403.28"}Three Streams, Same Data as the WebSockets
Each SSE path mirrors the WebSocket path of the same name: same subscriptions, throttle and message fields, plus a type field.
- SSE/sse/rates
One aggregated price and 24-hour volume per coin. Subscribe with
currency-uuids[](1–100) orlist=allfor every coin. A coin’s price and volume per exchange, tagged
cexordex. Subscribe withreferences[],exchange-uuids[],currency-uuids[]orlist=all.- SSE/sse/tickers
Trading-pair level with base and quote volume. Subscribe with
market-uuids[],exchange-uuids[],currency-uuids[]orlist=all.
Eligible plans can access DEX markets through Real-Time DEX Data.
SSE or WebSocket
One data set, two transports. Pick by where the client runs.
| Server-Sent Events | WebSocket | |
|---|---|---|
| Recommended for | Front ends | Back ends |
| Protocol | HTTP GET, text/event-stream | WebSocket upgrade, wss:// |
| Base URL | https://api.coinranking.com/v2/real-time/sse | wss://api.coinranking.com/v2/real-time |
| Authentication | x-access-token header, or query parameter for EventSource | x-access-token query parameter |
| Change subscriptions | Open a new stream | Send a JSON message on the open socket |
| Subscribe to everything | list=all | Up to 100 UUIDs per connection |
| Reconnect | Automatic in EventSource, after 5 seconds | Reopen the URL |
| Through proxies, CDNs, serverless | Yes, it is a normal HTTP response | Only where upgrades are allowed |
| Cost | Per delivered message, at your plan rate | Per delivered message, at your plan rate |
| Plan | All plans | All plans |
Built for Production Front Ends
What the stream does for you, and the one thing to do yourself.
Validated Before It Streams
A bad UUID, throttle or key returns a normal JSON error with a code, before a single byte streams. Match on the code.
Confirmed on Open
The first message lists what you subscribed to and the throttle. Every data message carries a type field.
Heartbeats and Reconnect
A :ping keeps idle timeouts away and the stream announces retry: 5000. No maximum duration.
Any HTTP Client
EventSource, fetch, curl, Python requests with stream=True, Node, Deno, Bun. The docs have each one.
Keep the key on your server and proxy the stream through your own origin; the docs include a Node proxy and a fetch-based client that reads error codes EventSource cannot.
SSE by Plan
SSE and 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.
SSE Questions
Coinranking SSE API streams the same real-time rates, exchange rates and tickers as Coinranking WebSockets as Server-Sent Events: a plain HTTP GET to /v2/real-time/sse/rates, /sse/exchange-rates or /sse/tickers that stays open and writes one data: line of JSON per update. Subscriptions, throttle, message fields and plan requirements are identical to the WebSocket path of the same name. See the SSE documentation.
Use Coinranking SSE for front ends and for any environment without a WebSocket client: browsers with the built-in EventSource, serverless and edge runtimes, curl, or any HTTP library that can read a response as it arrives. Use WebSockets for back ends that need to change subscriptions mid-stream; an SSE stream is one-way, so a new subscription means a new stream.
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.
Send the key in the x-access-token header, as for every REST call; curl, fetch and server-side HTTP libraries can all set it. The browser's built-in EventSource cannot set headers, so for that case only the key is also accepted as a ?x-access-token= query parameter. For a public website, keep the key on your server and proxy the stream through your own origin.
WebSocket and SSE streaming are available on all plans. See plans and confirm streaming access in your account.
Reconnect with the same URL; the subscriptions live in the URL, so there is no state to rebuild. EventSource reconnects by itself after the five seconds the stream announces with retry: 5000. The stream carries updates only and does not replay what was missed, so fetch a starting value from the REST endpoints if the first screen needs one before the first update arrives.
More of Coinranking API
Same key, same base URL.
Stream Prices over SSE
One GET request and the first price arrives. Professional is free for 30 days.
10,000 credits a month, no credit card. WebSocket and SSE streaming are available on all plans.