Free API
The economic release calendar, every report Clometrix measures, and how far Bitcoin moved in the 15 minutes after each release, as JSON. For trading bots, sheets and dashboards. Free with an account.
Start
- Make a free account, or log in.
- Make a key under API key in your account. It is shown once; keep it secret.
- Send it with each request, as a header or in the address:
curl -H "Authorization: Bearer cmx_yourkey" https://www.clometrix.com/api/v1/calendar
https://www.clometrix.com/api/v1/calendar?key=cmx_yourkey
Limits: 60 requests a minute and 1,000 a day per key. Over either, the answer is 429; wait and try again. Every answer is JSON with the data under data and an attribution line.
The calendar
GET /api/v1/calendar?days=7: every release in the next 1 to 31 days, soonest first.
{
"slug": "cpi",
"name": "CPI",
"region": "United States",
"tier": 1,
"usual_btc_swing": 4.32,
"at": "2026-12-10T13:30:00Z",
"local_time": "2026-12-10 08:30",
"local_timezone": "America/New_York",
"time_estimated": false,
"url": "https://www.clometrix.com/reports/cpi"
}
usual_btc_swing is how far Bitcoin usually moves in the 15 minutes after the report, against a normal 15 minutes that day (CPI's 4.32 means 4.32 times), or null when too few releases are measured. time_estimated is true while the publisher has not set the minute.
Reports
GET /api/v1/reports: every report, US and abroad, with its publisher, region, tier, unit, usual swing and next release.
A report's releases
GET /api/v1/reports/{slug}/releases?limit=24: its latest releases, newest first, up to 100.
{
"at": "2026-11-10T13:30:00Z",
"local_time": "2026-11-10 08:30",
"local_timezone": "America/New_York",
"time_estimated": false,
"status": null,
"figure": "0.4",
"consensus": "0.3",
"btc_swing": 6.69,
"verdict": "strong",
"url": "https://www.clometrix.com/data/cpi/fw165qm11hom/BTC"
}
figure is the figure first published, the one the market saw, in the report's unit; null for reports Clometrix measures without a figure. btc_swing is how far Bitcoin moved in the 15 minutes after, against a normal 15 minutes; verdict compares it with the report's usual: quiet, ordinary, strong or exceptional.
Using the data
Show it anywhere, with credit and a link to Clometrix (section 16 of the Terms). Do not resell it as a data feed of your own. It is what prices did after past releases, not advice.