Topics by kind
US CPI and core CPI, payrolls, unemployment, GDP and recession, plus central bank decisions, metals and energy.
All APIs
Commodity prediction markets API
Query market-implied probabilities for metals and energy events 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/xau-settle" \
--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 →Gold and silver coverage includes price levels and weekly or monthly highs and lows, alongside other metals and energy commodities.
Metals
Energy
Brent crude oil price at a fixed time→Crude oil all-time high by a date→
Natural gas price at a fixed time→Natural gas up or down on the day→Natural gas weekly high and low→WTI crude oil daily close→WTI crude oil monthly high and low→WTI crude oil price at a fixed time→WTI crude oil up or down on the day→WTI crude oil weekly high and low→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 commodity spot prices?
No. The API returns market-implied probabilities for commodity events, including price-level outcomes.
Are free-plan odds delayed?
Yes. Free plans show odds with a 15-minute delay.
Can I retrieve historical odds or use a stream?
Minute to daily odds history is available. Paid plans also include a live stream.