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.

MacroMicro

Macro and market charts, indicators, calendars and 13F filings from MacroMicro.

llms.txt

Chart

Series values, render config and the source stat ids behind them, for up to 12 charts in one call.

GET/v1/finance:macromicro/chart/:id1h cache4 paramschecking key…

Parameters

Response

EXAMPLE

{
  "to": null,
  "from": "2015-01-01",
  "count": 2,
  "items": [
    {
      "url": "https://en.macromicro.me/charts/55744/global-citi-earnings-revision-index",
      "slug": "global-citi-earnings-revision-index",
      "type": 1,
      "nameEn": "World - Citi Earnings Revision Index",
      "nameSc": "全球-花旗盈利修正指数",
      "nameTc": "全球-花旗盈利修正指數",
      "series": [
        {
          "color": "#3bafda",
          "count": 8,
          "stats": [
            {
              "units": "idx",
              "nameEn": "World - Citigroup Earnings Revision Index",
              "nameSc": "全球-花旗盈利修正指数",
              "nameTc": "全球-花旗盈利修正指數",
              "statId": 22951,
              "category": 21,
              "frequency": "W",
              "operation": "lin",
              "categoryV2": 100003,
              "aggregation": "eop",
              "frequencyName": "Weekly",
              "unitsOriginal": "idx",
              "frequencyOriginal": "W"
            }
          ],
          "total": 607,
          "units": "idx",
          "nameEn": "World",
          "nameSc": "全球-花旗盈利修正指数",
          "nameTc": "全球-花旗盈利修正指數",
          "axisType": "linear",
          "lastDate": "2026-08-14",
          "lineType": "column",
          "firstDate": "2015-01-04",
          "frequency": "W",
          "lineWidth": 2,
          "operation": "lin",
          "axisOffset": 0,
          "axisPosition": 1,
          "axisReversed": false,
          "observations": [
            {
              "date": "2026-08-14",
              "value": 0.18
            }
          ],
          "frequencyName": "Weekly",
          "unitsOriginal": "idx",
          "frequencyOriginal": "W"
        }
      ],
      "chartId": 55744,
      "seriesCount": 4,
      "sortBarChart": false,
      "descriptionEn": "The Citi Earnings Revision Index is calculated as “Proportion of Companies Revising EPS (%)” − “Proportion of Companies Revising EPS Down (%)” (compared to last week). When the ind…",
      "descriptionSc": "花旗盈利修正指数计算方式为「上调 EPS 的公司比例（%）」−「下调 EPS 的公司比例（%）」（与上周相比）。该指数位于零轴之上时，代表平均而言分析师对于企业盈利展望持乐观态度，反之则表示相对而言分析师持较悲观看法。",
      "descriptionTc": "花旗盈利修正指數計算方式為「上調 EPS 的公司比例（%）」−「下調 EPS 的公司比例（%）」（與上週相比）。該指數位於零軸之上時，代表平均而言分析師對於企業盈利展望持樂觀態度，反之則表示相對而言分析師持較悲觀看法。",
      "valueDecimals": 2
    }
  ],
  "total": 2,
  "charts": [
    55744
  ],
  "length": 8,
  "dataset": "chart",
  "missing": [],
  "provider": "macromicro",
  "resolved": [
    55744
  ]
}

Code

Chart

index.ts

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

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

const data = await client.run("finance:macromicro", "chart", {
  "id": "55744",
  "from": "2020-01-01",
  "to": "2026-08-29",
  "length": 100
});
console.log(data);

Recommended · typed errors, safe retries and bulk jobsSDK reference

Full reference

10 endpoints · plain text

GET

Chart/v1/finance:macromicro/chart/:id

4 params

Series values, render config and the source stat ids behind them, for up to 12 charts in one call.

Parameters

idstringrequiredin path: Chart ids, comma-separated, up to 12. Take them from charts, collection or market.
fromstringoptional: Drop observations before this date, YYYY-MM-DD.
tostringoptional: Drop observations after this date, YYYY-MM-DD.
lengthnumberoptional: Observations per series, newest first (default 100, max 20000)

Request

