zapi.
APIsPricingDocsMCP
APIsPricingDocsMCP
Sign in
zapi.
APIsPricingDocsMCP
APIsPricingDocsMCP
Sign in
Finance/Coingecko
Logo Coingecko

Coingecko

Sector market caps — which categories exist and which coins lead them.

8 endpoints8 endpoints on this scraper640 calls640 calls so farupdated last monthLast updated 8/21/2026, 2:24:50 AMBusy: 10+ calls so farllms.txt
Endpoints8

8/8 passing
checked 20 hours ago · daily 01:00 WIB

Categories

Sector market caps — which categories exist and which coins lead them.

GET/v1/finance:coingecko/categories1h cache3 paramschecking key…
Parameters
orderenum

Row ordering. Default market_cap_desc.

querystring

Free text over category id and name.

limitnumber

Categories to return. Default 50, max 500.

·
Response
EXAMPLE
{
  "count": 50,
  "items": [
    {
      "id": "smart-contract-platform",
      "name": "Smart Contract Platform",
      "topCoins": [
        "bitcoin",
        "ethereum",
        "binancecoin"
      ],
      "marketCap": 2169182803129.4478,
      "updatedAt": "2026-08-21T02:18:58.000Z",
      "volume24h": 109354512259.09181,
      "description": "Smart contract platforms are usually blockchains that host smart contracts or decentralized applications. Users can interact with different smart contracts on these platforms to pe…",
      "marketCapChange24h": 6.851820346894821
    },
    {
      "id": "layer-1",
      "name": "Layer 1 (L1)",
      "topCoins": [
        "bitcoin",
        "ethereum",
        "binancecoin"
      ],
      "marketCap": 2139409183150.855,
      "updatedAt": "2026-08-21T02:18:58.000Z",
      "volume24h": 106224662697.78165,
      "description": "Layer 1 serves as the primary and autonomous chain on which transactions are directly executed and confirmed, as well as providing the essential infrastructure for the blockchain n…",
      "marketCapChange24h": 6.860799823767945
    },
    {
      "id": "proof-of-work-pow",
      "name": "Proof of Work (PoW)",
      "topCoins": [
        "bitcoin",
        "dogecoin",
        "zcash"
      ],
      "marketCap": 1544838272129.8872,
      "updatedAt": "2026-08-21T02:18:58.000Z",
      "volume24h": 61883560925.84648,
      "description": "Proof of Work (PoW) is a blockchain consensus mechanism to validate transactions and create new blocks through computational efforts by miners.",
      "marketCapChange24h": 7.351411748462364
    }
  ],
  "order": "market_cap_desc",
  "query": null,
  "total": 753,
  "dataset": "categories",
  "provider": "coingecko"
}

Code

Categories
index.ts
// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

const data = await client.run("finance:coingecko", "categories", {
  "order": "market_cap_desc",
  "query": "layer",
  "limit": 50
});
console.log(data);
Recommended · typed errors, safe retries and bulk jobsSDK reference

Full reference

8 endpoints · plain text
GET
Categories/v1/finance:coingecko/categories
3 params

Sector market caps — which categories exist and which coins lead them.

Parameters

orderenumoptional
Row ordering. Default market_cap_desc. Values: market_cap_desc, market_cap_asc, name_desc, name_asc, market_cap_change_24h_desc, market_cap_change_24h_asc.
querystringoptional
Free text over category id and name.
limitnumberoptional
Categories to return. Default 50, max 500.

Request

