Use Cases
Automated Asset Updates
Update your UI when a token rebrands, changes ticker, or updates its logo.
Cross-Chain Contract Monitoring
Detect when a project deploys on a new chain or migrates a contract address.
Risk & Compliance
Act on critical alerts β malicious activity warnings or contract migration notices.
Bots & Alert Systems
Notify your community when a project updates its whitepaper, GitHub repo, or social links.
Tracked Fields
The webhook listens for changes in the following fields. Each change is reported as anaddition, update, or removal in the payload.
| Field | Description | Example |
|---|---|---|
id | CoinGecko coin ID. Typically immutable β only changes to fix errors. | bitcoin, usd-coin |
symbol | Ticker symbol. | btc, usdc |
name | Display name. | Bitcoin, USDC |
web_slug | URL slug on CoinGecko.com. Can differ from id. | bitcoin, usdc |
platforms.{asset_platform_id} | Token contract address on a given chain. See Asset Platforms List. | platforms.ethereum β 0x1f98... |
categories | Category IDs assigned to the coin. | meme-token, artificial-intelligence |
public_notices | Security breach info and contract migration announcements. | $MATIC was upgraded 1:1 to $POL... |
additional_notices.{status} | Flags like can_mint_new_tokens or has_unverified_contract. | true, false, or null |
links.{site} | Official websites and social media links. | links.homepage, links.whitepaper, links.twitter_screen_name |
image | Image filename (not URL). Use /coins/{id} or /coins/markets to get full URLs. | uniswap-logo.png |
When
platforms.{asset_platform_id} changes its key (e.g. xdai β ethereum), two changes are sent: a removal of the old key and an addition of the new key.For
links.homepage, links.official_forum_url, links.chat_url, and links.announcement_url β only update events are triggered.- The payload contains the full array of links.
- A removed link returns an empty value.
Payload
Each payload contains the event type, coin identity, and an array ofchanges describing exactly what was modified.
| Field | Description |
|---|---|
event_type | cg.coin.info.updated |
data.id | CoinGecko coin ID |
data.symbol | Coin symbol |
data.name | Coin name |
data.changes | Array of change objects |
data.changes[].field | Field that changed |
data.changes[].change_type | addition, update, or removal |
data.changes[].new_value | Updated value. null if removal. |
data.changes[].old_value | Previous value. null if addition. |

