Quickstart

This page takes you from a key to your first useful responses: an event priced on both venues, the proven relation behind a cross-venue gap, a lead sized against order books, a market’s rules, then the live stream and MCP. Every response shown was recorded from the API on 17 September 2026; the markets in the examples settle after that date, so pick current ids from GET /v1/events when you follow along.

Get a key

Keys are issued by the Routeur team during the private preview. A key looks like rk_live_<12-character id>_<43-character secret> and is shown once. Put it in an environment variable and only use it server-side:

export ROUTEUR_API_KEY="rk_live_..."

Send it as X-API-Key or as a bearer token; see Authentication.

Check the service

GET /v1/status names the latest finished graph run and the crawls it was built from.

curl -s https://api.routeur.app/v1/status -H "X-API-Key: $ROUTEUR_API_KEY"

{
  "data": {
    "graph_run": {
      "id": 74,
      "graph_version": "contract-graph/v1",
      "started_at": "2026-09-17T12:10:17.023795Z",
      "finished_at": "2026-09-17T12:10:36.937979Z",
      "listings": [
        { "venue": "kalshi", "crawl_run": 405, "since": "2026-09-17T12:00:19.066598Z" },
        { "venue": "polymarket", "crawl_run": 404, "since": "2026-09-17T12:00:18.890952Z" }
      ],
      "markets": 304955,
      "propositions": 131409,
      "cross_venue_games": 148,
      "edge_counts": { "cross-venue:equivalent": 1301, "cross-venue:contradicts": 1265, "kalshi:contradicts": 589531, "...": 0 },
      "new_edges": 59380,
      "conflicts": 0,
      "opportunities": 36
    },
    "latest_crawls": [
      { "venue": "kalshi", "started_at": "2026-09-17T12:30:14.362718Z", "finished_at": "2026-09-17T12:33:23.889705Z", "complete": true, "markets": 130310 },
      { "venue": "polymarket", "started_at": "2026-09-17T12:30:14.364144Z", "finished_at": "2026-09-17T12:36:04.079904Z", "complete": true, "markets": 174810 }
    ],
    "latest_complete_crawls": [ "..." ]
  },
  "graph_run": 74
}

The output above is trimmed; edge_counts lists every relation kind per venue and across venues.

An event with its outcomes

Events group a venue’s markets the way people browse them. cross_venue=true keeps only events listed on both venues.

curl -s "https://api.routeur.app/v1/events?cross_venue=true&limit=1" \
  -H "X-API-Key: $ROUTEUR_API_KEY"

{
  "data": [
    {
      "venue": "polymarket",
      "id": "810546",
      "title": "Detroit vs Buffalo: Total Points",
      "category": "Sports",
      "venues": ["kalshi", "polymarket"],
      "twin": { "venue": "kalshi", "id": "KXNFLTOTAL-26SEP17DETBUF" },
      "markets": 315,
      "mutually_exclusive": false,
      "starts_at": "2026-09-18T00:15:00Z",
      "closes_at": "2026-09-18T00:15:00Z",
      "volume_24h_usd": "1518274.93",
      "trades_24h": 2795,
      "outcomes": [
        {
          "label": "O/U 54.5",
          "venue": "polymarket",
          "market_id": "nfl-det-buf-2026-09-18-total-54pt5",
          "title": "Lions vs. Bills: O/U 54.5",
          "chance": "0.5200",
          "prices": [
            { "venue": "kalshi", "market_id": "KXNFLTOTAL-26SEP17DETBUF-55", "yes_ask_usd": "0.52", "no_ask_usd": "0.49", "yes_bid_usd": "0.51", "no_bid_usd": "0.48", "observed_at": "2026-09-17T12:33:03.021417Z", "volume_24h_usd": "1076115.39", "spread_usd": "0.01", "liquidity": "deep", "book_yes_depth_5c_usd": "703799.64", "book_no_depth_5c_usd": "371661.00" },
            { "venue": "polymarket", "market_id": "nfl-det-buf-2026-09-18-total-54pt5", "yes_ask_usd": "0.53", "no_ask_usd": "0.48", "yes_bid_usd": "0.52", "no_bid_usd": "0.47", "observed_at": "2026-09-17T12:31:00.831305Z", "volume_24h_usd": "62870.97", "spread_usd": "0.01", "liquidity": "deep" }
          ],
          "best_venue": "kalshi",
          "volume_24h_usd": "1138986.36",
          "spread_usd": "0.01",
          "liquidity": "deep"
        }
      ]
    }
  ],
  "graph_run": 74
}

What to read:

Field	Meaning
`twin`	The same event on the other venue, proven equivalent outcome by outcome.
`outcomes[].prices[]`	One entry per venue that lists the outcome, with that venue’s asks and bids and when they were observed.
`outcomes[].best_venue`	The venue with the lower Yes ask. Here Kalshi asks 0.52 for Yes and Polymarket 0.53: a one-cent gap.
`liquidity`	`deep`, `tradeable` or `thin`; see Liquidity.

