Skip to main content
GET
/
list-futures
List available futures
curl --request GET \
  --url https://api.polyrouter.io/functions/v1/list-futures \
  --header 'X-API-Key: <api-key>'
{
  "data": {
    "futures": [
      {
        "id": "nfl_superbowl_2025",
        "future_name": "Super Bowl LX Winner",
        "league": "nfl",
        "season": 2025,
        "future_type": "championship",
        "category": "team",
        "platforms": [
          "<string>"
        ],
        "metadata": {
          "deadline": "2023-11-07T05:31:56Z",
          "description": "<string>",
          "eligible_teams": [
            "<string>"
          ]
        }
      }
    ],
    "pagination": {
      "total": 123,
      "limit": 123,
      "offset": 123,
      "has_more": true,
      "next_offset": 123
    },
    "meta": {
      "league": "<string>",
      "data_freshness": "2023-11-07T05:31:56Z"
    }
  },
  "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

Query Parameters

league
enum<string>
required

League ID (required)

Available options:
,
nfl,
nba,
nhl,
mlb
future_type
enum<string>

Filter by future type

Available options:
championship,
division,
conference
season
integer
default:2025

Season year

Response

Futures list retrieved successfully

data
object
meta
object