curl -X GET "https://api.zapi.ink/v1/finance:coingecko/categories?order=market_cap_desc&query=layer&limit=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 50,
  "items": [
    {
      "id": "smart-contract-platform",
      "name": "Smart Contract Platform",
      "topCoins": [
        "bitcoin",
        "ethereum",
        "binancecoin"
      ],
      "marketCap": 2169182803129.4478,
      "updatedAt": "2026-08-21T02:18:58.000Z",
      "volume24h": 109354512259.09181,
      "description": "Smart contract platforms are usually blockchains that host smart contracts or decentralized applications. Users can interact with different smart contracts on these platforms to pe…",
      "marketCapChange24h": 6.851820346894821
    },
    {
      "id": "layer-1",
      "name": "Layer 1 (L1)",
      "topCoins": [
        "bitcoin",
        "ethereum",
        "binancecoin"
      ],
      "marketCap": 2139409183150.855,
      "updatedAt": "2026-08-21T02:18:58.000Z",
      "volume24h": 106224662697.78165,
      "description": "Layer 1 serves as the primary and autonomous chain on which transactions are directly executed and confirmed, as well as providing the essential infrastructure for the blockchain n…",
      "marketCapChange24h": 6.860799823767945
    },
    {
      "id": "proof-of-work-pow",
      "name": "Proof of Work (PoW)",
      "topCoins": [
        "bitcoin",
        "dogecoin",
        "zcash"
      ],
      "marketCap": 1544838272129.8872,
      "updatedAt": "2026-08-21T02:18:58.000Z",
      "volume24h": 61883560925.84648,
      "description": "Proof of Work (PoW) is a blockchain consensus mechanism to validate transactions and create new blocks through computational efforts by miners.",
      "marketCapChange24h": 7.351411748462364
    }
  ],
  "order": "market_cap_desc",
  "query": null,
  "total": 753,
  "dataset": "categories",
  "provider": "coingecko"
}
GET
Exchanges/v1/finance:coingecko/exchanges
2 params

Venue directory with CoinGecko's trust score — a map of where things trade,

Parameters

pagenumberoptional
Result page. Default 1.
limitnumberoptional
Venues per page, best trust score first. Default 50, max 250.

Request

curl -X GET "https://api.zapi.ink/v1/finance:coingecko/exchanges?page=1&limit=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "page": 1,
  "count": 50,
  "items": [
    {
      "id": "gdax",
      "url": "https://www.coinbase.com/",
      "name": "Coinbase Exchange",
      "image": "https://coin-images.coingecko.com/markets/images/23/small/Coinbase_Coin_Primary.png?1706864258",
      "country": "United States",
      "trustScore": 10,
      "description": "A leading U.S.-based exchange known for its regulatory compliance, user-friendly interface, and support for fiat-to-crypto transactions.",
      "trustScoreRank": 1,
      "yearEstablished": 2012,
      "tradeVolume24hBtc": 43119.712310406896,
      "hasTradingIncentive": false
    },
    {
      "id": "binance",
      "url": "https://www.binance.com/",
      "name": "Binance",
      "image": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274",
      "country": "Cayman Islands",
      "trustScore": 10,
      "description": "One of the world’s largest cryptocurrency exchanges by trading volume, offering a wide range of services including spot, futures, and staking options.",
      "trustScoreRank": 2,
      "yearEstablished": 2017,
      "tradeVolume24hBtc": 216189.3202817008,
      "hasTradingIncentive": false
    },
    {
      "id": "kraken",
      "url": "https://www.kraken.com/",
      "name": "Kraken",
      "image": "https://coin-images.coingecko.com/markets/images/29/small/kraken.jpg?1706864265",
      "country": "United States",
      "trustScore": 10,
      "description": "Kraken is a San Francisco-based cryptocurrency exchange, offering a wide range of trading services for various cryptocurrencies and known for its robust security and regulatory com…",
      "trustScoreRank": 3,
      "yearEstablished": 2011,
      "tradeVolume24hBtc": 26793.790275749678,
      "hasTradingIncentive": false
    }
  ],
  "total": null,
  "dataset": "exchanges",
  "hasMore": true,
  "nextPage": 2,
  "provider": "coingecko"
}
GET
Vs Currencies/v1/finance:coingecko/vs-currencies
0 params

The currency codes every `vsCurrency` knob in this scraper accepts.

Parameters

This endpoint takes no parameters.

Request

curl -X GET "https://api.zapi.ink/v1/finance:coingecko/vs-currencies" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 63,
  "items": [
    "aed",
    "ars",
    "aud",
    "bch",
    "bdt",
    "bhd",
    "bits",
    "bmd"
  ],
  "total": 63,
  "dataset": "vs-currencies",
  "provider": "coingecko"
}
GET
Global/v1/finance:coingecko/global
2 params

