Power AI Agents with CoinGecko's On-chain Crypto Data

Access on-chain market data and metadata for smarter  AI-powered trades, research, and analysis.

Get Your API Key

Explore Docs

Hows Bitcoin doing?

BTC vs. ETH

24h top gainers

Hows Bitcoin doing?

BTC vs. ETH

24h top gainers

Why developers_ choose us

Extensive. Fast. Reliable. Enterprise-Grade.

We’re always making our API better with more endpoints, greater data granularity and lower latency. See what’s new →

30M+ Tokens

Complete token coverage with on-chain data

Trusted by Industry Builders

Enterprise-Grade Service

Enjoy tailored integration guidance, 24/7 dedicated support, and a custom API plan designed to scale with your business.

Talk to Sales

10+ Years

Of Historical Data

Up to Sub-second

Real-time Data Update

99% Uptime SLA

Enterprise-grade infrastructure

10 billion

Monthly API calls

250+

Networks

1,700+

Exchanges

CoinGecko API is SOC 2 Type 2 compliant. Our systems and processes meet rigorous industry standards to safeguard data.

Why developers_ choose us

Extensive. Fast. Reliable. Enterprise-Grade.

We’re always making our API better with more endpoints, greater data granularity and lower latency. See what’s new →

30M+ Tokens

Complete token coverage with on-chain data

Trusted by Industry Builders

Enterprise-Grade Service

Enjoy tailored integration guidance, 24/7 dedicated support, and a custom API plan designed to scale with your business.

Talk to Sales

10+ Years

Of Historical Data

Up to Sub-second

Real-time Data Update

99% Uptime SLA

Enterprise-grade infrastructure

10 billion

Monthly API calls

250+

Networks

1,700+

Exchanges

CoinGecko API is SOC 2 Type 2 compliant. Our systems and processes meet rigorous industry standards to safeguard data.

Why developers_ choose us

Extensive. Fast. Reliable. Enterprise-Grade.

We’re always making our API better with more endpoints, greater data granularity and lower latency. See what’s new →

30M+ Tokens

Complete token coverage with on-chain data

Trusted by Industry Builders

Enterprise-Grade Service

Enjoy tailored integration guidance, 24/7 dedicated support, and a custom API plan designed to scale with your business.

Talk to Sales

10+ Years

Of Historical Data

Up to Sub-second

Real-time Data Update

99% Uptime SLA

Enterprise-grade infrastructure

10 billion

Monthly API calls

250+

Networks

1,700+

Exchanges

CoinGecko API is SOC 2 Type 2 compliant. Our systems and processes meet rigorous industry standards to safeguard data.

Designed for developers_

Enhance Your AI with Reliable Crypto Market Data

On-chain Prices & Market Data

Fetch real-time and historical data including prices, market cap, volume, and more.

Live data updated every 20 seconds

1
// Get live prices and market data
2
{
3
  "bitcoin": {
4
    "usd": 67187.3358936566,
5
    "usd_market_cap": 1317802988326.25,
6
    "usd_24h_vol": 31260929299.5248,
7
    "usd_24h_change": 3.63727894677354,
8
    "last_updated_at": 1711356300
9
  }
10
}
11
12
// Get on-chain token prices and market data
13
{
14
  "data": {
15
    "id": "1ba898f0-eda2-4291-9491-9a5b323f66ef",
16
    "type": "simple_token_price",
17
    "attributes": {
18
      "token_prices": {
19
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3399.24368371279"
20
      },
21
      "market_cap_usd": {
22
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "10005535878.50094"
23
      },
24
      "h24_volume_usd": {
25
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2544539948.02599"
26
      }
27
    }
28
  }
29
}

On-chain Prices & Market Data

Fetch real-time and historical data including prices, market cap, volume, and more.

Live data updated every 20 seconds

