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.

Histdata

Which years exist for a pair, and in what unit each is served. HistData chunks

5 endpoints502 calls3/5 passing

Get API key

Coverage

GET/v1/finance:histdata/coverage

passing · 1.1s1d cache

Parameters

Name	Type	In	Description
pair	string	query	Instrument code as HistData spells it, e.g. XAUUSD, EURUSD, SPXUSD. Required.
timeframe	enum	query	m1 (1-minute bars) or tick. Default m1. One of m1, tick.

Example response

{"project":"finance:histdata",  "data": {"pair":"XAUUSD","count":18,    "items": [      {"unit":"month","year":2026,        "months": [          1,          2,          3,          4,          5,          6,          7,          8        ]      },      {"unit":"year","year":2025,"months":[]      },      {"unit":"year","year":2024,"months":[]      },      {"unit":"year","year":2023,"months":[]      },      {"unit":"year","year":2022,"months":[]      },      {"unit":"year","year":2021,"months":[]      },      {"unit":"year","year":2020,"months":[]      },      {"unit":"year","year":2019,"months":[]      }    ],"dataset":"coverage","lastYear":2026,"provider":"histdata","firstYear":2009,"timeframe":"m1"  },"timestamp":"2026-08-21T02:23:28Z"}

Errors

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

Gap Report

HistData's own audit of where its data is missing, for one file. Cheap — it is

GET/v1/finance:histdata/gap-report

passing · 1.2s1d cache

Parameters

Name	Type	In	Description
pair	string	query	Instrument code as HistData spells it. Required.
year	number	query	Calendar year of the file. The current year has no report until it closes. Required.
month	number	query	Month 1-12. Required for tick and for the current year; omit for a closed year of M1.
timeframe	enum	query	m1 (1-minute bars) or tick. Default m1. One of m1, tick.
sessionBreaks	enum	query	Whether to keep the daily 17:00-18:00 EST rollover gaps. Default exclude. One of include, exclude.

Example response

{"project":"finance:histdata",  "data": {"file":"DAT_ASCII_XAUUSD_M1_2024.csv","pair":"XAUUSD","year":2024,"count":5,    "items": [      {"to":"2024-04-10T18:01:06-05:00","from":"2024-04-10T16:59:59-05:00","seconds":3660,"sessionBreak":false      },      {"to":"2024-10-09T20:11:48-05:00","from":"2024-10-09T19:05:51-05:00","seconds":3951,"sessionBreak":false      },      {"to":"2024-11-21T18:00:00-05:00","from":"2024-11-21T16:59:34-05:00","seconds":3619,"sessionBreak":false      },      {"to":"2024-12-11T18:02:01-05:00","from":"2024-12-11T16:59:59-05:00","seconds":3715,"sessionBreak":false      },      {"to":"2024-12-26T18:05:00-05:00","from":"2024-12-26T16:59:59-05:00","seconds":3894,"sessionBreak":false      }    ],"month":null,"dataset":"gap-report","provider":"histdata","timezone":"EST-no-DST","timeframe":"M1","totalGaps":313,"sessionBreaks":"exclude","sessionBreakGaps":308,"longestGapSeconds":3951  },"timestamp":"2026-08-21T02:23:28Z"}

Errors

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

List Instruments

Every instrument HistData publishes, with the month its history starts.

GET/v1/finance:histdata/list-instruments

passing · 0.9s1d cache

Parameters

Name	Type	In	Description
timeframe	enum	query	Which index to read: m1 (1-minute bars) or tick. Default m1. One of m1, tick.
query	string	query	Filter by instrument code or display name, case-insensitive.
page	number	query	Page of instruments. Default 1.
limit	number	query	Instruments per page. Default 50, max 100.

Example response

{"project":"finance:histdata",  "data": {"page":1,"count":50,    "items": [      {"name":"EUR/USD","pair":"EURUSD","startsAt":"2000-05","startYear":2000,"startMonth":5      },      {"name":"EUR/CHF","pair":"EURCHF","startsAt":"2002-03","startYear":2002,"startMonth":3      },      {"name":"EUR/GBP","pair":"EURGBP","startsAt":"2002-03","startYear":2002,"startMonth":3      },      {"name":"EUR/JPY","pair":"EURJPY","startsAt":"2002-03","startYear":2002,"startMonth":3      },      {"name":"EUR/AUD","pair":"EURAUD","startsAt":"2002-08","startYear":2002,"startMonth":8      },      {"name":"USD/CAD","pair":"USDCAD","startsAt":"2000-06","startYear":2000,"startMonth":6      },      {"name":"USD/CHF","pair":"USDCHF","startsAt":"2000-05","startYear":2000,"startMonth":5      },      {"name":"USD/JPY","pair":"USDJPY","startsAt":"2000-05","startYear":2000,"startMonth":5      }    ],"query":null,"total":66,"dataset":"instruments","hasMore":true,"nextPage":2,"provider":"histdata","timeframe":"m1"  },"timestamp":"2026-08-21T02:23:28Z"}

Errors

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

Download M1

One-minute OHLC bars from HistData — the fallback book behind `finance/dukascopy`

GET/v1/finance:histdata/download-m1

failed last check1d cache

Parameters

