MintSlips API

Read-only sports betting data for your code and your AI agent: every MintSlips pick with its chance to hit and fair payout, live cards, a price check, and graded results.

Quickstart

  1. Make a free MintSlips account on the home page (the free tier is 100 calls a day).
  2. Log in with your MintSlips account, come back here and create a key under Your API keys. The full key is shown once.
  3. Call the board:
curl https://api.mintslips.com/api/v1/board \
  -H "Authorization: Bearer ms_live_…"

Base URL: https://api.mintslips.com/api/v1. Every response is JSON (except /stream and /history/export) and carries schema_version, as_of (the data's own time when it has one) and disclaimer.

Information only, not betting advice. The API never places or automates an order, never asks for or accepts a sportsbook or exchange login, and never promises results. Venue links are plain links to the market's page. Probabilities are estimates. 21+. Gambling problem? Call 1-800-GAMBLER.
Our numbers, not a venue's. MintSlips returns its own probability and fair price. It does not show, cache, proxy or relay Kalshi's prices. Where a pick, leg or live market is a Kalshi market it carries kalshi_ticker and kalshi_url; if you want Kalshi's live price, fetch it yourself from Kalshi's public market-data API with that ticker (for example GET https://api.elections.kalshi.com/trade-api/v2/markets/{kalshi_ticker}). MintSlips is not affiliated with Kalshi. /size works from a price you type in yourself; MintSlips never fetches it and never stores it.
No third-party data. The API carries no sportsbook prices or sportsbook names, no live scores and no exchange order bodies: only MintSlips' own numbers and the venue identifiers and links that let you find the same market. Third-party data is not licensed to you for redistribution (terms §20).

Your API keys

Keys belong to your MintSlips account. You can hold up to 3 active keys.

Authentication

Send your key as a bearer token on every request:

Authorization: Bearer ms_live_…

A key is ms_live_ followed by 32 letters and digits. MintSlips stores only a hash of it, so a lost key can't be shown again: revoke it and create another. Keep keys out of client-side code and public repositories.

Your tier is worked out on every request from your account (see tiers), so an upgrade or a lapsed membership applies to existing keys at once.

Endpoints

GET/health

Service check. No key needed; 10 calls a minute per address.

{
  "schema_version": 2,
  "as_of": "2026-10-11T12:00:00.000Z",
  "disclaimer": "Information only, not betting advice. 21+. Gambling problem? 1-800-GAMBLER.",
  "status": "ok",
  "service": "mintslips-public"
}
GET/me

Your account, tier and today's usage.

{
  "schema_version": 2,
  "as_of": "2026-10-11T12:00:00.000Z",
  "disclaimer": "Information only, not betting advice. 21+. Gambling problem? 1-800-GAMBLER.",
  "email": "you@example.com",
  "tier": "member",
  "usage": { "day": "2026-10-11", "calls": 12, "daily_limit": 1000 },
  "limits": { "per_minute": 60, "per_day": 1000 },
  "key_id": "key_3f9c0a1b2c3d4e5f6a7b8c9d"
}
GET/board?date=YYYY-MM-DD

Today's board: the day's 16 picks, every leg, at every tier (all picks are free with an account since 2026-10-12; members pay for live cards and higher limits). A past date (Member and Pro) answers from the graded results, marked "source": "results"; a day with nothing graded returns an empty list.

response (abbreviated)
{
  "schema_version": 2,
  "as_of": "2026-10-11T12:00:00.000Z",
  "disclaimer": "Information only, not betting advice. 21+. Gambling problem? 1-800-GAMBLER.",
  "day": "2026-10-11",
  "state": "board",
  "source": "live",
  "picks": [
    {
      "pick_id": "20261011-PROP1",
      "tier": "boost",
      "band": "prop",
      "sport": "props",
      "n_legs": 1,
      "first_start": "2026-10-11T17:00:00Z",
      "prob": 0.6214,
      "fair_cents": 62.1,
      "payout_if_hit_per_dollar": 1.61,
      "units": 1.0,
      "basis": "model",
      "locked": false,
      "kalshi_ticker": "KXNFLTD-26OCT11BALATL-BALDHENRY22-1",
      "kalshi_url": "https://kalshi.com/markets/kxnfltd/kxnfltd/kxnfltd-26oct11balatl",
      "legs": [
        { "desc": "Derrick Henry 1+ touchdowns", "prob": 0.6214,
          "ticker": "KXNFLTD-26OCT11BALATL-BALDHENRY22-1",
          "kalshi_ticker": "KXNFLTD-26OCT11BALATL-BALDHENRY22-1",
          "kalshi_url": "https://kalshi.com/markets/kxnfltd/kxnfltd/kxnfltd-26oct11balatl",
          "venues": { "kalshi": { "ticker": "KXNFLTD-26OCT11BALATL-BALDHENRY22-1", "side": "yes", "url": "https://kalshi.com/markets/kxnfltd/kxnfltd/kxnfltd-26oct11balatl" } } }
      ],
      "games": ["BAL @ ATL"]
    },
    …
  ]
}
fieldmeaning
probthe MintSlips model's chance that every leg hits (0 to 1)
basisalways model: a MintSlips model estimate (picks priced from a market's own prices are not published)
fair_centsfair price of a $1 contract, in cents
payout_if_hit_per_dollartotal return per $1 at the fair price if it hits (stake included)
kalshi_ticker, kalshi_urlon a single-leg pick that is a Kalshi market: the market's ticker and its page on kalshi.com (also on every leg). Fetch the live price from Kalshi yourself with the ticker
tier, bandboard section: banker or boost, and a boost's band
unitsa fixed stake size: 1 unit on every pick
legs[]{desc, prob, ticker, kalshi_ticker, kalshi_url, venues} per leg; absent when locked
legs[].venueswhere the same position is listed: always kalshi {ticker, side, url}; polymarket_us {market, side: long|short, url, same_rules, rule_note, matched_at} only when that venue lists the same game, line and side (player props: same player, stat and threshold, e.g. 2+ = over 1.5). same_rules: false with a rule_note flags a settlement-rule difference (overtime, postponement, a player who does not play); the entry is still shown. Each side of a live card market carries the same venues (Polymarket US, when listed). Information only.
venues.*.urlplain links: Kalshi's is the market's page on kalshi.com; Polymarket US's is the game's page (pick the market there). Opening a link places nothing.
GET/picks/{pick_id}

One pick from today's board, or (Member and Pro) from the graded results.

{
  "schema_version": 2,
  "as_of": "2026-10-11T12:00:00.000Z",
  "disclaimer": "Information only, not betting advice. 21+. Gambling problem? 1-800-GAMBLER.",
  "day": "2026-10-11",
  "source": "live",
  "pick": { "pick_id": "20261011-F1", "tier": "banker", "prob": 0.6032, … }
}
GET/catalog?sport=&game_id=&stat=&family=&player=&min_chance=&max_chance=

The pregame catalog: for each game that has not started, every market our pregame models price today (game lines and player props). Each market carries both sides (yes / no), each with our model chance and fair_price, plus the market's kalshi_ticker and kalshi_url (and Polymarket US ids where listed): the same market shape as a live card. No pick is chosen for you and no venue price is included: pull the price from the venue and compare, or send it to /size. Member and Pro only; free gets the 16 daily picks. A game leaves the catalog at its start; in play, only /live prices it. The filters work as on /live.

{
  "day": "2026-10-15",
  "updated_at": "2026-10-15T15:00:00Z",
  "n_games": 11,
  "games": [
    { "game_id": "nhl:26OCT15BUFTOR", "sport": "nhl", "label": "BUF @ TOR", "away": "BUF", "home": "TOR",
      "start": "2026-10-15T23:00:00Z", "n_markets": 61, "locked": false,
      "markets": [
        { "kalshi_ticker": "KXNHLPTS-26OCT15BUFTOR-TORAMATTHEWS34-1", "kalshi_url": "https://kalshi.com/markets/kxnhlpts/…",
          "label": "Auston Matthews 1+ points", "family": "points", "player": "Auston Matthews", "stat": "points", "line": 0.5,
          "yes": { "label": "Auston Matthews 1+ points", "chance": 0.7012, "fair_price": 0.7 },
          "no":  { "label": "Auston Matthews no points", "chance": 0.2988, "fair_price": 0.3 } }, …
      ] }, …
  ]
}
GET/live?sport=&game_id=&stat=&family=&player=&min_chance=&max_chance=

In-game live cards as a catalog: one card per game with the game's status and every market our model prices for that game. Each market carries both sides (yes / no), and each side its model chance and fair_price, plus the market's kalshi_ticker and kalshi_url. No single pick is chosen and no venue price is included: compare with the live price on the venue yourself and decide. Members and Pro get the latest cards; free keys get a snapshot delayed 15 minutes ("delayed": true). Scores are not included.

A card whose sport's model is being updated shows the game's state only ("catalog_ready": false, no markets). A sport whose public live cards are paused (for example while a licensed live-stats feed is put in place) has no cards and is listed in paused with a note.

filterkeeps
sport, game_idcards of that sport key (e.g. nba) or game
stat, familymarkets of that stat (e.g. pts) or family (e.g. player_prop)
playermarkets whose player's name contains it (any case)
min_chance, max_chancesides whose model chance is in range (0 to 1); a market with no side left is dropped

Without filters you get every market. A filtered card keeps n_markets (its total) and adds n_shown; the filters you sent come back in filters. A bad filter is a 400.

response (abbreviated)
{
  "schema_version": 2,
  "as_of": "2026-10-12T01:31:45Z",
  "disclaimer": "Information only, not betting advice. 21+. Gambling problem? 1-800-GAMBLER.",
  "delayed": false,
  "paused": [],
  "cards": [
    {
      "sport": "nba",
      "game_id": "nba_401898717",
      "home": "LAL",
      "away": "SAC",
      "status": "live",
      "state_line": "live",
      "checked_at": "2026-10-12T01:31:45Z",
      "catalog_ready": true,
      "n_markets": 148,
      "markets": [
        {
          "kalshi_ticker": "KXNBAPTS-26OCT11SACLAL-LALLDONCIC77-30",
          "kalshi_url": "https://kalshi.com/markets/kxnbapts/kxnbapts/kxnbapts-26oct11saclal",
          "label": "Luka Doncic 30+ points",
          "family": "player_prop",
          "player": "Luka Doncic",
          "team": "LAL",
          "stat": "pts",
          "line": 30,
          "updated_at": "2026-10-12T01:31:00Z",
          "yes": { "label": "Luka Doncic 30+ points", "chance": 0.4588, "fair_price": 0.46 },
          "no": { "label": "Luka Doncic under 30 points", "chance": 0.5412, "fair_price": 0.54 }
        },
        …
      ]
    },
    …
  ]
}

chance is our model's chance that the side wins; fair_price is that chance as a price per $1 contract: our price. Both are computed from the model alone, not from any Kalshi price. The API returns no order templates: MintSlips never places, prepares or automates an order.

GET/results?from=YYYY-MM-DD&to=YYYY-MM-DD Member and Pro

Graded picks by day (hit, miss or void), newest day first, at most 31 days per call. Without dates you get the last 7 days.

{
  "schema_version": 2,
  "as_of": "2026-10-11T12:05:00Z",
  "disclaimer": "Information only, not betting advice. 21+. Gambling problem? 1-800-GAMBLER.",
  "from": "2026-10-05",
  "to": "2026-10-11",
  "days": [
    {
      "day": "2026-10-11",
      "picks": [
        {
          "pick_id": "20261011-1",
          "tier": "banker",
          "n_legs": 2,
          "first_start": "2026-10-11T17:05:00Z",
          "prob": 0.9079,
          "fair_cents": 90.8,
          "payout_if_hit_per_dollar": 1.1,
          "basis": "model",
          "settled": { "hit": true },
          "legs": [ { "desc": "Home Team A–Away Team B Over 1.5", "prob": 0.965,
                      "kalshi_ticker": "KXMLBTOTAL-…", "kalshi_url": "https://kalshi.com/markets/…" }, … ]
        }
      ]
    }
  ]
}

A void pick has "void": true and "settled": null; it is neither a hit nor a miss. The result above is illustrative.

POST/check

Compare the price you're offered with our chance for a pick. Send exactly one of american or cents. The answer comes from our chance alone: the offered price plus Kalshi's published taker fee on one contract (0.07 × p × (1 − p), rounded up to the cent) at or under our chance is "under our price after the fee".

curl https://api.mintslips.com/api/v1/check \
  -H "Authorization: Bearer ms_live_…" \
  -H "content-type: application/json" \
  -d '{"pick_id": "20261011-F1", "offered": {"cents": 58}}'
{
  "schema_version": 2,
  "as_of": "2026-10-11T12:00:00.000Z",
  "disclaimer": "Information only, not betting advice. 21+. Gambling problem? 1-800-GAMBLER.",
  "pick_id": "20261011-F1",
  "under_our_price": true,
  "label": "under our price after the fee",
  "our_price": { "cents": 60.3, "american": -152, "implied_prob": 0.603 },
  "fee_at_offered": 0.02,
  "ev_at_offered": 0.003,
  "offered": { "cents": 58, "american": -138, "decimal": 1.7241 },
  "offered_implied_prob": 0.58,
  "fair_cents": 60.3,
  "fair_payout": 1.6584,
  "offered_payout": 1.7241,
  "difference_vs_fair": 0.0658
}

Payouts are total return per $1 if the pick hits. difference_vs_fair is offered_payout − fair_payout. ev_at_offered is chance − price − fee per $1 contract. The same pick at {"cents": 59} returns "under_our_price": false, "label": "over our price after the fee". A label describes the price, not whether to bet.

POST/size

Units at a price you enter. Give a market MintSlips prices (a kalshi_ticker from the board or a live card, or a Polymarket US market slug from venues.polymarket_us.market), the side, the venue whose fee applies (kalshi or polymarket_us) and the price you see there, in dollars per $1 contract. You get back an estimate at the price you entered: our chance and fair price, the venue's published fee on one contract at your price, the expected value per contract after that fee, and units. Every tier, including free (sized on the 15-minute delayed live snapshot and the 16 daily picks). It counts toward your daily limit. The price you send is used for this answer only: never stored, never logged.

curl https://api.mintslips.com/api/v1/size \
  -H "Authorization: Bearer ms_live_…" \
  -H "content-type: application/json" \
  -d '{"market": "KXNBAPTS-26OCT11SACLAL-LALLDONCIC77-25", "side": "yes", "venue": "kalshi", "price": 0.65}'
{
  "schema_version": 2,
  "as_of": "2026-10-12T01:31:45Z",
  "disclaimer": "Information only, not betting advice. 21+. Gambling problem? 1-800-GAMBLER.",
  "market": "KXNBAPTS-26OCT11SACLAL-LALLDONCIC77-25",
  "side": "yes",
  "fee_venue": "kalshi",
  "your_price": 0.65,
  "priced": true,
  "source": "live",
  "label": "Luka Doncic 25+ points",
  "kalshi_ticker": "KXNBAPTS-26OCT11SACLAL-LALLDONCIC77-25",
  "kalshi_url": "https://kalshi.com/markets/kxnbapts/kxnbapts/kxnbapts-26oct11saclal",
  "sport": "nba",
  "game_id": "nba_401898717",
  "chance": 0.7412,
  "fair_price": 0.74,
  "fee_at_your_price": 0.02,
  "ev_at_your_price": 0.0712,
  "edge_at_your_price": 0.0912,
  "units": 1,
  "note": "Estimate at the price you entered. …"
}
fieldmeaning
fee_at_your_pricethe venue's published taker fee on one contract at your price: 0.07 × p × (1 − p) rounded up to the cent on Kalshi, 0.0695 × p × (1 − p) rounded to the cent on Polymarket US
ev_at_your_pricechance − price − fee, dollars per $1 contract
edge_at_your_pricechance − price
units0 with "reason": "no bet at this price" when the expected value after the fee is zero or less, or your price plus Kalshi's one-contract fee is over our chance. Otherwise 0.25 plus a quarter-Kelly share of half the edge after the fee, capped at 1, in quarter units. One fixed rule, the same for everyone: no bankroll goes in.

A market we don't price right now (not in today's pregame catalog or on today's board before its start, nor in a live catalog, a sport whose live cards are paused, a catalog that isn't ready) returns "priced": false, "units": 0, "reason": "not priced". For a parlay's leg only its expected value decides. Units are an estimate at the price you entered, not a recommendation to bet; any bet can lose.

GET/stream pro

Server-sent events. Each event's data is {id, type, created_at, data, disclaimer}. A : heartbeat comment arrives every 25 seconds.

eventdata
pick.created{day, pick}: a pick new to the board
live.updated{sport, game_id, card}: a card's status, state, note or market count changed (the card without its markets)
live.markets_changed{sport, game_id, updated_at, n_markets, changed, removed, part, parts}: the markets whose chance or fair price moved (or that are new) since the last publish, and the kalshi_tickers that left; at most 50 markets per event, a larger change arrives in parts
result.graded{day, pick}: a pick was graded (hit, miss or void)
curl -N https://api.mintslips.com/api/v1/stream \
  -H "Authorization: Bearer ms_live_…"

id: evt_5d0c9b8a7f6e5d4c3b2a1908
event: pick.created
data: {"id":"evt_5d0c9b8a7f6e5d4c3b2a1908","type":"pick.created","created_at":"2026-10-11T15:00:04.000Z","data":{"day":"2026-10-11","pick":{…}},"disclaimer":"…"}

: heartbeat
POSTGETDELETE/webhooks pro

Register an https URL to receive the same events as the stream. The signing secret is shown once. Up to 5 active webhooks per account; events defaults to every event type. (live.bet_changed is still accepted on a webhook for older subscriptions but is no longer sent: live cards have no single bet.)

curl https://api.mintslips.com/api/v1/webhooks \
  -H "Authorization: Bearer ms_live_…" \
  -H "content-type: application/json" \
  -d '{"url": "https://example.com/mintslips", "events": ["pick.created", "result.graded"]}'
{
  "schema_version": 2,
  "as_of": "2026-10-11T12:00:00.000Z",
  "disclaimer": "Information only, not betting advice. 21+. Gambling problem? 1-800-GAMBLER.",
  "id": "wh_8e7d6c5b4a39281706f5e4d3",
  "url": "https://example.com/mintslips",
  "events": ["pick.created", "result.graded"],
  "secret": "whsec_…",
  "created_at": "2026-10-11T12:00:00.000Z"
}

GET /webhooks returns {"webhooks": [{id, url, events, created_at, disabled_at, fail_count}]}. DELETE /webhooks/{id} returns {"ok": true, "id"}. Failed deliveries retry after 1 minute, 5 minutes, 30 minutes, 2 hours and 12 hours.

GET/history/export?month=YYYY-MM pro

One month as NDJSON (application/x-ndjson): a meta line, then one line per pick ("type": "pick" for today's board, "type": "result" for graded picks).

{"type":"meta","schema_version":2,"month":"2026-10","as_of":"2026-10-11T12:00:00.000Z","disclaimer":"…"}
{"type":"result","day":"2026-10-01","pick_id":"…","prob":…,"settled":{"hit":false},…}

MCP setup

The MCP server is at https://api.mintslips.com/mcp (Streamable HTTP). Tools: get_board(date?), get_pick(pick_id), get_catalog(sport?, game_id?, stat?, family?, player?, min_chance?, max_chance?), get_live_cards(sport?, game_id?, stat?, family?, player?, min_chance?, max_chance?), check_price(pick_id, american_odds? | price_cents?), size_bet(market, side, venue, price), get_results(from, to), explain_pick(pick_id). Tool calls count toward the same daily limit as REST calls.

Claude Code

claude mcp add --transport http mintslips https://api.mintslips.com/mcp \
  --header "Authorization: Bearer ms_live_…"

Claude Desktop

Claude Desktop connects through mcp-remote (needs Node.js). Add this to claude_desktop_config.json and restart the app:

{
  "mcpServers": {
    "mintslips": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.mintslips.com/mcp",
               "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer ms_live_…" }
    }
  }
}