curl -X GET "https://api.zapi.ink/v1/finance:macromicro/chart/55744?from=2020-01-01&to=2026-08-29&length=100" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "to": null,
  "from": "2015-01-01",
  "count": 2,
  "items": [
    {
      "url": "https://en.macromicro.me/charts/55744/global-citi-earnings-revision-index",
      "slug": "global-citi-earnings-revision-index",
      "type": 1,
      "nameEn": "World - Citi Earnings Revision Index",
      "nameSc": "全球-花旗盈利修正指数",
      "nameTc": "全球-花旗盈利修正指數",
      "series": [
        {
          "color": "#3bafda",
          "count": 8,
          "stats": [
            {
              "units": "idx",
              "nameEn": "World - Citigroup Earnings Revision Index",
              "nameSc": "全球-花旗盈利修正指数",
              "nameTc": "全球-花旗盈利修正指數",
              "statId": 22951,
              "category": 21,
              "frequency": "W",
              "operation": "lin",
              "categoryV2": 100003,
              "aggregation": "eop",
              "frequencyName": "Weekly",
              "unitsOriginal": "idx",
              "frequencyOriginal": "W"
            }
          ],
          "total": 607,
          "units": "idx",
          "nameEn": "World",
          "nameSc": "全球-花旗盈利修正指数",
          "nameTc": "全球-花旗盈利修正指數",
          "axisType": "linear",
          "lastDate": "2026-08-14",
          "lineType": "column",
          "firstDate": "2015-01-04",
          "frequency": "W",
          "lineWidth": 2,
          "operation": "lin",
          "axisOffset": 0,
          "axisPosition": 1,
          "axisReversed": false,
          "observations": [
            {
              "date": "2026-08-14",
              "value": 0.18
            }
          ],
          "frequencyName": "Weekly",
          "unitsOriginal": "idx",
          "frequencyOriginal": "W"
        }
      ],
      "chartId": 55744,
      "seriesCount": 4,
      "sortBarChart": false,
      "descriptionEn": "The Citi Earnings Revision Index is calculated as “Proportion of Companies Revising EPS (%)” − “Proportion of Companies Revising EPS Down (%)” (compared to last week). When the ind…",
      "descriptionSc": "花旗盈利修正指数计算方式为「上调 EPS 的公司比例（%）」−「下调 EPS 的公司比例（%）」（与上周相比）。该指数位于零轴之上时，代表平均而言分析师对于企业盈利展望持乐观态度，反之则表示相对而言分析师持较悲观看法。",
      "descriptionTc": "花旗盈利修正指數計算方式為「上調 EPS 的公司比例（%）」−「下調 EPS 的公司比例（%）」（與上週相比）。該指數位於零軸之上時，代表平均而言分析師對於企業盈利展望持樂觀態度，反之則表示相對而言分析師持較悲觀看法。",
      "valueDecimals": 2
    }
  ],
  "total": 2,
  "charts": [
    55744
  ],
  "length": 8,
  "dataset": "chart",
  "missing": [],
  "provider": "macromicro",
  "resolved": [
    55744
  ]
}

GET

Charts/v1/finance:macromicro/charts

4 params

The full chart catalogue — id, slug and URL for every chart the site publishes.

Parameters

querystringoptional: Keep only charts whose slug contains this text.
countrystringoptional: Keep only charts whose slug starts with this country prefix.
pagenumberoptional: Result page (default 1)
countnumberoptional: Charts per page (default 100, max 500)

Request

curl -X GET "https://api.zapi.ink/v1/finance:macromicro/charts?query=inflation&country=us&page=1&count=100" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "page": 1,
  "count": 8,
  "items": [
    {
      "url": "https://en.macromicro.me/charts/152511/us-pce-price-index-change-in-inflation-distribution",
      "slug": "us-pce-price-index-change-in-inflation-distribution",
      "chartId": 152511
    },
    {
      "url": "https://en.macromicro.me/charts/152510/us-pce-price-index-inflation-distribution",
      "slug": "us-pce-price-index-inflation-distribution",
      "chartId": 152510
    },
    {
      "url": "https://en.macromicro.me/charts/152487/us-inflation-shock-momentum-index",
      "slug": "us-inflation-shock-momentum-index",
      "chartId": 152487
    },
    {
      "url": "https://en.macromicro.me/charts/151992/us-trimmed-mean-inflation",
      "slug": "us-trimmed-mean-inflation",
      "chartId": 151992
    },
    {
      "url": "https://en.macromicro.me/charts/147683/us-money-supply-and-inflation-vs-gold",
      "slug": "us-money-supply-and-inflation-vs-gold",
      "chartId": 147683
    },
    {
      "url": "https://en.macromicro.me/charts/131622/us-cleveland-fed-expected-inflation",
      "slug": "us-cleveland-fed-expected-inflation",
      "chartId": 131622
    },
    {
      "url": "https://en.macromicro.me/charts/131621/us-new-york-fed-expected-inflation",
      "slug": "us-new-york-fed-expected-inflation",
      "chartId": 131621
    },
    {
      "url": "https://en.macromicro.me/charts/116478/us-the-number-of-mentions-of-inflation-in-all-industry",
      "slug": "us-the-number-of-mentions-of-inflation-in-all-industry",
      "chartId": 116478
    }
  ],
  "query": "inflation",
  "total": 20,
  "country": "us",
  "dataset": "charts",
  "hasMore": true,
  "nextPage": 2,
  "provider": "macromicro"
}

GET

Series Search/v1/finance:macromicro/series-search

7 params

Search the indicator directory: 66,000+ series with country, frequency, units and currency.

Parameters

querystringoptional: Free-text match against the indicator name.
countrystringoptional: Two-letter country code.
categorystringoptional: Category id.
categoryParentstringoptional: Parent category id.
slugstringoptional: Exact indicator slug.
pagenumberoptional: Result page (default 1)
countnumberoptional: Rows per page (default 100, max 500)

Request

curl -X GET "https://api.zapi.ink/v1/finance:macromicro/series-search?query=inflation&country=us&category=21&categoryParent=100003&slug=realgdp&page=1&count=100" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "page": 1,
  "count": 8,
  "items": [
    {
      "name": "US - Gold - Commercial Net Position",
      "slug": "cot-gold-commercial",
      "statId": 3070,
      "country": "us",
      "frequency": "W",
      "unitsName": "Number",
      "countryName": "United States",
      "frequencyName": "Weekly"
    },
    {
      "name": "US - Gold - Non Commercial Net Position",
      "slug": "cot-gold-noncommercial",
      "statId": 3071,
      "country": "us",
      "frequency": "W",
      "unitsName": "Number",
      "countryName": "United States",
      "frequencyName": "Weekly"
    },
    {
      "name": "Gold COT Index",
      "slug": "gold-cot-index",
      "units": "idx",
      "statId": 3351,
      "country": "us",
      "frequency": "W",
      "unitsName": "Index",
      "countryName": "United States",
      "frequencyName": "Weekly"
    }
  ],
  "query": "gold",
  "total": 225,
  "country": "us",
  "dataset": "series-search",
  "hasMore": true,
  "category": null,
  "nextPage": 2,
  "provider": "macromicro"
}

