> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cg.coin.info.updated

### `cg.coin.info.updated`

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

### Potential Use Cases

<Columns cols={2}>
  <Column>
    <Card title="Automated Asset Updates for Wallets & Exchanges" icon="wallet">
      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).
    </Card>
  </Column>

  <Column>
    <Card title="Cross-Chain Contract Monitoring" icon="chart-network">
      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).
    </Card>
  </Column>
</Columns>

<Columns cols={2}>
  <Column>
    <Card title="Risk Management & Compliance" icon="camera-security">
      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`).
    </Card>
  </Column>

  <Column>
    <Card title="Bots & Alert Systems" icon="robot">
      Build automated bots that notify your community, the moment a project updates its whitepaper, GitHub repository, or official social media links.
    </Card>
  </Column>
</Columns>

### References based on CoinGecko coin page

<Frame>
  <img src="https://mintcdn.com/coingecko/g1OBFtScHaVeBXLR/images/Untitled-presentation.png?fit=max&auto=format&n=g1OBFtScHaVeBXLR&q=85&s=d62276f124e04c1d4277f876aeef7b8f" alt="Untitled Presentation" width="960" height="540" data-path="images/Untitled-presentation.png" />
</Frame>

## 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. <ul><li>`bitcoin`</li><li>`usd-coin`</li></ul> <br />The API ID serves as the primary unique identifier. It is typically immutable, except when an update is required to resolve unforeseen errors.<br />You can also retrieve the full coin id list via this [/coins/list endpoint](https://docs.coingecko.com/reference/coins-list-new) or visit respective coin page on [CoinGecko.com](http://CoinGecko.com)                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `symbol`                                                                                                                                                                                                                                                                                                                                            | Ticker symbol of a coin. e.g. <ul><li>`btc`</li><li>`usdc`</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `name`                                                                                                                                                                                                                                                                                                                                              | Name of a coin. e.g. <ul><li>`Bitcoin`</li><li>`USDC`</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `web_slug`                                                                                                                                                                                                                                                                                                                                          | URL Slug of a coin on [CoinGecko.com](http://CoinGecko.com). e.g. <ul><li>`bitcoin`</li><li>`usdc`</li></ul> <br />`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](http://CoinGecko.com).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `platforms.{asset_platform_id}` <ul><li>`platforms.ethereum`</li><li>`platforms.arbitrum-one`<br /></li></ul>                                                                                                                                                                                                                                       | Token contract address of a coin. e.g. <ul><li>`0x1f9840a85d5af5bf1d1762f925bdaddc4201f984`</li><li>`0xfa7f8980b0f1e64a2062791cc3b0871572f1f7f0`</li></ul> <br />You can get the full list of asset platforms id via [this endpoint](https://docs.coingecko.com/reference/asset-platforms-list). <br />In edge cases involving changes to the `asset_platform_id` itself <br />(e.g., migrating from xdai to ethereum), the system will send two changes: <ol><li>`removal` of the old key</li><li>`addition` of the new key</li></ol>                                                                                                                                                                                                                                                                                                                                     |
| `categories`                                                                                                                                                                                                                                                                                                                                        | Categories of a coin, e.g. <ul><li>`Meme`</li><li>`Artificial Intelligence`</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `public_notices`                                                                                                                                                                                                                                                                                                                                    | Public notices of a coin, including: security breach information and contract migration announcements. e.g. <ul><li>`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.`<br /></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `additional_notices`                                                                                                                                                                                                                                                                                                                                | Additional notices of a coin: can mint new tokens, has unverified contract<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `links.{site}` <ul><li>`homepage`</li><li>`whitepaper`</li><li>`official_forum_url`</li><li>`chat_url`</li><li>`announcement_url`</li><li>`snapshot_url`</li><li>`twitter_screen_name`</li><li>`facebook_username`</li><li>`telegram_channel_identifier`</li><li>`subreddit_url`</li><li>`repos_url.github`</li><li>`repos_url.bitbucket`</li></ul> | Official websites and social media sites of a coin. e.g. <ul><li>[https://uniswap.org/](https://uniswap.org/)</li><li>[https://blog.uniswap.org/uni](https://blog.uniswap.org/uni)</li><li>[https://discord.gg/FCfyBSbCU5](https://discord.gg/FCfyBSbCU5)</li><li>[https://uniswap.org/blog/](https://uniswap.org/blog/)</li><li>[https://www.reddit.com/r/Uniswap](https://www.reddit.com/r/Uniswap)</li><li>[https://github.com/Uniswap/uniswap-v3-core](https://github.com/Uniswap/uniswap-v3-core) <br /></li></ul> 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: <ul><li>`links.homepage`</li><li>`links.official_forum_url`</li><li>`links.chat_url`</li><li>`links.announcement_url`<br /></li></ul> |
| `image`                                                                                                                                                                                                                                                                                                                                             | Image file name of a coin. e.g. <ul><li>`uniswap-logo.png`</li></ul> <br />Instead of tracking the `image.thumb` URL in the payload, <br />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

```json theme={null}
{
  "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
      }
    ]
  }
}
```
