Get future by ID

Fetch a single future with live market data from all platforms

GET /futures/{id}

Get future by ID

cURL

curl --request GET \
  --url https://api-v2.polyrouter.io/futures/{id} \
  --header 'X-API-Key: <api-key>'

200

{
  "data": {
    "id": "nfl_superbowl_2025",
    "future_name": "Super Bowl LIX Winner",
    "league": "nfl",
    "season": 2024,
    "future_type": "championship",
    "category": "team",
    "markets": [
      {
        "platform": "polymarket",
        "market_id": "pm_sb_2025",
        "outcomes": [
          {
            "outcome_name": "Kansas City Chiefs",
            "odds": {
              "american": "+150",
              "decimal": 2.5,
              "implied_probability": 0.4
            },
            "team_polyrouter_id": "nfl_kc",
            "volume_24h": 25000,
            "last_trade_price": 0.15,
            "metadata": {}
          }
        ]
      }
    ],
    "metadata": {
      "deadline": "<string>",
      "description": "<string>",
      "eligible_teams": [
        "<string>"
      ]
    }
  },
  "meta": {
    "platforms_queried": [
      "polymarket",
      "kalshi",
      "prophetx"
    ],
    "request_time": 250,
    "data_freshness": "2025-01-01T00:00:00.000Z",
    "platform_errors": {}
  }
}

Authorizations

X-API-Key · string · header · required

API key for authentication

Path Parameters

id · string · required

Future ID

Example:

"nfl_superbowl_2025"

Response

200

application/json

Future details with market data

data · object · required

Show child attributes

meta · object · required

Show child attributes