CoinGecko

Look up cryptocurrency prices, charts, price history, trending coins, categories, exchanges and company treasuries from CoinGecko. Works without an account on its keyless public API; add a free Demo API key for a rate limit of your own.

Actions

Action	What it does
Get coin data on a date	Get a coin's price, market cap and 24 hour volume in every currency CoinGecko supports, as they stood at 00:00 UTC on a date in the past 365 days.
Get coin details	Get a coin's profile from CoinGecko: what it is, its links, categories and contract addresses, and its market data in every currency, optionally with its top 100 trading pairs.
Get coin prices	Look up the current price of one or more cryptocurrencies in the currencies you choose, finding the coins by CoinGecko ID, ticker symbol or name.
Get exchange details	Get an exchange's profile from CoinGecko: its country, links, trust score, how many coins and pairs it lists and its 24 hour volume, optionally with its top 100 trading pairs.
Get global DeFi market data	Retrieve statistics for decentralized finance (DeFi): its total market cap and 24 hour volume, its share of the whole market, and its largest coin.
Get global market data	Retrieve statistics for the whole cryptocurrency market: its total market cap and volume, how it moved over 24 hours, and the share held by the largest coins.
Get market chart	Get a coin's price, market cap and trading volume over the past 1 to 365 days, as series of points you can chart or summarize.
Get market chart for a date range	Get a coin's price, market cap and trading volume between two dates within the past 365 days, as series of points you can chart or summarize.
Get price candles (OHLC)	Get a coin's open, high, low and close prices as candles over the past 1 to 365 days, oldest first.
Get public treasury holdings	See which public companies or governments hold a coin, such as bitcoin or ethereum, and how much: each holder's amount, value and share of the supply, largest first, with the totals.
Get token prices by contract address	Look up the current price of tokens by their contract address on a blockchain platform such as Ethereum or Solana, in the currencies you choose.
Get trending coins	Fetch the coins, NFT collections and categories most searched on CoinGecko over the past 24 hours.
List coin categories	List CoinGecko's coin categories (such as layer 1, meme or AI coins) with each category's market cap, 24 hour change and volume, and its three largest coins.
List coins with market data	List coins ranked by market cap or volume, each with its price, market cap, volume, 24 hour high and low, supply and all-time high.
List exchanges	List cryptocurrency exchanges ranked by CoinGecko's trust score, each with its country, founding year and 24 hour trading volume, up to 250 a page.
List tokenized real-world assets	List tokenized real-world assets tracked by CoinGecko, such as stocks, commodities like gold, and ETFs, with the price, market cap and 24 hour change of the tokens that track each one.
Search CoinGecko	Find the CoinGecko IDs of the coins, exchanges, categories and NFT collections matching a name or symbol, coins ranked by market cap.

Get coin data on a date

Get a coin's price, market cap and 24 hour volume in every currency CoinGecko supports, as they stood at 00:00 UTC on a date in the past 365 days.

Inputs

Coin IDcoin_idtextRequired: The coin's CoinGecko ID (for example, bitcoin or ethereum). IDs are CoinGecko's own names, not ticker symbols: use Search CoinGecko to find a coin's ID from its name or symbol.
DatedatetextRequired: The date: 2026-01-31 or 31-01-2026, or a UNIX timestamp in seconds or milliseconds such as a chart gives. Within the past 365 days.

Outputs

datetext: The date the figures are for (YYYY-MM-DD).
idtext: The coin's CoinGecko ID.
imageobject: Links to the coin's logo: thumb and small.
market_dataobject: The figures at 00:00 UTC that day.
nametext: The coin's name.
symboltext: The coin's ticker symbol.

Example output

{
  "date": "2026-09-24",
  "id": "bitcoin",
  "image": {
    "small": "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",
    "thumb": "https://coin-images.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400"
  },
  "market_data": {
    "current_price": {
      "btc": 0.9998271293056906,
      "eur": 74138.37655527353,
      "usd": 84382.39990356649
    },
    "market_cap": {
      "btc": 20084948.30071415,
      "eur": 1489322920498.8643,
      "usd": 1695109174253.2031
    },
    "total_volume": {
      "btc": 518235.6887457729,
      "eur": 38427809983.35004,
      "usd": 43737548353.46009
    }
  },
  "name": "Bitcoin",
  "symbol": "btc"
}

Get coin details

Get a coin's profile from CoinGecko: what it is, its links, categories and contract addresses, and its market data in every currency, optionally with its top 100 trading pairs.

Inputs

Coin IDcoin_idtextRequired: The coin's CoinGecko ID (for example, bitcoin or ethereum). IDs are CoinGecko's own names, not ticker symbols: use Search CoinGecko to find a coin's ID from its name or symbol.
Include market datainclude_market_datatrue/false: Leave on to include prices and market figures; turn off for the profile alone.Default: true.
Include tickersinclude_tickerstrue/false: Set to true to include the coin's top 100 trading pairs.Default: false.

Outputs

additional_noticeslist: Further notices about the coin.
asset_platform_idtext: The platform a token is issued on, or null for a coin with its own chain.
block_time_in_minutesnumber: The chain's block time in minutes, where it has one.
categorieslist: The categories CoinGecko files the coin under.
country_origintext: The country the project comes from, if known.
descriptionobject: What the coin is, in English, under en.
detail_platformsobject: The same, with each contract's decimal places.
genesis_datetext: The date the coin launched, if known.
hashing_algorithmtext: The chain's hashing algorithm, where it has one.
idtext: The coin's CoinGecko ID.
imageobject: Links to the coin's logo: thumb, small and large.
last_updatedtext: When the figures were last updated (ISO 8601).
linksobject: The coin's homepage, whitepaper, block explorers, forums, social accounts and source code.
market_cap_ranknumber: The coin's rank by market cap.
market_dataobject: Prices and market figures, or null when Include market data is off.
nametext: The coin's name.
platformsobject: The token's contract address on each platform it is issued on.
public_noticetext: A notice CoinGecko shows on the coin's page, if any.
sentiment_votes_down_percentagenumber: The share who voted it down, as a percentage.
sentiment_votes_up_percentagenumber: The share of CoinGecko users who voted the coin up, as a percentage.
symboltext: The coin's ticker symbol, in lowercase.
tickerslist: The coin's top 100 trading pairs, or empty unless Include tickers is on.
watchlist_portfolio_usersnumber: How many CoinGecko users watch the coin.
web_slugtext: The coin's page on coingecko.com.

