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.

Tokocrypto

Tokocrypto aggregated tape — consecutive fills of one taker order at one

6 endpoints394 calls6/6 passing

Get API key

Agg Trades

GET/v1/finance:tokocrypto/agg-trades

passing · 0.8s5s cache

Parameters

Name	Type	In	Description
symbol	string	query	Symbol. Accepts BTCIDR, BTC_IDR or BTC/IDR. Required.
limit	number	query	Number of recent aggregated trades. Default 100, max 1000.

Example response

{"project":"finance:tokocrypto",  "data": {"base":"BTC","pair":"BTC_IDR","count":100,    "items": [      {"side":"buy","price":1326185291,"value":66309.26455,"amount":0.00005,"tradedAt":1787277957618,"aggTradeId":"839944","lastTradeId":"897133","tradedAtIso":"2026-08-21T02:05:57.618Z","firstTradeId":"897133"      },      {"side":"buy","price":1326185291,"value":13261.85291,"amount":0.00001,"tradedAt":1787277958311,"aggTradeId":"839945","lastTradeId":"897134","tradedAtIso":"2026-08-21T02:05:58.311Z","firstTradeId":"897134"      },      {"side":"buy","price":1326712538,"value":39801.37614,"amount":0.00003,"tradedAt":1787277958704,"aggTradeId":"839946","lastTradeId":"897135","tradedAtIso":"2026-08-21T02:05:58.704Z","firstTradeId":"897135"      },      {"side":"buy","price":1326712538,"value":13267.12538,"amount":0.00001,"tradedAt":1787277959308,"aggTradeId":"839947","lastTradeId":"897136","tradedAtIso":"2026-08-21T02:05:59.308Z","firstTradeId":"897136"      },      {"side":"buy","price":1326712538,"value":13267.12538,"amount":0.00001,"tradedAt":1787277960302,"aggTradeId":"839948","lastTradeId":"897137","tradedAtIso":"2026-08-21T02:06:00.302Z","firstTradeId":"897137"      },      {"side":"buy","price":1326712538,"value":13267.12538,"amount":0.00001,"tradedAt":1787277962406,"aggTradeId":"839949","lastTradeId":"897138","tradedAtIso":"2026-08-21T02:06:02.406Z","firstTradeId":"897138"      },      {"side":"buy","price":1327212210,"value":26544.2442,"amount":0.00002,"tradedAt":1787277965501,"aggTradeId":"839950","lastTradeId":"897139","tradedAtIso":"2026-08-21T02:06:05.501Z","firstTradeId":"897139"      },      {"side":"buy","price":1327212210,"value":53088.4884,"amount":0.00004,"tradedAt":1787277966309,"aggTradeId":"839951","lastTradeId":"897140","tradedAtIso":"2026-08-21T02:06:06.309Z","firstTradeId":"897140"      }    ],"quote":"IDR","symbol":"BTCIDR","dataset":"agg-trades","provider":"tokocrypto"  },"timestamp":"2026-08-21T02:26:02Z"}

Errors

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

Klines

Tokocrypto OHLCV candles, including the taker-buy split — the half of the

GET/v1/finance:tokocrypto/klines

passing · 0.3s30s cache

Parameters

Name	Type	In	Description
symbol	string	query	Symbol. Accepts BTCIDR, BTC_IDR or BTC/IDR. Required.
interval	enum	query	Candle size: 1m 3m 5m 15m 30m 1h 2h 4h 6h 8h 12h 1d 3d 1w 1M. Default 15m. One of 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M.
startTime	string	query	Oldest candle to include. Epoch seconds/ms or ISO date.
endTime	string	query	Newest candle to include. Epoch seconds/ms or ISO date. Default now.
count	number	query	Candles per page. Default 500, max 1000.
page	number	query	Page number, walking backwards in time. Default 1.

Example response

