Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalog, 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 catalog yet?

Yes, through the community Discord, on any tier.

Why are Pro and Ultra marked Soon?

Checkout is not open yet. The limits and features listed on those tiers are already built and enforced — what is pending is billing, not the product.

Histdata

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

Endpoints: 5
Requests: 428
Updated: 5 hours ago
For LLMs: llms.txt

Endpoint healthnot yet measured

coveragenot measured
gap-reportnot measured
list-instrumentsnot measured
download-m1not measured
download-ticknot measured

no measurements yetdaily 01:00 WIB

Playground

5 endpoints

GET/v1/finance:histdata/coverage1d cache2 paramschecking key…

Parameters

Response

EXAMPLE

{
  "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"
}

Code examples

Coverage

zpi-sdkrecommended

// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

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

Full SDK reference →

cURL

request.sh

curl -X GET "https://api.zpi.web.id/v1/finance:histdata/coverage?pair=XAUUSD&timeframe=m1" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

5 endpoints · plain text

GETCoverage/v1/finance:histdata/coverageWhich years exist for a pair, and in what unit each is served. HistData chunks

Parameters

pairstringrequired: Instrument code as HistData spells it, e.g. XAUUSD, EURUSD, SPXUSD.
timeframeenumoptional: m1 (1-minute bars) or tick. Default m1. Values: m1, tick.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:histdata/coverage?pair=XAUUSD&timeframe=m1" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
}

GETGap Report/v1/finance:histdata/gap-reportHistData's own audit of where its data is missing, for one file. Cheap — it is

Parameters

pairstringrequired: Instrument code as HistData spells it.
yearnumberrequired: Calendar year of the file. The current year has no report until it closes.
monthnumberoptional: Month 1-12. Required for tick and for the current year; omit for a closed year of M1.
timeframeenumoptional: m1 (1-minute bars) or tick. Default m1. Values: m1, tick.
sessionBreaksenumoptional: Whether to keep the daily 17:00-18:00 EST rollover gaps. Default exclude. Values: include, exclude.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:histdata/gap-report?pair=XAUUSD&year=2024&month=7&timeframe=m1&sessionBreaks=exclude" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}

GETList Instruments/v1/finance:histdata/list-instrumentsEvery instrument HistData publishes, with the month its history starts.

Parameters

timeframeenumoptional: Which index to read: m1 (1-minute bars) or tick. Default m1. Values: m1, tick.
querystringoptional: Filter by instrument code or display name, case-insensitive.
pagenumberoptional: Page of instruments. Default 1.
limitnumberoptional: Instruments per page. Default 50, max 100.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:histdata/list-instruments?timeframe=m1&query=xau&page=1&limit=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
}

GETDownload M1/v1/finance:histdata/download-m1One-minute OHLC bars from HistData — the fallback book behind `finance/dukascopy`

Parameters

pairstringrequired: Instrument code as HistData spells it. XAUUSD starts 2009-03.
yearnumberrequired: Calendar year to download.
monthnumberoptional: Month 1-12. Required for the current year, which ships month by month; narrows a closed year.
pagenumberoptional: Page of bars. Default 1.
limitnumberoptional: Bars per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:histdata/download-m1?pair=XAUUSD&year=2023&month=7&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
}

GETDownload Tick/v1/finance:histdata/download-tickTick quotes from HistData — bid AND ask, so a real spread per tick, which the

Parameters

pairstringrequired: Instrument code as HistData spells it. XAUUSD starts 2009-03.
datestringrequired: One trading day, YYYY-MM-DD. A whole tick month is millions of rows and is never served at once.
pagenumberoptional: Page of ticks. Default 1.
limitnumberoptional: Ticks per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:histdata/download-tick?pair=XAUUSD&date=2026-07-15&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
}

{ "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" }

// npm i zpi-sdk import { ZpiClient } from "zpi-sdk"; const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" }); const data = await client.run("finance:histdata", "coverage", { "pair": "XAUUSD", "timeframe": "m1" }); console.log(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 }

{ "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" }

{ "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" }

{ "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" }

Playground

Code examples

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

Pluang

Binance Vision

TradingView

Stockbit

Mempool Space

Etherscan

Playground

Code examples

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

Pluang

Binance Vision

TradingView

Stockbit

Mempool Space

Etherscan