Example output

{
  "additional_notices": [],
  "asset_platform_id": null,
  "block_time_in_minutes": 10,
  "categories": [
    "Smart Contract Platform",
    "Layer 1 (L1)",
    "FTX Holdings"
  ],
  "country_origin": "",
  "description": {
    "en": "Bitcoin is the world's first decentralized cryptocurrency, created in 2009 by the pseudonymous Satoshi Nakamoto."
  },
  "detail_platforms": {
    "": {
      "contract_address": "",
      "decimal_place": null
    }
  },
  "genesis_date": "2009-01-03",
  "hashing_algorithm": "SHA-256",
  "id": "bitcoin",
  "image": {
    "large": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
    "small": "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",
    "thumb": "https://coin-images.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400"
  },
  "last_updated": "2026-09-25T17:38:40.000Z",
  "links": {
    "blockchain_site": [
      "https://mempool.space/"
    ],
    "homepage": [
      "http://www.bitcoin.org"
    ],
    "repos_url": {
      "github": [
        "https://github.com/bitcoin/bitcoin"
      ]
    },
    "subreddit_url": "https://www.reddit.com/r/Bitcoin/",
    "whitepaper": "https://bitcoin.org/bitcoin.pdf"
  },
  "market_cap_rank": 1,
  "market_data": {
    "ath": {
      "btc": 1.084796,
      "eur": 107662,
      "usd": 126080
    },
    "ath_date": {
      "btc": "2026-04-14T12:50:00.000Z",
      "eur": "2025-10-06T10:57:42.000Z",
      "usd": "2025-10-06T10:57:42.000Z"
    },
    "atl": {
      "btc": 0.98336471,
      "eur": 51.3,
      "usd": 67.81
    },
    "atl_date": {
      "btc": "2026-04-16T14:22:00.000Z",
      "eur": "2013-07-04T16:00:00.000Z",
      "usd": "2013-07-05T16:00:00.000Z"
    },
    "circulating_supply": 20089253.0,
    "current_price": {
      "btc": 0.99981097,
      "eur": 73495,
      "usd": 83710
    },
    "fully_diluted_valuation": {
      "btc": 20085285,
      "eur": 1476448825492,
      "usd": 1681652467886
    },
    "high_24h": {
      "btc": 1.003694,
      "eur": 74810,
      "usd": 85208
    },
    "last_updated": "2026-09-25T17:38:40.000Z",
    "low_24h": {
      "btc": 0.99306132,
      "eur": 73074,
      "usd": 83230
    },
    "market_cap": {
      "btc": 20085285,
      "eur": 1476448825492,
      "usd": 1681652467886
    },
    "market_cap_rank": 1,
    "max_supply": 21000000.0,
    "price_change_percentage_1y": -24.58334,
    "price_change_percentage_24h": -0.59715,
    "price_change_percentage_30d": 7.33022,
    "price_change_percentage_7d": 3.57077,
    "total_supply": 20089259.0,
    "total_volume": {
      "btc": 445628,
      "eur": 32757743860,
      "usd": 37310565631
    }
  },
  "name": "Bitcoin",
  "platforms": {
    "": ""
  },
  "public_notice": null,
  "sentiment_votes_down_percentage": 25.33,
  "sentiment_votes_up_percentage": 74.67,
  "symbol": "btc",
  "tickers": [
    {
      "base": "BTC",
      "bid_ask_spread_percentage": 0.010012,
      "coin_id": "bitcoin",
      "coin_mcap_usd": 1681652467886.1924,
      "converted_last": {
        "btc": 0.99997522,
        "eth": 31.271741,
        "usd": 83730
      },
      "converted_volume": {
        "btc": 63550,
        "eth": 1987362,
        "usd": 5321187577
      },
      "is_anomaly": false,
      "is_stale": false,
      "last": 83750.0,
      "last_fetch_at": "2026-09-25T17:38:50+00:00",
      "last_traded_at": "2026-09-25T17:37:07+00:00",
      "market": {
        "has_trading_incentive": false,
        "identifier": "btcc",
        "name": "BTCC"
      },
      "target": "USDT",
      "target_coin_id": "tether",
      "timestamp": "2026-09-25T17:37:07+00:00",
      "token_info_url": null,
      "trade_url": "https://www.btcc.com/en-US/spot/BTCUSDT",
      "trust_score": null,
      "volume": 63551.37666063
    }
  ],
  "watchlist_portfolio_users": 2455821,
  "web_slug": "bitcoin"
}

Get coin prices

Look up the current price of one or more cryptocurrencies in the currencies you choose, finding the coins by CoinGecko ID, ticker symbol or name. Optionally include each market cap, 24 hour volume and 24 hour change.

Inputs

