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
- Your API keys
- Authentication
- Endpoints
- MCP setup
- Webhooks and signatures
- Rate limits and tiers
- Errors
- Terms of use
Quickstart
- Make a free MintSlips account on the home page (the free tier is 100 calls a day).
- Log in with your MintSlips account, come back here and create a key under Your API keys. The full key is shown once.
- 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.
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.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
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"
}
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"
}
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.
{
"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"]
},
…
]
}
| field | meaning |
|---|---|
prob | the MintSlips model's chance that every leg hits (0 to 1) |
basis | always model: a MintSlips model estimate (picks priced from a market's own prices are not published) |
fair_cents | fair price of a $1 contract, in cents |
payout_if_hit_per_dollar | total return per $1 at the fair price if it hits (stake included) |
kalshi_ticker, kalshi_url | on 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, band | board section: banker or boost, and a boost's band |
units | a fixed stake size: 1 unit on every pick |
legs[] | {desc, prob, ticker, kalshi_ticker, kalshi_url, venues} per leg; absent when locked |
legs[].venues | where 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.*.url | plain 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. |
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, … }
}
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 } }, …
] }, …
]
}
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.
| filter | keeps |
|---|---|
sport, game_id | cards of that sport key (e.g. nba) or game |
stat, family | markets of that stat (e.g. pts) or family (e.g. player_prop) |
player | markets whose player's name contains it (any case) |
min_chance, max_chance | sides 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.
{
"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.
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.
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.
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. …"
}
| field | meaning |
|---|---|
fee_at_your_price | the 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_price | chance − price − fee, dollars per $1 contract |
edge_at_your_price | chance − price |
units | 0 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.
Server-sent events. Each event's data is {id, type, created_at, data,
disclaimer}. A : heartbeat comment arrives every 25 seconds.
| event | data |
|---|---|
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
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.
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.
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)
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
| tier | price | calls a day | access |
|---|---|---|---|
| Free | $0 | 100 | all 16 daily picks; live cards delayed 15 minutes; MCP; personal use |
| Member | $25/mo | 1,000 | full board, every pregame market (/catalog), live cards in real time, results, MCP; personal use |
| Pro | $79/mo | 10,000 | everything 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"}.
| status | error | when |
|---|---|---|
| 400 | bad_request | a bad date, month, body or price |
| 401 | unauthorized | missing, malformed, unknown or revoked key (or session, on the key routes) |
| 403 | unverified | confirm your email on the site first |
| 403 | tier | the endpoint needs a higher tier (required_tier, tier) |
| 404 | not_found | unknown route, pick, key or webhook |
| 409 | key_limit, webhook_limit | 3 active keys or 5 active webhooks already |
| 429 | rate_limited, quota_exceeded | per-minute or daily limit; wait for Retry-After seconds |
Terms of use
- Information only, not betting advice. Nothing here tells you to place a bet.
- Probabilities and fair prices are estimates. Any pick can lose. Past results do not predict future ones.
- MintSlips is not a sportsbook and does not place bets. The API never takes or stores sportsbook or exchange credentials.
- For people 21 and over, where sports wagering is lawful. Gambling problem? Call 1-800-GAMBLER.
- Use of the API is covered by the terms and privacy policy. Free and Member are for personal use; Pro includes commercial use (public display, your own products, your company) of MintSlips' own numbers, with credit ("Data: MintSlips"). Third-party data (sportsbook prices, venue identifiers and links, scores) is not licensed for redistribution. Reselling the raw data or sharing keys is never allowed; custom terms: mintslips1@gmail.com.