> ## 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

This event is dispatched when a top-100 coin by market cap makes a significant 24h price move (USD), in either direction.

* **Threshold:** 24h price change of at least 5–8%, depending on the coin's market cap rank.
* **Cooldown:** Once dispatched, the same coin won't trigger again for 2 hours (max 12 events per coin per day).

## Use Cases

> [card] Real-Time Price Alerts
>
> Notify your users or community the moment a major coin makes a significant move.

> [card] Automated Trading Triggers
>
> Kick off bots, screens, or trading workflows when a top coin moves meaningfully.

> [card] Portfolio & Risk Monitoring
>
> Track significant swings across major assets without constant polling.

> [card] Market Dashboards & Feeds
>
> Surface live price movements to power dashboards, tickers, and market updates.

## Payload

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

**event\_type** `string`

`cg.coin.price.moved`

**data** `object`

Coin and its price movement.

**properties**

**id** `string`

CoinGecko coin ID

**symbol** `string`

Coin symbol

**name** `string`

Coin name

**current\_price** `number`

Current price

**price\_change\_percentage\_24h** `number`

24-hour price change percentage

**price\_change\_24h** `number`

24-hour price change

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