CGSimplePrice - CoinGecko API

This Websocket channel allows you to subscribe to real-time updates of price changes for token.

Lookup by Coin ID
It will return price & market data of the top pool of the specified token

Update Frequency: as fast as ~10s, for large cap and actively traded coins.

Data Payload

	Field	Type	Description	Example
`c`	`channel_type`	string	Indicates the type of channel subscribed to.	C1
`i`	`coin_id`	string	Identifier of the coins. Check full list of IDs here.	`ethereum`, `usd-coin`
`p`	`usd_price`	string	Current token price in USD.	3639.78228844745
`pp`	`usd_price_24h_change_percentage`	float	Percentage change in token price over the last 24 hours.	3.566
`m`	`usd_market_cap`	float	Market capitalization in USD.	123
`v`	`usd_24h_vol`	float	24-hour trading volume in USD.	31233333.33
`t`	`last_updated_at`	integer	Timestamp of the last data update in UNIX time.	1709542750

Tips: The Websocket payload will use the value null when specific data is unavailable. Ensure your application is capable of handling null values for fields that may not always have data.

1. Establish Connection to Websocket

wss://stream.coingecko.com/v1?x_cg_pro_api_key=YOUR_KEY

OR

wss://stream.coingecko.com/v1  
x-cg-pro-api-key: YOUR_KEY

Input Example:

{"command":"subscribe","identifier":"{\"channel\":\"CGSimplePrice\"}"}

Output Example:

{"type":"confirm_subscription","identifier":"{\"channel\":\"CGSimplePrice\"}"}

3. Stream CGSimplePrice

Input Example:

{"command":"message","identifier":"{\"channel\":\"CGSimplePrice\"}","data":"{\"coin_id\":[\"ethereum\",\"bitcoin\"],\"action\":\"set_tokens\"}"}

Output Example:

{
    "code": 2000,
    "message": "Subscription is successful for ethereum"
}

Output Example:

{
    "c": "C1",
    "i": "ethereum",
    "m": 312938652962.8005,
    "p": 2591.080889351465,
    "pp": 1.3763793110454519,
    "t": 1747808150.269067,
    "v": 20460612214.801384
}

The output keys will be in random order.

Tips:

Input Example: Unsubscribe for 1 specific token data:

{"command":"message","identifier":"{\"channel\":\"CGSimplePrice\"}","data":"{\"coin_id\":[\"ethereum\"],\"action\":\"unset_tokens\"}"}

Output Example:

{
    "code": 2000,
    "message": "Unsubscription is successful for ethereum"
}

Input Example: Unsubscribe from CGSimplePrice channel and all token data:

{"command":"unsubscribe","identifier":"{\"channel\":\"CGSimplePrice\"}"}

Output Example:

{
    "code": 2000,
    "message": "Unsubscription is successful for all tokens"
}

Websocket (Beta)

​Data Payload

​1. Establish Connection to Websocket

​2. Subscribe to a specific channel - CGSimplePrice

​3. Stream CGSimplePrice

​Tips:

​Un-subscribe to stop streaming CGSimplePrice data

Data Payload

1. Establish Connection to Websocket

2. Subscribe to a specific channel - CGSimplePrice

3. Stream CGSimplePrice

Tips:

Un-subscribe to stop streaming CGSimplePrice data