Machina Sports Intelligence API
Grounded briefs, price-move explanations, fan sentiment, and model-vs-market differences, with sources, confidence, and caveats. Informational research only; no selection, ranking, or recommendation of wagers.
Grounded briefs, price-move explanations, fan sentiment, and model-vs-market differences, with sources, confidence, and caveats. Informational research only; no selection, ranking, or recommendation of wagers.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/machina-gg:machina-gg-intelligence-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Machina World Cup Intelligence API
version: 0.4.0
summary: World Cup Intelligence APIs for apps and agents (developer preview).
description: 'World Cup 2026 has finished, and this is what the tournament build shipped. Ask anything about a tournament match, get a grounded, source-cited answer. One MCP tool call or one REST request.
Fixture-scoped endpoints accept plain-English inputs (event/team/opponent/date) and player endpoints accept player names, no URNs or provider ids needed. Every fixture response echoes the resolved event_urn for chaining. Model-vs-market differences, probabilities, and backtests are informational research only; there is no selection, ranking, or recommendation of wagers.
The eleven archived storefront endpoints (resolve, get-schedule, get-event-context, get-standings, get-squads, get-injuries, get-player-performance-context, get-match-forecast, backtest-forecasts, skills/match-recap, skills/player-spotlight) carry complete request and response schemas plus one real 200 example each, captured from the completed-tournament archive (world-cup-2026-final-v3). Every body is wrapped in the platform transport envelope exactly as delivered: 200 → {"status":"success","meta":{"code":200},"data":{...endpoint payload}}; errors → {"status":"error","meta":{"code":},"data":{},"error":{...}} (components.schemas.GatewayError). The 200 schemas describe the wrapped body; read the payload from data. Fixture-scoped endpoints REQUIRE a fixture selector in the JSON body: event ("Brazil vs Morocco"), event_urn, provider_event_id, or team (+ opponent / date); player endpoints need a player selector; resolve needs id. A request the API cannot answer returns a typed 400 / 404 / 503 with error.reason_code, error.accepted_fields and error.candidates, and is never billed. get-match-forecast returns the model''s original pre-kickoff forecast: forecast.data_source = "seed" (confidence 0.15) is the FIFA-ranking prior used for a side''s first match — intended, not a placeholder. The remaining live-market and intelligence endpoints keep the developer-preview partial shape. x402 per-call payment is available through the ZeroClick storefront (agents.machina.gg).'
contact:
email: support@machina.gg
url: https://machina.gg/contact
servers:
- url: https://api.machina.gg/world-cup/v1
tags:
- name: intelligence
description: Grounded briefs, price-move explanations, fan sentiment, and model-vs-market differences, with sources, confidence, and caveats. Informational research only; no selection, ranking, or recommendation of wagers.
paths:
/generate-market-brief:
post:
operationId: worldcup-generate-market-brief
tags:
- intelligence
summary: worldcup generate market brief
description: Grounded briefs, price-move explanations, fan sentiment, and model-vs-market differences, with sources, confidence, and caveats. Informational research only; no selection, ranking, or recommendation of wagers.
security:
- bearerAuth: []
responses:
'200':
description: Structured World Cup intelligence. Schemas are partial during the developer preview.
'401':
description: Missing or invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayError'
'402':
description: Insufficient credits for this endpoint; `error.top_up_url` says where to top up. Metered endpoints only.
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayError'
/explain-market-move:
post:
operationId: worldcup-explain-market-move
tags:
- intelligence
summary: worldcup explain market move
description: Grounded briefs, price-move explanations, fan sentiment, and model-vs-market differences, with sources, confidence, and caveats. Informational research only; no selection, ranking, or recommendation of wagers.
security:
- bearerAuth: []
responses:
'200':
description: Structured World Cup intelligence. Schemas are partial during the developer preview.
'401':
description: Missing or invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayError'
'402':
description: Insufficient credits for this endpoint; `error.top_up_url` says where to top up. Metered endpoints only.
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayError'
/fan-sentiment-context:
post:
operationId: worldcup-fan-sentiment-context
tags:
- intelligence
summary: worldcup fan sentiment context
description: Grounded briefs, price-move explanations, fan sentiment, and model-vs-market differences, with sources, confidence, and caveats. Informational research only; no selection, ranking, or recommendation of wagers.
security:
- bearerAuth: []
responses:
'200':
description: Structured World Cup intelligence. Schemas are partial during the developer preview.
'401':
description: Missing or invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayError'
'402':
description: Insufficient credits for this endpoint; `error.top_up_url` says where to top up. Metered endpoints only.
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayError'
/find-market-edges:
post:
operationId: worldcup-find-market-edges
tags:
- intelligence
summary: worldcup find market edges
description: Grounded briefs, price-move explanations, fan sentiment, and model-vs-market differences, with sources, confidence, and caveats. Informational research only; no selection, ranking, or recommendation of wagers.
security:
- bearerAuth: []
responses:
'200':
description: Structured World Cup intelligence. Schemas are partial during the developer preview.
'401':
description: Missing or invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayError'
'402':
description: Insufficient credits for this endpoint; `error.top_up_url` says where to top up. Metered endpoints only.
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayError'
components:
schemas:
GatewayError:
type: object
required:
- meta
- status
- data
- error
properties:
meta:
type: object
required:
- code
properties:
code:
type: integer
status:
const: error
data:
type: object
error:
type: object
required:
- code
- message
properties:
code:
type: integer
description: Mirrors the HTTP status.
type:
type: string
enum:
- selector_required
- selector_ambiguous
- unsupported_parameter
- not_found
- capability_unavailable
- archive_error
description: Gateway classification of an unserved answer (absent on auth/credit errors).
reason_code:
type: string
description: The archive's machine-readable cause (see components.schemas.Coverage.reason_code); falls back to the gateway classification.
message:
type: string
billed:
const: false
description: 'Always false on an unserved answer: no credit debit, no ZeroClick usage.'
accepted_fields:
type: array
items:
type: string
description: Request fields the endpoint accepts — use them to correct the call.
candidates:
type: array
items:
$ref: '#/components/schemas/FixtureSummary'
description: Fixtures that matched an ambiguous selector.
archive:
$ref: '#/components/schemas/ArchiveMetadata'
coverage:
$ref: '#/components/schemas/Coverage'
top_up_url:
type: string
description: 'On 402 only: where to buy credits.'
Coverage:
type: object
required:
- schema_version
- status
- reason
- scope
- mode
- source_provenance
- population_count
- eligible_count
- included_count
- excluded_count
- exclusion_reasons
- unsupported_fields
properties:
schema_version:
const: worldcup-storefront-coverage-v1
status:
type: string
enum:
- complete
- partial
- unavailable
- error
reason:
type: string
minLength: 1
scope:
const: completed_tournament_archive
mode:
const: historical
source_provenance:
type: array
items:
type: string
population_count:
type:
- integer
- 'null'
minimum: 0
description: Null means the legacy response did not record this count; null is never equivalent to zero.
eligible_count:
type:
- integer
- 'null'
minimum: 0
included_count:
type:
- integer
- 'null'
minimum: 0
excluded_count:
type:
- integer
- 'null'
minimum: 0
exclusion_reasons:
type: object
additionalProperties:
type: integer
minimum: 0
unsupported_fields:
type: array
items:
type: string
reason_code:
type: string
enum:
- fixture_selector_required
- fixture_ambiguous
- fixture_not_found
- player_selector_required
- player_ambiguous
- player_not_found
- entity_selector_required
- entity_ambiguous
- entity_not_found
- unsupported_parameter
- archive_row_missing
- archive_error
description: Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed.
accepted_fields:
type: array
items:
type: string
description: The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct.
TeamSummary:
type: object
required:
- name
properties:
team_urn:
type:
- string
- 'null'
name:
type: string
qualifier:
type: string
crest:
type:
- string
- 'null'
ResultDetails:
type: object
required:
- schema_version
- fixture_id
- status
- regulation_time_score
- extra_time_score_contribution
- shootout_score
- winner
- provenance
properties:
schema_version:
const: worldcup-result-details-v1
fixture_id:
type: string
status:
type: string
enum:
- FT
- AET
- PEN
regulation_time_score:
$ref: '#/components/schemas/Score'
extra_time_score_contribution:
$ref: '#/components/schemas/Score'
shootout_score:
$ref: '#/components/schemas/Score'
winner:
type:
- object
- 'null'
properties:
qualifier:
type: string
team_id:
type: string
name:
type: string
provenance:
type: object
required:
- provider
- fixture_id
- provider_result_sha256
- source_url
- observed_at
properties:
provider:
type: string
fixture_id:
type: string
provider_result_sha256:
type: string
pattern: ^[0-9a-f]{64}$
source_url:
type: string
format: uri
observed_at:
type:
- string
- 'null'
ArchiveMetadata:
type: object
required:
- mode
- version
- status
- competition
- competition_status
- live
- snapshot_as_of
- capability_status
- provenance
- missing_capabilities
- notes
properties:
mode:
const: final_archive
version:
type: string
enum:
- world-cup-2026-final-v2
- world-cup-2026-final-v3
status:
type: string
enum:
- hit
- miss
- unavailable
- error
description: hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface.
competition:
const: FIFA World Cup 2026
competition_status:
const: completed
live:
const: false
snapshot_as_of:
type:
- string
- 'null'
source_observed_at:
type:
- string
- 'null'
content_created_at:
type:
- string
- 'null'
timestamp_semantics:
type: string
capability_status:
type: string
provenance:
type: array
items:
type: string
missing_capabilities:
type: array
items:
type: string
notes:
type: array
items:
type: string
response_sha256:
type: string
pattern: ^[0-9a-f]{64}$
source_manifest_sha256:
type: string
pattern: ^[0-9a-f]{64}$
request_identity_sha256:
type: string
pattern: ^[0-9a-f]{64}$
reason_code:
type: string
enum:
- fixture_selector_required
- fixture_ambiguous
- fixture_not_found
- player_selector_required
- player_ambiguous
- player_not_found
- entity_selector_required
- entity_ambiguous
- entity_not_found
- unsupported_parameter
- archive_row_missing
- archive_error
FixtureSummary:
type: object
required:
- event_urn
- name
- start_date
- status
- teams
- fixture_id
properties:
event_urn:
type: string
name:
type: string
start_date:
type: string
status:
type: string
competition:
type: string
score:
$ref: '#/components/schemas/Score'
round:
type:
- string
- 'null'
stage:
type:
- string
- 'null'
teams:
type: array
minItems: 2
items:
$ref: '#/components/schemas/TeamSummary'
venue:
type:
- string
- 'null'
fixture_id:
type:
- string
- integer
result_details:
$ref: '#/components/schemas/ResultDetails'
Score:
type:
- object
- 'null'
properties:
home:
type: integer
minimum: 0
away:
type: integer
minimum: 0
elapsed:
type: number
minimum: 0
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'API key passed as a Bearer token: Authorization: Bearer $MACHINA_API_KEY. The MCP server takes the same key as an X-Api-Token header.'