{"project":"finance:tokocrypto",  "data": {"base":"BTC","page":1,"pair":"BTC_IDR","count":500,    "items": [      {"low":1123639484,"date":"2026-08-15T21:30:00.000Z","high":1123917268,"open":1123639484,"close":1123917268,"volume":0.00347,"openTime":1786829400000,"closeTime":1786830299999,"tradeCount":4,"quoteVolume":3899087.9,"takerBuyVolume":0.00017,"takerBuyQuoteVolume":191065.93      },      {"low":1123925572,"date":"2026-08-15T21:45:00.000Z","high":1123925572,"open":1123925572,"close":1123925572,"volume":0.00127,"openTime":1786830300000,"closeTime":1786831199999,"tradeCount":1,"quoteVolume":1427385.47,"takerBuyVolume":0,"takerBuyQuoteVolume":0      },      {"low":1123671838,"date":"2026-08-15T22:00:00.000Z","high":1123931540,"open":1123931540,"close":1123671838,"volume":0.00205,"openTime":1786831200000,"closeTime":1786832099999,"tradeCount":44,"quoteVolume":2303927.04,"takerBuyVolume":0.00161,"takerBuyQuoteVolume":1809511.44      },      {"low":1123526294,"date":"2026-08-15T22:15:00.000Z","high":1125249663,"open":1123918687,"close":1123536529,"volume":0.01094,"openTime":1786832100000,"closeTime":1786832999999,"tradeCount":8,"quoteVolume":12304091.85,"takerBuyVolume":0.00897,"takerBuyQuoteVolume":10090743.12      },      {"low":1123648378,"date":"2026-08-15T22:30:00.000Z","high":1123648378,"open":1123648378,"close":1123648378,"volume":0.00003,"openTime":1786833000000,"closeTime":1786833899999,"tradeCount":1,"quoteVolume":33709.45,"takerBuyVolume":0,"takerBuyQuoteVolume":0      },      {"low":1123457394,"date":"2026-08-15T22:45:00.000Z","high":1125182518,"open":1123890961,"close":1123457394,"volume":0.00272,"openTime":1786833900000,"closeTime":1786834799999,"tradeCount":7,"quoteVolume":3056505,"takerBuyVolume":0.00092,"takerBuyQuoteVolume":1034110.85      },      {"low":1123457394,"date":"2026-08-15T23:00:00.000Z","high":1124010008,"open":1123981311,"close":1123982378,"volume":0.00266,"openTime":1786834800000,"closeTime":1786835699999,"tradeCount":46,"quoteVolume":2989712.71,"takerBuyVolume":0.00251,"takerBuyQuoteVolume":2821194.11      },      {"low":1123429622,"date":"2026-08-15T23:15:00.000Z","high":1123431185,"open":1123429622,"close":1123429622,"volume":0.01802,"openTime":1786835700000,"closeTime":1786836599999,"tradeCount":6,"quoteVolume":20244225.8,"takerBuyVolume":0,"takerBuyQuoteVolume":0      }    ],"quote":"IDR","symbol":"BTCIDR","dataset":"klines","endTime":1787279399999,"hasMore":true,"interval":"15m","nextPage":2,"provider":"tokocrypto","startTime":null  },"timestamp":"2026-08-21T02:26:02Z"}

Errors

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

Ticker

Tokocrypto 24-hour ticker — the only IDR book in this repo carrying bid and

GET/v1/finance:tokocrypto/ticker

passing · 0.4s10s cache

Parameters

Name	Type	In	Description
symbol	string	query	One symbol. Accepts BTCIDR, BTC_IDR or BTC/IDR. Omit to list every symbol.
quote	string	query	Restrict the list to this quote asset. Ignored when `symbol` is set.
query	string	query	Filter the list by symbol substring. Ignored when `symbol` is set.
page	number	query	Page number. Default 1.
count	number	query	Items per page. Default 100, max 500.

Example response

{"project":"finance:tokocrypto",  "data": {"page":1,"count":1,    "items": [      {"base":"BTC","pair":"BTC_IDR","type":"main","quote":"IDR","askQty":0.02811,"bidQty":0.04206,"symbol":"BTCIDR","volume":19.19794,"lastQty":0.00003,"askPrice":1322765665,"bidPrice":1321305370,"lowPrice":1222000000,"openTime":1787192764361,"closeTime":1787279164361,"highPrice":1336459176,"lastPrice":1320388680,"openPrice":1231613026,"tradeCount":4218,"lastTradeId":897237,"openTimeIso":"2026-08-20T02:26:04.361Z","priceChange":88775654,"quoteVolume":24512927167.4,"closeTimeIso":"2026-08-21T02:26:04.361Z","firstTradeId":893020,"prevClosePrice":1231691936,"weightedAvgPrice":1276851952.21,"priceChangePercent":7.208      }    ],"query":null,"quote":null,"total":1,"symbol":"BTCIDR","dataset":"ticker","hasMore":false,"nextPage":null,"provider":"tokocrypto"  },"timestamp":"2026-08-21T02:26:02Z"}

Errors

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

Symbols

Tokocrypto's own tradable list — symbol, precision and the order filters

GET/v1/finance:tokocrypto/symbols

passing · 0.2s10m cache

Parameters

Name	Type	In	Description
quote	string	query	Restrict to pairs quoted in this asset.
query	string	query	Filter by symbol substring.
type	enum	query	Listing type. `next` pairs are served by a different market host and are excluded by default. Default main. One of main, next, all.
page	number	query	Page number. Default 1.
count	number	query	Items per page. Default 100, max 500.

Example response