Aggregate market state — one currency's slice of it.

Parameters

vsCurrencystringoptional
Currency code from vs-currencies for the totals. Default usd.
limitnumberoptional
Dominance rows to return, largest share first. Default 10, max 100.

Request

curl -X GET "https://api.zapi.ink/v1/finance:coingecko/global?vsCurrency=usd&limit=10" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 10,
  "items": [
    {
      "symbol": "BTC",
      "percentage": 59.09948287325917
    },
    {
      "symbol": "ETH",
      "percentage": 11.16740932646525
    },
    {
      "symbol": "USDT",
      "percentage": 7.216053472191729
    },
    {
      "symbol": "BNB",
      "percentage": 3.4670143554415223
    },
    {
      "symbol": "XRP",
      "percentage": 3.175776279344623
    },
    {
      "symbol": "USDC",
      "percentage": 2.868964371860268
    },
    {
      "symbol": "SOL",
      "percentage": 2.0493882834354373
    },
    {
      "symbol": "TRX",
      "percentage": 1.2645660246975423
    }
  ],
  "total": 10,
  "dataset": "global",
  "markets": 1494,
  "provider": "coingecko",
  "endedIcos": 3376,
  "updatedAt": 1787278945,
  "vsCurrency": "usd",
  "ongoingIcos": 49,
  "totalVolume": 137275603987.54155,
  "upcomingIcos": 0,
  "totalMarketCap": 2529967923795.755,
  "activeCryptocurrencies": 18522,
  "marketCapChangePercentage24hUsd": 2.775890752056489
}
GET
Coins Markets/v1/finance:coingecko/coins-markets
8 params

The market-cap ranked cross-section — which coins exist, what they are called,

Parameters

vsCurrencystringoptional
Currency code from vs-currencies. Default usd.
idsstringoptional
Restrict to these coin ids, comma-separated.
categorystringoptional
Restrict to one category id from categories.
orderenumoptional
Row ordering. Default market_cap_desc. Values: market_cap_desc, market_cap_asc, volume_desc, volume_asc, id_desc, id_asc.
priceChangePercentagestringoptional
Extra change windows, comma-separated. Any of 1h, 24h, 7d, 14d, 30d, 200d, 1y.
precisionstringoptional
Decimal places, 0 to 18, or full.
pagenumberoptional
Result page. Default 1.
limitnumberoptional
Coins per page. Default 50, max 250.

Request

curl -X GET "https://api.zapi.ink/v1/finance:coingecko/coins-markets?vsCurrency=usd&ids=bitcoin%2Cethereum&category=layer-1&order=market_cap_desc&priceChangePercentage=1h%2C24h%2C7d&precision=4&page=1&limit=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "page": 1,
  "count": 50,
  "items": [
    {
      "id": "bitcoin",
      "ath": 126080,
      "atl": 67.81,
      "name": "Bitcoin",
      "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
      "low24h": 68898,
      "symbol": "BTC",
      "athDate": "2025-10-06T10:57:42.000Z",
      "atlDate": "2013-07-05T16:00:00.000Z",
      "high24h": 75528,
      "marketCap": 1499534928428,
      "maxSupply": 21000000,
      "lastUpdated": "2026-08-21T02:22:20.000Z",
      "totalSupply": 20071518,
      "totalVolume": 58961898192,
      "currentPrice": 74697,
      "marketCapRank": 1,
      "priceChange24h": 5698.72,
      "circulatingSupply": 20071518,
      "marketCapChange24h": 114629005419,
      "athChangePercentage": -40.754,
      "atlChangePercentage": 110058.36751,
      "fullyDilutedValuation": 1499534928428,
      "priceChangePercentage": {},
      "priceChangePercentage24h": 8.2,
      "marketCapChangePercentage24h": 8.27702
    },
    {
      "id": "ethereum",
      "ath": 4946.05,
      "atl": 0.432979,
      "name": "Ethereum",
      "image": "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628",
      "low24h": 2223.48,
      "symbol": "ETH",
      "athDate": "2025-08-24T11:21:03.000Z",
      "atlDate": "2015-10-19T16:00:00.000Z",
      "high24h": 2374.35,
      "marketCap": 283551699609,
      "maxSupply": null,
      "lastUpdated": "2026-08-21T02:22:20.000Z",
      "totalSupply": 120681688.0431787,
      "totalVolume": 26184981802,
      "currentPrice": 2349.18,
      "marketCapRank": 2,
      "priceChange24h": 111.63,
      "circulatingSupply": 120681688.04317872,
      "marketCapChange24h": 13520065655,
      "athChangePercentage": -52.50392,
      "atlChangePercentage": 542462.0911,
      "fullyDilutedValuation": 283551821528,
      "priceChangePercentage": {},
      "priceChangePercentage24h": 4.2,
      "marketCapChangePercentage24h": 5.00685
    }
  ],
  "order": "market_cap_desc",
  "total": null,
  "dataset": "coins-markets",
  "hasMore": true,
  "category": null,
  "nextPage": 2,
  "provider": "coingecko",
  "priceBasis": "cross-venue-aggregate",
  "vsCurrency": "usd"
}
GET
Simple Price/v1/finance:coingecko/simple-price
6 params