GET

Collection/v1/finance:macromicro/collection/:id

2 params

One curated collection and every chart in it, in the site's own order.

Parameters

idstringrequiredin path: Collection id. Take it from a collection URL.
slugstringoptional: Collection slug. Optional — the id decides which collection you get.

Request

curl -X GET "https://api.zapi.ink/v1/finance:macromicro/collection/3208?slug=high-frequency-data" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "url": "https://en.macromicro.me/collections/3208/high-frequency-data",
  "name": "High Frequency Data",
  "slug": "high-frequency-data",
  "count": 12,
  "items": [
    {
      "url": "https://en.macromicro.me/charts/22281/flight-tracking",
      "slug": "flight-tracking",
      "type": 1,
      "state": "active",
      "nameEn": "World - Global Flight Tracking",
      "chartId": 22281,
      "updatedAt": "2025-05-19T17:20:18.000Z",
      "viewCount": 0,
      "commentCount": 3,
      "bookmarkCount": 216,
      "descriptionEn": "The number of daily flights is calculated by Flightradar counting the number of flights on the website.\n\nCommercial flights: Commercial passenger flights + cargo flights + charter …",
      "isMembersOnly": false
    },
    {
      "url": "https://en.macromicro.me/charts/26114/us-tsa-checkpoint",
      "slug": "us-tsa-checkpoint",
      "type": 1,
      "state": "active",
      "nameEn": "US - TSA Checkpoint Travel Numbers",
      "chartId": 26114,
      "country": "us",
      "updatedAt": "2023-08-30T04:29:21.000Z",
      "viewCount": 0,
      "commentCount": 0,
      "bookmarkCount": 42,
      "descriptionEn": "This chart shows the headcount of travelers everyday at the US borders and the changes in the number of travelers since the pandemic hit.",
      "isMembersOnly": false
    },
    {
      "url": "https://en.macromicro.me/charts/947/commodity-ccfi-scfi",
      "slug": "commodity-ccfi-scfi",
      "type": 1,
      "state": "active",
      "nameEn": "China - Global & Shanghai Export Containerized Freight Index",
      "chartId": 947,
      "country": "cn",
      "updatedAt": "2026-04-04T09:10:17.000Z",
      "viewCount": 0,
      "commentCount": 11,
      "bookmarkCount": 1238,
      "descriptionEn": "First released in 1998 by the Shanghai Shipping Exchange, the China Export Containerized Freight Index (CCFI) is based on the freight rate and shipped volume of 12 selected trade r…",
      "isMembersOnly": false
    }
  ],
  "total": 12,
  "country": null,
  "dataset": "collection",
  "chartIds": [
    22281,
    26114,
    947
  ],
  "isPublic": true,
  "language": "tc",
  "provider": "macromicro",
  "createdAt": "2020-10-30T09:33:13.000Z",
  "updatedAt": "2025-07-06T07:41:58.000Z",
  "coverStatId": 7250,
  "description": "High frequency data",
  "collectionId": 3208,
  "isSearchable": true,
  "isMembersOnly": false
}

GET

Market/v1/finance:macromicro/market/:category

2 params

Live quotes for one asset class with six percentage-change windows and 380 days of raw values.

Parameters

categoryenumrequiredin path: Asset class: stocks, forex, bonds, etf, crypto, volatility, cds, commodities. Values: stocks, forex, bonds, etf, crypto, volatility, cds, commodities.
historyenumoptional: Include the 380-day raw value series on every quote. Default false. Values: true, false.

Request

curl -X GET "https://api.zapi.ink/v1/finance:macromicro/market/commodities?history=false" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 54,
  "items": [
    {
      "name": "Crude Oil (WTI)",
      "group": 1,
      "statId": 486,
      "altName": "Crude Oil (WTI)",
      "chartId": 888,
      "history": [
        {
          "date": "2025-08-14",
          "value": 63.96
        }
      ],
      "chartUrl": "https://en.macromicro.me/charts/888/commodity-wti",
      "position": 3,
      "statName": "NYMEX - WTI Crude Oil Futures Price",
      "chartSlug": "commodity-wti",
      "chartType": 1,
      "viewCount": 0,
      "chartState": "active",
      "pctChanges": {
        "1D": [
          {
            "date": "2026-08-28",
            "value": 83.4,
            "changePercent": -0.16
          }
        ],
        "1M": [
          {
            "date": "2026-08-28",
            "value": 83.4,
            "changePercent": -1.26
          }
        ],
        "1W": [
          {
            "date": "2026-08-28",
            "value": 83.4,
            "changePercent": -4.2
          }
        ],
        "1Y": [
          {
            "date": "2026-08-28",
            "value": 83.4,
            "changePercent": 30.29
          }
        ],
        "6M": [
          {
            "date": "2026-08-28",
            "value": 83.4,
            "changePercent": 15.85
          }
        ],
        "YTD": [
          {
            "date": "2026-08-28",
            "value": 83.4,
            "changePercent": 45.07
          }
        ]
      },
      "chartNameEn": "WTI Crude Oil",
      "chartCountry": "us",
      "commentCount": 1,
      "statCategory": 22,
      "bookmarkCount": 168,
      "isMembersOnly": false,
      "chartUpdatedAt": "2026-06-08T06:43:17.000Z",
      "imageUpdatedAt": "2026-08-28T22:59:38.000Z",
      "chartDescription": "Market: New York Mercantile Exchange (NYMEX)\nContract Size: 1000 barrels\nPrice Quotation: USD/barrel"
    }
  ],
  "total": 54,
  "groups": 6,
  "dataset": "market",
  "category": "commodities",
  "provider": "macromicro",
  "updatedAt": "2022-11-29T10:13:11.000Z"
}

