Skip to main content
2026-11-10
US Fed Funds rate and FOMC meetings.Added
  • Macro · Fed Funds — GET /macro/fed-funds/us/daily: the daily Effective Federal Funds Rate (EFFR) from 2016-03-01, with the 1st, 25th, 75th and 99th percentiles, volume, the FOMC target range, IORB (IOER before 2021-07-29) and the EFFR − IORB spread in basis points, over a 1Y, 3Y or ALL window. Sources: Federal Reserve Bank of New York; FRED.
  • Macro · Fed Funds — GET /macro/fed-funds/us/fomc-meetings: the FOMC calendar with the next meeting, every upcoming meeting, the current target range and one year’s meetings with their decision, change in basis points, target range and EFFR. Sources: Federal Reserve Board; Federal Reserve Bank of New York.
Both responses carry meta.terms_notice, the notice the New York Fed requires next to any EFFR figure you publish. Gated by macro_data and costs 2 weight per call, like the other Macro endpoints.
2026-11-06
Vietnam CPI by component.Added
  • Macro · Vietnam CPI — GET /macro/vietnam/cpi-by-component: quarterly CPI from 2015-Q1 for the headline, 11 groups, 5 sub-groups and the gold and US dollar price indices, as % change against the same quarter of the previous year. Source: National Statistics Office of Viet Nam. Supports asOf for point-in-time queries.
Gated by macro_data and costs 2 weight per call, like the other Macro endpoints.
2026-11-03
Manufacturing PMI for the United States and Japan.Changed
  • Macro · PMI — GET /macro/pmi/vn/manufacturing becomes GET /macro/pmi/{country}/manufacturing, with country one of vn, us or jp. The old URL keeps working (it is the same route with country=vn). The operation is renamed macroPmiManufacturing in the spec.
  • New field releaseStage (flash or final) on latest and on every entry of points, and release_stage in meta. The US and JP publish a flash reading in the second half of the survey month; the final reading replaces it on the first working day of the next month. Vietnam is always final.
  • GET /macro/indicators/pmi now fills the US and JP rows.
US and JP history is shorter than Vietnam’s for now; older months are being added.
2026-10-16
Vietnam Manufacturing PMI.Added
  • Macro · PMI — the S&P Global Vietnam Manufacturing PMI, monthly, in index points:
    • GET /macro/pmi/vn/manufacturing — the series over a 3M, 6M, 1Y or 3Y window, plus the latest reading’s change, status against 50 and streak. Supports asOf for point-in-time queries.
    • GET /macro/indicators/pmi — the US/JP/VN indicator table; only VN has data for now.
Both are gated by macro_data and cost 2 weight per call, like the other Macro endpoints.
2026-10-16
FDI, interbank rates, trade by region, Japan GDP and debt breakdowns, BOJ ETF holdings.Every dataset behind an “API” button in the HayInsights app now has its own reference page.Added
  • Macro · FDI — GET /macro/fdi/flows, GET /macro/fdi/by-region and GET /macro/fdi/by-industry (Japan, JETRO); GET /macro/fdi/vn/flows and GET /macro/fdi/vn/breakdown (Vietnam); GET /macro/indicators/fdi.
  • Macro · Interbank rates — GET /macro/interbank-rates (US/JP history), GET /macro/interbank-rates/jp/tibor, GET /macro/interbank-rates/jp/overnight, GET /macro/interbank-rates/vn (weight 3) and GET /macro/indicators/interbank-rates.
  • Macro · Trade — GET /macro/trade/turnover and GET /macro/trade/by-region.
  • Macro · Japan — GET /macro/japan/gdp-breakdown and GET /macro/japan/central-gov-debt.
  • ETF — GET /etf/boj-holdings and GET /etf/boj-holdings/latest (gated by etf_data, weight 2).
New Macro routes are gated by macro_data.
2026-10-15
Equities domain.Added
  • Equities — Japanese stock detail for Tokyo Stock Exchange listings, under /market/{market}/equities/{code} (market is jp for now; code accepts 7203 or 72030):
    • GET /market/{market}/equities/{code} — end-of-day snapshot: quote, overview, trading activity, period changes and TTM ratios.
    • GET …/events — dividends and earnings releases within ±30 days.
    • GET …/prices — daily closes, raw and split-adjusted.
    • GET …/financial-statements — income statement or balance sheet as a tree.
    • GET …/related-stocks — TSE 33-sector peers by market cap.
Equities is gated by the existing macro_data feature code, like News, Calendar and Market.
2026-09-16
News, Calendar and Market domains; Real Estate restructured.Brings the specification in line with the deployed API — 57 endpoints across nine domains.Added
  • News — GET /news/feed (headlines with per-article sentiment) and GET /news/sentiment (aggregate reading over a rolling window).
  • Calendar — GET /calendar/events: rate decisions, CPI and GDP releases, market holidays and asset-level events.
  • Market — GET /market/indices/snapshot and GET /market/global-indices.
  • Macro — 13 GET /macro/indicators/* tables covering GDP, CPI, PPI, PCE, trade, population, unemployment, exchange rates, deposit rates and bond yields.
  • Real Estate — ward-level GET /real-estate/{country}/provinces/{provinceId}/wards and /geojson, province-level GET /real-estate/{country}/provinces/prices, and transaction-level GET /real-estate/{country}/wards/{wardId}/transactions (Japan only).
News, Calendar and Market are gated by the existing macro_data feature code, so any plan that already includes Macro reaches them without a change of subscription.Removed — breakingFive Real Estate endpoints have been withdrawn. They were never exercised by a first-party client, and so carried no coverage guarantee:Ward access is now scoped to a province rather than a whole country. If you call any of the withdrawn routes, fetch the province list first and iterate.Changed
  • GET /real-estate/{country}/provinces accepts country=all, and every province now carries a country field so a combined response can be grouped client-side.
  • Province bbox is populated (it previously documented null), with offshore units excluded.
2026-06-19
Initial preview release.
  • 40 read endpoints across six domains: Commodities, Crypto, ETF, FX, Macro and Real Estate.
  • Single-tier authentication via the X-API-Key header.
  • Weighted, per-minute rate limiting with X-RateLimit-* headers.
  • Plan-based feature gating (<domain>_data feature codes).
  • Standard response envelope { success, statusCode, data, meta }.