Coin IDscoin_idstext: The coins to look up by CoinGecko ID, separated by commas (for example, bitcoin,ethereum). Fill in this, Symbols or Names.
Symbolssymbolstext: Coins to look up by ticker symbol instead, separated by commas (for example, btc,eth). A symbol several coins share gives the top ranked one.
Namesnamestext: Coins to look up by name instead, separated by commas (for example, Bitcoin,Ethereum).
Currenciesvs_currenciestextRequired: The currencies to show prices in, separated by commas (for example, usd,eur). CoinGecko's codes include usd, eur, gbp, jpy, btc and eth.
Include market capinclude_market_captrue/false: Set to true to also include each market cap.
Include 24-hour volumeinclude_24hr_voltrue/false: Set to true to also include the trading volume over the past 24 hours.
Include 24-hour changeinclude_24hr_changetrue/false: Set to true to also include how much each price changed over the past 24 hours, as a percentage.
Include last updated timeinclude_last_updated_attrue/false: Set to true to also include when each price was last updated, as a UNIX time in seconds (last_updated_at).
Decimal placesprecisiontext: How many decimal places to give prices to. Leave empty for CoinGecko's default, which rounds to a few significant digits.One of: full (Full precision), 0 (0 decimal places), 1 (1 decimal place), 2 (2 decimal places), 3 (3 decimal places), 4 (4 decimal places), 5 (5 decimal places), 6 (6 decimal places), 7 (7 decimal places), 8 (8 decimal places), and 10 more.

Outputs

pricesobject: One entry per coin found, keyed by the ID, symbol or name it was looked up by. Each holds the price in each currency asked for (for example, usd), and when asked for, <currency>_market_cap, <currency>_24h_vol, <currency>_24h_change and last_updated_at. A coin CoinGecko does not know is left out.

Example output

{
  "prices": {
    "bitcoin": {
      "eur": 73487.03,
      "eur_24h_change": -0.7758320623833801,
      "eur_24h_vol": 32761405447.606632,
      "eur_market_cap": 1476291346548.9685,
      "last_updated_at": 1790357910,
      "usd": 83700.59,
      "usd_24h_change": -0.6111695005961733,
      "usd_24h_vol": 37314736123.01789,
      "usd_market_cap": 1681473101795.5735
    },
    "ethereum": {
      "eur": 2354.76,
      "eur_24h_change": 0.0485652601835485,
      "eur_24h_vol": 13629169271.575308,
      "eur_market_cap": 287465686830.01245,
      "last_updated_at": 1790357910,
      "usd": 2682.03,
      "usd_24h_change": 0.21459590978529602,
      "usd_24h_vol": 15523413846.152008,
      "usd_market_cap": 327418988957.55853
    }
  }
}

Get exchange details

Get an exchange's profile from CoinGecko: its country, links, trust score, how many coins and pairs it lists and its 24 hour volume, optionally with its top 100 trading pairs.

Inputs

Exchange IDexchange_idtextRequired: The exchange's CoinGecko ID (for example, binance, gdax for Coinbase, or kraken). List exchanges and Search CoinGecko give the IDs.
Include tickersinclude_tickerstrue/false: Set to true to include the exchange's top 100 trading pairs.Default: false.

Outputs

alert_noticetext: A warning CoinGecko shows on the exchange's page, if any.
centralizedtrue/false: True for a centralized exchange, false for a decentralized one.
coinsnumber: How many coins it lists.
countrytext: Where the exchange is based.
descriptiontext: A short description.
facebook_urltext: Its Facebook page.
has_trading_incentivetrue/false: True when the exchange pays traders to trade.
idtext: The exchange's CoinGecko ID.
imagetext: A link to the exchange's logo.
nametext: The exchange's name.
other_url_1text: Another of its links.
other_url_2text: Another of its links.
pairsnumber: How many trading pairs it lists.
public_noticetext: A notice CoinGecko shows on the exchange's page, if any.
reddit_urltext: Its Reddit community.
slack_urltext: Its Slack workspace.
status_updateslist: Announcements the exchange has posted on CoinGecko.
telegram_urltext: Its Telegram group.
tickerslist: Its top 100 trading pairs, or empty unless Include tickers is on.
trade_volume_24h_btcnumber: The exchange's trading volume over 24 hours, in bitcoin.
trust_scorenumber: CoinGecko's trust score, from 1 to 10.
trust_score_ranknumber: The exchange's rank by trust score.
twitter_handletext: Its X (Twitter) handle.
urltext: The exchange's website.
year_establishednumber: The year the exchange was founded, if known.

Example output

{
  "alert_notice": "",
  "centralized": true,
  "coins": 405,
  "country": "United States",
  "description": "A leading U.S.-based exchange known for its regulatory compliance, user-friendly interface, and support for fiat-to-crypto transactions.",
  "facebook_url": "https://www.facebook.com/coinbase/",
  "has_trading_incentive": false,
  "id": "gdax",
  "image": "https://coin-images.coingecko.com/markets/images/23/small/Coinbase_Coin_Primary.png?1706864258",
  "name": "Coinbase Exchange",
  "other_url_1": "",
  "other_url_2": "",
  "pairs": 514,
  "public_notice": "",
  "reddit_url": "",
  "slack_url": "",
  "status_updates": [],
  "telegram_url": "",
  "tickers": [
    {
      "base": "USDT",
      "bid_ask_spread_percentage": 0.010001,
      "coin_id": "tether",
      "coin_mcap_usd": 183735785350.23523,
      "converted_last": {
        "btc": 1.194e-05,
        "eth": 0.00037275,
        "usd": 0.999706
      },
      "converted_volume": {
        "btc": 371.118,
        "eth": 11586,
        "usd": 31073444
      },
      "is_anomaly": false,
      "is_stale": false,
      "last": 0.9999,
      "last_fetch_at": "2026-09-25T17:39:40+00:00",
      "last_traded_at": "2026-09-25T17:39:38+00:00",
      "market": {
        "has_trading_incentive": false,
        "identifier": "gdax",
        "name": "Coinbase Exchange"
      },
      "target": "USDC",
      "target_coin_id": "usd-coin",
      "timestamp": "2026-09-25T17:39:38+00:00",
      "token_info_url": null,
      "trade_url": "https://www.coinbase.com/advanced-trade/spot/USDT-USDC",
      "trust_score": null,
      "volume": 31082575.25
    }
  ],
  "trade_volume_24h_btc": 32110.309033701957,
  "trust_score": 10,
  "trust_score_rank": 1,
  "twitter_handle": "CoinbasePro",
  "url": "https://www.coinbase.com/",
  "year_established": 2012
}

