Skip to main content
GET
/
feeds
/
catalog
Feed catalog
curl --request GET \
  --url https://api.oddpool.com/feeds/catalog
List all available feed events, grouped by feed vertical. Returns event keys, venues, outcome counts, and pre-built channel names.

​
Parameters

​
feed
string
default:"all"
Filter by feed vertical: macro, crypto, or weather.
​
status
string
default:"all"
Filter by event status: active, upcoming, or resolved. Useful for crypto feeds where hundreds of short-lived events accumulate — use status=active to get only live events.

​
Example

# All active crypto events
curl -H "X-API-Key: oddpool_..." \
  "https://api.oddpool.com/feeds/catalog?feed=crypto&status=active"

# All macro events (any status)
curl -H "X-API-Key: oddpool_..." \
  "https://api.oddpool.com/feeds/catalog?feed=macro"

​
Response

{
  "feeds": {
    "crypto": {
      "description": "Crypto prediction markets enriched with Binance spot/futures",
      "events": [
        {
          "event_key": "btc-5m-2026-03-24-0830-et",
          "title": "BTC 5min Mar 24 8:30AM ET",
          "type": "crypto",
          "event_date": "2026-03-24",
          "status": "active",
          "venues": ["polymarket"],
          "outcomes": 1,
          "enrichment": "binance",
          "channels": {
            "dist": "dist:btc-5m-2026-03-24-0830-et",
            "book": "book:btc-5m-2026-03-24-0830-et:{outcome_key}",
            "trade": "trade:btc-5m-2026-03-24-0830-et:{outcome_key}",
            "snapshot": "snapshot:btc-5m-2026-03-24-0830-et"
          }
        },
        {
          "event_key": "btc-hourly-2026-03-24-0900-et",
          "title": "BTC Hourly Mar 24 9:00AM ET",
          "type": "crypto",
          "event_date": "2026-03-24",
          "status": "active",
          "venues": ["kalshi", "polymarket"],
          "outcomes": 188,
          "enrichment": "binance",
          "channels": {
            "dist": "dist:btc-hourly-2026-03-24-0900-et",
            "book": "book:btc-hourly-2026-03-24-0900-et:{outcome_key}",
            "trade": "trade:btc-hourly-2026-03-24-0900-et:{outcome_key}",
            "snapshot": "snapshot:btc-hourly-2026-03-24-0900-et"
          }
        }
      ]
    },
    "macro": {
      "description": "Cross-venue macro economic prediction markets",
      "events": [
        {
          "event_key": "fomc-2026-04-29",
          "title": "FOMC April 2026",
          "type": "fomc",
          "event_date": "2026-04-29",
          "status": "upcoming",
          "venues": ["kalshi", "polymarket"],
          "outcomes": 5,
          "channels": {
            "dist": "dist:fomc-2026-04-29",
            "book": "book:fomc-2026-04-29:{outcome_key}",
            "trade": "trade:fomc-2026-04-29:{outcome_key}",
            "snapshot": "snapshot:fomc-2026-04-29"
          }
        }
      ]
    }
  }
}
FieldDescription
event_keyUnique identifier for the event. Use this in channel subscriptions.
venuesWhich prediction market venues have data for this event.
enrichmentExternal data source attached to every message. Only present for enriched feeds (e.g., "binance" for crypto). Macro events do not have this field.
channelsPre-built channel names. Replace {outcome_key} with a value from the single-event endpoint.

​
Get single event

GET https://api.oddpool.com/feeds/catalog/{event_key}
Get a single event with its full outcome list and per-outcome channel names. Use this to find the outcome_key values for book and trade subscriptions.

​
Example

curl -H "X-API-Key: oddpool_..." \
  "https://api.oddpool.com/feeds/catalog/fomc-2026-04-29"

​
Response

{
  "event_key": "fomc-2026-04-29",
  "title": "FOMC April 2026",
  "type": "fomc",
  "feed": "macro",
  "event_date": "2026-04-29",
  "status": "upcoming",
  "outcomes": [
    {
      "outcome_key": "hold",
      "label": "Fed maintains rate",
      "venues": ["kalshi", "polymarket"],
      "channels": {
        "book": "book:fomc-2026-04-29:hold",
        "trade": "trade:fomc-2026-04-29:hold"
      }
    },
    {
      "outcome_key": "cut_25",
      "label": "Cut 25bps",
      "venues": ["kalshi", "polymarket"],
      "channels": {
        "book": "book:fomc-2026-04-29:cut_25",
        "trade": "trade:fomc-2026-04-29:cut_25"
      }
    }
  ],
  "channels": {
    "dist": "dist:fomc-2026-04-29",
    "snapshot": "snapshot:fomc-2026-04-29"
  }
}