Claude.ai and ChatGPT

Add a custom connector (in Claude.ai: Settings, Connectors; in ChatGPT: the apps and connectors settings) with the URL https://api.mintslips.com/mcp, then sign in with your MintSlips account when asked. No key to paste: the sign-in grants the connector your account's tier.

Any other agent

Any MCP client that speaks Streamable HTTP and can send an Authorization: Bearer ms_live_… header works.

Webhooks and signatures

Each delivery is a POST of the event JSON with the header

MintSlips-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256(secret, t + "." + raw body)>

Verify it against the raw request body (before any JSON parsing), reject old timestamps, and compare in constant time.

Python
import hashlib, hmac, time

def verify(secret: str, header: str, body: bytes, tolerance: int = 300) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t, sig = parts.get("t", ""), parts.get("v1", "")
    if not t.isdigit() or abs(time.time() - int(t)) > tolerance:
        return False
    expected = hmac.new(secret.encode(), t.encode() + b"." + body,
                        hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, sig)
Node.js
import crypto from "node:crypto";

export function verify(secret, header, rawBody, tolerance = 300) {
  const parts = Object.fromEntries(header.split(",").map((p) => {
    const i = p.indexOf("=");
    return [p.slice(0, i), p.slice(i + 1)];
  }));
  const t = parts.t || "", sig = parts.v1 || "";
  if (!/^\d+$/.test(t) || Math.abs(Date.now() / 1000 - Number(t)) > tolerance) return false;
  const expected = crypto.createHmac("sha256", secret)
    .update(`${t}.${rawBody}`).digest("hex");
  return sig.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
}