Name	Type	In	Description
pair	string	query	Instrument code as HistData spells it. XAUUSD starts 2009-03. Required.
year	number	query	Calendar year to download. Required.
month	number	query	Month 1-12. Required for the current year, which ships month by month; narrows a closed year.
page	number	query	Page of bars. Default 1.
limit	number	query	Bars per page. Default 5000, max 20000.

Example response

{"project":"finance:histdata",  "data": {"file":"DAT_ASCII_XAUUSD_M1_2023.csv","page":1,"pair":"XAUUSD","unit":"year","year":2023,"count":5000,    "items": [      {"low":1826.617,"high":1827.337,"open":1826.837,"time":"2023-01-02T18:00:00-05:00","close":1826.637      },      {"low":1826.137,"high":1827.357,"open":1826.537,"time":"2023-01-02T18:01:00-05:00","close":1826.537      },      {"low":1826.137,"high":1826.737,"open":1826.137,"time":"2023-01-02T18:02:00-05:00","close":1826.737      },      {"low":1827.187,"high":1828.867,"open":1827.187,"time":"2023-01-02T18:05:00-05:00","close":1828.738      },      {"low":1828.758,"high":1829.958,"open":1828.758,"time":"2023-01-02T18:06:00-05:00","close":1829.497      },      {"low":1828.117,"high":1829.507,"open":1829.497,"time":"2023-01-02T18:07:00-05:00","close":1829.397      },      {"low":1828.718,"high":1829.357,"open":1829.357,"time":"2023-01-02T18:08:00-05:00","close":1829.277      },      {"low":1828.757,"high":1829.488,"open":1829.277,"time":"2023-01-02T18:09:00-05:00","close":1829.298      }    ],"month":null,"total":308812,"dataset":"m1","hasMore":true,"nextPage":2,"provider":"histdata","timezone":"EST-no-DST","priceSide":"bid","timeframe":"M1"  },"timestamp":"2026-08-21T02:23:28Z"}

Errors

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

Download Tick

Tick quotes from HistData — bid AND ask, so a real spread per tick, which the

GET/v1/finance:histdata/download-tick

failed last check1d cache

Parameters

Name	Type	In	Description
pair	string	query	Instrument code as HistData spells it. XAUUSD starts 2009-03. Required.
date	string	query	One trading day, YYYY-MM-DD. A whole tick month is millions of rows and is never served at once. Required.
page	number	query	Page of ticks. Default 1.
limit	number	query	Ticks per page. Default 5000, max 20000.

Example response

{"project":"finance:histdata",  "data": {"date":"2026-07-15","file":"DAT_ASCII_XAUUSD_T_202607.csv","page":1,"pair":"XAUUSD","unit":"month","count":5000,    "items": [      {"ask":4031.865,"bid":4031.085,"time":"2026-07-15T00:00:00.000-05:00","spread":0.78      },      {"ask":4031.865,"bid":4031.065,"time":"2026-07-15T00:00:00.000-05:00","spread":0.8      },      {"ask":4031.905,"bid":4031.185,"time":"2026-07-15T00:00:00.000-05:00","spread":0.72      },      {"ask":4031.905,"bid":4031.145,"time":"2026-07-15T00:00:00.000-05:00","spread":0.76      },      {"ask":4031.875,"bid":4031.165,"time":"2026-07-15T00:00:00.000-05:00","spread":0.71      },      {"ask":4031.875,"bid":4031.105,"time":"2026-07-15T00:00:00.000-05:00","spread":0.77      },      {"ask":4031.875,"bid":4031.085,"time":"2026-07-15T00:00:00.000-05:00","spread":0.79      },      {"ask":4031.745,"bid":4030.945,"time":"2026-07-15T00:00:00.000-05:00","spread":0.8      }    ],"total":379210,"dataset":"tick","hasMore":true,"nextPage":2,"provider":"histdata","timezone":"EST-no-DST","timeframe":"T"  },"timestamp":"2026-08-21T02:23:28Z"}

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:histdata",  "coverage",  { pair: "XAUUSD", timeframe: "m1" });

Histdata

Which years exist for a pair, and in what unit each is served. HistData chunks

5 endpoints502 calls3/5 passing

Get API key

GET/v1/…histdata/coverage

passing · 1.1s1d cache

Try it

Parameters

pair

string · query · required

Instrument code as HistData spells it, e.g. XAUUSD, EURUSD, SPXUSD.

timeframe

enum · query · optional

m1 (1-minute bars) or tick. Default m1.

Example response

{"project":"finance:histdata",  "data": {"pair":"XAUUSD","count":18,    "items": [      {"unit":"month","year":2026,        "months": [          1,          2,          3,          4,          5,          6,          7,          8        ]      },      {"unit":"year","year":2025,"months":[]      },      {"unit":"year","year":2024,"months":[]      },      {"unit":"year","year":2023,"months":[]      },      {"unit":"year","year":2022,"months":[]      },      {"unit":"year","year":2021,"months":[]      },      {"unit":"year","year":2020,"months":[]      },      {"unit":"year","year":2019,"months":[]      }    ],"dataset":"coverage","lastYear":2026,"provider":"histdata","firstYear":2009,"timeframe":"m1"  },"timestamp":"2026-08-21T02:23:28Z"}

Errors

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

Code

const data = await client.run(  "finance:histdata",  "coverage",  { pair: "XAUUSD", timeframe: "m1" });