The relation behind a cross-venue gap

Take the venue and market_id from a price and ask what that market is proven to relate to. cross_venue=true keeps only markets on the other venue.

curl -s "https://api.routeur.app/v1/markets/kalshi/KXNFLTOTAL-26SEP17DETBUF-55/relations?cross_venue=true&limit=1" \
  -H "X-API-Key: $ROUTEUR_API_KEY"

{
  "data": [
    {
      "relation": "equivalent",
      "cross_venue": true,
      "evidence": [
        "cross-venue: same nfl game scheduled 2026-09-17 ET, matched by team codes; both settle on the game's final score; neither venue restricts periods; postponement and cancellation settle differently"
      ],
      "market": {
        "venue": "polymarket",
        "id": "nfl-det-buf-2026-09-18-total-54pt5",
        "title": "Lions vs. Bills: O/U 54.5",
        "strike": { "type": "greater", "floor": "109/2" },
        "quote": { "yes_ask_usd": "0.53", "no_ask_usd": "0.48", "yes_bid_usd": "0.52", "no_bid_usd": "0.47", "observed_at": "2026-09-17T12:31:00.831305Z" },
        "liquidity": "deep"
      }
    }
  ]
}

The two markets are equivalent: both pay Yes when the game’s total exceeds 54.5, stated as the exact rational 109/2. To see the proof step by step, ask for the trail:

curl -s "https://api.routeur.app/v1/relations/kalshi/KXNFLTOTAL-26SEP17DETBUF-55/polymarket/nfl-det-buf-2026-09-18-total-54pt5" \
  -H "X-API-Key: $ROUTEUR_API_KEY"

{
  "data": {
    "relation": "equivalent",
    "reproduced": true,
    "steps": [
      { "step": "game_quantity", "left": "NFL total, Detroit vs Buffalo, 2026-09-17 ET", "right": "NFL total, Lions vs Bills, 2026-09-17 ET", "result": "same_kind" },
      { "step": "same_game", "detail": "cross-venue: same nfl game scheduled 2026-09-17 ET, matched by team codes and team names; both settle on the game's final score; neither venue restricts periods; postponement and cancellation settle differently", "result": "same" },
      { "step": "intervals", "left": "(54.5, ∞)", "right": "(54.5, ∞)", "result": "equivalent" },
      { "step": "conclusion", "relation": "equivalent" }
    ]
  },
  "graph_run": 74
}

The full response also carries both contract versions, the runs that found and last confirmed the relation, and first_seen_at. See Proof trail. The whole list of cross-venue pairs is GET /v1/cross-venue; see Cross-venue pairs.

A lead with depth

A lead is a two-leg purchase that a proven relation says pays at least $1 in every outcome. depth sizes it against the live order books.

curl -s "https://api.routeur.app/v1/opportunities?limit=1" -H "X-API-Key: $ROUTEUR_API_KEY"

{
  "data": [
    {
      "relation": "contradicts",
      "cross_venue": false,
      "left":  { "venue": "polymarket", "id": "will-karen-bass-win-the-2026-los-angeles-mayoral-election", "title": "Will Karen Bass win the 2026 Los Angeles mayoral election?", "quote": { "yes_ask_usd": "0.64", "no_ask_usd": "0.37" }, "liquidity": "deep" },
      "right": { "venue": "polymarket", "id": "will-nithya-raman-win-the-2026-los-angeles-mayoral-election-876", "title": "Will Nithya Raman win the 2026 Los Angeles mayoral election?", "quote": { "yes_ask_usd": "0.378", "no_ask_usd": "0.623" }, "liquidity": "deep" },
      "legs": [
        { "side": "no", "venue": "polymarket", "market_id": "will-karen-bass-win-the-2026-los-angeles-mayoral-election", "ask_usd": "0.37" },
        { "side": "no", "venue": "polymarket", "market_id": "will-nithya-raman-win-the-2026-los-angeles-mayoral-election-876", "ask_usd": "0.623" }
      ],
      "cost_usd": "0.993",
      "gross_edge_usd": "0.007",
      "estimated_fee_usd": "0.018719",
      "net_edge_usd": "-0.011719",
      "issues": [
        "unverified: top-of-book depth is unknown; asks are discovery observations",
        "estimated: Polymarket taker fee rate * p * (1 - p) for one share, before rounding"
      ],
      "depth": {
        "executable": false,
        "pairs": "0",
        "cost_usd": "0",
        "fees_usd": "0",
        "net_usd": "0",
        "limited_by": "price",
        "observed_at": "2026-09-17T12:10:26.079Z",
        "issues": [ "..." ]
      }
    }
  ],
  "graph_run": 74
}

Read depth.executable before anything else. Here the two No contracts cost 0.993 together and pay $1, a gross edge of 0.007, but fees of about 0.019 make the net negative, so executable is false and limited_by is price. Add executable=true to list only leads whose books could be filled at a profit. See Leads.