1
// Get live prices and market data
2
{
3
  "bitcoin": {
4
    "usd": 67187.3358936566,
5
    "usd_market_cap": 1317802988326.25,
6
    "usd_24h_vol": 31260929299.5248,
7
    "usd_24h_change": 3.63727894677354,
8
    "last_updated_at": 1711356300
9
  }
10
}
11
12
// Get on-chain token prices and market data
13
{
14
  "data": {
15
    "id": "1ba898f0-eda2-4291-9491-9a5b323f66ef",
16
    "type": "simple_token_price",
17
    "attributes": {
18
      "token_prices": {
19
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3399.24368371279"
20
      },
21
      "market_cap_usd": {
22
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "10005535878.50094"
23
      },
24
      "h24_volume_usd": {
25
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2544539948.02599"
26
      }
27
    }
28
  }
29
}

New & Trending Tokens

Retrieve data on trending coins, top gainers, and popular narratives to spot market opportunities

Track newly launched tokens and liquidity pools

1
// Get trending pools across all networks
2
{
3
  "data": [
4
    {
5
      "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
6
      "type": "pool",
7
      "attributes": {
8
        "base_token_price_usd": "3653.12491645176",
9
        "base_token_price_native_currency": "1.0",
10
        "quote_token_price_usd": "0.998343707926245",
11
        "quote_token_price_native_currency": "0.000273040545093221",
12
        "base_token_price_quote_token": "3662.46",
13
        "quote_token_price_base_token": "0.00027304",
14
        "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
15
        "name": "WETH / USDC 0.05%",
16
        "pool_created_at": "2021-12-29T12:35:14Z",
17
        "fdv_usd": "11007041041",
18
        "market_cap_usd": null,
19
        "price_change_percentage": {
20
          "m5": "0",
21
          "h1": "0.51",
22
          "h6": "0.86",
23
          "h24": "7.71"
24
        },
25
        "transactions": {
26
          "m5": {
27
            "buys": 7,
28
            "sells": 2,
29
            "buyers": 7,
30
            "sellers": 2
31
          },
32
          "m15": {
33
            "buys": 19,
34
            "sells": 27,
35
            "buyers": 19,
36
            "sellers": 27
37
          },
38
          "m30": {
39
            "buys": 49,
40
            "sells": 61,
41
            "buyers": 45,
42
            "sellers": 57
43
          },
44
          "h1": {
45
            "buys": 97,
46
            "sells": 144,
47
            "buyers": 83,
48
            "sellers": 124
49
          },
50
          "h24": {
51
            "buys": 2966,
52
            "sells": 3847,
53
            "buyers": 1625,
54
            "sellers": 2399
55
          }
56
        },
57
        "volume_usd": {
58
          "m5": "868581.7348314",
59
          "h1": "16798158.0138526",
60
          "h6": "164054610.850188",
61
          "h24": "536545444.904535"
62
        },
63
        "reserve_in_usd": "163988541.3812"
64
      },
65
      "relationships": {
66
        "base_token": {
67
          "data": {
68
            "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
69
            "type": "token"
70
          }
71
        },
72
        "quote_token": {
73
          "data": {
74
            "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
75
            "type": "token"
76
          }
77
        },
78
        "dex": {
79
          "data": {
80
            "id": "uniswap_v3",
81
            "type": "dex"
82
          }
83
        }
84
      }
85
    }
86
  ],
87
  "included": [
88
    {
89
      "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
90
      "type": "token",
91
      "attributes": {
92
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
93
        "name": "Wrapped Ether",
94
        "symbol": "WETH",
95
        "image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",
96
        "coingecko_coin_id": "weth"
97
      }
98
    }
99
  ]
100
}

New & Trending Tokens

Retrieve data on trending coins, top gainers, and popular narratives to spot market opportunities

Track newly launched tokens and liquidity pools

