# Machina World Cup Intelligence APIs — agent.txt

Status: developer preview
Base URL: https://api.machina.gg/world-cup/v1
Human page: https://machina.gg/world-cup-api
OpenAPI (partial, preview): https://machina.gg/world-cup-api/openapi.json
Docs: https://docs.machina.gg/

## Product summary

World Cup Intelligence APIs for apps and agents.
Ask anything about any match — get a grounded, source-cited answer you can put on air, publish, show in-app, or analyze. One call, for your team or your agents.

## Providers
Markets and reasoning: Kalshi, Polymarket, Google Gemini, xAI Grok

## Skills — finished outcome cards
  - worldcup-match-preview: Match Preview — Grounded preview: form, key men, group context, market snapshot.
  - worldcup-match-recap: Match Recap — Post-match recap, authored once the final whistle blows.
  - worldcup-player-spotlight: Player Spotlight — Grounded player card with performance context and narrative.
  - worldcup-fan-pulse: Fan Pulse — Social and news sentiment around a team, player, or match.
  - worldcup-market-watch: Market Watch — Biggest movers plus informational edge candidates, summarized.

## APIs — building blocks

### Match & Context
Resolve any provider id to a canonical entity, then pull fixtures, standings, squads, injuries, and enriched match context.
Endpoints:
  - worldcup-resolve
  - worldcup-get-schedule
  - worldcup-get-event-context
  - worldcup-get-standings
  - worldcup-get-squads
  - worldcup-get-injuries
  - worldcup-get-player-performance-context

### Markets
Search Kalshi and Polymarket in one normalized shape, with live order-book depth, price history, and movers.
Endpoints:
  - worldcup-search-markets
  - worldcup-get-market-state
  - worldcup-market-movers
  - worldcup-compare-market-sources

### Intelligence
Grounded briefs, price-move explanations, fan sentiment, and cross-venue edge candidates — with sources, confidence, and caveats.
Endpoints:
  - worldcup-generate-market-brief
  - worldcup-explain-market-move
  - worldcup-fan-sentiment-context
  - worldcup-find-market-edges

### Forecast & Signals
Dixon-Coles model probabilities, the live model-vs-market gap, value signals (de-vigged edge, EV, suggested stake), and a published accuracy track record.
Endpoints:
  - worldcup-get-match-forecast
  - worldcup-get-signal
  - worldcup-backtest-forecasts

## Authentication

API-key auth via Bearer token in the Authorization header:

  Authorization: Bearer $MACHINA_API_KEY

x402 per-call payment (no account, no key) is coming soon. Never hardcode credentials — use environment variables.

## Example request (Skill)

curl https://api.machina.gg/world-cup/v1/skills/match-preview \
  -H "Authorization: Bearer $MACHINA_API_KEY" \
  -d '{ "event": "Brazil vs Morocco" }'

## Example response (example data, not live)

{
  "skill_card": {
    "headline": "Brazil vs Morocco: Group C heavyweights clash at MetLife Stadium",
    "summary": "Brazil bring Vinícius Júnior and Endrick; Morocco rely on the tactical discipline that powered their 2022 semi-final run.",
    "key_players": ["Vinícius Júnior", "Endrick"],
    "model_forecast": {
      "home_win": 0.39, "draw": 0.32, "away_win": 0.29,
      "most_likely_score": "1-1", "confidence": 0.15
    },
    "team_form": { "home": "Seeded from FIFA/qualifier form.", "away": "Seeded from FIFA/qualifier form." },
    "watch_items": ["How Morocco's defense handles Vinícius Júnior and Endrick."]
  },
  "served_from": "cache",
  "freshness": "FRESH"
}

## Pricing — Machina Credits

Credits never expire and work across every Machina product.

Packs:
  - Free ($0): 100 credits. Explore and prototype — no card required.
  - Starter ($50): 5,000 credits. $0.010 / credit.
  - Pro ($200): 25,000 credits. $0.008 / credit · 20% off.
  - Scale ($600): 100,000 credits. $0.006 / credit · 40% off.

Credit cost by class:
  - data: 1 credits
  - market: 3 credits
  - social: 8 credits
  - intelligence: 12 credits
  - edge: 18 credits
  - skill: 25–60 credits

Coming soon — agents pay per call in stablecoin via x402, same rate, no account or key. Health checks are free.

## Rate limits

  - Free: 10 requests/min
  - Starter: 60 requests/min
  - Pro: 300 requests/min
  - Scale: custom

## Safety rules

  - Read-only. These endpoints never place trades, route orders, or recommend bets.
  - Market and signal outputs are informational research candidates, not betting or financial advice.
  - Responses carry confidence, sources, and resolution/liquidity/freshness caveats — treat them as signals, not certainties.
  - Demo payloads on the marketing page are example data until backed by live endpoints.
  - Respect rate limits and credit entitlements for your plan tier.

## Support / contact

  - Email: support@machina.gg
  - Contact form: https://machina.gg/contact
  - Talk to the team: https://machina.gg/schedule