GET

Calendar Macro/v1/finance:macromicro/calendar-macro

2 params

Scheduled macro data releases for the window around a date.

Parameters

datestringoptional: Any date inside the month you want, YYYY-MM-DD. Defaults to today.
countrystringoptional: Keep only releases for this two-letter country code.

Request

curl -X GET "https://api.zapi.ink/v1/finance:macromicro/calendar-macro?date=2026-08-29&country=us" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "to": "2026-09-09T16:00:00.000Z",
  "date": "2026-08-29",
  "from": "2026-07-21T16:00:00.000Z",
  "count": 53,
  "items": [
    {
      "url": "https://en.macromicro.me/collections/4/us-employ-relative/19/initial-jobless-claims",
      "name": "US Initial & Continuing Jobless Claims",
      "statId": 34,
      "country": "us",
      "eventId": 16,
      "groupId": 1190,
      "onFront": true,
      "isPublic": true,
      "createdAt": "2020-04-08T07:36:16.000Z",
      "updatedAt": "2023-01-12T09:48:23.000Z",
      "onCalendar": true,
      "releasedAt": "2026-07-23T12:30:00.000Z",
      "onQuickview": true,
      "releasedAtEpoch": 1784809800
    },
    {
      "url": "https://en.macromicro.me/collections/7/us-housing-relative/34/new-house-price",
      "name": "US Supply and Demand of New Homes",
      "statId": 252,
      "country": "us",
      "eventId": 36,
      "groupId": 86,
      "onFront": true,
      "isPublic": true,
      "createdAt": "2020-04-08T07:36:16.000Z",
      "updatedAt": "2026-03-23T04:20:44.000Z",
      "onCalendar": false,
      "releasedAt": "2026-07-24T14:00:00.000Z",
      "onQuickview": true,
      "relatedCharts": [
        31,
        32,
        34
      ],
      "releasedAtEpoch": 1784901600
    },
    {
      "url": "https://en.macromicro.me/collections/8/us-industry-relative/3/durable-goods",
      "name": "US Durable Goods Orders",
      "statId": 321,
      "country": "us",
      "eventId": 35,
      "groupId": 55,
      "onFront": false,
      "isPublic": true,
      "createdAt": "2020-04-08T07:36:16.000Z",
      "updatedAt": "2026-03-23T04:20:44.000Z",
      "onCalendar": false,
      "releasedAt": "2026-07-27T12:30:00.000Z",
      "onQuickview": true,
      "releasedAtEpoch": 1785155400
    }
  ],
  "total": 212,
  "country": "us",
  "dataset": "calendar-macro",
  "provider": "macromicro"
}

GET

Calendar Earnings/v1/finance:macromicro/calendar-earnings

2 params

Earnings calendar with ticker, fiscal period, market cap and logo.

Parameters

datestringoptional: Any date inside the window you want, YYYY-MM-DD. Defaults to today.
symbolstringoptional: Keep only this ticker.

Request

curl -X GET "https://api.zapi.ink/v1/finance:macromicro/calendar-earnings?date=2026-08-29&symbol=AAPL" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "to": "2026-09-10",
  "date": "2026-08-29",
  "from": "2026-07-22",
  "count": 434,
  "items": [
    {
      "date": "2026-07-22",
      "logo": "https://cdn.macromicro.me/stocks/logo/T/TEL-2bac1695.png",
      "name": "TE CONNECTIVITY PLC",
      "time": "01:00",
      "symbol": "TEL",
      "earningId": 12820,
      "marketCap": 58974060000,
      "fiscalYear": 2026,
      "industryId": 452030,
      "fiscalPeriod": "Q2"
    },
    {
      "date": "2026-07-22",
      "logo": "https://cdn.macromicro.me/stocks/logo/O/OTIS-848b696b.png",
      "name": "OTIS WORLDWIDE CORP",
      "time": "01:08",
      "symbol": "OTIS",
      "earningId": 6949,
      "marketCap": 27634247999,
      "fiscalYear": 2026,
      "industryId": 201060,
      "fiscalPeriod": "Q2"
    },
    {
      "date": "2026-07-22",
      "logo": "https://cdn.macromicro.me/stocks/logo/G/GEV-18bc3ee8.png",
      "name": "GE VERNOVA INC",
      "time": "01:27",
      "symbol": "GEV",
      "earningId": 11455,
      "marketCap": 244397240000,
      "fiscalYear": 2026,
      "industryId": 201040,
      "fiscalPeriod": "Q2"
    }
  ],
  "total": 434,
  "symbol": null,
  "dataset": "calendar-earnings",
  "provider": "macromicro"
}

GET

Calendar Holidays/v1/finance:macromicro/calendar-holidays

3 params

Market holidays by date and country.

Parameters

countrystringoptional: Keep only this two-letter country code.
fromstringoptional: Drop holidays before this date, YYYY-MM-DD.
tostringoptional: Drop holidays after this date, YYYY-MM-DD.

Request