Answer with any 2xx within 10 seconds. After 5 failed events in a row the webhook is disabled; create it again to resume.

Rate limits and tiers

tierpricecalls a dayaccess
Free$0100all 16 daily picks; live cards delayed 15 minutes; MCP; personal use
Member$25/mo1,000full board, every pregame market (/catalog), live cards in real time, results, MCP; personal use
Pro$79/mo10,000everything in Member, plus /stream, webhooks, and history export; commercial use of MintSlips' own numbers, with credit (terms §20)

Every key is also limited to 60 calls a minute. Daily counts reset at 00:00 UTC. /health and the key routes are limited to 10 calls a minute per address. Free comes with any verified account; Member and Pro are monthly, in US dollars, from the pricing section, where Commercial terms are too.

Errors

Errors are JSON: {"error": "<code>", "message": "…", "disclaimer", "as_of"}.

statuserrorwhen
400bad_requesta bad date, month, body or price
401unauthorizedmissing, malformed, unknown or revoked key (or session, on the key routes)
403unverifiedconfirm your email on the site first
403tierthe endpoint needs a higher tier (required_tier, tier)
404not_foundunknown route, pick, key or webhook
409key_limit, webhook_limit3 active keys or 5 active webhooks already
429rate_limited, quota_exceededper-minute or daily limit; wait for Retry-After seconds

Terms of use