{"openapi":"3.1.0","info":{"title":"Machina World Cup Intelligence APIs","version":"0.1.0-preview","summary":"World Cup Intelligence APIs for apps and agents (developer preview).","description":"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.\n\nThis schema is partial and published for the developer preview. Endpoint request/response schemas will be expanded before general availability. x402 per-call payment is coming soon.","contact":{"email":"support@machina.gg","url":"https://machina.gg/contact"}},"servers":[{"url":"https://api.machina.gg/world-cup/v1"}],"tags":[{"name":"skills","description":"Composite, grounded, source-cited cards — served fresh from cache or authored on demand. Work in Claude and any AI agent."},{"name":"match-context","description":"Resolve any provider id to a canonical entity, then pull fixtures, standings, squads, injuries, and enriched match context."},{"name":"markets","description":"Search Kalshi and Polymarket in one normalized shape, with live order-book depth, price history, and movers."},{"name":"intelligence","description":"Grounded briefs, price-move explanations, fan sentiment, and cross-venue edge candidates — with sources, confidence, and caveats."},{"name":"forecast-signals","description":"Dixon-Coles model probabilities, the live model-vs-market gap, value signals (de-vigged edge, EV, suggested stake), and a published accuracy track record."}],"paths":{"/skills/match-preview":{"post":{"operationId":"worldcup-match-preview","tags":["skills"],"summary":"Match Preview","description":"Grounded preview: form, key men, group context, market snapshot.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/skills/match-recap":{"post":{"operationId":"worldcup-match-recap","tags":["skills"],"summary":"Match Recap","description":"Post-match recap, authored once the final whistle blows.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/skills/player-spotlight":{"post":{"operationId":"worldcup-player-spotlight","tags":["skills"],"summary":"Player Spotlight","description":"Grounded player card with performance context and narrative.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/skills/fan-pulse":{"post":{"operationId":"worldcup-fan-pulse","tags":["skills"],"summary":"Fan Pulse","description":"Social and news sentiment around a team, player, or match.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/skills/market-watch":{"post":{"operationId":"worldcup-market-watch","tags":["skills"],"summary":"Market Watch","description":"Biggest movers plus informational edge candidates, summarized.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/resolve":{"post":{"operationId":"worldcup-resolve","tags":["match-context"],"summary":"worldcup resolve","description":"Resolve any provider id to a canonical entity, then pull fixtures, standings, squads, injuries, and enriched match context.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/get-schedule":{"post":{"operationId":"worldcup-get-schedule","tags":["match-context"],"summary":"worldcup get schedule","description":"Resolve any provider id to a canonical entity, then pull fixtures, standings, squads, injuries, and enriched match context.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/get-event-context":{"post":{"operationId":"worldcup-get-event-context","tags":["match-context"],"summary":"worldcup get event context","description":"Resolve any provider id to a canonical entity, then pull fixtures, standings, squads, injuries, and enriched match context.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/get-standings":{"post":{"operationId":"worldcup-get-standings","tags":["match-context"],"summary":"worldcup get standings","description":"Resolve any provider id to a canonical entity, then pull fixtures, standings, squads, injuries, and enriched match context.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/get-squads":{"post":{"operationId":"worldcup-get-squads","tags":["match-context"],"summary":"worldcup get squads","description":"Resolve any provider id to a canonical entity, then pull fixtures, standings, squads, injuries, and enriched match context.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/get-injuries":{"post":{"operationId":"worldcup-get-injuries","tags":["match-context"],"summary":"worldcup get injuries","description":"Resolve any provider id to a canonical entity, then pull fixtures, standings, squads, injuries, and enriched match context.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/get-player-performance-context":{"post":{"operationId":"worldcup-get-player-performance-context","tags":["match-context"],"summary":"worldcup get player performance context","description":"Resolve any provider id to a canonical entity, then pull fixtures, standings, squads, injuries, and enriched match context.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/search-markets":{"post":{"operationId":"worldcup-search-markets","tags":["markets"],"summary":"worldcup search markets","description":"Search Kalshi and Polymarket in one normalized shape, with live order-book depth, price history, and movers.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/get-market-state":{"post":{"operationId":"worldcup-get-market-state","tags":["markets"],"summary":"worldcup get market state","description":"Search Kalshi and Polymarket in one normalized shape, with live order-book depth, price history, and movers.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/market-movers":{"post":{"operationId":"worldcup-market-movers","tags":["markets"],"summary":"worldcup market movers","description":"Search Kalshi and Polymarket in one normalized shape, with live order-book depth, price history, and movers.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/compare-market-sources":{"post":{"operationId":"worldcup-compare-market-sources","tags":["markets"],"summary":"worldcup compare market sources","description":"Search Kalshi and Polymarket in one normalized shape, with live order-book depth, price history, and movers.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/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 cross-venue edge candidates — with sources, confidence, and caveats.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/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 cross-venue edge candidates — with sources, confidence, and caveats.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/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 cross-venue edge candidates — with sources, confidence, and caveats.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/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 cross-venue edge candidates — with sources, confidence, and caveats.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/get-match-forecast":{"post":{"operationId":"worldcup-get-match-forecast","tags":["forecast-signals"],"summary":"worldcup get match forecast","description":"Dixon-Coles model probabilities, the live model-vs-market gap, value signals (de-vigged edge, EV, suggested stake), and a published accuracy track record.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/get-signal":{"post":{"operationId":"worldcup-get-signal","tags":["forecast-signals"],"summary":"worldcup get signal","description":"Dixon-Coles model probabilities, the live model-vs-market gap, value signals (de-vigged edge, EV, suggested stake), and a published accuracy track record.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}},"/backtest-forecasts":{"post":{"operationId":"worldcup-backtest-forecasts","tags":["forecast-signals"],"summary":"worldcup backtest forecasts","description":"Dixon-Coles model probabilities, the live model-vs-market gap, value signals (de-vigged edge, EV, suggested stake), and a published accuracy track record.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Structured World Cup intelligence. Schemas are partial during the developer preview."}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key passed as a Bearer token: Authorization: Bearer $MACHINA_API_KEY. x402 per-call payment coming soon."}}}}