Get global DeFi market data

Retrieve statistics for decentralized finance (DeFi): its total market cap and 24 hour volume, its share of the whole market, and its largest coin.

Inputs

None.

Outputs

defi_dominancenumber: DeFi's share of the whole market cap, as a percentage.
defi_market_capnumber: The market cap of DeFi coins, in US dollars.
defi_to_eth_rationumber: The DeFi market cap as a percentage of Ethereum's.
eth_market_capnumber: Ethereum's market cap, in US dollars.
top_coin_defi_dominancenumber: Its share of the DeFi market cap, as a percentage.
top_coin_nametext: The largest DeFi coin.
trading_volume_24hnumber: DeFi trading volume over 24 hours, in US dollars.

Example output

{
  "defi_dominance": 4.479020610828023,
  "defi_market_cap": 133026873224.40128,
  "defi_to_eth_ratio": 40.544610124940725,
  "eth_market_cap": 327783541983.96,
  "top_coin_defi_dominance": 19.678594230237984,
  "top_coin_name": "Lido Staked Ether",
  "trading_volume_24h": 7960444806.753094
}

Get global market data

Retrieve statistics for the whole cryptocurrency market: its total market cap and volume, how it moved over 24 hours, and the share held by the largest coins.

Inputs

None.

Outputs

Response envelope; the payload is in the "global" field.

globalobject: The whole market's statistics, under data.

Example output

{
  "global": {
    "data": {
      "active_cryptocurrencies": 21588,
      "ended_icos": 3376,
      "market_cap_change_percentage_24h_usd": -3.017686268178517,
      "market_cap_percentage": {
        "btc": 58.27533380296545,
        "eth": 11.342977793384913,
        "usdt": 6.36759773637654
      },
      "markets": 1501,
      "ongoing_icos": 49,
      "total_market_cap": {
        "btc": 34463897.190040775,
        "eur": 2528737341667.241,
        "usd": 2880192877550.3193
      },
      "total_volume": {
        "btc": 1354099.136091017,
        "eur": 99355015797.29077,
        "usd": 113163832452.28027
      },
      "upcoming_icos": 0,
      "updated_at": 1790357823,
      "volume_change_percentage_24h_usd": 7.198640833276405
    }
  }
}

Get market chart

Get a coin's price, market cap and trading volume over the past 1 to 365 days, as series of points you can chart or summarize.

Inputs

Coin IDcoin_idtextRequired: The coin's CoinGecko ID (for example, bitcoin or ethereum). IDs are CoinGecko's own names, not ticker symbols: use Search CoinGecko to find a coin's ID from its name or symbol.
Currencyvs_currencytextRequired: The currency to show values in, as CoinGecko's code for it (for example, usd, eur, gbp or btc).
DaysdaysnumberRequired: How many days back to go, from 1 to 365. CoinGecko's free API reaches back 365 days at most.From 1 to 365.
Intervalintervaltext: How often to include a point: daily, or hourly for up to the past 100 days. Leave empty to let CoinGecko choose: every 5 minutes over 1 day, hourly over up to 90 days, and daily beyond that.One of: daily (Daily, one point a day at 00:00 UTC), hourly (Hourly, up to 100 days back).
Decimal placesprecisiontext: How many decimal places to give prices to. Leave empty for CoinGecko's default, which rounds to a few significant digits.One of: full (Full precision), 0 (0 decimal places), 1 (1 decimal place), 2 (2 decimal places), 3 (3 decimal places), 4 (4 decimal places), 5 (5 decimal places), 6 (6 decimal places), 7 (7 decimal places), 8 (8 decimal places), and 10 more.

Outputs

Response envelope; the payload is in the "chart" field.

chartobject: Three series, oldest point first. Each point is a pair: the time in milliseconds since 1970 (UTC), then the value.

Example output

{
  "chart": {
    "market_caps": [
      [
        1790186400000,
        1693750853487.4185
      ],
      [
        1790190000000,
        1694183604638.3762
      ]
    ],
    "prices": [
      [
        1790186400000,
        84315.18573536711
      ],
      [
        1790190000000,
        84336.728156199
      ]
    ],
    "total_volumes": [
      [
        1790186400000,
        46028133314.45535
      ],
      [
        1790190000000,
        45506097506.38443
      ]
    ]
  }
}

Get market chart for a date range

Get a coin's price, market cap and trading volume between two dates within the past 365 days, as series of points you can chart or summarize.

Inputs

Coin IDcoin_idtextRequired: The coin's CoinGecko ID (for example, bitcoin or ethereum). IDs are CoinGecko's own names, not ticker symbols: use Search CoinGecko to find a coin's ID from its name or symbol.
Currencyvs_currencytextRequired: The currency to show values in, as CoinGecko's code for it (for example, usd, eur, gbp or btc).
Fromfrom_datetextRequired: When the range starts: a date such as 2026-01-31, a date and time in ISO 8601, or a UNIX timestamp in seconds or milliseconds. Within the past 365 days.
Toto_datetextRequired: When the range ends, written the same ways. It must come after From.
Intervalintervaltext: How often to include a point: daily, or hourly for up to the past 100 days. Leave empty to let CoinGecko choose: every 5 minutes over 1 day, hourly over up to 90 days, and daily beyond that.One of: daily (Daily, one point a day at 00:00 UTC), hourly (Hourly, up to 100 days back).
Decimal placesprecisiontext: How many decimal places to give prices to. Leave empty for CoinGecko's default, which rounds to a few significant digits.One of: full (Full precision), 0 (0 decimal places), 1 (1 decimal place), 2 (2 decimal places), 3 (3 decimal places), 4 (4 decimal places), 5 (5 decimal places), 6 (6 decimal places), 7 (7 decimal places), 8 (8 decimal places), and 10 more.

