Authentication

Send your API key in the Authorization header on every request:

Authorization: Token YOUR_API_KEY

Get a key at predictiqpro.com/register. 14-day trial: a card is required and nothing is charged until it ends. WebSockets can’t set headers in a browser, so they take the key as a ?key= query parameter instead. Endpoints marked Public need no key.

Base URL & limits

https://api.predictiqpro.com

Request limits depend on your plan; see pricing. Every authenticated response carries X-RateLimit-Limit-Hourly and X-RateLimit-Remaining-Hourly headers (plus daily and monthly ones where your plan has those limits), so you can see where you stand before you hit a 429. GET /account/me shows current usage.

Errors

Errors use standard HTTP status codes. 401 means a missing or invalid key, 404 an unknown id and 429 a rate limit reached.

Original endpoints return a detail message:

{ "detail": "Missing or malformed Authorization header" }

v2 endpoints return a structured error:

{ "success": false, "error": { "code": "NOT_FOUND", "message": "No player found with id 1" } }

And a successful v2 response looks like this:

{
  "success": true,
  "data": { ... },
  "meta": { "last_updated": "2026-10-05T09:30:00+00:00", "source": "internal" },
  "pagination": { "limit": 50, "offset": 0, "total": 312 }
}

Quickstart

curl https://api.predictiqpro.com/predictions/live \
  -H "Authorization: Token YOUR_API_KEY"

Download the OpenAPI spec

Import the collection into Postman, add your key to the api_key variable, and run Live and upcoming predictions first.

Free sandbox

Build and test your integration before you add a card. Create a free account, copy your key and call the sandbox routes. They return invented matches in the same format as the live API, marked "sample": true, limited to 120 calls an hour. Live predictions, odds and market data need the 14-day trial or a paid plan.

# No card needed. Sample data in the same format as the live API.
curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.predictiqpro.com/sandbox/predictions/live

# One sample match (ids 900001 to 900003)
curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.predictiqpro.com/sandbox/predictions/900001

Create a free account to get a key.

Fixtures & lineups

Matches across every covered league, with scores, kickoff times and confirmed line-ups.

Standings

League tables built from finished and in-play matches.

News

Predictions

Win/draw/loss probabilities, expected goals and goal markets. Probabilities are the market consensus where market data exists (basis: market_consensus) and the statistical model otherwise (basis: statistical_model); the model’s own numbers are always included as model_prob_*.

Market analysis

De-vigged market probabilities and movement signals, for comparing the model against the market. Coverage varies by match.

Accuracy & status

Published on purpose, no key needed: measured against finished matches the model predicted before kickoff.

Live scores feed

Every match in play, straight from the live feed rather than waiting on a database sync. Poll it every 20 seconds, or use the WebSocket below to have changes pushed to you.

curl https://api.predictiqpro.com/live/feed

Live arena

Momentum and match statistics behind the 3D arena. The arena on any fixture is included from the Developer plan up; the stats and history endpoints are open.

Show the 3D arena on your own site with one iframe. It runs live for a match in play, or replays a finished match. What it draws is real match data: pressure, score and statistics. It does not move a ball or players, because no on-pitch position data is part of the feed.

Your embed key

• One key per account, on the Live arena embed card of your dashboard.
• You choose up to 3 sites that may show it. Subdomains are included, so example.com also allows app.example.com.
• predictiqpro.com always works, so you can preview. With an empty list the embed shows nowhere else.
• Making a new key stops the old one at once; anything still using it goes blank.
• The key is not an API key. It only lets the arena load and gives no access to your data.

Embedding

<iframe src="https://predictiqpro.com/embed/arena/{match_id}?key=YOUR_EMBED_KEY"
  width="100%" height="520" frameborder="0" allowfullscreen></iframe>

{match_id} is the same id the REST API uses, so a match from GET /live/feed drops straight in.

URL options

The arena starts with every layer on. Add options to the address to change what it draws before the first frame, for a small panel or next to a scoreboard you already show.

<iframe src="https://predictiqpro.com/embed/arena/{match_id}?key=YOUR_EMBED_KEY&mode=replay&dim=2&off=wave,rings&quality=low"
  width="100%" height="520" frameborder="0" allowfullscreen></iframe>

Layers

Names that are not on this list are ignored, so a typo does nothing rather than breaking the page. The address has the last word: the arena always starts in the state you asked for.

Which matches work

• Live: a match in play with reported pressure data. Check GET /live/feed first.
• Replay: a finished match with recorded pressure data. Without it the embed says so instead of drawing an empty pitch.

What you will see

Live demo

This isn’t a screenshot. It’s the real /predictions/live endpoint, rendered as one of the drop-in embeddable widgets.

v2 · Events

v2 wraps every response in { success, data, meta } and paginates lists with limit and offset (default 50, max 200). The index at GET /api/v2 lists every resource.

v2 · Leagues & teams

v2 · Players, managers & venues

v2 · TV & social

Account

Widgets & MCP

Drop ready-made match and prediction widgets into your own site with the widgets, or let AI agents call this data directly through the MCP server. New to the API? Follow a step-by-step quickstart guide in Python or JavaScript.