# Coingecko — Zapi reference > Sector market caps — which categories exist and which coins lead them. **Base URL:** `https://api.zpi.web.id` **Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys. **Response envelope:** `{ content, message, errors }` **Rate limit:** 60 req/min on free tier. **Related:** - Detail page: https://zpi.web.id/api/finance/coingecko - Endpoint catalog: https://zpi.web.id/category/finance - Concise index: https://zpi.web.id/llms.txt - Full reference: https://zpi.web.id/llms-full.txt --- ## Coingecko **Category:** finance · **Slug:** `coingecko` **Detail page:** https://zpi.web.id/api/finance/coingecko Sector market caps — which categories exist and which coins lead them. **Tags:** finance, coingecko ### Categories Sector market caps — which categories exist and which coins lead them. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:coingecko/categories` - **Cache TTL:** 3600s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `order` | enum(market_cap_desc|market_cap_asc|name_desc|name_asc|market_cap_change_24h_desc|market_cap_change_24h_asc) | query | no | Row ordering. Default market_cap_desc. | | `query` | string | query | no | Free text over category id and name. | | `limit` | number | query | no | Categories to return. Default 50, max 500. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:coingecko/categories?order=market_cap_desc&query=layer&limit=50" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:coingecko/categories?order=market_cap_desc&query=layer&limit=50", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/finance:coingecko/categories?order=market_cap_desc&query=layer&limit=50", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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 perform various actions such as lending and borrowing funds, staking their assets or minting NFTs. Smart contracts are programs that are stored on the blockchain and are automatically executed when certain conditions are met.", "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 network.", "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 }, { "id": "world-liberty-financial-portfolio", "name": "World Liberty Financial Portfolio", "topCoins": [ "ethereum", "tether", "usd-coin" ], "marketCap": 593583330794.9008, "updatedAt": "2026-08-21T02:18:58.000Z", "volume24h": 149736005220.40707, "description": "The World Liberty Financial portfolio includes purchases made by the World Liberty Financial project. World Liberty Financial is a DeFi project associated with U.S. presidential candidate Donald Trump and his family members.", "marketCapChange24h": 2.0467187219617577 }, { "id": "proof-of-stake-pos", "name": "Proof of Stake (PoS)", "topCoins": [ "ethereum", "binancecoin", "solana" ], "marketCap": 501794993295.9111, "updatedAt": "2026-08-21T02:18:58.000Z", "volume24h": 36781948402.51884, "description": "Proof of Stake (PoS) is a blockchain consensus mechanism where validators are selected to create new blocks based on the amount of cryptocurrency they hold and are willing to stake as collateral.", "marketCapChange24h": 4.244045735526035 }, { "id": "made-in-usa", "name": "Made in USA", "topCoins": [ "ripple", "usd-coin", "solana" ], "marketCap": 301305708772.3516, "updatedAt": "2026-08-21T02:18:58.000Z", "volume24h": 43769121481.169106, "description": "Refers to cryptocurrencies that have significant connections to the United States, either through their founding team or company headquarters.", "marketCapChange24h": 5.871783727993504 }, { "id": "stablecoins", "name": "Stablecoins", "topCoins": [ "tether", "usd-coin", "usds" ], "marketCap": 288679680734.6354, "updatedAt": "2026-08-21T02:18:58.000Z", "volume24h": 124092178305.77885, "description": "A stablecoin is a type of cryptocurrency that is designed to maintain a stable value by being pegged to an external reference, such as a fiat currency.", "marketCapChange24h": 0.13974186369288907 }, { "id": "usd-stablecoin", "name": "USD Stablecoin", "topCoins": [ "tether", "usd-coin", "usds" ], "marketCap": 285965474537.6464, "updatedAt": "2026-08-21T02:18:58.000Z", "volume24h": 123950968526.06122, "description": "A USD stablecoin is a type of cryptocurrency that is designed to maintain a stable value by being pegged to the United States dollar.", "marketCapChange24h": 0.13345029142541218 } ], "order": "market_cap_desc", "query": null, "total": 753, "dataset": "categories", "provider": "coingecko" } ``` --- ### Exchanges Venue directory with CoinGecko's trust score — a map of where things trade, - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:coingecko/exchanges` - **Cache TTL:** 86400s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `page` | number | query | no | Result page. Default 1. | | `limit` | number | query | no | Venues per page, best trust score first. Default 50, max 250. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:coingecko/exchanges?page=1&limit=50" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:coingecko/exchanges?page=1&limit=50", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/finance:coingecko/exchanges?page=1&limit=50", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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 compliance efforts.", "trustScoreRank": 3, "yearEstablished": 2011, "tradeVolume24hBtc": 26793.790275749678, "hasTradingIncentive": false }, { "id": "okex", "url": "https://www.okx.com", "name": "OKX", "image": "https://coin-images.coingecko.com/markets/images/96/small/WeChat_Image_20220117220452.png?1706864283", "country": "Seychelles", "trustScore": 10, "description": "OKX is a leading global cryptocurrency exchange offering diverse trading options, advanced security, and Web3 integration for millions of users worldwide.", "trustScoreRank": 4, "yearEstablished": 2017, "tradeVolume24hBtc": 44484.488636382994, "hasTradingIncentive": false }, { "id": "bitget", "url": "https://www.bitget.com/", "name": "Bitget", "image": "https://coin-images.coingecko.com/markets/images/540/small/2023-07-25_21.47.43.jpg?1706864507", "country": "Seychelles", "trustScore": 10, "description": "Established in 2018, Bitget is the world's leading cryptocurrency exchange and Web3 company. Serving over 100 million users in 150+ countries and regions, the Bitget exchange is committed to helping users trade smarter with its pioneering copy trading feature and other trading solutions, while offering real-time access to Bitcoin price, Ethereum price, and other cryptocurrency prices. Formerly known as BitKeep, Bitget Wallet is a world-class multi-chain crypto wallet that offers an array of comprehensive Web3 solutions and features including wallet functionality, token swap, NFT Marketplace, DApp browser, and more. Bitget is at the forefront of driving crypto adoption through strategic partnerships, such as its role as the Official Crypto Partner of the World's Top Football League, LALIGA, in EASTERN, SEA and LATAM market, as well as a global partner of Turkish National athletes Buse Tosun Çavuşoğlu (Wrestling world champion), Samet Gümüş (Boxing gold medalist) and İlkin Aydın (Volleyball national team), to inspire the global community to embrace the future of cryptocurrency.", "trustScoreRank": 5, "yearEstablished": 2018, "tradeVolume24hBtc": 19605.038162766952, "hasTradingIncentive": false }, { "id": "gate", "url": "https://www.gate.com", "name": "Gate", "image": "https://coin-images.coingecko.com/markets/images/60/small/Frame_1.png?1747795534", "country": "Panama", "trustScore": 10, "description": "Gate was established in 2013 and provides digital asset trading and related blockchain services to users globally. The platform reports serving more than 58 million users and supports spot, futures, and margin trading, as well as wealth management products for over 4,900 cryptocurrencies and 12,500+ stock assets.\n\nGate states that it uses zero-knowledge technology to provide verifiable proof of reserves. According to the company, as of June 22, 2026, its reported total reserves were valued at approximately USD 8.182 billion, with a reserve ratio of 115%, covering nearly 500 types of user assets.\n\nVarious Gate entities have obtained regulatory registrations, licenses, authorizations, or approvals in multiple jurisdictions, including Malta, Italy, Gibraltar, the Bahamas, Hong Kong, Japan, and the United Arab Emirates. In 2024, Gate Group completed the acquisition of a Japan-licensed exchange. In April 2025, Gate Technology FZE obtained a full operational license from Dubai’s Virtual Assets Regulatory Authority (VARA). In September 2025, Gate Technology Ltd. received authorization under the EU’s Markets in Crypto-Assets (MiCA) framework from the Malta Financial Services Authority (MFSA).In February 2026, Gate's Malta-based entity, Gate Technology Ltd, officially obtained a Payment Institution license under the EU's Second Payment Services Directive (PSD2) from the Malta Financial Services Authority (MFSA).", "trustScoreRank": 6, "yearEstablished": 2013, "tradeVolume24hBtc": 43041.70347289879, "hasTradingIncentive": false }, { "id": "bitstamp", "url": "https://links.bitstamp.net/c/2223866/1100037/14006", "name": "Bitstamp by Robinhood", "image": "https://coin-images.coingecko.com/markets/images/9/small/bitstamp.jpg?1706864251", "country": "Luxembourg", "trustScore": 9, "description": "Bitstamp is the world's longest-running cryptocurrency exchange, providing a secure platform for trading popular cryptocurrencies like Bitcoin and Ethereum with a focus on transparency and customer service.", "trustScoreRank": 7, "yearEstablished": 2011, "tradeVolume24hBtc": 9835.273114318577, "hasTradingIncentive": false }, { "id": "bybit_spot", "url": "https://www.bybit.com", "name": "Bybit", "image": "https://coin-images.coingecko.com/markets/images/698/small/bybit_spot.png?1706864649", "country": "British Virgin Islands", "trustScore": 9, "description": "Bybit is the world’s second-largest cryptocurrency exchange by trading volume, serving a global community of over 60 million users. Founded in 2018, Bybit is redefining openness in the decentralized world by creating a simpler, open and equal ecosystem for everyone. With a strong focus on Web3, Bybit partners strategically with leading blockchain protocols to provide robust infrastructure and drive on-chain innovation. Renowned for its secure custody, diverse marketplaces, intuitive user experience, and advanced blockchain tools, Bybit bridges the gap between TradFi and DeFi, empowering builders, creators, and enthusiasts to unlock the full potential of Web3. Discover the future of decentralized finance at Bybit.com.", "trustScoreRank": 8, "yearEstablished": 2018, "tradeVolume24hBtc": 43257.112822053066, "hasTradingIncentive": false } ], "total": null, "dataset": "exchanges", "hasMore": true, "nextPage": 2, "provider": "coingecko" } ``` --- ### Vs Currencies The currency codes every `vsCurrency` knob in this scraper accepts. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:coingecko/vs-currencies` - **Cache TTL:** 86400s **Parameters:** _No parameters._ **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:coingecko/vs-currencies" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:coingecko/vs-currencies", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/finance:coingecko/vs-currencies", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 63, "items": [ "aed", "ars", "aud", "bch", "bdt", "bhd", "bits", "bmd" ], "total": 63, "dataset": "vs-currencies", "provider": "coingecko" } ``` --- ### Global Aggregate market state — one currency's slice of it. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:coingecko/global` - **Cache TTL:** 900s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `vsCurrency` | string | query | no | Currency code from `vs-currencies` for the totals. Default usd. | | `limit` | number | query | no | Dominance rows to return, largest share first. Default 10, max 100. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:coingecko/global?vsCurrency=usd&limit=10" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:coingecko/global?vsCurrency=usd&limit=10", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/finance:coingecko/global?vsCurrency=usd&limit=10", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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 } ``` --- ### Coins Markets The market-cap ranked cross-section — which coins exist, what they are called, - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:coingecko/coins-markets` - **Cache TTL:** 900s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `vsCurrency` | string | query | no | Currency code from `vs-currencies`. Default usd. | | `ids` | string | query | no | Restrict to these coin ids, comma-separated. | | `category` | string | query | no | Restrict to one category id from `categories`. | | `order` | enum(market_cap_desc|market_cap_asc|volume_desc|volume_asc|id_desc|id_asc) | query | no | Row ordering. Default market_cap_desc. | | `priceChangePercentage` | string | query | no | Extra change windows, comma-separated. Any of 1h, 24h, 7d, 14d, 30d, 200d, 1y. | | `precision` | string | query | no | Decimal places, 0 to 18, or full. | | `page` | number | query | no | Result page. Default 1. | | `limit` | number | query | no | Coins per page. Default 50, max 250. | **cURL:** ```bash curl "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: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("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", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.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", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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 }, { "id": "tether", "ath": 1.32, "atl": 0.572521, "name": "Tether", "image": "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661", "low24h": 0.999172, "symbol": "USDT", "athDate": "2018-07-23T16:00:00.000Z", "atlDate": "2015-03-01T16:00:00.000Z", "high24h": 0.999781, "marketCap": 183028623916, "maxSupply": null, "lastUpdated": "2026-08-21T02:22:20.000Z", "totalSupply": 188572211645.5762, "totalVolume": 94205801338, "currentPrice": 0.999609, "marketCapRank": 3, "priceChange24h": 0.00018099, "circulatingSupply": 183105266035.02103, "marketCapChange24h": 33537221, "athChangePercentage": -24.44923, "atlChangePercentage": 74.59774, "fullyDilutedValuation": 188493281234, "priceChangePercentage": {}, "priceChangePercentage24h": 0, "marketCapChangePercentage24h": 0.01833 }, { "id": "binancecoin", "ath": 1369.99, "atl": 0.0398177, "name": "BNB", "image": "https://coin-images.coingecko.com/coins/images/825/large/bnb-icon2_2x.png?1696501970", "low24h": 622.18, "symbol": "BNB", "athDate": "2025-10-13T00:41:24.000Z", "atlDate": "2017-10-18T16:00:00.000Z", "high24h": 665.31, "marketCap": 88021355185, "maxSupply": 200000000, "lastUpdated": "2026-08-21T02:22:20.000Z", "totalSupply": 133163284.66, "totalVolume": 1588840355, "currentPrice": 661.09, "marketCapRank": 4, "priceChange24h": 37.22, "circulatingSupply": 133163284.66, "marketCapChange24h": 4945379190, "athChangePercentage": -51.7451, "atlChangePercentage": 1660187.10097, "fullyDilutedValuation": 88021356692, "priceChangePercentage": {}, "priceChangePercentage24h": 5.2, "marketCapChangePercentage24h": 5.95284 }, { "id": "ripple", "ath": 3.65, "atl": 0.00268621, "name": "XRP", "image": "https://coin-images.coingecko.com/coins/images/44/large/xrp-symbol-white-128.png?1696501442", "low24h": 1.088, "symbol": "XRP", "athDate": "2025-07-17T19:40:53.000Z", "atlDate": "2014-05-21T16:00:00.000Z", "high24h": 1.34, "marketCap": 80626281592, "maxSupply": 100000000000, "lastUpdated": "2026-08-21T02:22:20.000Z", "totalSupply": 99985629672, "totalVolume": 7367029239, "currentPrice": 1.29, "marketCapRank": 5, "priceChange24h": 0.193983, "circulatingSupply": 62676938832, "marketCapChange24h": 12139388491, "athChangePercentage": -64.71348, "atlChangePercentage": 47799.50946, "fullyDilutedValuation": 128619388300, "priceChangePercentage": {}, "priceChangePercentage24h": 16.5, "marketCapChangePercentage24h": 17.72513 }, { "id": "usd-coin", "ath": 1.043, "atl": 0.877647, "name": "USDC", "image": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602", "low24h": 0.999437, "symbol": "USDC", "athDate": "2018-11-14T16:00:00.000Z", "atlDate": "2023-03-11T00:02:13.000Z", "high24h": 1, "marketCap": 72780727804, "maxSupply": null, "lastUpdated": "2026-08-21T02:22:20.000Z", "totalSupply": 72783787437.54024, "totalVolume": 23902753663, "currentPrice": 0.99976, "marketCapRank": 6, "priceChange24h": 0.00011262, "circulatingSupply": 72800451917.0638, "marketCapChange24h": 313762067, "athChangePercentage": -4.18837, "atlChangePercentage": 13.91379, "fullyDilutedValuation": 72784322670, "priceChangePercentage": {}, "priceChangePercentage24h": 0, "marketCapChangePercentage24h": 0.43297 }, { "id": "solana", "ath": 293.31, "atl": 0.500801, "name": "Solana", "image": "https://coin-images.coingecko.com/coins/images/4128/large/solana.png?1718769756", "low24h": 84.01, "symbol": "SOL", "athDate": "2025-01-19T03:15:27.000Z", "atlDate": "2020-05-11T11:35:23.000Z", "high24h": 89.32, "marketCap": 51945913457, "maxSupply": null, "lastUpdated": "2026-08-21T02:22:20.000Z", "totalSupply": 632513074.5503877, "totalVolume": 4471510907, "currentPrice": 89.06, "marketCapRank": 7, "priceChange24h": 4.71, "circulatingSupply": 583063256.7775589, "marketCapChange24h": 2768700804, "athChangePercentage": -69.63661, "atlChangePercentage": 17683.39222, "fullyDilutedValuation": 56351468178, "priceChangePercentage": {}, "priceChangePercentage24h": 4.6, "marketCapChangePercentage24h": 5.63005 }, { "id": "tron", "ath": 0.431288, "atl": 0.00180434, "name": "TRON", "image": "https://coin-images.coingecko.com/coins/images/1094/large/photo_2026-04-13_09-59-16.png?1776048311", "low24h": 0.332043, "symbol": "TRX", "athDate": "2024-12-03T16:10:40.000Z", "atlDate": "2017-11-11T16:00:00.000Z", "high24h": 0.3402, "marketCap": 32077396056, "maxSupply": null, "lastUpdated": "2026-08-21T02:22:20.000Z", "totalSupply": 94912161400.71889, "totalVolume": 597819466, "currentPrice": 0.337964, "marketCapRank": 8, "priceChange24h": 0.00536952, "circulatingSupply": 94911376357.14629, "marketCapChange24h": 510777098, "athChangePercentage": -21.63846, "atlChangePercentage": 18630.60992, "fullyDilutedValuation": 32077644737, "priceChangePercentage": {}, "priceChangePercentage24h": 1.2, "marketCapChangePercentage24h": 1.61809 } ], "order": "market_cap_desc", "total": null, "dataset": "coins-markets", "hasMore": true, "category": null, "nextPage": 2, "provider": "coingecko", "priceBasis": "cross-venue-aggregate", "vsCurrency": "usd" } ``` --- ### Simple Price Spot price for a set of coins against a set of currencies. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:coingecko/simple-price` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `ids` | string | query | yes | Comma-separated coin ids as CoinGecko spells them. Required, up to 100. | | `vsCurrencies` | string | query | no | Comma-separated currency codes from `vs-currencies`. Default usd. | | `includeMarketCap` | enum(true|false) | query | no | Include market cap per pair. Default true. | | `include24hVol` | enum(true|false) | query | no | Include 24-hour volume per pair. Default true. | | `include24hChange` | enum(true|false) | query | no | Include 24-hour percentage change per pair. Default true. | | `precision` | string | query | no | Decimal places, 0 to 18, or full. | **cURL:** ```bash curl "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: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:coingecko/simple-price?ids=bitcoin%2Cethereum&vsCurrencies=usd%2Cidr&includeMarketCap=true&include24hVol=true&include24hChange=true&precision=4", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.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", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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" ] } ``` --- ### Derivatives Every perp and future ticker CoinGecko tracks, with funding, open interest, - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:coingecko/derivatives` - **Cache TTL:** 900s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `market` | string | query | no | Keep only this venue. Case-insensitive substring. | | `indexId` | string | query | no | Keep only contracts on this index. Case-insensitive. | | `symbol` | string | query | no | Keep only contracts whose symbol contains this. Case-insensitive. | | `contractType` | enum(perpetual|futures) | query | no | Keep only one contract type. | | `page` | number | query | no | Result page. Default 1. | | `limit` | number | query | no | Contracts per page, largest 24-hour volume first. Default 50, max 500. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:coingecko/derivatives?market=Binance%20(Futures)&indexId=BTC&symbol=BTCUSDT&contractType=perpetual&page=1&limit=50" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:coingecko/derivatives?market=Binance%20(Futures)&indexId=BTC&symbol=BTCUSDT&contractType=perpetual&page=1&limit=50", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/finance:coingecko/derivatives?market=Binance%20(Futures)&indexId=BTC&symbol=BTCUSDT&contractType=perpetual&page=1&limit=50", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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 }, { "basis": 0.041912279389909844, "index": 74721.90453295, "price": 74809.6, "market": "Binance (Futures)", "spread": 0.01, "symbol": "BTCUSDC", "indexId": "BTC", "expiredAt": null, "volume24h": 5522656981.6448, "fundingRate": 0.002201, "contractType": "perpetual", "lastTradedAt": 1787278744, "openInterest": 1414701337.32, "priceChangePercentage24h": 7.311613526125837 }, { "basis": 0.05155583331257938, "index": 1606.94804855, "price": 1605.38, "market": "Binance (Futures)", "spread": 0.01, "symbol": "SNDKUSDT", "indexId": "SNDK", "expiredAt": null, "volume24h": 4170273242.0654387, "fundingRate": 0, "contractType": "futures", "lastTradedAt": 1787278871, "openInterest": 325518761.98, "priceChangePercentage24h": 0.5257491925994542 }, { "basis": -0.028067122436295836, "index": 1.28683872, "price": 1.29, "market": "Binance (Futures)", "spread": 0.02, "symbol": "XRPUSDT", "indexId": "XRP", "expiredAt": null, "volume24h": 2953812469.796339, "fundingRate": 0.01, "contractType": "perpetual", "lastTradedAt": 1787278868, "openInterest": 432960472.75, "priceChangePercentage24h": 16.13136051966799 }, { "basis": 0.039892730536235134, "index": 89.17556038, "price": 89.1, "market": "Binance (Futures)", "spread": 0.01, "symbol": "SOLUSDT", "indexId": "SOL", "expiredAt": null, "volume24h": 2396764209.3489757, "fundingRate": 0.01, "contractType": "perpetual", "lastTradedAt": 1787278925, "openInterest": 725123342.44, "priceChangePercentage24h": 4.698144233027954 }, { "basis": 0.6906498455298722, "index": 1271.09862552, "price": 1261.8, "market": "Binance (Futures)", "spread": 0.01, "symbol": "SKHYNIXUSDT", "indexId": "SKHYNIX", "expiredAt": null, "volume24h": 2237188601.808816, "fundingRate": -0.151075, "contractType": "futures", "lastTradedAt": 1787278873, "openInterest": 476048175.93, "priceChangePercentage24h": 5.237797507398608 } ], "total": 768, "market": "Binance (Futures)", "symbol": null, "dataset": "derivatives", "hasMore": true, "indexId": null, "nextPage": 2, "provider": "coingecko", "contractType": null } ``` --- ### Ping Upstream liveness. The cheapest way to tell a quota refusal apart from an - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:coingecko/ping` - **Cache TTL:** 300s **Parameters:** _No parameters._ **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:coingecko/ping" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:coingecko/ping", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/finance:coingecko/ping", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "ok": true, "dataset": "ping", "provider": "coingecko" } ``` --- _Generated: 2026-08-21T07:38:55.639Z_