Datasets

Every dataset, one key

All endpoints live under https://api.polx.io/v1 and share the same auth, pagination and field conventions. Endpoints marked live answer today with a free-tier key; planned ones follow in order.

Fixtures & results

core live
  • GET /fixtures
  • GET /matches/{id}
  • GET /results
Coverage
335,191 matches · 2,139 leagues
Fields
match_id, league, kickoff, status, home, away, score

Live match state

core live
  • GET /live
  • GET /matches/{id}/live
Coverage
every match in play, from the live stream
Fields
minute, half, score, dangerous_attacks, shots_on_target, possession, corners, cards, derived.tempo_per_min

Timelines

core live
  • GET /matches/{id}/timeline
Coverage
1.9M snapshots · 2020 →
Fields
one row per snapshot: minute, score, stats, odds, as_of

Match stats

core live
  • GET /matches/{id}/stats
  • GET /teams/{id}/form
Coverage
final-state stats per match; rolling team aggregates
Fields
goals, shots, corners, dangerous_attacks, possession, cards, subs

Odds & line movement

premium planned
  • GET /odds/prematch
  • GET /odds/inplay
  • GET /odds/movement
Coverage
1X2, Asian handicap, goal and corner lines, pre-match and in-play
Fields
line, over, under, implied, delta_vs_open

Form & head-to-head

core live
  • GET /teams/{id}/form
  • GET /h2h?home=&away=
Coverage
last-N results per team
Fields
scored/conceded by half, corner profile, tempo profile

Signal ledger

premium live
  • GET /signals
  • GET /signals/{id}
  • GET /signals/feed
  • GET /signals/markets
Coverage
768k settled signals since 2019
Fields
market, selection, line, odds, minute, score_at_entry, state_at_entry, outcome, settled_at

Match screener

core live
  • POST /screener/matches
Coverage
live and historical
Fields
filter expressions: {"minute_lte": 20, "goals_gte": 2, "tempo_gte": 1.2}

Model probabilities

premium planned
  • GET /models
  • GET /models/{name}/predict?match_id=
Coverage
our in-play models as probabilities with EV vs current price
Fields
model, probability, price, ev, features_used

Smart-money flow

premium planned
  • GET /polymarket/markets
  • GET /polymarket/flow
  • GET /polymarket/wallets
Coverage
933k trades · 250 vetted wallets
Fields
wallet, market, side, price, size, timestamp, conviction_ratio

Leagues, teams & search

core live
  • GET /leagues
  • GET /teams
  • GET /search?q=
  • GET /coverage
Coverage
2,139 leagues · 176 countries
Fields
canonical ids, names, country, season

Events

scale planned
  • GET /stream (SSE)
  • webhooks
Coverage
goals, cards, kick-off, full time, signals fired
Fields
event_type, match_id, minute, payload