Outputs

Response envelope; the payload is in the "chart" field.

chartobject: Three series, oldest point first. Each point is a pair: the time in milliseconds since 1970 (UTC), then the value.

Example output

{
  "chart": {
    "market_caps": [
      [
        1790100000000,
        1739361172671.89
      ],
      [
        1790103600000,
        1737143221100.5378
      ]
    ],
    "prices": [
      [
        1790100000000,
        86587.1444676524
      ],
      [
        1790103600000,
        86476.73261291615
      ]
    ],
    "total_volumes": [
      [
        1790100000000,
        46383599651.56697
      ],
      [
        1790103600000,
        46765784516.501
      ]
    ]
  }
}

Get price candles (OHLC)

Get a coin's open, high, low and close prices as candles over the past 1 to 365 days, oldest first. The candle size follows the span: 30 minutes over 1 day, 4 hours up to 30 days, 4 days beyond.

Inputs

Coin IDcoin_idtextRequired: The coin's CoinGecko ID (for example, bitcoin or ethereum). IDs are CoinGecko's own names, not ticker symbols: use Search CoinGecko to find a coin's ID from its name or symbol.
Currencyvs_currencytextRequired: The currency to show values in, as CoinGecko's code for it (for example, usd, eur, gbp or btc).
DaysdaystextRequired: How many days back to go, which sets the candle size.One of: 1 (1 day, in 30 minute candles), 7 (7 days, in 4 hour candles), 14 (14 days, in 4 hour candles), 30 (30 days, in 4 hour candles), 90 (90 days, in 4 day candles), 180 (180 days, in 4 day candles), 365 (365 days, in 4 day candles).
Decimal placesprecisiontext: How many decimal places to give prices to. Leave empty for CoinGecko's default, which rounds to a few significant digits.One of: full (Full precision), 0 (0 decimal places), 1 (1 decimal place), 2 (2 decimal places), 3 (3 decimal places), 4 (4 decimal places), 5 (5 decimal places), 6 (6 decimal places), 7 (7 decimal places), 8 (8 decimal places), and 10 more.

Outputs

candleslist: The candles, oldest first.
countnumber: How many candles there are.

Example output

{
  "candles": [
    {
      "close": 84269.0,
      "high": 84493.0,
      "low": 84207.0,
      "open": 84405.0,
      "time": "2026-09-24T17:30:00Z",
      "timestamp": 1790271000000
    }
  ],
  "count": 1
}

Get public treasury holdings

See which public companies or governments hold a coin, such as bitcoin or ethereum, and how much: each holder's amount, value and share of the supply, largest first, with the totals.

Inputs

Coin IDcoin_idtextRequired: The coin's CoinGecko ID (for example, bitcoin or ethereum). IDs are CoinGecko's own names, not ticker symbols: use Search CoinGecko to find a coin's ID from its name or symbol.
Holdersentitytext: Whether to list public companies or governments.One of: companies (Public companies), governments. Default: companies.
Orderordertext: How to sort the holders. Leave empty for largest first.One of: total_holdings_usd_desc (Largest holdings first), total_holdings_usd_asc (Smallest holdings first).
Results per pageper_pagenumber: How many holders to return, from 1 to 250. Leave empty for 250.From 1 to 250.
Pagepagenumber: Which page of results to return, starting at 1. Leave empty for the first page.At least 1.

Outputs

coin_idtext: The coin asked about.
countnumber: How many results are on this page.
entitytext: companies or governments, as asked.
has_moretrue/false: True when the page is full, so the next page may hold more.
holderslist: The holders on this page.
market_cap_dominancenumber: Their share of the coin's market cap, as a percentage.
pagenumber: The page number.
total_holdingsnumber: How many of the coin they hold between them.
total_value_usdnumber: What those holdings are worth, in US dollars.

Example output

{
  "coin_id": "bitcoin",
  "count": 1,
  "entity": "companies",
  "has_more": false,
  "holders": [
    {
      "country": "US",
      "name": "Strategy",
      "percentage_of_total_supply": 4.029,
      "symbol": "MSTR.US",
      "total_current_value_usd": 70861152949.52348,
      "total_entry_value_usd": 64343516500.0,
      "total_holdings": 846000.0
    }
  ],
  "market_cap_dominance": 6.17,
  "page": 1,
  "total_holdings": 1296098.6692943657,
  "total_value_usd": 108561520144.84859
}

Get token prices by contract address

Look up the current price of tokens by their contract address on a blockchain platform such as Ethereum or Solana, in the currencies you choose. Up to 10 addresses a step, each looked up in turn.

Inputs

