> ## 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.price.moved

> Triggered when a coin in the top 100 by market cap makes a significant price move

Dispatched whenever a top-100 coin's price moves significantly, using a pre-tuned sensitivity threshold so you only receive meaningful moves.

## Use Cases

<CardGroup cols={2}>
  <Card title="Real-Time Price Alerts" icon="bell">
    Notify your users or community the moment a major coin makes a significant move.
  </Card>

  <Card title="Automated Trading Triggers" icon="robot">
    Kick off bots, screens, or trading workflows when a top coin moves meaningfully.
  </Card>

  <Card title="Portfolio & Risk Monitoring" icon="shield-halved">
    Track significant swings across major assets without constant polling.
  </Card>

  <Card title="Market Dashboards & Feeds" icon="chart-line">
    Surface live price movements to power dashboards, tickers, and market updates.
  </Card>
</CardGroup>

## Payload

Each payload contains the event type, the identity of the coin, and its price movement.

<ResponseField name="event_type" type="string">
  `cg.coin.price.moved`
</ResponseField>

<ResponseField name="data" type="object">
  Coin and its price movement.

  <Expandable title="properties" defaultOpen>
    <ResponseField name="id" type="string">
      CoinGecko coin ID
    </ResponseField>

    <ResponseField name="symbol" type="string">
      Coin symbol
    </ResponseField>

    <ResponseField name="name" type="string">
      Coin name
    </ResponseField>

    <ResponseField name="current_price" type="number">
      Current price
    </ResponseField>

    <ResponseField name="price_change_percentage_24h" type="number">
      24-hour price change percentage
    </ResponseField>

    <ResponseField name="price_change_24h" type="number">
      24-hour price change
    </ResponseField>
  </Expandable>
</ResponseField>

### Example

```json expandable theme={null}
{
  "event_type": "cg.coin.price.moved",
  "data": {
    "id": "bitcoin",
    "symbol": "btc",
    "name": "Bitcoin",
    "current_price": 86216,
    "price_change_percentage_24h": 2.34,
    "price_change_24h": 1972.45
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.