Spot price for a set of coins against a set of currencies.

Parameters

idsstringrequired
Comma-separated coin ids as CoinGecko spells them. Required, up to 100.
vsCurrenciesstringoptional
Comma-separated currency codes from vs-currencies. Default usd.
includeMarketCapenumoptional
Include market cap per pair. Default true. Values: true, false.
include24hVolenumoptional
Include 24-hour volume per pair. Default true. Values: true, false.
include24hChangeenumoptional
Include 24-hour percentage change per pair. Default true. Values: true, false.
precisionstringoptional
Decimal places, 0 to 18, or full.

Request

curl -X GET "https://api.zapi.ink/v1/finance:coingecko/simple-price?ids=bitcoin%2Cethereum&vsCurrencies=usd%2Cidr&includeMarketCap=true&include24hVol=true&include24hChange=true&precision=4" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ids": [
    "bitcoin",
    "ethereum"
  ],
  "count": 2,
  "items": [
    {
      "id": "bitcoin",
      "price": 74689,
      "currency": "usd",
      "change24h": 7.460665907023785,
      "marketCap": 1499117826177.651,
      "volume24h": 59038237292.78621,
      "lastUpdatedAt": 1787279010
    },
    {
      "id": "ethereum",
      "price": 2350.05,
      "currency": "usd",
      "change24h": 3.9806303409494834,
      "marketCap": 283498394715.6619,
      "volume24h": 26204899105.23797,
      "lastUpdatedAt": 1787279030
    }
  ],
  "total": 2,
  "dataset": "simple-price",
  "provider": "coingecko",
  "priceBasis": "cross-venue-aggregate",
  "vsCurrencies": [
    "usd"
  ]
}
GET
Derivatives/v1/finance:coingecko/derivatives
6 params

Every perp and future ticker CoinGecko tracks, with funding, open interest,

Parameters

marketstringoptional
Keep only this venue. Case-insensitive substring.
indexIdstringoptional
Keep only contracts on this index. Case-insensitive.
symbolstringoptional
Keep only contracts whose symbol contains this. Case-insensitive.
contractTypeenumoptional
Keep only one contract type. Values: perpetual, futures.
pagenumberoptional
Result page. Default 1.
limitnumberoptional
Contracts per page, largest 24-hour volume first. Default 50, max 500.

Request