curl -X GET "https://api.zapi.ink/v1/finance:macromicro/calendar-holidays?country=us&from=2026-01-01&to=2026-12-31" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "to": "2026-12-31",
  "from": "2026-01-01",
  "count": 10,
  "items": [
    {
      "date": "2026-01-01",
      "name": "New Year's Day",
      "country": "us",
      "holidayId": 198,
      "countryName": "United States"
    },
    {
      "date": "2026-01-19",
      "name": "Martin L. King Day",
      "country": "us",
      "holidayId": 199,
      "countryName": "United States"
    },
    {
      "date": "2026-02-16",
      "name": "Presidents' Day",
      "country": "us",
      "holidayId": 200,
      "countryName": "United States"
    },
    {
      "date": "2026-04-03",
      "name": "Good Friday (not Fed Hol)",
      "country": "us",
      "holidayId": 201,
      "countryName": "United States"
    },
    {
      "date": "2026-05-25",
      "name": "Memorial Day",
      "country": "us",
      "holidayId": 202,
      "countryName": "United States"
    },
    {
      "date": "2026-06-19",
      "name": "Juneteenth",
      "country": "us",
      "holidayId": 203,
      "countryName": "United States"
    },
    {
      "date": "2026-07-03",
      "name": "Independence Day",
      "country": "us",
      "holidayId": 204,
      "countryName": "United States"
    },
    {
      "date": "2026-09-07",
      "name": "Labor Day",
      "country": "us",
      "holidayId": 205,
      "countryName": "United States"
    }
  ],
  "total": 385,
  "country": "us",
  "dataset": "calendar-holidays",
  "provider": "macromicro"
}

GET

Institutions/v1/finance:macromicro/institutions

1 param

13F filers with CIK, slug and the quarter each one is currently reported through.

Parameters

querystringoptional: Free-text match against the institution name or slug.

Request

curl -X GET "https://api.zapi.ink/v1/finance:macromicro/institutions?query=berkshire" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 1,
  "items": [
    {
      "cik": "0001067983",
      "url": "https://en.macromicro.me/13f/berkshire_hathaway",
      "slug": "berkshire_hathaway",
      "nameEn": "Berkshire Hathaway Inc",
      "nameSc": "波克夏·海瑟威",
      "nameTc": "波克夏·海瑟威",
      "period": "q",
      "quarter": "2026-Q2",
      "createdAt": "2020-12-23T05:07:52.000Z",
      "institutionId": 2
    }
  ],
  "query": "berkshire",
  "total": 20,
  "dataset": "institutions",
  "provider": "macromicro"
}

GET

Institution Holdings/v1/finance:macromicro/institution-holdings/:institutionId

2 params

One filer's twenty largest positions for a quarter, plus its biggest increases and decreases.

Parameters

institutionIdstringrequiredin path: Institution id, from institutions.
quarterstringoptional: Reporting quarter. Defaults to the latest the upstream reports for this filer.

Request

curl -X GET "https://api.zapi.ink/v1/finance:macromicro/institution-holdings/2?quarter=2026-Q2" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "name": null,
  "count": 20,
  "items": [
    {
      "url": "https://en.macromicro.me/stocks/info/AAPL",
      "isEtf": false,
      "nameEn": "Apple Inc",
      "nameSc": "苹果",
      "nameTc": "蘋果",
      "shares": 227917808,
      "splits": [
        {
          "date": "2020-08-31",
          "label": "August 31, 20",
          "numerator": 4,
          "denominator": 1
        }
      ],
      "ticker": "AAPL",
      "sectorId": 5,
      "holdingId": 22,
      "portfolioPercent": 22.04,
      "sharesChangePercentYear": -18.6,
      "sharesChangePercent3Year": -75.11,
      "portfolioPercentChangeYear": -0.28,
      "sharesChangePercentQuarter": 0,
      "portfolioPercentChange3Year": -28.95,
      "portfolioPercentChangeQuarter": 0.06
    }
  ],
  "total": 20,
  "losers": [
    {
      "url": "https://en.macromicro.me/stocks/info/KR",
      "name": "Kroger Co",
      "ticker": "KR",
      "assetId": 155,
      "current": {
        "date": "2026-06-30",
        "shares": 39000000,
        "portfolioPercent": 0.72
      },
      "previous": {
        "date": "2026-03-31",
        "shares": 50000000,
        "portfolioPercent": 1.37
      },
      "sectorName": "EQUITY-Consumer Defensive",
      "sharesDiff": -11000000,
      "portfolioPercent": 0.72,
      "sharesChangePercent": -22,
      "portfolioPercentChange": -0.65
    }
  ],
  "dataset": "institution-holdings",
  "gainers": [
    {
      "url": "https://en.macromicro.me/stocks/info/GOOGL",
      "name": "Alphabet, Inc. Class A",
      "ticker": "GOOGL",
      "assetId": 754,
      "current": {
        "date": "2026-06-30",
        "shares": 78791167,
        "portfolioPercent": 9.41
      },
      "previous": {
        "date": "2026-03-31",
        "shares": 54249798,
        "portfolioPercent": 5.92
      },
      "sectorName": "EQUITY-Communication Services",
      "sharesDiff": 24541369,
      "portfolioPercent": 9.41,
      "sharesChangePercent": 45.24,
      "portfolioPercentChange": 3.49
    }
  ],
  "quarter": "2026-Q2",
  "provider": "macromicro",
  "institutionId": 2,
  "portfolioValue": 299253556246
}