Platform IDplatform_idtextRequired: The blockchain the tokens live on, as CoinGecko's ID for it (for example, ethereum, binance-smart-chain, polygon-pos, arbitrum-one, base or solana).
Contract addressescontract_addressestextRequired: The tokens' contract addresses, separated by commas, up to 10.
Currenciesvs_currenciestextRequired: The currencies to show prices in, separated by commas (for example, usd,eur). CoinGecko's codes include usd, eur, gbp, jpy, btc and eth.
Include market capinclude_market_captrue/false: Set to true to also include each market cap.
Include 24-hour volumeinclude_24hr_voltrue/false: Set to true to also include the trading volume over the past 24 hours.
Include 24-hour changeinclude_24hr_changetrue/false: Set to true to also include how much each price changed over the past 24 hours, as a percentage.
Include last updated timeinclude_last_updated_attrue/false: Set to true to also include when each price was last updated, as a UNIX time in seconds (last_updated_at).
Decimal placesprecisiontext: How many decimal places to give prices to. Leave empty for CoinGecko's default, which rounds to a few significant digits.One of: full (Full precision), 0 (0 decimal places), 1 (1 decimal place), 2 (2 decimal places), 3 (3 decimal places), 4 (4 decimal places), 5 (5 decimal places), 6 (6 decimal places), 7 (7 decimal places), 8 (8 decimal places), and 10 more.

Outputs

pricesobject: One entry per token found, keyed by its contract address. Each holds the price in each currency asked for, and the extra figures asked for, as Get coin prices does.

Example output

{
  "prices": {
    "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": {
      "last_updated_at": 1790357910,
      "usd": 0.999923,
      "usd_24h_change": 0.042451798583624696,
      "usd_24h_vol": 20680643602.584755,
      "usd_market_cap": 75326531986.30414
    }
  }
}

Fetch the coins, NFT collections and categories most searched on CoinGecko over the past 24 hours.

Inputs

None.

Outputs

Response envelope; the payload is in the "trending" field.

trendingobject: What is trending: coins, NFT collections and categories.

Example output

{
  "trending": {
    "categories": [
      {
        "coins_count": "60",
        "data": {
          "market_cap": 9031505305.961391,
          "market_cap_btc": 107665.21741093652,
          "market_cap_change_percentage_24h": {
            "btc": 11.830323637499012,
            "eur": 11.106112789664664,
            "usd": 11.262779043602517
          },
          "sparkline": "https://data.coingecko.com/categories/72/sparkline.svg",
          "total_volume": 3176012471.8245387,
          "total_volume_btc": 37860.86171324798
        },
        "id": 72,
        "market_cap_1h_change": 0.48502184268330123,
        "name": "Binance Launchpool",
        "slug": "binance-launchpool",
        "top_3_coins_images": [
          "https://assets.coingecko.com/coins/images/16362/small/GergDDN3_400x400.jpg?1696515961",
          "https://assets.coingecko.com/coins/images/36530/small/ethena.png?1711701436",
          "https://assets.coingecko.com/coins/images/39082/small/nillion.jpg?1723033507"
        ]
      }
    ],
    "coins": [
      {
        "item": {
          "coin_id": 31745,
          "data": {
            "content": null,
            "market_cap": "$839,309,557",
            "market_cap_btc": "10015.67104752935",
            "price": 0.8402922404735258,
            "price_btc": "0.00001003010282027317",
            "price_change_percentage_24h": {
              "btc": 20.251632849988642,
              "eur": 19.36625482851076,
              "usd": 19.56012523635759
            },
            "sparkline": "https://data.coingecko.com/coins/31745/sparkline.svg",
            "total_volume": "$105,976,881",
            "total_volume_btc": "1264.980057820191"
          },
          "id": "aerodrome-finance",
          "large": "https://coin-images.coingecko.com/coins/images/31745/large/token.png?1696530564",
          "market_cap_rank": 87,
          "name": "Aerodrome Finance",
          "price_btc": 1.0030102820273172e-05,
          "score": 0,
          "slug": "aerodrome-finance",
          "small": "https://coin-images.coingecko.com/coins/images/31745/small/token.png?1696530564",
          "symbol": "AERO",
          "thumb": "https://coin-images.coingecko.com/coins/images/31745/standard/token.png?1696530564"
        }
      }
    ],
    "nfts": [
      {
        "data": {
          "content": null,
          "floor_price": "12.34 SOL",
          "floor_price_in_usd_24h_percentage_change": "40.37183408544958",
          "h24_average_sale_price": "11.08 SOL",
          "h24_volume": "831.32 SOL",
          "sparkline": "https://data.coingecko.com/nft/3187/sparkline.svg"
        },
        "floor_price_24h_percentage_change": 40.37183408544958,
        "floor_price_in_native_currency": 12.337254,
        "id": "mad-lads",
        "name": "Mad Lads",
        "native_currency_symbol": "sol",
        "nft_contract_id": 3187,
        "symbol": "MLADS",
        "thumb": "https://coin-images.coingecko.com/nft_contracts/images/3187/standard/mad-lads.png?1707289879"
      }
    ]
  }
}

List coin categories

List CoinGecko's coin categories (such as layer 1, meme or AI coins) with each category's market cap, 24 hour change and volume, and its three largest coins.

Inputs

Orderordertext: How to sort the categories. Leave empty for largest market cap first.One of: market_cap_desc (Market cap, largest first), market_cap_asc (Market cap, smallest first), name_asc (Name, A to Z), name_desc (Name, Z to A), market_cap_change_24h_desc (24 hour market cap change, biggest rise first), market_cap_change_24h_asc (24 hour market cap change, biggest fall first).
Limitlimitnumber: How many categories to return, from the top of that order, from 1 to 1000. Leave empty for 100; CoinGecko has about 770.From 1 to 1000.

Outputs

categorieslist: The categories, in the order asked for.
countnumber: How many are returned.
totalnumber: How many categories CoinGecko has in all.

Example output