curl -X GET "https://api.zapi.ink/v1/finance:coingecko/derivatives?market=Binance+%28Futures%29&indexId=BTC&symbol=BTCUSDT&contractType=perpetual&page=1&limit=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "page": 1,
  "count": 50,
  "items": [
    {
      "basis": 0.06723269891566265,
      "index": 74750.22282609,
      "price": 74809.6,
      "market": "Binance (Futures)",
      "spread": 0.01,
      "symbol": "BTCUSDT",
      "indexId": "BTC",
      "expiredAt": null,
      "volume24h": 25178009121.568,
      "fundingRate": 0.009004999999999999,
      "contractType": "perpetual",
      "lastTradedAt": 1787278869,
      "openInterest": 8051672809.38,
      "priceChangePercentage24h": 7.491139535586474
    },
    {
      "basis": 0.054214549828617654,
      "index": 2349.82325581,
      "price": 2350.89,
      "market": "Binance (Futures)",
      "spread": 0.01,
      "symbol": "ETHUSDT",
      "indexId": "ETH",
      "expiredAt": null,
      "volume24h": 19004272641.0522,
      "fundingRate": 0.01,
      "contractType": "perpetual",
      "lastTradedAt": 1787278868,
      "openInterest": 5504742404.25,
      "priceChangePercentage24h": 3.9227399442453206
    },
    {
      "basis": -0.010425597516681073,
      "index": 2348.22515797,
      "price": 2350.89,
      "market": "Binance (Futures)",
      "spread": 0.01,
      "symbol": "ETHUSDC",
      "indexId": "ETH",
      "expiredAt": null,
      "volume24h": 5599928344.27455,
      "fundingRate": 0.009365,
      "contractType": "perpetual",
      "lastTradedAt": 1787278744,
      "openInterest": 2334291679.43,
      "priceChangePercentage24h": 3.6293916742416887
    }
  ],
  "total": 768,
  "market": "Binance (Futures)",
  "symbol": null,
  "dataset": "derivatives",
  "hasMore": true,
  "indexId": null,
  "nextPage": 2,
  "provider": "coingecko",
  "contractType": null
}
GET
Ping/v1/finance:coingecko/ping
0 params

Upstream liveness. The cheapest way to tell a quota refusal apart from an

Parameters

This endpoint takes no parameters.

Request

curl -X GET "https://api.zapi.ink/v1/finance:coingecko/ping" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ok": true,
  "dataset": "ping",
  "provider": "coingecko"
}

Related APIs

More in finance

Pluang

financepluang

Data pasar Pluang lintas aset: order book, running trade, tradebook dan ringkasan broker per saham IDX, plus saham Amerika, emas, kripto, sinyal analis dan berita.

1.7M1.7M calls so far1dResponses cached for 1d
Busy: 10+ calls so far

IDX (Bursa Efek Indonesia)

financeidx

Data Bursa Efek Indonesia: ringkasan saham & indeks, top movers, broker, emiten, laporan keuangan, berita, dan passthrough ke ratusan endpoint /primary/.

756.1K756.1K calls so far1dResponses cached for 1d
Busy: 10+ calls so far

TradingView

financetradingview

Screener, charts, technical indicators, fundamentals, news and the macro calendar across 16 markets — Indonesian equities, US equities, crypto, forex and futures.

341.4K341.4K calls so far1dResponses cached for 1d
Busy: 10+ calls so far

Stockbit

financestockbit

Data saham IDX dari Stockbit: harga, chart intraday, profil emiten, diskusi komunitas, dan kamus investasi.

115.5K115.5K calls so far1dResponses cached for 1d
Busy: 10+ calls so far

Investing

financeinvesting

Data pasar finansial lengkap — quote saham/forex/crypto/komoditas, teknikal, OHLCV historis, berita, analisis, dan kalender ekonomi.

69.6K69.6K calls so far1hResponses cached for 1h
Busy: 10+ calls so far

Binance Futures

financebinance-futures

USD-M perpetual futures market data: funding, premium index, open interest, long/short ratios, candles and depth.

40.3K40.3K calls so far10mResponses cached for 10m
Busy: 10+ calls so far
zapi.

One key, one response shape. We keep the scrapers working.

Get an API key
ProductBrowse APIsPricingDocsMCP server
DevelopersSDK on npmGitHubOpenAPI specllms.txt
SupportReport an issueDiscord
LegalTermsPrivacyCookiesAUPRefunds
© 2026 ZapiPublic web data, one API.
zapi.