{ "to": null, "from": "2015-01-01", "count": 2, "items": [ { "url": "https://en.macromicro.me/charts/55744/global-citi-earnings-revision-index", "slug": "global-citi-earnings-revision-index", "type": 1, "nameEn": "World - Citi Earnings Revision Index", "nameSc": "全球-花旗盈利修正指数", "nameTc": "全球-花旗盈利修正指數", "series": [ { "color": "#3bafda", "count": 8, "stats": [ { "units": "idx", "nameEn": "World - Citigroup Earnings Revision Index", "nameSc": "全球-花旗盈利修正指数", "nameTc": "全球-花旗盈利修正指數", "statId": 22951, "category": 21, "frequency": "W", "operation": "lin", "categoryV2": 100003, "aggregation": "eop", "frequencyName": "Weekly", "unitsOriginal": "idx", "frequencyOriginal": "W" } ], "total": 607, "units": "idx", "nameEn": "World", "nameSc": "全球-花旗盈利修正指数", "nameTc": "全球-花旗盈利修正指數", "axisType": "linear", "lastDate": "2026-08-14", "lineType": "column", "firstDate": "2015-01-04", "frequency": "W", "lineWidth": 2, "operation": "lin", "axisOffset": 0, "axisPosition": 1, "axisReversed": false, "observations": [ { "date": "2026-08-14", "value": 0.18 } ], "frequencyName": "Weekly", "unitsOriginal": "idx", "frequencyOriginal": "W" } ], "chartId": 55744, "seriesCount": 4, "sortBarChart": false, "descriptionEn": "The Citi Earnings Revision Index is calculated as “Proportion of Companies Revising EPS (%)” − “Proportion of Companies Revising EPS Down (%)” (compared to last week). When the ind…", "descriptionSc": "花旗盈利修正指数计算方式为「上调 EPS 的公司比例（%）」−「下调 EPS 的公司比例（%）」（与上周相比）。该指数位于零轴之上时，代表平均而言分析师对于企业盈利展望持乐观态度，反之则表示相对而言分析师持较悲观看法。", "descriptionTc": "花旗盈利修正指數計算方式為「上調 EPS 的公司比例（%）」−「下調 EPS 的公司比例（%）」（與上週相比）。該指數位於零軸之上時，代表平均而言分析師對於企業盈利展望持樂觀態度，反之則表示相對而言分析師持較悲觀看法。", "valueDecimals": 2 } ], "total": 2, "charts": [ 55744 ], "length": 8, "dataset": "chart", "missing": [], "provider": "macromicro", "resolved": [ 55744 ] }

// npm i zpi-sdk import { ZpiClient } from "zpi-sdk"; const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" }); const data = await client.run("finance:macromicro", "chart", { "id": "55744", "from": "2020-01-01", "to": "2026-08-29", "length": 100 }); console.log(data);

{ "page": 1, "count": 8, "items": [ { "url": "https://en.macromicro.me/charts/152511/us-pce-price-index-change-in-inflation-distribution", "slug": "us-pce-price-index-change-in-inflation-distribution", "chartId": 152511 }, { "url": "https://en.macromicro.me/charts/152510/us-pce-price-index-inflation-distribution", "slug": "us-pce-price-index-inflation-distribution", "chartId": 152510 }, { "url": "https://en.macromicro.me/charts/152487/us-inflation-shock-momentum-index", "slug": "us-inflation-shock-momentum-index", "chartId": 152487 }, { "url": "https://en.macromicro.me/charts/151992/us-trimmed-mean-inflation", "slug": "us-trimmed-mean-inflation", "chartId": 151992 }, { "url": "https://en.macromicro.me/charts/147683/us-money-supply-and-inflation-vs-gold", "slug": "us-money-supply-and-inflation-vs-gold", "chartId": 147683 }, { "url": "https://en.macromicro.me/charts/131622/us-cleveland-fed-expected-inflation", "slug": "us-cleveland-fed-expected-inflation", "chartId": 131622 }, { "url": "https://en.macromicro.me/charts/131621/us-new-york-fed-expected-inflation", "slug": "us-new-york-fed-expected-inflation", "chartId": 131621 }, { "url": "https://en.macromicro.me/charts/116478/us-the-number-of-mentions-of-inflation-in-all-industry", "slug": "us-the-number-of-mentions-of-inflation-in-all-industry", "chartId": 116478 } ], "query": "inflation", "total": 20, "country": "us", "dataset": "charts", "hasMore": true, "nextPage": 2, "provider": "macromicro" }

curl -X GET "https://api.zapi.ink/v1/finance:macromicro/series-search?query=inflation&country=us&category=21&categoryParent=100003&slug=realgdp&page=1&count=100" \ -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

{ "page": 1, "count": 8, "items": [ { "name": "US - Gold - Commercial Net Position", "slug": "cot-gold-commercial", "statId": 3070, "country": "us", "frequency": "W", "unitsName": "Number", "countryName": "United States", "frequencyName": "Weekly" }, { "name": "US - Gold - Non Commercial Net Position", "slug": "cot-gold-noncommercial", "statId": 3071, "country": "us", "frequency": "W", "unitsName": "Number", "countryName": "United States", "frequencyName": "Weekly" }, { "name": "Gold COT Index", "slug": "gold-cot-index", "units": "idx", "statId": 3351, "country": "us", "frequency": "W", "unitsName": "Index", "countryName": "United States", "frequencyName": "Weekly" } ], "query": "gold", "total": 225, "country": "us", "dataset": "series-search", "hasMore": true, "category": null, "nextPage": 2, "provider": "macromicro" }

