cg.coin.info.updated - CoinGecko API

`cg.coin.info.updated`

This event is triggered whenever there is an update to the core information of a coin.

Potential Use Cases

Automated Asset Updates for Wallets & Exchanges

Instantly update your platform’s UI when a token undergoes a rebrand, changes its ticker symbol, is assigned a new category, or updates its official logo (image updates).

Cross-Chain Contract Monitoring

Automatically detect when an existing project deploys on a new blockchain, or when a token migrates to a new smart contract address (platforms additions/removals).

Risk Management & Compliance

Act immediately when CoinGecko adds critical alerts to a coin, such as a warning about a malicious activity or contract address migration notice (public_notices).

Bots & Alert Systems

Build automated bots that notify your community, the moment a project updates its whitepaper, GitHub repository, or official social media links.

References based on CoinGecko coin page

Data References

The webhook will only listen for and dispatch payloads for changes in the following data fields:

Data Field	Description & Output Field Example
`id`	API ID of a coin. e.g. `bitcoin` `usd-coin` The API ID serves as the primary unique identifier. It is typically immutable, except when an update is required to resolve unforeseen errors. You can also retrieve the full coin id list via this /coins/list endpoint or visit respective coin page on CoinGecko.com
`symbol`	Ticker symbol of a coin. e.g. `btc` `usdc`
`name`	Name of a coin. e.g. `Bitcoin` `USDC`
`web_slug`	URL Slug of a coin on CoinGecko.com. e.g. `bitcoin` `usdc` `web_slug` can be different from `coin_id`, use `web_slug` when you want to obtain the URL of a coin page on CoinGecko.com.
`platforms.{asset_platform_id}` `platforms.ethereum` `platforms.arbitrum-one`	Token contract address of a coin. e.g. `0x1f9840a85d5af5bf1d1762f925bdaddc4201f984` `0xfa7f8980b0f1e64a2062791cc3b0871572f1f7f0` You can get the full list of asset platforms id via this endpoint. In edge cases involving changes to the `asset_platform_id` itself (e.g., migrating from xdai to ethereum), the system will send two changes: `removal` of the old key `addition` of the new key
`categories`	Categories of a coin, e.g. `Meme` `Artificial Intelligence`
`public_notices`	Public notices of a coin, including: security breach information and contract migration announcements. e.g. `On September 4th, 2024, Polygon’s previous network token, $MATIC, was upgraded 1:1 to $POL. For more information, please refer to this post. For the new migrated token, visit POL on CoinGecko.`
`additional_notices`	Additional notices of a coin: can mint new tokens, has unverified contract
`links.{site}` `homepage` `whitepaper` `official_forum_url` `chat_url` `announcement_url` `snapshot_url` `twitter_screen_name` `facebook_username` `telegram_channel_identifier` `subreddit_url` `repos_url.github` `repos_url.bitbucket`	Official websites and social media sites of a coin. e.g. https://uniswap.org/ https://blog.uniswap.org/uni https://discord.gg/FCfyBSbCU5 https://uniswap.org/blog/ https://www.reddit.com/r/Uniswap https://github.com/Uniswap/uniswap-v3-core Note: for updates related to the 4 links below, only ‘`update`’ event will be triggered and the payload will contain an array of multiple links. If a link is being removed, it will return empty value: `links.homepage` `links.official_forum_url` `links.chat_url` `links.announcement_url`
`image`	Image file name of a coin. e.g. `uniswap-logo.png` Instead of tracking the `image.thumb` URL in the payload, the webhook returns the `image_file_name` (e.g., `uniswap-logo.png`).

Payload

Each webhook payload contains a specific event ID, timestamp, and a data object detailing the exact fields that changed.

Payload Structure

event_type: cg.coin.info.updated
data:
- id: CoinGecko coin ID (e.g., bitcoin)
- symbol: Coin symbol (e.g., btc)
- name: Coin name (e.g., Bitcoin)
- changes: An array of objects detailing the modifications. A single payload can contain one or multiple field changes.
  - field: The specific field that was altered.
  - change_type: Represents the action (addition, update, or removal).
  - new_value: The updated value (returns null if change_type is removal).
  - old_value: The previous value (returns null if change_type is addition).

Payload 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
      }
    ]
  }
}

Webhooks

Documentation Index