{
  "categories": [
    {
      "content": "Smart contract platforms are usually blockchains that host smart contracts or decentralized applications.",
      "id": "smart-contract-platform",
      "market_cap": 2498106215364.428,
      "market_cap_change_24h": -0.25459779468022703,
      "name": "Smart Contract Platform",
      "top_3_coins": [
        "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png",
        "https://coin-images.coingecko.com/coins/images/279/small/ethereum.png",
        "https://coin-images.coingecko.com/coins/images/825/small/bnb-icon2_2x.png"
      ],
      "top_3_coins_id": [
        "bitcoin",
        "ethereum",
        "binancecoin"
      ],
      "updated_at": "2026-09-25T17:36:29.000Z",
      "volume_24h": 83036604952.51022
    }
  ],
  "count": 1,
  "total": 770
}

List coins with market data

List coins ranked by market cap or volume, each with its price, market cap, volume, 24 hour high and low, supply and all-time high. Get the top coins, or only the coins you name or a category's coins, up to 250 a page.

Inputs

Currencyvs_currencytextRequired: The currency to show values in, as CoinGecko's code for it (for example, usd, eur, gbp or btc).
Coin IDscoin_idstext: Only these coins, by CoinGecko ID, separated by commas (for example, bitcoin,ethereum). Leave empty for all coins.
Symbolssymbolstext: Coins to look up by ticker symbol instead, separated by commas (for example, btc,eth). A symbol several coins share gives the top ranked one.
Namesnamestext: Coins to look up by name instead, separated by commas (for example, Bitcoin,Ethereum).
Coins per symbolinclude_tokenstext: When looking up by symbol, whether to list only the top ranked coin with each symbol or every coin that uses it.One of: top (Only the top ranked coin for each symbol), all (Every coin that uses the symbol).
Categorycategorytext: Only coins in this category, by its ID (for example, layer-1 or meme-token). List coin categories gives the IDs.
Orderordertext: How to rank the coins. Leave empty for largest market cap first.One of: market_cap_desc (Market cap, largest first), market_cap_asc (Market cap, smallest first), volume_desc (24 hour volume, largest first), volume_asc (24 hour volume, smallest first), id_asc (ID, A to Z), id_desc (ID, Z to A).
Results per pageper_pagenumber: How many results to return, from 1 to 250. Leave empty for 100.From 1 to 250.
Pagepagenumber: Which page of results to return, starting at 1. Leave empty for the first page.At least 1.
Price change periodsprice_change_percentagetext: Also include the price change over these periods, as percentages.One or more of: 1h (1 hour), 24h (24 hours), 7d (7 days), 14d (14 days), 30d (30 days), 200d (200 days), 1y (1 year).
Decimal placesprecisiontext: How many decimal places to give prices to. Leave empty for CoinGecko's default, which rounds to a few significant digits.One of: full (Full precision), 0 (0 decimal places), 1 (1 decimal place), 2 (2 decimal places), 3 (3 decimal places), 4 (4 decimal places), 5 (5 decimal places), 6 (6 decimal places), 7 (7 decimal places), 8 (8 decimal places), and 10 more.

Outputs

coinslist: The coins, in the order asked for.
countnumber: How many results are on this page.
has_moretrue/false: True when the page is full, so the next page may hold more.
pagenumber: The page number.

Example output

{
  "coins": [
    {
      "ath": 126080,
      "ath_change_percentage": -33.62201,
      "ath_date": "2025-10-06T10:57:42.000Z",
      "atl": 67.81,
      "atl_change_percentage": 123319.15483,
      "atl_date": "2013-07-05T16:00:00.000Z",
      "circulating_supply": 20089253.0,
      "current_price": 83689,
      "fully_diluted_valuation": 1681322192659,
      "high_24h": 85208,
      "id": "bitcoin",
      "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
      "last_updated": "2026-09-25T17:39:20.000Z",
      "low_24h": 83230,
      "market_cap": 1681322192659,
      "market_cap_change_24h": -9869077425.843994,
      "market_cap_change_percentage_24h": -0.58356,
      "market_cap_rank": 1,
      "max_supply": 21000000.0,
      "name": "Bitcoin",
      "price_change_24h": -496.7228201213293,
      "price_change_percentage_14d_in_currency": 7.8089,
      "price_change_percentage_1h_in_currency": 0.1232,
      "price_change_percentage_1y_in_currency": -24.9559,
      "price_change_percentage_200d_in_currency": 21.6572,
      "price_change_percentage_24h": -0.59003,
      "price_change_percentage_24h_in_currency": -0.59003,
      "price_change_percentage_30d_in_currency": 7.3711,
      "price_change_percentage_7d_in_currency": 3.8016,
      "roi": null,
      "symbol": "btc",
      "total_supply": 20089259.0,
      "total_volume": 37314900985
    }
  ],
  "count": 1,
  "has_more": false,
  "page": 1
}

List exchanges

List cryptocurrency exchanges ranked by CoinGecko's trust score, each with its country, founding year and 24 hour trading volume, up to 250 a page.

Inputs

Results per pageper_pagenumber: How many results to return, from 1 to 250. Leave empty for 100.From 1 to 250.
Pagepagenumber: Which page of results to return, starting at 1. Leave empty for the first page.At least 1.

Outputs

countnumber: How many results are on this page.
exchangeslist: The exchanges, highest trust score first.
has_moretrue/false: True when the page is full, so the next page may hold more.
pagenumber: The page number.

Example output

{
  "count": 1,
  "exchanges": [
    {
      "country": "United States",
      "description": "A leading U.S.-based exchange known for its regulatory compliance, user-friendly interface, and support for fiat-to-crypto transactions.",
      "has_trading_incentive": false,
      "id": "gdax",
      "image": "https://coin-images.coingecko.com/markets/images/23/small/Coinbase_Coin_Primary.png?1706864258",
      "name": "Coinbase Exchange",
      "trade_volume_24h_btc": 32123.235044739056,
      "trust_score": 10,
      "trust_score_rank": 1,
      "url": "https://www.coinbase.com/",
      "year_established": 2012
    }
  ],
  "has_more": false,
  "page": 1
}