{ "url": "https://en.macromicro.me/collections/3208/high-frequency-data", "name": "High Frequency Data", "slug": "high-frequency-data", "count": 12, "items": [ { "url": "https://en.macromicro.me/charts/22281/flight-tracking", "slug": "flight-tracking", "type": 1, "state": "active", "nameEn": "World - Global Flight Tracking", "chartId": 22281, "updatedAt": "2025-05-19T17:20:18.000Z", "viewCount": 0, "commentCount": 3, "bookmarkCount": 216, "descriptionEn": "The number of daily flights is calculated by Flightradar counting the number of flights on the website.\n\nCommercial flights: Commercial passenger flights + cargo flights + charter …", "isMembersOnly": false }, { "url": "https://en.macromicro.me/charts/26114/us-tsa-checkpoint", "slug": "us-tsa-checkpoint", "type": 1, "state": "active", "nameEn": "US - TSA Checkpoint Travel Numbers", "chartId": 26114, "country": "us", "updatedAt": "2023-08-30T04:29:21.000Z", "viewCount": 0, "commentCount": 0, "bookmarkCount": 42, "descriptionEn": "This chart shows the headcount of travelers everyday at the US borders and the changes in the number of travelers since the pandemic hit.", "isMembersOnly": false }, { "url": "https://en.macromicro.me/charts/947/commodity-ccfi-scfi", "slug": "commodity-ccfi-scfi", "type": 1, "state": "active", "nameEn": "China - Global & Shanghai Export Containerized Freight Index", "chartId": 947, "country": "cn", "updatedAt": "2026-04-04T09:10:17.000Z", "viewCount": 0, "commentCount": 11, "bookmarkCount": 1238, "descriptionEn": "First released in 1998 by the Shanghai Shipping Exchange, the China Export Containerized Freight Index (CCFI) is based on the freight rate and shipped volume of 12 selected trade r…", "isMembersOnly": false } ], "total": 12, "country": null, "dataset": "collection", "chartIds": [ 22281, 26114, 947 ], "isPublic": true, "language": "tc", "provider": "macromicro", "createdAt": "2020-10-30T09:33:13.000Z", "updatedAt": "2025-07-06T07:41:58.000Z", "coverStatId": 7250, "description": "High frequency data", "collectionId": 3208, "isSearchable": true, "isMembersOnly": false }

{ "count": 54, "items": [ { "name": "Crude Oil (WTI)", "group": 1, "statId": 486, "altName": "Crude Oil (WTI)", "chartId": 888, "history": [ { "date": "2025-08-14", "value": 63.96 } ], "chartUrl": "https://en.macromicro.me/charts/888/commodity-wti", "position": 3, "statName": "NYMEX - WTI Crude Oil Futures Price", "chartSlug": "commodity-wti", "chartType": 1, "viewCount": 0, "chartState": "active", "pctChanges": { "1D": [ { "date": "2026-08-28", "value": 83.4, "changePercent": -0.16 } ], "1M": [ { "date": "2026-08-28", "value": 83.4, "changePercent": -1.26 } ], "1W": [ { "date": "2026-08-28", "value": 83.4, "changePercent": -4.2 } ], "1Y": [ { "date": "2026-08-28", "value": 83.4, "changePercent": 30.29 } ], "6M": [ { "date": "2026-08-28", "value": 83.4, "changePercent": 15.85 } ], "YTD": [ { "date": "2026-08-28", "value": 83.4, "changePercent": 45.07 } ] }, "chartNameEn": "WTI Crude Oil", "chartCountry": "us", "commentCount": 1, "statCategory": 22, "bookmarkCount": 168, "isMembersOnly": false, "chartUpdatedAt": "2026-06-08T06:43:17.000Z", "imageUpdatedAt": "2026-08-28T22:59:38.000Z", "chartDescription": "Market: New York Mercantile Exchange (NYMEX)\nContract Size: 1000 barrels\nPrice Quotation: USD/barrel" } ], "total": 54, "groups": 6, "dataset": "market", "category": "commodities", "provider": "macromicro", "updatedAt": "2022-11-29T10:13:11.000Z" }

{ "to": "2026-09-09T16:00:00.000Z", "date": "2026-08-29", "from": "2026-07-21T16:00:00.000Z", "count": 53, "items": [ { "url": "https://en.macromicro.me/collections/4/us-employ-relative/19/initial-jobless-claims", "name": "US Initial & Continuing Jobless Claims", "statId": 34, "country": "us", "eventId": 16, "groupId": 1190, "onFront": true, "isPublic": true, "createdAt": "2020-04-08T07:36:16.000Z", "updatedAt": "2023-01-12T09:48:23.000Z", "onCalendar": true, "releasedAt": "2026-07-23T12:30:00.000Z", "onQuickview": true, "releasedAtEpoch": 1784809800 }, { "url": "https://en.macromicro.me/collections/7/us-housing-relative/34/new-house-price", "name": "US Supply and Demand of New Homes", "statId": 252, "country": "us", "eventId": 36, "groupId": 86, "onFront": true, "isPublic": true, "createdAt": "2020-04-08T07:36:16.000Z", "updatedAt": "2026-03-23T04:20:44.000Z", "onCalendar": false, "releasedAt": "2026-07-24T14:00:00.000Z", "onQuickview": true, "relatedCharts": [ 31, 32, 34 ], "releasedAtEpoch": 1784901600 }, { "url": "https://en.macromicro.me/collections/8/us-industry-relative/3/durable-goods", "name": "US Durable Goods Orders", "statId": 321, "country": "us", "eventId": 35, "groupId": 55, "onFront": false, "isPublic": true, "createdAt": "2020-04-08T07:36:16.000Z", "updatedAt": "2026-03-23T04:20:44.000Z", "onCalendar": false, "releasedAt": "2026-07-27T12:30:00.000Z", "onQuickview": true, "releasedAtEpoch": 1785155400 } ], "total": 212, "country": "us", "dataset": "calendar-macro", "provider": "macromicro" }

