Skip to main content
GET
/
futures
/
{future_id}
Get futures odds
curl --request GET \
  --url https://api.polyrouter.io/functions/v1/futures/{future_id} \
  --header 'X-API-Key: <api-key>'
{
  "futures": [
    {
      "id": "nfl_superbowl_2025",
      "future_name": "Super Bowl LX Winner",
      "league": "nfl",
      "season": 2025,
      "future_type": "championship",
      "category": "team",
      "markets": [
        {
          "platform": "<string>",
          "market_id": "<string>",
          "outcomes": [
            {
              "team_polyrouter_id": "<string>",
              "outcome_name": "<string>",
              "odds": {
                "american": "<string>",
                "decimal": 123,
                "implied_probability": 123
              },
              "volume_24h": 123,
              "last_trade_price": 123,
              "metadata": {}
            }
          ]
        }
      ],
      "metadata": {}
    }
  ],
  "pagination": {
    "total": 123,
    "limit": 123,
    "offset": 123,
    "has_more": true,
    "next_offset": 123
  },
  "meta": {
    "request_time": 123,
    "cache_hit": true,
    "data_freshness": "2023-11-07T05:31:56Z"
  }
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

future_id
string
required

Future identifier (format: {league}{future_type}{season})

Example:

"nfl_superbowl_2025"

Query Parameters

platform
enum<string>

Filter by platforms (comma-separated): polymarket, kalshi

Available options:
,
polymarket,
kalshi
odds_format
enum<string>
default:american

Odds format

Available options:
american,
decimal,
probability

Response

Futures markets retrieved successfully

futures
object[]
pagination
object
meta
object