List tokenized real-world assets

List tokenized real-world assets tracked by CoinGecko, such as stocks, commodities like gold, and ETFs, with the price, market cap and 24 hour change of the tokens that track each one.

Inputs

Asset typeasset_typetext: Only this kind of asset. Leave empty for every kind.One of: stock (Stocks), commodity (Commodities), etf (ETFs).
Asset IDsrwa_idstext: Only these assets, by CoinGecko ID, separated by commas (for example, gold).
Symbolssymbolstext: Only these assets, by symbol instead, separated by commas (for example, xau,mstr).
Orderordertext: How to rank the assets. Leave empty for largest market cap first.One of: market_cap_desc (Market cap, largest first), market_cap_asc (Market cap, smallest first), volume_desc (24 hour volume, largest first), volume_asc (24 hour volume, smallest first), id_asc (ID, A to Z), id_desc (ID, Z to A).
Results per pageper_pagenumber: How many results to return, from 1 to 250. Leave empty for 100.From 1 to 250.
Pagepagenumber: Which page of results to return, starting at 1. Leave empty for the first page.At least 1.
Decimal placesprecisiontext: How many decimal places to give prices to. Leave empty for CoinGecko's default, which rounds to a few significant digits.One of: full (Full precision), 0 (0 decimal places), 1 (1 decimal place), 2 (2 decimal places), 3 (3 decimal places), 4 (4 decimal places), 5 (5 decimal places), 6 (6 decimal places), 7 (7 decimal places), 8 (8 decimal places), and 10 more.

Outputs

assetslist: The assets, in the order asked for.
countnumber: How many results are on this page.
has_moretrue/false: True when the page is full, so the next page may hold more.
pagenumber: The page number.

Example output

{
  "assets": [
    {
      "asset_type": "commodity",
      "id": "gold",
      "image": "https://coin-images.coingecko.com/coins/images/10481/large/logo.png?1774627372",
      "name": "Gold",
      "symbol": "xau",
      "tokenized_market_data": {
        "current_price": 4282.24,
        "high_24h": 4308.88,
        "last_updated": "2026-09-25T17:41:20Z",
        "low_24h": 4254.58,
        "market_cap": 5263411763,
        "market_cap_change_24h": 26651184,
        "market_cap_change_percentage_24h": 0.50893,
        "price_change_24h": 22.48,
        "price_change_percentage_24h": 0.52779,
        "total_volume": 534250481
      }
    }
  ],
  "count": 1,
  "has_more": false,
  "page": 1
}

Search CoinGecko

Find the CoinGecko IDs of the coins, exchanges, categories and NFT collections matching a name or symbol, coins ranked by market cap. The other actions take these IDs, so use this to turn BTC or Bitcoin into bitcoin.

Inputs

QueryquerytextRequired: The name or symbol to look for (for example, solana or sol).

Outputs

categorieslist: Matching categories.
coinslist: Matching coins, largest market cap first.
exchangeslist: Matching exchanges.
nftslist: Matching NFT collections.
querytext: What was searched for.

Example output

{
  "categories": [
    {
      "id": "bitcoin-ecosystem",
      "name": "Bitcoin Ecosystem"
    }
  ],
  "coins": [
    {
      "api_symbol": "bitcoin",
      "id": "bitcoin",
      "large": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png",
      "market_cap_rank": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "thumb": "https://coin-images.coingecko.com/coins/images/1/thumb/bitcoin.png"
    }
  ],
  "exchanges": [
    {
      "id": "mercado_bitcoin",
      "large": "https://coin-images.coingecko.com/markets/images/34/large/logo_MB_hexagono.png",
      "market_type": "spot",
      "name": "Mercado Bitcoin",
      "thumb": "https://coin-images.coingecko.com/markets/images/34/thumb/logo_MB_hexagono.png"
    }
  ],
  "nfts": [
    {
      "id": "bitcoin-boos-boottalion",
      "name": "Bitcoin Boos: Boottalion",
      "symbol": "BOOTTALION",
      "thumb": "https://coin-images.coingecko.com/nft_contracts/images/4045/thumb/bitcoin-boos-boottalion.png"
    }
  ],
  "query": "bitcoin"
}

ActionsCopy Anchor Link

Get coin data on a dateCopy Anchor Link

Inputs

Outputs

Get coin detailsCopy Anchor Link

Inputs

Outputs

Get coin pricesCopy Anchor Link

Inputs

Outputs

Get exchange detailsCopy Anchor Link

Inputs

Outputs

Get global DeFi market dataCopy Anchor Link

Inputs

Outputs

Get global market dataCopy Anchor Link

Inputs

Outputs

Get market chartCopy Anchor Link

Inputs

Outputs

Get market chart for a date rangeCopy Anchor Link

Inputs

Outputs

Get price candles (OHLC)Copy Anchor Link

Inputs

Outputs

Get public treasury holdingsCopy Anchor Link

Inputs

Outputs

Get token prices by contract addressCopy Anchor Link

Inputs

Outputs

Get trending coinsCopy Anchor Link

Inputs

Outputs

List coin categoriesCopy Anchor Link

Inputs

Outputs

List coins with market dataCopy Anchor Link

Inputs

Outputs

List exchangesCopy Anchor Link

Inputs

Outputs

List tokenized real-world assetsCopy Anchor Link

Inputs

Outputs

Search CoinGeckoCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get coin data on a date

Get coin details

Get coin prices

Get exchange details

Get global DeFi market data

Get global market data

Get market chart

Get market chart for a date range

Get price candles (OHLC)

Get public treasury holdings

Get token prices by contract address

Get trending coins

List coin categories

List coins with market data

List exchanges

List tokenized real-world assets

Search CoinGecko