Sector market caps — which categories exist and which coins lead them.
categoriesnot measuredexchangesnot measuredvs-currenciesnot measuredglobalnot measuredcoins-marketsnot measuredsimple-pricenot measuredderivativesnot measuredpingnot measured/v1/finance:coingecko/categories1h cache3 paramschecking key…// 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);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"/v1/finance:coingecko/categoriesSector market caps — which categories exist and which coins lead them.orderenumoptionalquerystringoptionallimitnumberoptionalcurl -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"{
"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"
}/v1/finance:coingecko/exchangesVenue directory with CoinGecko's trust score — a map of where things trade,pagenumberoptionallimitnumberoptionalcurl -X GET "https://api.zpi.web.id/v1/finance:coingecko/exchanges?page=1&limit=50" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"{
"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"
}/v1/finance:coingecko/vs-currenciesThe currency codes every `vsCurrency` knob in this scraper accepts.This endpoint takes no parameters.
curl -X GET "https://api.zpi.web.id/v1/finance:coingecko/vs-currencies" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"{
"count": 63,
"items": [
"aed",
"ars",
"aud",
"bch",
"bdt",
"bhd",
"bits",
"bmd"
],
"total": 63,
"dataset": "vs-currencies",
"provider": "coingecko"
}/v1/finance:coingecko/globalAggregate market state — one currency's slice of it.vsCurrencystringoptionalvs-currencies for the totals. Default usd.limitnumberoptionalcurl -X GET "https://api.zpi.web.id/v1/finance:coingecko/global?vsCurrency=usd&limit=10" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"{
"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
}/v1/finance:coingecko/coins-marketsThe market-cap ranked cross-section — which coins exist, what they are called,vsCurrencystringoptionalvs-currencies. Default usd.idsstringoptionalcategorystringoptionalcategories.orderenumoptionalpriceChangePercentagestringoptionalprecisionstringoptionalpagenumberoptionallimitnumberoptionalcurl -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"{
"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"
}/v1/finance:coingecko/simple-priceSpot price for a set of coins against a set of currencies.idsstringrequiredvsCurrenciesstringoptionalvs-currencies. Default usd.includeMarketCapenumoptionalinclude24hVolenumoptionalinclude24hChangeenumoptionalprecisionstringoptionalcurl -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"{
"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"
]
}/v1/finance:coingecko/derivativesEvery perp and future ticker CoinGecko tracks, with funding, open interest,marketstringoptionalindexIdstringoptionalsymbolstringoptionalcontractTypeenumoptionalpagenumberoptionallimitnumberoptionalcurl -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"{
"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
}/v1/finance:coingecko/pingUpstream liveness. The cheapest way to tell a quota refusal apart from anThis endpoint takes no parameters.
curl -X GET "https://api.zpi.web.id/v1/finance:coingecko/ping" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"{
"ok": true,
"dataset": "ping",
"provider": "coingecko"
}