Fetch. Stream. Push.
Flexible Crypto Data Delivery for Every Workflow

Get crypto data via REST, WebSocket, or Webhook. Fetch market data on demand, stream live prices, and sync updates automatically with CoinGecko's flexible data delivery methods

Get Your API Key

Explore Docs

Get Crypto Data with REST API

Trusted by Industry Builders

Trusted by Industry Builders

Delivery Methods

Pick the right method
for every workflow

PULL MODEL

REST API

The standard way to fetch crypto data on demand. Send an HTTP request, get a JSON response.

70+ crypto data endpoints

Coin prices, market cap, volume, historical OHLCV

Onchain DEX data powered by GeckoTerminal

Available on all plans

Best for

Portfolio trackers, price lookups and converters, market screeners, backtesting, research

Explore Docs

1
[
2
  {
3
    "id": "bitcoin",
4
    "symbol": "btc",
5
    "name": "Bitcoin",
6
    "image": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
7
    "current_price": 70187,
8
    "market_cap": 1381651251183,
9
    "market_cap_rank": 1,
10
    "fully_diluted_valuation": 1474623675796,
11
    "total_volume": 20154184933,
12
    "high_24h": 70215,
13
    "low_24h": 68060,
14
    "price_change_24h": 2126.88,
15
    "price_change_percentage_24h": 3.12502,
16
    "market_cap_change_24h": 44287678051,
17
    "market_cap_change_percentage_24h": 3.31157,
18
    "circulating_supply": 19675987,
19
    "total_supply": 21000000,
20
    "max_supply": 21000000,
21
    "ath": 73738,
22
    "ath_change_percentage": -4.77063,
23
    "ath_date": "2024-03-14T07:10:36.635Z",
24
    "atl": 67.81,
25
    "atl_change_percentage": 103455.83335,
26
    "atl_date": "2013-07-06T00:00:00.000Z",
27
    "roi": null,
28
    "last_updated": "2024-04-07T16:49:31.736Z",
29
    "market_cap_rank_with_rehypothecated": 1
30
  }
31
]

1
// Token Prices & Liquidity Data
2
{
3
  "data": {
4
    "id": "solana_ED5nyyWEzpPPiWimP8vYm7sD7TD3LAt3Q3gRTWHzPJBY",
5
    "type": "token",
6
    "attributes": {
7
      "address": "ED5nyyWEzpPPiWimP8vYm7sD7TD3LAt3Q3gRTWHzPJBY",
8
      "name": "Moo Deng",
9
      "symbol": "MOODENG",
10
      "decimals": 6,
11
      "image_url": "https://coin-images.coingecko.com/coins/images/50264/large/MOODENG.jpg?1726726975",
12
      "coingecko_coin_id": "moo-deng",
13
      "total_supply": "989940962969385.0",
14
      "price_usd": "0.2260493612",
15
      "fdv_usd": "223775522.276758",
16
      "total_reserve_in_usd": "5180212.306700410094472",
17
      "volume_usd": {
18
        "h24": "10235022.5216961"
19
      },
20
      "market_cap_usd": "225739398.037755"
21
    },
22
    "relationships": {
23
      "top_pools": {
24
        "data": [
25
          {
26
            "id": "solana_22WrmyTj8x2TRVQen3fxxi2r4Rn6JDHWoMTpsSmn8RUd",
27
            "type": "pool"
28
          },
29
          {
30
            "id": "solana_6BiuT5BT2ZUVgvtzrsn7fReRquKY78C7TFsp57qXkczu",
31
            "type": "pool"
32
          },
33
          {
34
            "id": "solana_5DBqaJegKNemJxvrvrReHDL1Dkpk83237PYH2wjUpdgi",
35
            "type": "pool"
36
          }
37
        ]
38
      }
39
    }
40
  }
41
}
42
43
// More Endpoints & Data at https://docs.coingecko.com/reference/introduction

STREAM MODEL

WebSocket

Stream live crypto prices and market data with a persistent connection. Receive updates as they happen — no polling, no delays. Learn more about WebSocket.

Ultra-low latency crypto data

4 channels: price, onchain price, trades & OHLCV

Available on Analyst & above

Best for

Price alerts, live charting, high-frequency trading dashboards

Explore Docs

1
{
2
    "c": "C1",
3
    "i": "ethereum",
4
    "vs": "usd",
5
    "m": 312938652962.8005,
6
    "p": 2591.080889351465,
7
    "pp": 1.3763793110454519,
8
    "t": 1747808150.269067,
9
    "v": 20460612214.801384
10
}

PUSH MODEL

Webhook

Receive an automatic HTTP POST to your endpoint when when coin metadata changes. If your server is unavailable, we retry delivery for up to 24 hours.

Fires when coin name, symbol, contract address, category, public notices or official links changes

Up to 5 Webhooks per account

Available on Analyst & above

Estimated cost: 60K credits/month — 10 credits per event, 200 events/day

Best for

Token database sync, metadata monitoring, listing change alerts, compliance workflows

Explore Docs

1
{
2
  "event_type": "cg.coin.info.updated",
3
  "data": {
4
    "id": "bitcoin",
5
    "symbol": "btc",
6
    "name": "Bitcoin",
7
    "changes": [
8
      {
9
        "field": "categories",
10
        "change_type": "addition",
11
        "old_value": null,
12
        "new_value": "Store of Value"
13
      },
14
      {
15
        "field": "links.facebook_username",
16
        "change_type": "update",
17
        "old_value": "bitcoins",
18
        "new_value": "bitcoin"
19
      },
20
      {
21
        "field": "platforms.ethereum",
22
        "change_type": "removal",
23
        "old_value": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
24
        "new_value:": null
25
      }
26
    ]
27
  }
28
}

Delivery Method Comparison

Upgrade to a paid plan to unlock WebSocket and Webhook

REST

WebSocket

Webhook

Model

Pull — you request, we respond

Stream — persistent connection, continuous data

Push — you'll be notified when there's an update

Latency

Request-bound

Ultra-low

Event-triggered

Data

All

Prices, Trades & OHLCV

Coin Metadata

Plans

All

Analyst & above

Credits

1 credit per request

0.1 credit per response

10 credits per event delivery

Uses

Historical data, ad-hoc queries, standard lookups

Real-time price feeds, live charting, trading dashboards

Metadata sync, event-driven workflows

Get Your API Key

Explore Docs

Talk to Our Sales Team

Need higher WebSocket connections, more Webhooks, or custom credits and rate limits for REST? Talk to our team for a tailored plan with expert advice on optimizing your infrastructure