Skip to main content

​
Stream Real-Time Crypto Data with CoinGecko WebSockets

CoinGecko WebSocket API provides a persistent connection for real-time data streaming — receive market updates the moment they happen, without polling.
CoinGecko WebSocket (Beta) is available for paid plan customers (Analyst plan & above).
  • Analyst, Lite, Pro, and Pro+ self-serve plans include:
    • Max connections: 10 concurrent socket connections
    • Max subscriptions: 100 token or pool data subscriptions per channel, per socket
    • Channel access: all 4 channels
    • Credit charge: 0.1 credit per response returned, deducting from monthly API plan credits
  • Enterprise plan clients who want higher limits (max connections, max subscriptions, lower credit charge) — contact your Customer Success Manager.
CoinGecko WebSocket is a supplementary delivery mechanism for live data streaming. Currently in beta — excluded from the SLA applicable to the CoinGecko API Platform.

Share Feedback

Help us improve WebSocket — share your suggestions and feedback.

​
Channel & Data Support

WebSocket ChannelChannel CodeDetails
CGSimplePriceC1Real-time coin prices, as seen on CoinGecko.com
OnchainSimpleTokenPriceG1Real-time token prices, as seen on GeckoTerminal.com
OnchainTradeG2Real-time pool transactions, as seen on GeckoTerminal.com
OnchainOHLCVG3Real-time OHLCV data for pools, as seen on GeckoTerminal.com
(More coming soon!)

​
Connection Handling

  1. Ping/Pong Mechanism:
    • Server sends a ping every 10 seconds.
    • If no pong is received within 20 seconds, the connection is automatically closed.
    • Ensure your WebSocket client responds to pings with pongs — most libraries handle this automatically, but verify your implementation.
  2. Planned Disconnections (Deployments & Reboots):
    • System reboots or deployments may temporarily disconnect active connections.
    • Your application should automatically reconnect on disconnection. Use exponential backoff to avoid overwhelming the server during widespread disconnections.

Access WebSocket

Subscribe to an Analyst plan or above to start streaming real-time data.