{"project":"finance:tokocrypto",  "data": {"page":1,"type":"main","count":29,    "items": [      {"base":"ADA","pair":"ADA_IDR","type":"main","quote":"IDR","maxQty":324354,"minQty":0.1,"symbol":"ADAIDR","maxPrice":284360,"minPrice":1,"stepSize":0.1,"tickSize":1,"ocoEnabled":true,        "orderTypes": [          "LIMIT",          "LIMIT_MAKER",          "MARKET"        ],"maxNotional":9000000000,"minNotional":20000,        "permissions": [          "SPOT"        ],"basePrecision":8,"icebergEnabled":true,"quotePrecision":2,"spotTradingEnabled":true,"marginTradingEnabled":false      },      {"base":"ARB","pair":"ARB_IDR","type":"main","quote":"IDR","maxQty":530991,"minQty":0.1,"symbol":"ARBIDR","maxPrice":173700,"minPrice":1,"stepSize":0.1,"tickSize":1,"ocoEnabled":true,        "orderTypes": [          "LIMIT",          "LIMIT_MAKER",          "MARKET"        ],"maxNotional":9000000000,"minNotional":20000,        "permissions": [          "SPOT"        ],"basePrecision":8,"icebergEnabled":true,"quotePrecision":2,"spotTradingEnabled":true,"marginTradingEnabled":false      },      {"base":"ASTER","pair":"ASTER_IDR","type":"main","quote":"IDR","maxQty":102481,"minQty":0.01,"symbol":"ASTERIDR","maxPrice":899999,"minPrice":1,"stepSize":0.01,"tickSize":1,"ocoEnabled":true,        "orderTypes": [          "LIMIT",          "LIMIT_MAKER",          "MARKET"        ],"maxNotional":9000000000,"minNotional":20000,        "permissions": [          "SPOT"        ],"basePrecision":8,"icebergEnabled":true,"quotePrecision":2,"spotTradingEnabled":true,"marginTradingEnabled":false      }    ],"query":null,"quote":"IDR","total":29,"dataset":"symbols","hasMore":false,"nextPage":null,"provider":"tokocrypto"  },"timestamp":"2026-08-21T02:26:02Z"}

Errors

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

Trades

Tokocrypto executed tape — every print carries its own quote value and the

GET/v1/finance:tokocrypto/trades

passing · 0.2s5s cache

Parameters

Name	Type	In	Description
symbol	string	query	Symbol. Accepts BTCIDR, BTC_IDR or BTC/IDR. Required.
limit	number	query	Number of recent trades. Default 100, max 1000.

Example response

{"project":"finance:tokocrypto",  "data": {"base":"BTC","pair":"BTC_IDR","count":100,    "items": [      {"side":"buy","price":1326712538,"value":13267.12,"amount":0.00001,"tradeId":"897138","tradedAt":1787277962406,"tradedAtIso":"2026-08-21T02:06:02.406Z"      },      {"side":"buy","price":1327212210,"value":26544.24,"amount":0.00002,"tradeId":"897139","tradedAt":1787277965501,"tradedAtIso":"2026-08-21T02:06:05.501Z"      },      {"side":"buy","price":1327212210,"value":53088.48,"amount":0.00004,"tradeId":"897140","tradedAt":1787277966309,"tradedAtIso":"2026-08-21T02:06:06.309Z"      },      {"side":"buy","price":1328023816,"value":39840.71,"amount":0.00003,"tradeId":"897141","tradedAt":1787277974821,"tradedAtIso":"2026-08-21T02:06:14.821Z"      },      {"side":"buy","price":1329407375,"value":39882.22,"amount":0.00003,"tradeId":"897142","tradedAt":1787277984133,"tradedAtIso":"2026-08-21T02:06:24.133Z"      },      {"side":"buy","price":1329407375,"value":13294.07,"amount":0.00001,"tradeId":"897143","tradedAt":1787277987109,"tradedAtIso":"2026-08-21T02:06:27.109Z"      },      {"side":"buy","price":1329407375,"value":93058.51,"amount":0.00007,"tradeId":"897144","tradedAt":1787277988811,"tradedAtIso":"2026-08-21T02:06:28.811Z"      },      {"side":"buy","price":1329407375,"value":159528.88,"amount":0.00012,"tradeId":"897145","tradedAt":1787277989208,"tradedAtIso":"2026-08-21T02:06:29.208Z"      }    ],"quote":"IDR","symbol":"BTCIDR","dataset":"trades","provider":"tokocrypto"  },"timestamp":"2026-08-21T02:26:02Z"}

Errors

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

Depth

Tokocrypto order book — bid and ask levels with SIZES, which is what

GET/v1/finance:tokocrypto/depth

slow · 0.4s5s cache

Parameters

Name	Type	In	Description
symbol	string	query	Symbol. Accepts BTCIDR, BTC_IDR or BTC/IDR. Required.
limit	number	query	Levels per side. Default 100, max 5000 — the exchange serves fewer when the book is thinner.

Example response

