Topics by kind
US CPI and core CPI, payrolls, unemployment, GDP and recession, plus central bank decisions, metals and energy.
All APIs
Economic prediction markets API
Query market-implied probabilities for economic releases and policy decisions by topic and dated event. Access latest odds, minute to daily history and a live stream on paid plans.
First request
Quickstart →curl --request GET \
--url "https://api.narwhalapi.com/v1/predictions/topics/usa-cpi-yoy" \
--header "Authorization: Bearer $NARWHAL_API_KEY"Example response Illustrative response · not a live request
{
"topic_id": "usa-cpi-yoy",
"group": "us_prices",
"title": "US CPI, 12-month change",
"shape": "scalar",
"unit": "percent",
"next_event_id": "usa-cpi-yoy-2026-09",
"events": [
{
"event_id": "usa-cpi-yoy-2026-09",
"question": "US CPI, 12-month change, September 2026",
"status": "trading",
"closes_at": "2026-10-14T12:29:00Z",
"resolves_at": "2026-10-14T12:30:00Z"
}
]
}Endpoints
GETList prediction topics/v1/predictions/topics
GETGet topic details/v1/predictions/topics/{topic_id}
GETList dated events/v1/predictions/events
GETGet event odds by shape/v1/predictions/{shape}/{event_id}
GETGet historical odds for an event/v1/predictions/{shape}/{event_id}/history
GETGet central bank policy paths/v1/predictions/policy-paths/{authority}
WSStream live odds over WebSocket/v1/predictions/stream
How the data works
Dated events
Events include a question, close and resolve times, an official resolution source, and status: upcoming, trading, closed, settled or void.
Event shapes
Scalar distributions, binary odds, extreme highs and lows, and timing markets, plus central bank policy paths.
Coverage
View coverage →Coverage spans economic releases and central bank rate decisions. Economic events resolve with the official release.
Economic data
US core CPI, 1-month change→US core CPI, 12-month change→US CPI, 1-month change→US CPI, 12-month change→
US real GDP growth, advance estimate→US real GDP growth for the year→
US nonfarm payrolls change→US PPI, 12-month change→
US recession by end of 2026→
US unemployment rate→Highest US unemployment rate in the year→Germany real GDP growth, first release→Euro area GDP growth, preliminary flash estimate→UK consumer price inflation in December→UK real GDP growth, first quarterly estimate→Mexico real GDP growth, timely estimate→
Central bank decisions
Reserve Bank of Australia rate decision→Central Bank of Brazil rate decision→Bank of Canada rate decision→Bank of Canada rate hike in 2026→European Central Bank rate decision→European Central Bank rate cut in 2026→Bank of England rate decision→Bank of England rate hike in 2026→Bank Indonesia rate decision→Bank of Japan rate decision→Bank of Mexico rate decision→Reserve Bank of New Zealand rate decision→Bank of Russia rate decision→Federal Reserve rate decision→Number of Federal Reserve rate cuts in the year→Federal Reserve emergency rate cut before 2027→Another Federal Reserve rate hike in 2026→Number of Federal Reserve rate hikes in the year→Next Federal Reserve rate cut→Federal Reserve rate at the end of the year→Federal Reserve rate levels reached before the year ends→
Explore related pages
Economic data API
Official indicators for prices, labour, output, trade, and rates.
Explore the API →Economic calendar API
Release schedules, status, and publication versions.
Explore the API →Commodities API
Prices for spot metals and physical commodities, with native units and series definitions.
Explore the API →Common questions
Are these official economic values?
No. These are market-implied probabilities. Economic events resolve with the official release, which the Economics API also publishes.
Are free-plan odds delayed?
Yes. Free plans show odds with a 15-minute delay.
What history and streaming access are available?
The API provides minute to daily odds history. A live stream is available on paid plans.