Skip to main content
Dispatched whenever a coin’s metadata, links, categories, contract addresses, or images change on CoinGecko.com.

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 an addition, update, or removal in the payload.
FieldDescriptionExample
idCoinGecko coin ID. Typically immutable β€” only changes to fix errors.bitcoin, usd-coin
symbolTicker symbol.btc, usdc
nameDisplay name.Bitcoin, USDC
web_slugURL 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...
categoriesCategory IDs assigned to the coin.meme-token, artificial-intelligence
public_noticesSecurity 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
imageImage 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 of changes describing exactly what was modified.
FieldDescription
event_typecg.coin.info.updated
data.idCoinGecko coin ID
data.symbolCoin symbol
data.nameCoin name
data.changesArray of change objects
data.changes[].fieldField that changed
data.changes[].change_typeaddition, update, or removal
data.changes[].new_valueUpdated value. null if removal.
data.changes[].old_valuePrevious value. null if addition.

Example

{
  "event_type": "cg.coin.info.updated",
  "data": {
    "id": "bitcoin",
    "symbol": "btc",
    "name": "Bitcoin",
    "changes": [
      {
        "field": "categories",
        "change_type": "addition",
        "old_value": null,
        "new_value": "Store of Value"
      },
      {
        "field": "links.facebook_username",
        "change_type": "update",
        "old_value": "bitcoins",
        "new_value": "bitcoin"
      },
      {
        "field": "platforms.ethereum",
        "change_type": "removal",
        "old_value": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
        "new_value": null
      }
    ]
  }
}