All APIs

Prediction markets API

One API for market-implied odds on economic releases, central bank decisions, metals and energy prices from regulated and crypto prediction markets. REST endpoints and MCP tools use the same inputs.

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

API reference →

GETGet topic details/v1/predictions/topics/{topic_id}

API reference →

GETList dated events/v1/predictions/events

API reference →

GETGet event odds by shape/v1/predictions/{shape}/{event_id}

API reference →

GETGet historical odds for an event/v1/predictions/{shape}/{event_id}/history

API reference →

GETGet central bank policy paths/v1/predictions/policy-paths/{authority}

API reference →

WSStream live odds over WebSocket/v1/predictions/stream

API reference →

How the data works

Topics by kind

US CPI and core CPI, payrolls, unemployment, GDP and recession, plus central bank decisions, metals and energy.

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 includes seven central banks; gold, silver and copper price levels and weekly or monthly highs and lows; and WTI, Brent and natural gas. Odds are market prices, not guarantees of outcomes.