FootyQuanta
Loading account…

FOOTYQUANTA · API DOCUMENTATION

From your first fixture to the full game.

Explore 43 read-only endpoints, organized by use case. Find parameter types, requirements, defaults, response fields and JSON examples.

Explore the API reference

Browse by resource

1. Create an API key

Create an account, then generate a key in the console. The full key is shown only once. Store it in a server-side environment variable.

shell
export FQ_API_KEY="fq_live_..."

2. Make a request

All endpoints use GET with an X-API-Key header. Base URL: https://api.footyquanta.com/v1/football.

shell
curl 'https://api.footyquanta.com/v1/football/matches/today' \
  -H "X-API-Key: $FQ_API_KEY"
JavaScript · Server-side
const response = await fetch(`https://api.footyquanta.com/v1/football/matches/today`, {
  headers: { "X-API-Key": process.env.FQ_API_KEY },
});
if (!response.ok) throw new Error(await response.text());
const body = await response.json();
console.log(body.data);

3. Read the response

Successful responses have code: 0. data contains an object or array. Only paginated endpoints include meta. Application errors return data: null; query parsing errors use a plain-text 400 response.

JSON · Paginated response
{
  "code": 0,
  "message": "ok",
  "request_id": "req_demo_001",
  "data": [],
  "meta": {
    "page": 1,
    "page_size": 50,
    "total": 0
  }
}

Common conventions

ConventionDetails
PaginationOnly endpoints listing page/page_size accept them. Defaults: page 1, page_size 50. Maximum page_size: 100. The number of skipped records must not exceed 100000.
Batch IDsOnly endpoints listing ids accept batch lookups. Use up to 20 comma-separated IDs. Treat entity IDs as opaque strings.
TimezonesOmit timezone to use UTC. Only fixed UTC offsets are supported, not IANA names such as Europe/London. Encode + as %2B in URLs.
Missing datanull means missing or unavailable data. An empty array means no records were returned. Neither should be treated as zero.
ValidationUse only parameters listed for the endpoint. Unknown query parameters return 400. GET requests do not need a request body.