OnchainSimpleTokenPrice - CoinGecko API

Notes

Streams real-time price and market data for tokens by network and token address.
Returns data from the top pool of the specified token.
Lookup format: network_id:token_address (e.g. bsc:0x55d398326f99059ff775485246999027b3197955).
Find supported network IDs via Networks List.
Fields may return null when data is unavailable. Ensure your application handles null values.

Update Frequency:
As fast as ~1 second for actively traded tokens.

Data Payload

Key	Field	Type	Description	Example
`c`	`channel_type`	string	Channel type subscribed to.	`G1`
`n`	`network_id`	string	Blockchain network identifier.	`bsc`
`ta`	`token_address`	string	Token contract address.	`0x55d398326f99059ff775485246999027b3197955`
`p`	`usd_price`	number	Current token price in USD.	1.0002630480973
`pp`	`usd_price_24h_change_percentage`	number	Price change percentage (24h).	0.05
`m`	`usd_market_cap`	number	Market capitalization in USD.	9187408426.01
`v`	`usd_24h_vol`	number	24-hour trading volume in USD.	1999727791.12
`t`	`last_updated_at`	integer	UNIX timestamp in seconds.	1780840630

1. Establish Connection

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

You can also pass the key as a header: x-cg-pro-api-key: YOUR_KEY

Output:

{
  "code": 3000,
  "message": "Connection established",
  "uuid": "YOUR_SESSION_ID"
}

{
  "type": "welcome",
  "sid": "YOUR_SESSION_ID"
}

Input:

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

Output:

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

3. Stream Token Price Data

Input:

{"command":"message","identifier":"{\"channel\":\"OnchainSimpleTokenPrice\"}","data":"{\"network_id:token_addresses\":[\"bsc:0x55d398326f99059ff775485246999027b3197955\"],\"action\":\"set_tokens\"}"}

Output:

{
  "code": 2000,
  "message": "Subscription successful for bsc:0x55d398326f99059ff775485246999027b3197955"
}

Streaming output:

{
  "c": "G1",
  "n": "bsc",
  "ta": "0x55d398326f99059ff775485246999027b3197955",
  "p": 1.0002630480973,
  "pp": 0.04574653488,
  "m": 9187408426.010283,
  "v": 1999727791.12026,
  "t": 1780840630
}

Output keys may appear in any order.

4. Unsubscribe

Unsubscribe from a specific token:

{"command":"message","identifier":"{\"channel\":\"OnchainSimpleTokenPrice\"}","data":"{\"network_id:token_addresses\":[\"bsc:0x55d398326f99059ff775485246999027b3197955\"],\"action\":\"unset_tokens\"}"}

{
  "code": 2000,
  "message": "Unsubscription is successful for bsc:0x55d398326f99059ff775485246999027b3197955"
}

Unsubscribe from the channel entirely:

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

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

​Notes

​Data Payload

​1. Establish Connection

​2. Subscribe to OnchainSimpleTokenPrice

​3. Stream Token Price Data

​4. Unsubscribe

Notes

Data Payload

1. Establish Connection

2. Subscribe to OnchainSimpleTokenPrice

3. Stream Token Price Data

4. Unsubscribe