Markets orchestration — connects ESPN live schedules with Kalshi and Polymarket prediction markets. Unified dashboards, odds comparison, entity search, and bet evaluation across platforms. Use when: user wants to see prediction market odds alongside ESPN game schedules, compare odds across platforms

Markets Orchestration Bridges ESPN live schedules (NBA, NFL, MLB, NHL, WNBA, CFB, CBB) with Kalshi and Polymarket prediction markets. Before writing queries, consult references/api reference.md for supported sport codes, command parameters, and price normalization formats. Quick Start Python SDK: CRITICAL: Before Any Query CRITICAL: Before calling any orchestration command, verify: A sport code is provided for sport aware commands ( get todays markets , compare odds , get sport markets , evaluate market ). Price sources are identified correctly before normalization: espn = American odds, polymarket / novig / gemini = 0 1 probability, kalshi = 0 100 integer. Important Notes Sport context is passed through. sport=nba maps automatically to the correct Polymarket sport code and Kalshi series ticker. Venues differ by command. get todays markets , search entity and compare odds include Kalshi, Polymarket, ProphetX, Novig and Gemini where supported. Gemini discovery accepts no sport or nba , wnba , nfl , cfb , mlb , nhl , epl , laliga , mls , ligamx , ufc , f1 , golf . The daily dashboard includes Gemini for supported ESPN scoreboard sports ( nba , wnba , nfl , cfb , mlb , nhl ). Gemini comparison is NBA only until settlement equivalence is verified for other sports; those sports leave Gemini out of sources . Unsupported discovery sports skip Gemini without a request. normalize price accepts gemini (0 1 probability). get sport markets , match markets and evaluate market use Kalshi and Polymarket only; compare market url , get market price and get price history do not support Gemini. Sport aware search. Polymarket uses sport → series id; Kalshi searches every series mapped for the sport (game winners, spreads, totals, futures). Prices are normalized. Everything is converted to implied probability for comparison. Discovery is not verification. Raw market lists ( markets , get sport markets , search entity ) are search hits, not verified equivalents of a given game's contract. Only compare odds side prices (and evaluate market ) are identity checked. Workflows Today's NBA Dashboard Returns each game with ESPN info, DraftKings odds, and matching Kalshi, Polymarket, ProphetX, Novig and Gemini ( gemini markets ) markets. Gemini dashboard discovery covers NBA, WNBA, NFL, CFB, MLB and NHL; it does not verify that each search hit is the same contract. Find Arb on a Specific Game 1. Get the ESPN event ID: get sport schedule sport=nba 2. Compare odds: compare odds sport=nba event id=<id 3. If arbitrage detected, response includes allocation percentages and ROI — computed from reference prices ( price basis: "reference" ), so confirm both legs on each venue's order book before trading it. 4. sources and completeness say which venues actually priced this game; a provider error is reported as error , not as "no markets". 5. For a direct price comparison read side prices.home / side prices.away : each lists quotes ( venue , implied probability , price basis: "reference" , execution guaranteed: false ) admitted as this game's full game moneyline, plus lowest reference ( null when a side has no quote; ties keep the first listed venue). The lowest reference is not an executable quote, not fee adjusted, and not a bet recommendation. Check warnings and completeness.complete before calling a comparison complete. 6. Venues searched: Kalshi, Polymarket, ProphetX and Novig. Novig counts only when the event date matches and a full game MONEY market has a two way order book. Its price is the derived ask (1 − best opposite bid), a cached snapshot. Catalog only markets, spreads and period markets show up in novig markets but never price a side. search entity and get todays markets also include a novig section with the same results. 7. Gemini (nba only) counts only for exactly one active, full contest moneyline ( moneyline / contest / full contest ) of the same league whose startTime equals ESPN's start instant, with exactly two active, open, non combo contracts whose sides agree with ESPN's teams and whose buy YES prices are both in (0, 1). Its price is that buy YES price from a cached public snapshot — a reference, not an executable quote, and volume says nothing about liquidity. Child markets (spreads, totals, props, periods), combos, three way markets, closed/settled contracts, missing or malformed prices, other start times and duplicate candidates are refused with a reason in sources.gemini.detail ; they still appear in gemini markets . A Gemini failure is error ; a partial scan (later page failed or scan truncated) is listed in sources.gemini.warnings . Compare a Pasted Market Link compare market url 1. compare market url url=<link . Supported links: https://polymarket.com/event/<event slug [/<market slug ] and https://kalshi.com/markets/<series /<slug /<event ticker ( www. allowed), for single games of nfl, nba, mlb, nhl, wnba, cfb, cbb. 2. The link is never fetched. The host must match exactly. Credentials, ports, fragments, encoded or odd path segments, and unknown query keys are refused before any call (only utm and other click tracking keys are ignored). 3. The venue API resolves exactly one open full game two way moneyline (Polymarket) or the two open game winner contracts (Kalshi). Closed, non moneyline, three way or ambiguous sources are refused, and so is a provider answer that names another slug/ticker. 4. ESPN scoreboards for the source date ±1 day must yield exactly one game whose teams and date validate. Doubleheaders and multiple matches are refused, and a scoreboard failure is reported as a failure, not as "no game". 5. Returns the compare odds payload unchanged ( side prices , sources , warnings , …) plus source market (venue, canonical url , event/market ids, espn event id , in downstream search ). When the source contract is missing from the comparison's venue search, a warning says so and no price is invented. 6. This matches the same game's moneyline only. It does not mean the venues settle identically, and it guarantees no execution. Novig, ProphetX and Gemini links are not accepted yet, though those venues still appear in the comparison where compare odds searches them. Full Bet Evaluation 1. evaluate market sport=nba event id=<id outcome=0 fee per contract=<dollars per $1 contract 2. Verifies the market is this game's full game winner market for the chosen side, then reads the ask off the order book 3. Pipes ask + fee through betting.evaluate bet : devig → edge → Kelly 4. Returns fair probability, edge, EV, Kelly fraction, and recommendation Without fee per contract the ask is reported but evaluation is null — the net numbers are refused rather than assumed free. A ticker or token id that names another team, another date, or a derivative (first half, spread) market is refused, not substituted. Pass the fee via the CLI ( fee per contract=<dollars ) or the Python wrapper. The fee must be an explicit, verified assumption: one the user stated, or the venue's officially documented fee schedule (say which). Never silently assume 0 . If no fee can be verified, evaluation stays null . Same Game on Both Venues 1. match markets sport=mlb date=2026 06 06 2. Each match pairs the Kalshi event (with market tickers) and the Polymarket event (with moneyline token IDs) for the same game — joined deterministically on date + team codes, fuzzy title match as fallback. 3. Feed kalshi.market tickers[i] and polymarket.markets[i].token ids[j] straight into get market price to compare prices. Price Movement Over Time 1. get market price venue=kalshi ticker=<ticker at time=2026 05 01 for a single point in time price (both yes / no sides, 0 1). 2. get price history venue=kalshi ticker=<ticker interval=1d for the full series — same {timestamp, price} shape on either venue. Examples Example 1: Today's games with prediction market odds User says: "What NBA games are on today and what are the prediction market odds?" Actions: 1. Call get todays markets(sport="nba") Result: Unified dashboard with each game's ESPN info and Kalshi/Polymarket/ProphetX/Novig/Gemini markets Example 2: Cross platform team search User says: "Find me Lakers markets on Kalshi and Polymarket" Actions: 1. Call search entity(query="Lakers", sport="nba") Result: Lakers search hits from Kalshi, Polymarket, ProphetX, Novig and Gemini (discovery only — not verified as the same contract) Example 3: Odds comparison for a specific game User says: "Compare the odds for this Celtics game across ESPN and Polymarket" Actions: 1. Get event id from get sport schedule(sport="nba") 2. Call compare odds(sport="nba", event id="<id ") Result: side prices per side (admitted reference quotes + lowest reference ) and an arbitrage check on reference prices Example 4: Full market evaluation User says: "Is there edge on the Chiefs game?" Actions: 1. Get event id from get sport schedule(sport="nfl") 2. Establish a verified fee (user stated or the venue's documented fee), then call evaluate market(sport="nfl", event id="<id ", fee per contract=<verified fee ) Result: Fair probability, edge percentage, EV, Kelly fraction, and bet recommendation. Without a verified fee, the executable ask is reported and evaluation is null . Example 5: Browse all markets for a sport User says: "Show me all NFL prediction markets" Actions: 1. Call get sport markets(sport="nfl") Result: All open NFL markets across Kalshi and Polymarket Example 6: Price conversion User says: "Convert a Polymarket price of 65 cents to American odds" Actions: 1. Call normalize price(price=0.65, source="polymarket") Result: Common structure with implied probability (0.65), American odds ( 185.7), and decimal (1.54) Example 7: Pair a game across venues User says: "Find the Mets game on both Kalshi and Polymarket" Actions: 1. Call match markets(sport="mlb", date="<game date ") Result: The game paired across venues — Kalshi market tickers and Polymarket moneyline token IDs side by side Example 8: Historical price User says: "What was France's World Cup price a month ago?" Actions: 1. Call get market price(venue="kalshi", ticker="KXMENWORLDCUP 26 FR", at time="2026 05 03T12:00:00+00:00") Result: Yes/no prices (0 1) as of that moment; use get price history for the full curve Commands that DO NOT exist — never call these ~~ get odds ~~ — does not exist. Use compare odds to see odds across sources. ~~ search markets ~~ — does not exist on the markets module. Use search entity instead. ~~ get schedule ~~ — does not exist. Use get sport schedule instead. If a command is not listed in references/api reference.md or in this file's workflows (e.g. compare market url ), it does not exist. Troubleshooting Error: No markets returned for a sport Cause: Sport code may be missing or incorrect Solution: Check references/api reference.md for valid sport codes. Use the exact code (e.g., nba , epl , laliga ) Error: compare odds returns no data for an event Cause: The event id is incorrect or the game has not been indexed yet Solution: Call get sport schedule(sport=...) to retrieve the correct event id first Error: One source shows warnings in the response Cause: Kalshi or Polymarket is temporarily unavailable Solution: The module returns partial results — use what is available. Retry the unavailable source separately using the kalshi or polymarket skill directly Error: normalize price returns unexpected American odds value Cause: Wrong source parameter — Kalshi uses 0 100 integers, Polymarket uses 0 1 decimals Solution: Verify the source. Kalshi price of 65 requires source="kalshi" , Polymarket price of 0.65 requires source="polymarket" Discover the Machina Agent Storefront (optional, paid