A market’s rules

curl -s "https://api.routeur.app/v1/markets/kalshi/KXNFLTOTAL-26SEP17DETBUF-55/rules" \
  -H "X-API-Key: $ROUTEUR_API_KEY"

{
  "data": {
    "venue": "kalshi",
    "id": "KXNFLTOTAL-26SEP17DETBUF-55",
    "title": "Full Game: over 54.5 points scored?",
    "rules_hash": "e3f3063e1d3e40ad74c47510bb0302de1178f4ef1b8af0edea7b26ee9d86d9c8",
    "rules": "If Detroit and Buffalo collectively score more than 54.5 points in the Detroit vs Buffalo Pro Football game originally scheduled for Sep 17, 2026, then the market resolves to Yes.\n\nKalshi is not affiliated, associated, authorized, endorsed by, or in any way officially connected with the Governing League. ...",
    "rulebooks": [
      { "venue": "kalshi", "kind": "event", "id": "KXNFLTOTAL-26SEP17DETBUF", "content_hash": "3004eaa19a80...", "fields": { "strike_period": "...", "mutually_exclusive": false, "settlement_sources": [], "collateral_return_type": "..." }, "changed_fields": [] }
    ],
    "versions": [
      { "rules_hash": "e3f3063e1d3e40ad74c47510bb0302de1178f4ef1b8af0edea7b26ee9d86d9c8", "first_seen_at": "2026-09-14T17:31:31.849536Z", "last_seen_at": "2026-09-17T12:33:03.021417Z", "changed_fields": [], "rulebooks_changed": [] }
    ],
    "changes": []
  }
}

rules_hash fingerprints this version of the terms; relations are proven against a specific version. versions lists every version recorded with a diff from the one before, and changes is the ledger of every change to the market’s terms, including changes to a rulebook above it. See Rules.

Stream what changes

The stream is Server-Sent Events over one keyed connection. Name the topics you want; min_usd drops small trades.

curl -N "https://api.routeur.app/v1/stream?topics=trades&min_usd=500" -H "X-API-Key: $ROUTEUR_API_KEY"

retry: 3000

event: ready
data: {"heartbeat_seconds":15,"reconnect_after_seconds":3253,"replay_window_seconds":3600,"topics":["trades"]}

id: 1530543
event: trade
data: {"venue":"polymarket","id":"6e9a18b14e6935a8a89492e80ada1189","market_id":"cs2-mouz-nrg-2026-09-17","outcome":"MOUZ","taker_action":"buy","price_usd":"0.68","quantity":"6033.93","notional_usd":"4103.07","executed_at":"2026-09-17T12:38:22Z","block":false,"recorded_at":"2026-09-17T12:41:16.078965Z"}

Every data event has an id. After a drop, reconnect with it in Last-Event-ID (or as cursor) and the events since are replayed, for up to an hour. Topics are quotes, trades, books, relations, leads and rules. See Live stream.

MCP in 60 seconds

The same endpoints are MCP tools at https://api.routeur.app/mcp, with the same key. In Claude Code:

claude mcp add --transport http routeur https://api.routeur.app/mcp \
  --header "Authorization: Bearer $ROUTEUR_API_KEY"

Or call a tool by hand. compare_venues prices one question on both venues in a single call:

curl -s -X POST https://api.routeur.app/mcp \
  -H "Authorization: Bearer $ROUTEUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"compare_venues","arguments":{"question":"Lions Bills total points","limit":2}}}'

The tool result’s text is JSON:

{
  "events": [
    {
      "venue": "polymarket",
      "id": "810546",
      "title": "Detroit vs Buffalo: Total Points",
      "twin": { "venue": "kalshi", "id": "KXNFLTOTAL-26SEP17DETBUF" },
      "widest_gap_cents": "1",
      "outcomes": [
        {
          "label": "O/U 54.5",
          "chance": "0.5200",
          "prices": [
            { "venue": "kalshi", "market_id": "KXNFLTOTAL-26SEP17DETBUF-55", "yes_ask_usd": "0.52", "no_ask_usd": "0.49", "observed_at": "2026-09-17T12:33:03.021417Z" },
            { "venue": "polymarket", "market_id": "nfl-det-buf-2026-09-18-total-54pt5", "yes_ask_usd": "0.53", "no_ask_usd": "0.48", "observed_at": "2026-09-17T12:31:00.831305Z" }
          ],
          "best_venue": "kalshi",
          "gap_cents": "1"
        }
      ]
    }
  ]
}

A tool call counts against your key as the REST requests it makes. See Agents and MCP and the tool reference.

Get started

Concepts

Agents & MCP

Webhooks

Reference

Get a key

Check the service

An event with its outcomes

The relation behind a cross-venue gap

A lead with depth

A market’s rules

Stream what changes

MCP in 60 seconds

Get a key

Check the service

An event with its outcomes

The relation behind a cross-venue gap

A lead with depth

A market’s rules

Stream what changes

MCP in 60 seconds

Related