Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalogue, with no credit card. Nothing about it expires.

What happens when I hit the quota?

Requests return 429 with the limit, what you have used, and which window you tripped — nothing is queued, and nothing is charged. The monthly quota resets on the 1st (UTC). There is no rollover: unused requests do not carry into the next month.

Do failed requests use up my quota?

A 5xx does not. If a source breaks on our side, the request is excluded from your monthly count. A 4xx does count — a wrong parameter is still a request we answered. Per-minute throttling counts everything, so a retry loop is still throttled.

Which tier do I need?

Start on Free. Every response carries the remaining quota in its headers, and the dashboard reads the same number enforcement uses, so you will see the ceiling coming rather than discovering it.

How is Zapi different from RapidAPI or Apify?

Zapi focuses on a consistent REST contract — one API key, one response format, one error pattern for every source. No need to learn per-provider quirks like on traditional marketplaces, and no need to set up scraping workflows like on Apify.

What about the legality of accessing public data?

Zapi only accesses data that is publicly available without a login. Responsibility for how it is ultimately used stays with the developer — make sure your use case complies with the original source's ToS and the regulations in your operating region.

Is there an official SDK?

One: zpi-sdk, for TypeScript and JavaScript. It carries a typed error hierarchy, retries only what is safe to retry, submits bulk jobs, and verifies webhook signatures. Everything else is plain REST — cURL or any HTTP client works.

Can I request a source that isn’t in the catalogue yet?

Yes, through the community Discord, on any tier.

Coingecko

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

8 endpoints730 calls6/8 passing

Get API key

Name	Type	In	Description
order	enum	query	Row ordering. Default market_cap_desc. One of market_cap_desc, market_cap_asc, name_desc, name_asc, market_cap_change_24h_desc, market_cap_change_24h_asc.
query	string	query	Free text over category id and name.
limit	number	query	Categories to return. Default 50, max 500.

Exchanges

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

GET/v1/finance:coingecko/exchanges

passing · 8.8s1d cache

Parameters

Name	Type	In	Description
page	number	query	Result page. Default 1.
limit	number	query	Venues per page, best trust score first. Default 50, max 250.

Example response

{"project":"finance:coingecko",  "data": {"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"  },"timestamp":"2026-08-21T02:24:50Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Vs Currencies

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

GET/v1/finance:coingecko/vs-currencies

passing · 8.9s1d cache

Parameters

No parameters. Call it as is.

Example response

{"project":"finance:coingecko",  "data": {"count":63,    "items": [      "aed",      "ars",      "aud",      "bch",      "bdt",      "bhd",      "bits",      "bmd"    ],"total":63,"dataset":"vs-currencies","provider":"coingecko"  },"timestamp":"2026-08-21T02:24:50Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Global

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

GET/v1/finance:coingecko/global

passing · 9.0s15m cache

Parameters

Name	Type	In	Description
vsCurrency	string	query	Currency code from `vs-currencies` for the totals. Default usd.
limit	number	query	Dominance rows to return, largest share first. Default 10, max 100.

Example response

{"project":"finance:coingecko",  "data": {"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  },"timestamp":"2026-08-21T02:24:50Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Coins Markets

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

GET/v1/finance:coingecko/coins-markets

passing · 9.0s15m cache

Parameters

Name	Type	In	Description
vsCurrency	string	query	Currency code from `vs-currencies`. Default usd.
ids	string	query	Restrict to these coin ids, comma-separated.
category	string	query	Restrict to one category id from `categories`.
order	enum	query	Row ordering. Default market_cap_desc. One of market_cap_desc, market_cap_asc, volume_desc, volume_asc, id_desc, id_asc.
priceChangePercentage	string	query	Extra change windows, comma-separated. Any of 1h, 24h, 7d, 14d, 30d, 200d, 1y.
precision	string	query	Decimal places, 0 to 18, or full.
page	number	query	Result page. Default 1.
limit	number	query	Coins per page. Default 50, max 250.

Example response

{"project":"finance:coingecko",  "data": {"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"  },"timestamp":"2026-08-21T02:24:50Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Simple Price

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

GET/v1/finance:coingecko/simple-price

passing · 9.0s5m cache

Parameters

Name	Type	In	Description
ids	string	query	Comma-separated coin ids as CoinGecko spells them. Required, up to 100. Required.
vsCurrencies	string	query	Comma-separated currency codes from `vs-currencies`. Default usd.
includeMarketCap	enum	query	Include market cap per pair. Default true. One of true, false.
include24hVol	enum	query	Include 24-hour volume per pair. Default true. One of true, false.
include24hChange	enum	query	Include 24-hour percentage change per pair. Default true. One of true, false.
precision	string	query	Decimal places, 0 to 18, or full.

Example response

{"project":"finance:coingecko",  "data": {    "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"    ]  },"timestamp":"2026-08-21T02:24:50Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Derivatives

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

GET/v1/finance:coingecko/derivatives

failed last check15m cache

Parameters

Name	Type	In	Description
market	string	query	Keep only this venue. Case-insensitive substring.
indexId	string	query	Keep only contracts on this index. Case-insensitive.
symbol	string	query	Keep only contracts whose symbol contains this. Case-insensitive.
contractType	enum	query	Keep only one contract type. One of perpetual, futures.
page	number	query	Result page. Default 1.
limit	number	query	Contracts per page, largest 24-hour volume first. Default 50, max 500.

Example response

{"project":"finance:coingecko",  "data": {"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  },"timestamp":"2026-08-21T02:24:50Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Ping

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

GET/v1/finance:coingecko/ping

failed last check5m cache

Parameters

No parameters. Call it as is.

Example response

{"project":"finance:coingecko",  "data": {"ok":true,"dataset":"ping","provider":"coingecko"  },"timestamp":"2026-08-21T02:24:50Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Try it

Live request with your key

const data = await client.run(  "finance:coingecko",  "categories",  { order: "market_cap_desc", query: "layer", limit: 50 });

Coingecko

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

8 endpoints730 calls6/8 passing

Get API key

GET/v1/…coingecko/categories

passing · 0.3s1h cache

Try it

Parameters

order

enum · query · optional

Row ordering. Default market_cap_desc.

query

string · query · optional

Free text over category id and name.

limit

number · query · optional

Categories to return. Default 50, max 500.

Example response

{"project":"finance:coingecko",  "data": {"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"  },"timestamp":"2026-08-21T02:24:50Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Code

const data = await client.run(  "finance:coingecko",  "categories",  { order: "market_cap_desc", query: "layer", limit: 50 });