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.

GitHub OpenAPI

Operations 4

POST /generate-market-brief worldcup generate market brief #
POST /explain-market-move worldcup explain market move #
POST /fan-sentiment-context worldcup fan sentiment context #
POST /find-market-edges worldcup find market edges #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/machina-gg:machina-gg-intelligence-api"
All apis
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.

Get an API 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 Specification

machina-gg-intelligence-api-openapi.yml Raw ↑
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.'