cg.coin.price.moved - CoinGecko API

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

Real-Time Price Alerts

Notify your users or community the moment a major coin makes a significant move.

Automated Trading Triggers

Kick off bots, screens, or trading workflows when a top coin moves meaningfully.

Portfolio & Risk Monitoring

Track significant swings across major assets without constant polling.

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.

string

cg.coin.price.moved

object

Coin and its price movement.

Hide properties

string

CoinGecko coin ID

string

Coin symbol

string

Coin name

number

Current price

number

24-hour price change percentage

number

24-hour price change

Example

{
  "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
  }
}

​Use Cases

Real-Time Price Alerts

Automated Trading Triggers

Portfolio & Risk Monitoring

Market Dashboards & Feeds

​Payload

​Example

Use Cases

Payload

Example