MacroMicro
Macro and market charts, indicators, calendars and 13F filings from MacroMicro.
Chart
Series values, render config and the source stat ids behind them, for up to 12 charts in one call.
/v1/finance:macromicro/chart/:idParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | path | Chart ids, comma-separated, up to 12. Take them from `charts`, `collection` or `market`. Required. |
| from | string | query | Drop observations before this date, YYYY-MM-DD. |
| to | string | query | Drop observations after this date, YYYY-MM-DD. |
| length | number | query | Observations per series, newest first (default 100, max 20000). |
Example response
{"project":"finance:macromicro", "data": {"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 ] },"timestamp":"2026-08-29T09:27:18Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Charts
The full chart catalogue — id, slug and URL for every chart the site publishes.
/v1/finance:macromicro/chartsParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Keep only charts whose slug contains this text. |
| country | string | query | Keep only charts whose slug starts with this country prefix. |
| page | number | query | Result page (default 1). |
| count | number | query | Charts per page (default 100, max 500). |
Example response
{"project":"finance:macromicro", "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" },"timestamp":"2026-08-29T09:27:18Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Series Search
Search the indicator directory: 66,000+ series with country, frequency, units and currency.
/v1/finance:macromicro/series-searchParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Free-text match against the indicator name. |
| country | string | query | Two-letter country code. |
| category | string | query | Category id. |
| categoryParent | string | query | Parent category id. |
| slug | string | query | Exact indicator slug. |
| page | number | query | Result page (default 1). |
| count | number | query | Rows per page (default 100, max 500). |
Example response
{"project":"finance:macromicro", "data": {"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" },"timestamp":"2026-08-29T09:27:18Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Collection
One curated collection and every chart in it, in the site's own order.
/v1/finance:macromicro/collection/:idParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | path | Collection id. Take it from a collection URL. Required. |
| slug | string | query | Collection slug. Optional — the id decides which collection you get. |
Example response
{"project":"finance:macromicro", "data": {"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 },"timestamp":"2026-08-29T09:27:18Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Market
Live quotes for one asset class with six percentage-change windows and 380 days of raw values.
/v1/finance:macromicro/market/:categoryParameters
| Name | Type | In | Description |
|---|---|---|---|
| category | enum | path | Asset class: stocks, forex, bonds, etf, crypto, volatility, cds, commodities. One of stocks, forex, bonds, etf, crypto, volatility, cds, commodities. Required. |
| history | enum | query | Include the 380-day raw value series on every quote. Default false. One of true, false. |
Example response
{"project":"finance:macromicro", "data": {"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" },"timestamp":"2026-08-29T09:27:18Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Calendar Macro
Scheduled macro data releases for the window around a date.
/v1/finance:macromicro/calendar-macroParameters
| Name | Type | In | Description |
|---|---|---|---|
| date | string | query | Any date inside the month you want, YYYY-MM-DD. Defaults to today. |
| country | string | query | Keep only releases for this two-letter country code. |
Example response
{"project":"finance:macromicro", "data": {"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" },"timestamp":"2026-08-29T09:27:18Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Calendar Earnings
Earnings calendar with ticker, fiscal period, market cap and logo.
/v1/finance:macromicro/calendar-earningsParameters
| Name | Type | In | Description |
|---|---|---|---|
| date | string | query | Any date inside the window you want, YYYY-MM-DD. Defaults to today. |
| symbol | string | query | Keep only this ticker. |
Example response
{"project":"finance:macromicro", "data": {"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" },"timestamp":"2026-08-29T09:27:18Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Calendar Holidays
Market holidays by date and country.
/v1/finance:macromicro/calendar-holidaysParameters
| Name | Type | In | Description |
|---|---|---|---|
| country | string | query | Keep only this two-letter country code. |
| from | string | query | Drop holidays before this date, YYYY-MM-DD. |
| to | string | query | Drop holidays after this date, YYYY-MM-DD. |
Example response
{"project":"finance:macromicro", "data": {"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" },"timestamp":"2026-08-29T09:27:18Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Institutions
13F filers with CIK, slug and the quarter each one is currently reported through.
/v1/finance:macromicro/institutionsParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Free-text match against the institution name or slug. |
Example response
{"project":"finance:macromicro", "data": {"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" },"timestamp":"2026-08-29T09:27:18Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Institution Holdings
One filer's twenty largest positions for a quarter, plus its biggest increases and decreases.
/v1/finance:macromicro/institution-holdings/:institutionIdParameters
| Name | Type | In | Description |
|---|---|---|---|
| institutionId | string | path | Institution id, from `institutions`. Required. |
| quarter | string | query | Reporting quarter. Defaults to the latest the upstream reports for this filer. |
Example response
{"project":"finance:macromicro", "data": {"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 },"timestamp":"2026-08-29T09:27:18Z"}
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:macromicro", "chart", { id: "55744", from: "2020-01-01", to: "2026-08-29", length: 100 });
MacroMicro
Macro and market charts, indicators, calendars and 13F filings from MacroMicro.
Series values, render config and the source stat ids behind them, for up to 12 charts in one call.
/v1/…macromicro/chart/:idTry it
Parameters
id
string · path · required
Chart ids, comma-separated, up to 12. Take them from `charts`, `collection` or `market`.
from
string · query · optional
Drop observations before this date, YYYY-MM-DD.
to
string · query · optional
Drop observations after this date, YYYY-MM-DD.
length
number · query · optional
Observations per series, newest first (default 100, max 20000).
Example response
{"project":"finance:macromicro", "data": {"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 ] },"timestamp":"2026-08-29T09:27:18Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "finance:macromicro", "chart", { id: "55744", from: "2020-01-01", to: "2026-08-29", length: 100 });