zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
On this page
  • Playground
  • Code examples
  • Full reference
  • Related APIs
Finance/Coingecko
Logo Coingecko

Coingecko

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

Endpoints
8
Requests
631
Updated
5 hours ago
For LLMs
llms.txt
Endpoint healthnot yet measured
  • categoriesnot measured
  • exchangesnot measured
  • vs-currenciesnot measured
  • globalnot measured
  • coins-marketsnot measured
+ 3 more endpointsShow less
  • simple-pricenot measured
  • derivativesnot measured
  • pingnot measured
no measurements yetdaily 01:00 WIB

Playground

8 endpoints
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 examples

Categories
zpi-sdkrecommended
// 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);
Full SDK reference →
request.sh
curl -X GET "https://api.zpi.web.id/v1/finance:coingecko/categories?order=market_cap_desc&query=layer&limit=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

8 endpoints · plain text
GETCategories/v1/finance:coingecko/categoriesSector 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.zpi.web.id/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"
}
GETExchanges/v1/finance:coingecko/exchangesVenue 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.zpi.web.id/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"
}
GETVs Currencies/v1/finance:coingecko/vs-currenciesThe currency codes every `vsCurrency` knob in this scraper accepts.

Parameters

This endpoint takes no parameters.

Request

curl -X GET "https://api.zpi.web.id/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"
}
GETGlobal/v1/finance:coingecko/globalAggregate 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.zpi.web.id/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
}
GETCoins Markets/v1/finance:coingecko/coins-marketsThe 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.zpi.web.id/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"
}
GETSimple Price/v1/finance:coingecko/simple-priceSpot 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.zpi.web.id/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"
  ]
}
GETDerivatives/v1/finance:coingecko/derivativesEvery 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.zpi.web.id/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
}
GETPing/v1/finance:coingecko/pingUpstream liveness. The cheapest way to tell a quota refusal apart from an

Parameters

This endpoint takes no parameters.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:coingecko/ping" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

Related APIs

More in finance

Pluang

finance/pluang

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.

27.9K calls·1d cache

Binance Vision

finance/binance-vision

Binance's public bulk archive: klines, 5-minute open-interest and long/short metrics, funding, book depth and liquidations, back to 2017.

7.9K calls·1d cache

TradingView

finance/tradingview

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

57K calls·1d cache

Stockbit

finance/stockbit

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

17.8K calls·1d cache

Mempool Space

finance/mempool-space

Recommended fee tiers in sat/vB, as mempool.space's own estimator sees them.

1.1K calls·2m cache

Etherscan

finance/etherscan

Current gas price tiers and base fee, from Etherscan's V2 multichain API.

683 calls·30s cache
Browse APIsPricingDocsMCP serverGet an API key
zapi.One key, one response shape.
TermsPrivacyCookiesAUPRefunds© 2026