{ "to": "2026-09-10", "date": "2026-08-29", "from": "2026-07-22", "count": 434, "items": [ { "date": "2026-07-22", "logo": "https://cdn.macromicro.me/stocks/logo/T/TEL-2bac1695.png", "name": "TE CONNECTIVITY PLC", "time": "01:00", "symbol": "TEL", "earningId": 12820, "marketCap": 58974060000, "fiscalYear": 2026, "industryId": 452030, "fiscalPeriod": "Q2" }, { "date": "2026-07-22", "logo": "https://cdn.macromicro.me/stocks/logo/O/OTIS-848b696b.png", "name": "OTIS WORLDWIDE CORP", "time": "01:08", "symbol": "OTIS", "earningId": 6949, "marketCap": 27634247999, "fiscalYear": 2026, "industryId": 201060, "fiscalPeriod": "Q2" }, { "date": "2026-07-22", "logo": "https://cdn.macromicro.me/stocks/logo/G/GEV-18bc3ee8.png", "name": "GE VERNOVA INC", "time": "01:27", "symbol": "GEV", "earningId": 11455, "marketCap": 244397240000, "fiscalYear": 2026, "industryId": 201040, "fiscalPeriod": "Q2" } ], "total": 434, "symbol": null, "dataset": "calendar-earnings", "provider": "macromicro" }

{ "to": "2026-12-31", "from": "2026-01-01", "count": 10, "items": [ { "date": "2026-01-01", "name": "New Year's Day", "country": "us", "holidayId": 198, "countryName": "United States" }, { "date": "2026-01-19", "name": "Martin L. King Day", "country": "us", "holidayId": 199, "countryName": "United States" }, { "date": "2026-02-16", "name": "Presidents' Day", "country": "us", "holidayId": 200, "countryName": "United States" }, { "date": "2026-04-03", "name": "Good Friday (not Fed Hol)", "country": "us", "holidayId": 201, "countryName": "United States" }, { "date": "2026-05-25", "name": "Memorial Day", "country": "us", "holidayId": 202, "countryName": "United States" }, { "date": "2026-06-19", "name": "Juneteenth", "country": "us", "holidayId": 203, "countryName": "United States" }, { "date": "2026-07-03", "name": "Independence Day", "country": "us", "holidayId": 204, "countryName": "United States" }, { "date": "2026-09-07", "name": "Labor Day", "country": "us", "holidayId": 205, "countryName": "United States" } ], "total": 385, "country": "us", "dataset": "calendar-holidays", "provider": "macromicro" }

{ "count": 1, "items": [ { "cik": "0001067983", "url": "https://en.macromicro.me/13f/berkshire_hathaway", "slug": "berkshire_hathaway", "nameEn": "Berkshire Hathaway Inc", "nameSc": "波克夏·海瑟威", "nameTc": "波克夏·海瑟威", "period": "q", "quarter": "2026-Q2", "createdAt": "2020-12-23T05:07:52.000Z", "institutionId": 2 } ], "query": "berkshire", "total": 20, "dataset": "institutions", "provider": "macromicro" }

{ "name": null, "count": 20, "items": [ { "url": "https://en.macromicro.me/stocks/info/AAPL", "isEtf": false, "nameEn": "Apple Inc", "nameSc": "苹果", "nameTc": "蘋果", "shares": 227917808, "splits": [ { "date": "2020-08-31", "label": "August 31, 20", "numerator": 4, "denominator": 1 } ], "ticker": "AAPL", "sectorId": 5, "holdingId": 22, "portfolioPercent": 22.04, "sharesChangePercentYear": -18.6, "sharesChangePercent3Year": -75.11, "portfolioPercentChangeYear": -0.28, "sharesChangePercentQuarter": 0, "portfolioPercentChange3Year": -28.95, "portfolioPercentChangeQuarter": 0.06 } ], "total": 20, "losers": [ { "url": "https://en.macromicro.me/stocks/info/KR", "name": "Kroger Co", "ticker": "KR", "assetId": 155, "current": { "date": "2026-06-30", "shares": 39000000, "portfolioPercent": 0.72 }, "previous": { "date": "2026-03-31", "shares": 50000000, "portfolioPercent": 1.37 }, "sectorName": "EQUITY-Consumer Defensive", "sharesDiff": -11000000, "portfolioPercent": 0.72, "sharesChangePercent": -22, "portfolioPercentChange": -0.65 } ], "dataset": "institution-holdings", "gainers": [ { "url": "https://en.macromicro.me/stocks/info/GOOGL", "name": "Alphabet, Inc. Class A", "ticker": "GOOGL", "assetId": 754, "current": { "date": "2026-06-30", "shares": 78791167, "portfolioPercent": 9.41 }, "previous": { "date": "2026-03-31", "shares": 54249798, "portfolioPercent": 5.92 }, "sectorName": "EQUITY-Communication Services", "sharesDiff": 24541369, "portfolioPercent": 9.41, "sharesChangePercent": 45.24, "portfolioPercentChange": 3.49 } ], "quarter": "2026-Q2", "provider": "macromicro", "institutionId": 2, "portfolioValue": 299253556246 }

Chart

Code

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

Pluang

IDX (Bursa Efek Indonesia)

TradingView

Stockbit

Investing

Binance Futures

Chart

Code

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

Pluang

IDX (Bursa Efek Indonesia)

TradingView

Stockbit

Investing

Binance Futures