Macro data API
Macro event calendar and release history (CPI, non-farm payrolls, PMI…), money-market rates SOFR / TGCR / BGCR / ON RRP with history, and the FOMC target-rate probability matrix. A direct answer to "what moves the market next" for backtests and agents.
- Event calendar
- No parameters; returns {date, events[]}
- Release history
- Newest first, limit default 50, max 100
- Rates
- sofr / tgcr / bgcr / on-rrp, daily
- FOMC
- Target-rate probability matrix, daily
US CPI: actual vs forecast
- Actual
- 3.7%
- Forecast
- 3.6%
- Deviation (percentage points)
- 0.1
Oct 14, 2026
● Actual● ForecastCPI · %
May 12Jun 10Jul 14Aug 12Sep 11Oct 14
Static API snapshot · Nov 6, 2026
View sample JSON response
{
"data": [
{
"date": "2026-10-14",
"actual": "3.7%",
"forecast": "3.6%",
"previous": "3.4%"
},
{
"date": "2026-09-11",
"actual": "3.4%",
"forecast": "3.4%",
"previous": "3.4%"
},
{
"date": "2026-08-12",
"actual": "3.4%",
"forecast": "3.4%",
"previous": "3.5%"
},
{
"date": "2026-07-14",
"actual": "3.5%",
"forecast": "3.8%",
"previous": "4.2%"
},
{
"date": "2026-06-10",
"actual": "4.2%",
"forecast": "4.2%",
"previous": "3.8%"
},
{
"date": "2026-05-12",
"actual": "3.8%",
"forecast": "3.7%",
"previous": "3.3%"
}
]
}Endpoints
GET/macro/eventsEvent calendar: [{date, events[]}], no parametersGET/macro/events/{event}/historyRelease history of one event (start_date, end_date, limit); unknown names return an empty arrayGET/macro/ratesMoney-market rate indicators with latest valueGET/macro/rates/{code}/historyRate history (actual / previous); code is sofr, tgcr, bgcr or on-rrpGET/macro/fomc-probabilitiesFOMC target-rate probability matrix
cURL (any language that can send an HTTP request)
curl "https://openapi.sosovalue.com/openapi/v1/macro/events/CPI%20(YoY)/history?limit=12" \
-H "x-soso-api-key: $SOSO_API_KEY"
# v1 envelope: {"code": 0, "message": "success", "data": ...}
# code 0 means success; data fields are listed in the table below
# Event names come from GET /macro/events; URL-encode them (& → %26)Response fields
GET /openapi/v1/macro/events/{event}/history| Field | Type | Unit | Description |
|---|---|---|---|
| date | string | yyyy-MM-dd | Release date |
| actual | string | per event | Released value with unit, e.g. "3.5%"; empty string "" until released |
| forecast | string | per event | Consensus forecast; empty string when unavailable |
| previous | string | per event | Previous release |
GET /openapi/v1/macro/rates| Field | Type | Unit | Description |
|---|---|---|---|
| code (rates) | string | — | sofr, tgcr, bgcr, on-rrp (lowercase); on-rrp is a USD amount, not a rate |
| latest_value (rates) | string | percent / usd | Most recent value; unit field says which |