{"project":"finance:tokocrypto",  "data": {    "asks": [      {"price":1323368740,"value":44518124.41360001,"amount":0.03364      },      {"price":1323403539,"value":37200873.48129,"amount":0.02811      },      {"price":1323439081,"value":181231747.75214002,"amount":0.13694      },      {"price":1323439084,"value":1760173.98172,"amount":0.00133      },      {"price":1323581129,"value":264716.2258,"amount":0.0002      },      {"price":1324147359,"value":1761115.98747,"amount":0.00133      },      {"price":1324210976,"value":3535643.30592,"amount":0.00267      },      {"price":1324417401,"value":3536194.46067,"amount":0.00267      }    ],"base":"BTC",    "bids": [      {"price":1321305370,"value":55574103.8622,"amount":0.04206      },      {"price":1321238003,"value":110891505.59179,"amount":0.08393      },      {"price":1321157600,"value":55567888.656,"amount":0.04206      },      {"price":1321082456,"value":60029986.80064,"amount":0.04544      },      {"price":1320388681,"value":90631479.06384,"amount":0.06864      },      {"price":1320264101,"value":1755951.25433,"amount":0.00133      },      {"price":1319549693,"value":1755001.09169,"amount":0.00133      },      {"price":1319036954,"value":1754319.14882,"amount":0.00133      }    ],"pair":"BTC_IDR","quote":"IDR","spread":2063370,"symbol":"BTCIDR","dataset":"depth","askCount":100,"bidCount":100,"provider":"tokocrypto","lastUpdateId":243951922  },"timestamp":"2026-08-21T02:26:02Z"}

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:tokocrypto",  "agg-trades",  { symbol: "BTCIDR", limit: 100 });

Tokocrypto

Tokocrypto aggregated tape — consecutive fills of one taker order at one

6 endpoints394 calls6/6 passing

Get API key

GET/v1/…tokocrypto/agg-trades

passing · 0.8s5s cache

Try it

Parameters

symbol

string · query · required

Symbol. Accepts BTCIDR, BTC_IDR or BTC/IDR.

limit

number · query · optional

Number of recent aggregated trades. Default 100, max 1000.

Example response

{"project":"finance:tokocrypto",  "data": {"base":"BTC","pair":"BTC_IDR","count":100,    "items": [      {"side":"buy","price":1326185291,"value":66309.26455,"amount":0.00005,"tradedAt":1787277957618,"aggTradeId":"839944","lastTradeId":"897133","tradedAtIso":"2026-08-21T02:05:57.618Z","firstTradeId":"897133"      },      {"side":"buy","price":1326185291,"value":13261.85291,"amount":0.00001,"tradedAt":1787277958311,"aggTradeId":"839945","lastTradeId":"897134","tradedAtIso":"2026-08-21T02:05:58.311Z","firstTradeId":"897134"      },      {"side":"buy","price":1326712538,"value":39801.37614,"amount":0.00003,"tradedAt":1787277958704,"aggTradeId":"839946","lastTradeId":"897135","tradedAtIso":"2026-08-21T02:05:58.704Z","firstTradeId":"897135"      },      {"side":"buy","price":1326712538,"value":13267.12538,"amount":0.00001,"tradedAt":1787277959308,"aggTradeId":"839947","lastTradeId":"897136","tradedAtIso":"2026-08-21T02:05:59.308Z","firstTradeId":"897136"      },      {"side":"buy","price":1326712538,"value":13267.12538,"amount":0.00001,"tradedAt":1787277960302,"aggTradeId":"839948","lastTradeId":"897137","tradedAtIso":"2026-08-21T02:06:00.302Z","firstTradeId":"897137"      },      {"side":"buy","price":1326712538,"value":13267.12538,"amount":0.00001,"tradedAt":1787277962406,"aggTradeId":"839949","lastTradeId":"897138","tradedAtIso":"2026-08-21T02:06:02.406Z","firstTradeId":"897138"      },      {"side":"buy","price":1327212210,"value":26544.2442,"amount":0.00002,"tradedAt":1787277965501,"aggTradeId":"839950","lastTradeId":"897139","tradedAtIso":"2026-08-21T02:06:05.501Z","firstTradeId":"897139"      },      {"side":"buy","price":1327212210,"value":53088.4884,"amount":0.00004,"tradedAt":1787277966309,"aggTradeId":"839951","lastTradeId":"897140","tradedAtIso":"2026-08-21T02:06:06.309Z","firstTradeId":"897140"      }    ],"quote":"IDR","symbol":"BTCIDR","dataset":"agg-trades","provider":"tokocrypto"  },"timestamp":"2026-08-21T02:26:02Z"}

Errors

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

Code

const data = await client.run(  "finance:tokocrypto",  "agg-trades",  { symbol: "BTCIDR", limit: 100 });