1
// Get trending pools across all networks
2
{
3
  "data": [
4
    {
5
      "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
6
      "type": "pool",
7
      "attributes": {
8
        "base_token_price_usd": "3653.12491645176",
9
        "base_token_price_native_currency": "1.0",
10
        "quote_token_price_usd": "0.998343707926245",
11
        "quote_token_price_native_currency": "0.000273040545093221",
12
        "base_token_price_quote_token": "3662.46",
13
        "quote_token_price_base_token": "0.00027304",
14
        "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
15
        "name": "WETH / USDC 0.05%",
16
        "pool_created_at": "2021-12-29T12:35:14Z",
17
        "fdv_usd": "11007041041",
18
        "market_cap_usd": null,
19
        "price_change_percentage": {
20
          "m5": "0",
21
          "h1": "0.51",
22
          "h6": "0.86",
23
          "h24": "7.71"
24
        },
25
        "transactions": {
26
          "m5": {
27
            "buys": 7,
28
            "sells": 2,
29
            "buyers": 7,
30
            "sellers": 2
31
          },
32
          "m15": {
33
            "buys": 19,
34
            "sells": 27,
35
            "buyers": 19,
36
            "sellers": 27
37
          },
38
          "m30": {
39
            "buys": 49,
40
            "sells": 61,
41
            "buyers": 45,
42
            "sellers": 57
43
          },
44
          "h1": {
45
            "buys": 97,
46
            "sells": 144,
47
            "buyers": 83,
48
            "sellers": 124
49
          },
50
          "h24": {
51
            "buys": 2966,
52
            "sells": 3847,
53
            "buyers": 1625,
54
            "sellers": 2399
55
          }
56
        },
57
        "volume_usd": {
58
          "m5": "868581.7348314",
59
          "h1": "16798158.0138526",
60
          "h6": "164054610.850188",
61
          "h24": "536545444.904535"
62
        },
63
        "reserve_in_usd": "163988541.3812"
64
      },
65
      "relationships": {
66
        "base_token": {
67
          "data": {
68
            "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
69
            "type": "token"
70
          }
71
        },
72
        "quote_token": {
73
          "data": {
74
            "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
75
            "type": "token"
76
          }
77
        },
78
        "dex": {
79
          "data": {
80
            "id": "uniswap_v3",
81
            "type": "dex"
82
          }
83
        }
84
      }
85
    }
86
  ],
87
  "included": [
88
    {
89
      "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
90
      "type": "token",
91
      "attributes": {
92
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
93
        "name": "Wrapped Ether",
94
        "symbol": "WETH",
95
        "image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",
96
        "coingecko_coin_id": "weth"
97
      }
98
    }
99
  ]
100
}

Token Metadata

Get crypto logos, official websites, contract addresses, social links and more.

Pull on-chain metadata like holder count, distribution percentages, and mint/freeze authority

1
// Get token metadata
2
{
3
  "data": {
4
    "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
5
    "type": "token",
6
    "attributes": {
7
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
8
      "name": "Tether USD",
9
      "symbol": "USDT",
10
      "image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
11
      "coingecko_coin_id": "tether",
12
      "websites": [
13
        "https://tether.to/"
14
      ],
15
      "description": "Tether (USDT) is a cryptocurrency with a value meant to mirror the value of the U.S. dollar...",
16
      "gt_score": 92.6605504587156,
17
      "discord_url": null,
18
      "telegram_handle": null,
19
      "twitter_handle": "Tether_to",
20
      "categories": [],
21
      "gt_categories_id": []
22
    }
23
  }
24
}

Token Metadata

Get crypto logos, official websites, contract addresses, social links and more.

Pull on-chain metadata like holder count, distribution percentages, and mint/freeze authority

1
// Get token metadata
2
{
3
  "data": {
4
    "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
5
    "type": "token",
6
    "attributes": {
7
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
8
      "name": "Tether USD",
9
      "symbol": "USDT",
10
      "image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
11
      "coingecko_coin_id": "tether",
12
      "websites": [
13
        "https://tether.to/"
14
      ],
15
      "description": "Tether (USDT) is a cryptocurrency with a value meant to mirror the value of the U.S. dollar...",
16
      "gt_score": 92.6605504587156,
17
      "discord_url": null,
18
      "telegram_handle": null,
19
      "twitter_handle": "Tether_to",
20
      "categories": [],
21
      "gt_categories_id": []
22
    }
23
  }
24
}