bets
Copy page
Log and read your own bets, their results and closing-line value.
On this page
- List your bets
- Parameters
- Response
- Errors
- Example
- Log a bet
- Parameters
- Response
- Errors
- Example
- Import bets from a CSV
- Parameters
- Response
- Errors
- Example
- Find the rule behind your bets
- Parameters
- Response
- Errors
- Example
- Get your totals
- Parameters
- Response
- Errors
- Example
- Get a bet
- Parameters
- Response
- Errors
- Example
- Change a bet
- Parameters
- Response
- Errors
- Example
- Delete a bet
- Parameters
- Response
- Errors
- Example
- Settle a bet
- Parameters
- Response
- Errors
- Example
- Fill a bet slip
- Parameters
- Response
- Errors
- Example
- Start sportsbook sign-ups
- Parameters
- Response
- Errors
- Example
- Get your results
- Parameters
- Response
- Errors
- Example
| Method | Path | Title | Access | Price | MCP tool |
|---|---|---|---|---|---|
| GET | /v1/bets | List your bets | read:tracker | 0 | list_my_bets |
| POST | /v1/bets | Log a bet | write:tracker | 0 | log_my_bet |
| POST | /v1/bets/import | Import bets from a CSV | write:tracker | 0 | import_my_bets |
| POST | /v1/bets/find_rule | Find the rule behind your bets | read:tracker | 1 | find_rule_in_my_bets |
| GET | /v1/bets/summary | Get your totals | read:tracker | 0 | get_my_bet_summary |
| GET | /v1/bets/{bet_id} | Get a bet | read:tracker | 0 | none |
| PATCH | /v1/bets/{bet_id} | Change a bet | write:tracker | 0 | update_my_bet |
| DELETE | /v1/bets/{bet_id} | Delete a bet | write:tracker | 0 | none |
| POST | /v1/bets/{bet_id}/settle | Settle a bet | write:tracker | 0 | settle_my_bet |
| POST | /v1/bet-slips | Fill a bet slip | write:tracker | 0 | none |
| POST | /v1/book-signups | Start sportsbook sign-ups | write:tracker | 0 | none |
| GET | /v1/me/results | Get your results | read:tracker | 0 | get_my_results |
GET /v1/bets
List your betsLink to this section
scope read:tracker · 0 credits, not charged during the beta · MCP tool list_my_bets · status live
Your bets, newest placed first, filtered by project, status, sport, book, tag, currency, game and when placed. Each carries its legs, result, payout and profit, and its closing-line value once the game has started. Kelly's own fair price and edge and your book's own closing price stay on Kelly's site, so they are null here.
ParametersLink to this section
projectstring · queryOne of your projects (proj_…), or none for bets in no project.
pattern ^(none|proj_[0-9a-hjkmnp-tv-z]{20})$
statusstring · queryOne status, or settled for every settled bet.
One of: open, won, lost, push, void, half_won, half_lost, cashed_out, settled (open: new values may be added).
sportstring · queryOnly this sport.
max length 40
bookstring · queryOnly this book, by Kelly's ID or by name.
max length 80
tagstring · queryOnly bets with this tag.
max length 40
currencystring · queryOnly this currency.
pattern ^[A-Z]{3}$
game_idstring · queryOnly bets with a leg on this game.
pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
analyststring · queryOnly bets that tail this analyst's picks (anl_…).
pattern ^anl_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
sincestring · queryPlaced at or after.
format date-time
untilstring · queryPlaced before.
format date-time
limitinteger · queryBets per page, 1 to 200.
min 1 · max 200 · default 50
cursorstring · queryThe next_cursor of the page before.
max length 200
ResponseLink to this section
200 A page of your bets, newest placed first.
objectconstrequiredAlways list.
Always "list".
dataarray of objectrequiredThe page's bets, newest placed first.
Show 34 fields
idstringrequiredThe bet's ID (tbet_…), a random handle.
pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
objectconstrequiredAlways bet.
Always "bet".
kindstringrequiredsingle, parlay or teaser.
One of: single, parlay, teaser (open: new values may be added).
statusstringrequiredopen until it settles.
One of: open, won, lost, push, void, half_won, half_lost, cashed_out (open: new values may be added).
placed_atstringrequiredWhen the bet was placed.
format date-time
settled_atstringnullableWhen it settled; null while open.
format date-time
settled_bystringnullableperson, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.
bookobjectrequiredThe book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).
placed_statestringnullableWhere it was placed, ISO 3166-2 (US-NJ).
currencystringrequiredISO 4217 currency of every amount.
stake_minorintegerrequiredThe stake the person placed, in minor units.
priceobjectrequiredThe price in the form the person gave it, echoed back.
price_decimalnumberrequiredThe price as decimal odds.
payout_minorintegernullableWhat the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.
profit_minorintegernullablePayout less the cash stake; null while open.
free_betbooleanrequiredA free (bonus) bet, whose stake was never the person's.
boostbooleanA price boost.
fair_price_decimalnullKelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.
edgenullKelly's edge when logged from an answer: shown on Kelly's site only.
clvnumbernullableThe closing-line value against the market close: price_decimal / close.market_decimal - 1 for a single, and for a parlay over its legs' closes multiplied (legs taken as independent); null until every leg's close is recorded, and for a teaser.
sourcestringrequiredWhere it was logged.
One of: answer, chat, manual, csv, api, mcp, sync (open: new values may be added).
project_idstringnullableThe person's project it belongs to.
conversation_idstringnullableThe saved chat it was logged from.
answer_idstringnullableThe answer it was logged from.
limit_minorintegernullableThe book's limit on this bet, when the person noted one.
tagsarray of stringrequiredThe person's tags.
notestringThe person's note.
import_idstringnullableThe CSV import it came from.
source_pick_idstringnullableThe analyst's pick it tails (apck_…), when the person logged one.
source_analyst_idstringnullableThat pick's analyst (anl_…).
created_atstringrequiredWhen it was logged.
format date-time
updated_atstringrequiredWhen it last changed.
format date-time
attributionstringrequiredThe odds attribution the closes carry.
legsarray of objectrequiredOne leg per selection, in ticket order.
Show 14 fields
seqintegerrequiredThe leg's place on the ticket, from 1.
selectionstringrequiredThe selection as the person wrote it, such as Chiefs -3.
market_kindstringrequiredThe kind of market.
One of: spread, total, moneyline, prop, future, other (open: new values may be added).
sportstringnullableThe sport, as given or from Kelly's game.
leaguestringnullableThe league, as given or from Kelly's game.
sidestringnullableThe side (home, away, over, under), when known.
linenumbernullableThe line the person took, such as -3 or 47.5.
price_decimalnumbernullableA parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.
game_idstringnullableKelly's game, when matched.
market_idstringnullableKelly's market, when matched.
selection_idstringnullableKelly's selection, when matched.
starts_atstringnullableThe game's start, when matched.
format date-time
resultstringrequiredThe leg's result: open until the person or the settle job decides it.
One of: open, won, lost, push, void, half_won, half_lost (open: new values may be added).
closeobjectrequiredThe close Kelly recorded at kick-off, once the game has started; every member is null until then, and for a leg not matched to Kelly's data.
Show 5 fields
price_decimalnullThe person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.
linenullThe person's own book's last line before kick-off: shown on askkelly.ai only.
market_decimalnumbernullableThe market close: the no-vig probability for this selection averaged over every book that quoted all sides, as decimal odds. Closing-line value is measured against it.
sourcestringnullableWhere the close came from.
atstringnullableWhen Kelly recorded the close.
format date-time
has_morebooleanrequiredWhether another page follows.
next_cursorstringrequirednullablePass as cursor for the next page.
attributionstringrequiredThe odds attribution the closes carry.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled
ExampleLink to this section
GET https://api.askkelly.ai/v1/bets?status=won&limit=10
Authorization: Bearer $KELLY_API_KEY{
"object": "list",
"data": [
{
"id": "tbet_gyswpkn4776tbf0aqz2z",
"object": "bet",
"kind": "single",
"status": "won",
"placed_at": "2026-10-04T16:45:00Z",
"settled_at": "2026-10-04T17:30:00Z",
"settled_by": "person",
"book": {
"id": null,
"name": "DraftKings",
"venue_type": "sportsbook"
},
"placed_state": null,
"currency": "USD",
"stake_minor": 5000,
"price": {
"american": -110
},
"price_decimal": 1.90909090909091,
"payout_minor": 9545,
"profit_minor": 4545,
"free_bet": false,
"boost": false,
"fair_price_decimal": null,
"edge": null,
"clv": null,
"source": "api",
"project_id": null,
"conversation_id": null,
"answer_id": null,
"limit_minor": null,
"tags": [],
"note": "Took it before the move",
"import_id": null,
"source_pick_id": null,
"source_analyst_id": null,
"created_at": "2026-10-04T17:30:00Z",
"updated_at": "2026-10-04T17:30:00Z",
"legs": [
{
"seq": 1,
"selection": "Chiefs -3",
"market_kind": "spread",
"sport": null,
"league": null,
"side": null,
"line": -3,
"price_decimal": 1.90909090909091,
"game_id": null,
"market_id": null,
"selection_id": null,
"starts_at": null,
"result": "won",
"close": {
"price_decimal": null,
"line": null,
"market_decimal": null,
"source": null,
"at": null
}
}
],
"attribution": "Odds data via The Odds API"
}
],
"has_more": false,
"next_cursor": null,
"attribution": "Odds data via The Odds API"
}POST /v1/bets
Log a betLink to this section
scope write:tracker · 0 credits, not charged during the beta · MCP tool log_my_bet · status live
Logs a bet you placed: its legs, book, price in the form you have it, stake and currency. Legs that name Kelly's selection, market or game settle on their own and get their close; free-text legs wait for you to settle them. Needs your own live API key with write:tracker; an AI app can't log a bet without your confirmation, and a test-mode key can't change your bet log.
ParametersLink to this section
Body, application/json (required):
legsarray of objectOne leg per selection.
min items 1
Show 10 fields
selectionstringrequiredThe selection in your own words, such as Chiefs -3.
min length 1 · max length 200
market_kindstringThe kind of market; default other.
One of: spread, total, moneyline, prop, future, other (open: new values may be added).
sportstringThe sport.
max length 40
leaguestringThe league.
max length 40
sidestringhome, away, over or under.
max length 40
linenumberThe line you took.
priceobjectA parlay leg's own price; a single takes the bet's. Exactly one of {"american": -110}, {"decimal": 1.91}, {"fractional": "10/11"} or {"cents": 52}.
game_idstringKelly's game.
pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
market_idstringKelly's market.
pattern ^mkt_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
selection_idstringKelly's selection: fills in the market, game, sport and start time.
pattern ^sel_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
kindstringDefault: single for one leg, parlay for more.
One of: single, parlay, teaser (open: new values may be added).
priceobjectThe ticket's price. Exactly one of {"american": -110}, {"decimal": 1.91}, {"fractional": "10/11"} or {"cents": 52}.
stake_minorintegerThe stake, in minor units.
min 1
bookstringThe book's name; book or book_id is required to log a bet.
min length 1 · max length 80
book_idstringKelly's book ID (bk_…).
pattern ^bk_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
venue_typestringDefault: the book's own kind, else sportsbook.
One of: sportsbook, exchange, prediction_market, dfs_pickem (open: new values may be added).
currencystringISO 4217; default USD.
pattern ^[A-Z]{3}$
placed_atstringWhen you placed it; default now.
format date-time
placed_statestringWhere you placed it, ISO 3166-2 (US-NJ).
pattern ^[A-Z]{2}-[A-Z0-9]{1,3}$
free_betbooleanA free (bonus) bet.
boostbooleanA price boost.
project_idstringOne of your projects.
pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
limit_minorintegerThe book's limit on this bet, in minor units.
min 1
source_pick_idstringThe analyst's pick it tails (apck_…), from list_analyst_picks: the bet then counts toward that analyst in the summary's by_analyst.
pattern ^apck_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
tagsarray of stringYour tags.
notestringYour note.
max length 1000
ResponseLink to this section
201 The bet as logged.
idstringrequiredThe bet's ID (tbet_…), a random handle.
pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
objectconstrequiredAlways bet.
Always "bet".
kindstringrequiredsingle, parlay or teaser.
One of: single, parlay, teaser (open: new values may be added).
statusstringrequiredopen until it settles.
One of: open, won, lost, push, void, half_won, half_lost, cashed_out (open: new values may be added).
placed_atstringrequiredWhen the bet was placed.
format date-time
settled_atstringnullableWhen it settled; null while open.
format date-time
settled_bystringnullableperson, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.
bookobjectrequiredThe book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).
placed_statestringnullableWhere it was placed, ISO 3166-2 (US-NJ).
currencystringrequiredISO 4217 currency of every amount.
stake_minorintegerrequiredThe stake the person placed, in minor units.
priceobjectrequiredThe price in the form the person gave it, echoed back.
price_decimalnumberrequiredThe price as decimal odds.
payout_minorintegernullableWhat the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.
profit_minorintegernullablePayout less the cash stake; null while open.
free_betbooleanrequiredA free (bonus) bet, whose stake was never the person's.
boostbooleanA price boost.
fair_price_decimalnullKelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.
edgenullKelly's edge when logged from an answer: shown on Kelly's site only.
clvnumbernullableThe closing-line value against the market close: price_decimal / close.market_decimal - 1 for a single, and for a parlay over its legs' closes multiplied (legs taken as independent); null until every leg's close is recorded, and for a teaser.
sourcestringrequiredWhere it was logged.
One of: answer, chat, manual, csv, api, mcp, sync (open: new values may be added).
project_idstringnullableThe person's project it belongs to.
conversation_idstringnullableThe saved chat it was logged from.
answer_idstringnullableThe answer it was logged from.
limit_minorintegernullableThe book's limit on this bet, when the person noted one.
tagsarray of stringrequiredThe person's tags.
notestringThe person's note.
import_idstringnullableThe CSV import it came from.
source_pick_idstringnullableThe analyst's pick it tails (apck_…), when the person logged one.
source_analyst_idstringnullableThat pick's analyst (anl_…).
created_atstringrequiredWhen it was logged.
format date-time
updated_atstringrequiredWhen it last changed.
format date-time
attributionstringrequiredThe odds attribution the closes carry.
legsarray of objectrequiredOne leg per selection, in ticket order.
Show 14 fields
seqintegerrequiredThe leg's place on the ticket, from 1.
selectionstringrequiredThe selection as the person wrote it, such as Chiefs -3.
market_kindstringrequiredThe kind of market.
One of: spread, total, moneyline, prop, future, other (open: new values may be added).
sportstringnullableThe sport, as given or from Kelly's game.
leaguestringnullableThe league, as given or from Kelly's game.
sidestringnullableThe side (home, away, over, under), when known.
linenumbernullableThe line the person took, such as -3 or 47.5.
price_decimalnumbernullableA parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.
game_idstringnullableKelly's game, when matched.
market_idstringnullableKelly's market, when matched.
selection_idstringnullableKelly's selection, when matched.
starts_atstringnullableThe game's start, when matched.
format date-time
resultstringrequiredThe leg's result: open until the person or the settle job decides it.
One of: open, won, lost, push, void, half_won, half_lost (open: new values may be added).
closeobjectrequiredThe close Kelly recorded at kick-off, once the game has started; every member is null until then, and for a leg not matched to Kelly's data.
Show 5 fields
price_decimalnullThe person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.
linenullThe person's own book's last line before kick-off: shown on askkelly.ai only.
market_decimalnumbernullableThe market close: the no-vig probability for this selection averaged over every book that quoted all sides, as decimal odds. Closing-line value is measured against it.
sourcestringnullableWhere the close came from.
atstringnullableWhen Kelly recorded the close.
format date-time
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · not_found · attestation_required
ExampleLink to this section
POST https://api.askkelly.ai/v1/bets
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"legs": [
{
"selection": "Chiefs -3",
"market_kind": "spread",
"line": -3
}
],
"book": "DraftKings",
"price": {
"american": -110
},
"stake_minor": 5000,
"placed_at": "2026-10-04T16:45:00Z"
}
{
"type": "https://docs.askkelly.ai/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This needs the write:tracker scope.",
"param": "write:tracker",
"doc_url": "https://docs.askkelly.ai/problems/insufficient_scope",
"request_id": "req_8e70a98446f5c6eceba3bdb0",
"retryable": false,
"display_message": "This app needs one more permission to do that."
}POST https://api.askkelly.ai/v1/bets
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"legs": [
{
"selection": "Chiefs -3",
"market_kind": "spread",
"line": -3
}
],
"book": "DraftKings",
"price": {
"american": -110
},
"stake_minor": 5000,
"placed_at": "2026-10-04T16:45:00Z",
"edge": 0.04
}
{
"type": "https://docs.askkelly.ai/problems/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "edge is set on askkelly.ai only, never through the API.",
"param": "edge",
"doc_url": "https://docs.askkelly.ai/problems/invalid_request",
"request_id": "req_8f43ad4cdb4bd6bcb99c9540",
"retryable": false,
"display_message": "Something in that request was not understood."
}POST https://api.askkelly.ai/v1/bets
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"legs": [
{
"selection": "Chiefs -3",
"market_kind": "spread",
"line": -3
}
],
"book": "DraftKings",
"price": {
"american": -110
},
"stake_minor": 5000,
"placed_at": "2026-10-04T16:45:00Z"
}
{
"id": "tbet_gyswpkn4776tbf0aqz2z",
"object": "bet",
"kind": "single",
"status": "open",
"placed_at": "2026-10-04T16:45:00Z",
"settled_at": null,
"settled_by": null,
"book": {
"id": null,
"name": "DraftKings",
"venue_type": "sportsbook"
},
"placed_state": null,
"currency": "USD",
"stake_minor": 5000,
"price": {
"american": -110
},
"price_decimal": 1.90909090909091,
"payout_minor": null,
"profit_minor": null,
"free_bet": false,
"boost": false,
"fair_price_decimal": null,
"edge": null,
"clv": null,
"source": "api",
"project_id": null,
"conversation_id": null,
"answer_id": null,
"limit_minor": null,
"tags": [],
"note": "",
"import_id": null,
"source_pick_id": null,
"source_analyst_id": null,
"created_at": "2026-10-04T17:30:00Z",
"updated_at": "2026-10-04T17:30:00Z",
"legs": [
{
"seq": 1,
"selection": "Chiefs -3",
"market_kind": "spread",
"sport": null,
"league": null,
"side": null,
"line": -3,
"price_decimal": 1.90909090909091,
"game_id": null,
"market_id": null,
"selection_id": null,
"starts_at": null,
"result": "open",
"close": {
"price_decimal": null,
"line": null,
"market_decimal": null,
"source": null,
"at": null
}
}
],
"attribution": "Odds data via The Odds API"
}POST /v1/bets/import
Import bets from a CSVLink to this section
scope write:tracker · 0 credits, not charged during the beta · MCP tool import_my_bets · status live
Reads a CSV of your bets (another tracker's export or your own sheet) into your bet log. Columns are found by their headings: date, book, bet (or event and selection), odds, stake, and for settled bets the result and the payout or profit; a parlay is one row listing its legs or several rows sharing a ticket number. Bets already in your log, from an earlier import, a chat, a slip or bet sync, are left alone, so the same file twice adds nothing. Legs naming their league and game are matched to Kelly's, graded and given their closing-line value. dry_run reads the file and says what it would add. Needs your own live API key with write:tracker.
ParametersLink to this section
Body, application/json (required):
csvstringThe CSV file's text, its heading row included. At most 5 MB.
min length 1
bookstringThe book, when the file has no book column.
min length 1 · max length 80
time_zonestringThe IANA zone for times the file gives without one.
max length 64 · default "America/New_York"
currencystringISO 4217, when the file has no currency column.
pattern ^[A-Z]{3}$ · default "USD"
dry_runbooleantrue: say what would be added and add nothing.
default false
ResponseLink to this section
200 A dry run: what would be added. Nothing was.
objectconstAlways bet_import.
Always "bet_import".
dry_runbooleantrue: nothing was added.
rowsintegerData rows read.
bets_foundintegerBets read from the rows.
to_addintegerBets not yet in the log.
addedintegerBets added (0 on a dry run).
already_loggedintegerBets already in the log, left alone.
skipped_countintegerRows left out.
cutintegerBets past the most one import takes, for another file.
skippedarray of objectUp to 20 rows left out: row and reason.
Show 2 fields
rowintegerThe file's row number (the header is 1).
reasonstringWhy.
columnsobjectEach field read, and the file's heading it was read from.
totalsobjectPer currency, the new bets: bets, open, settled, staked_minor, profit_minor.
samplearray of objectUp to 10 of the new bets.
Show 9 fields
whatstringWhat it is on.
sportsbookstringWhere.
placed_atstringnullableWhen placed.
format date-time
priceobjectThe price as the file gave it.
stake_minorintegerThe stake.
statusstringopen or the result.
payout_minorintegernullableWhat it returned.
free_betbooleanA free bet.
rowsarray of integerThe file's rows it came from.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · not_found · attestation_required
ExampleLink to this section
POST https://api.askkelly.ai/v1/bets/import
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"csv": "Date,Sportsbook,League,Bet,Odds,Stake,Result,Payout\n2026-09-27 12:40,FanDuel,NFL,Over 47.5,-110,22.00,Won,42.00\n2026-09-28,DraftKings,NFL,Bills ML | Over 44.5,+264,10.00,Lost,0\n2026-09-28,DraftKings,NFL,,-110,10.00,Lost,0\n"
}
{
"object": "bet_import",
"dry_run": false,
"rows": 3,
"bets_found": 2,
"columns": {
"placed": "Date",
"sportsbook": "Sportsbook",
"league": "League",
"selection": "Bet",
"odds": "Odds",
"stake": "Stake",
"result": "Result",
"payout": "Payout"
},
"skipped_count": 1,
"cut": 0,
"skipped": [
{
"row": 4,
"reason": "no selection: what was bet"
}
],
"to_add": 0,
"added": 0,
"already_logged": 2,
"totals": {},
"sample": []
}POST https://api.askkelly.ai/v1/bets/import
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"csv": "Date,Sportsbook,League,Bet,Odds,Stake,Result,Payout\n2026-09-27 12:40,FanDuel,NFL,Over 47.5,-110,22.00,Won,42.00\n2026-09-28,DraftKings,NFL,Bills ML | Over 44.5,+264,10.00,Lost,0\n2026-09-28,DraftKings,NFL,,-110,10.00,Lost,0\n",
"dry_run": true
}
{
"object": "bet_import",
"dry_run": true,
"rows": 3,
"bets_found": 2,
"columns": {
"placed": "Date",
"sportsbook": "Sportsbook",
"league": "League",
"selection": "Bet",
"odds": "Odds",
"stake": "Stake",
"result": "Result",
"payout": "Payout"
},
"skipped_count": 1,
"cut": 0,
"skipped": [
{
"row": 4,
"reason": "no selection: what was bet"
}
],
"to_add": 2,
"already_logged": 0,
"totals": {
"USD": {
"bets": 2,
"open": 0,
"settled": 2,
"staked_minor": 3200,
"profit_minor": 1000
}
},
"sample": [
{
"what": "Over 47.5",
"sportsbook": "FanDuel",
"placed_at": "2026-09-27T16:40:00Z",
"price": {
"american": -110
},
"stake_minor": 2200,
"status": "won",
"payout_minor": 4200,
"free_bet": false,
"rows": [
2
]
},
{
"what": "2-leg parlay: Bills ML, Over 44.5",
"sportsbook": "DraftKings",
"placed_at": "2026-09-28T04:00:00Z",
"price": {
"american": 264
},
"stake_minor": 1000,
"status": "lost",
"payout_minor": 0,
"free_bet": false,
"rows": [
3
]
}
],
"added": 0
}POST https://api.askkelly.ai/v1/bets/import
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"csv": "Date,Sportsbook,League,Bet,Odds,Stake,Result,Payout\n2026-09-27 12:40,FanDuel,NFL,Over 47.5,-110,22.00,Won,42.00\n2026-09-28,DraftKings,NFL,Bills ML | Over 44.5,+264,10.00,Lost,0\n2026-09-28,DraftKings,NFL,,-110,10.00,Lost,0\n"
}
{
"object": "bet_import",
"dry_run": false,
"rows": 3,
"bets_found": 2,
"columns": {
"placed": "Date",
"sportsbook": "Sportsbook",
"league": "League",
"selection": "Bet",
"odds": "Odds",
"stake": "Stake",
"result": "Result",
"payout": "Payout"
},
"skipped_count": 1,
"cut": 0,
"skipped": [
{
"row": 4,
"reason": "no selection: what was bet"
}
],
"to_add": 2,
"added": 2,
"already_logged": 0,
"totals": {
"USD": {
"bets": 2,
"open": 0,
"settled": 2,
"staked_minor": 3200,
"profit_minor": 1000
}
},
"sample": [
{
"what": "Over 47.5",
"sportsbook": "FanDuel",
"placed_at": "2026-09-27T16:40:00Z",
"price": {
"american": -110
},
"stake_minor": 2200,
"status": "won",
"payout_minor": 4200,
"free_bet": false,
"rows": [
2
]
},
{
"what": "2-leg parlay: Bills ML, Over 44.5",
"sportsbook": "DraftKings",
"placed_at": "2026-09-28T04:00:00Z",
"price": {
"american": 264
},
"stake_minor": 1000,
"status": "lost",
"payout_minor": 0,
"free_bet": false,
"rows": [
3
]
}
]
}POST https://api.askkelly.ai/v1/bets/import
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"csv": "Date,Sportsbook,League,Bet,Odds,Stake,Result,Payout\n2026-09-27 12:40,FanDuel,NFL,Over 47.5,-110,22.00,Won,42.00\n2026-09-28,DraftKings,NFL,Bills ML | Over 44.5,+264,10.00,Lost,0\n2026-09-28,DraftKings,NFL,,-110,10.00,Lost,0\n"
}
{
"type": "https://docs.askkelly.ai/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This needs the write:tracker scope.",
"param": "write:tracker",
"doc_url": "https://docs.askkelly.ai/problems/insufficient_scope",
"request_id": "req_518c8f683453a6e44d412f72",
"retryable": false,
"display_message": "This app needs one more permission to do that."
}POST https://api.askkelly.ai/v1/bets/import
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"csv": "a,b\n1,2\n"
}
{
"type": "https://docs.askkelly.ai/problems/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "No header row naming the bets' columns was found: the file needs a heading row with at least what was bet (bet, selection or description) and the stake or the odds.",
"param": "file",
"doc_url": "https://docs.askkelly.ai/problems/invalid_request",
"request_id": "req_ec625fde5bd49bfc738b99d2",
"retryable": false,
"display_message": "Something in that request was not understood."
}POST /v1/bets/find_rule
Find the rule behind your betsLink to this section
scope read:tracker · 1 credit, not charged during the beta · MCP tool find_rule_in_my_bets · status live
Finds up to three rules in Kelly's formula language that describe which games you bet: from your bet log's spread, moneyline or total bets in one competition, against every team-game Kelly held a line for, read from your choices only and never from whether the bets won. Each rule comes with its conditions, the share of your bets it matches (coverage), the share of its games you bet (precision) and its lift over chance. It needs at least 20 bets; test a rule with POST /v1/rules:test.
ParametersLink to this section
Body, application/json (required):
competitionstringThe competition's slug: nfl, nba, mlb, nhl, ncaaf, ncaab, wnba...
pattern ^[a-z0-9_]{2,24}$
marketstringspread, moneyline, over or under.
One of: spread, moneyline, over, under (open: new values may be added).
default "spread"
seasonsarray of stringSeasons to read; default the seasons your bets fall in.
max items 25
sincestringOnly bets placed at or after this time.
format date-time
untilstringOnly bets placed before this time.
format date-time
ResponseLink to this section
200 Up to three rules that describe which games you bet.
objectconstAlways bet_rule.
Always "bet_rule".
competitionstringThe competition.
marketstringspread, moneyline, over or under.
seasonsarray of stringSeasons read.
betsobjectgiven, used, and left_out: each reason (side_unread, not_in_kellys_games, same_game_twice, other_market) and its count.
universeintegerTeam-games Kelly held a line for: every game the person could have bet.
base_ratenumbernullableThe share of those the person bet.
candidatesarray of objectUp to three, each matching a different set of games.
Show 8 fields
labelstringdescribes_most (the most precise covering 80% of the bets), tightest (covering 50%) or balanced (the best F1).
One of: describes_most, tightest, balanced (open: new values may be added).
formulastringThe rule, ready for test_rule.
conditionsarray of objectIts conditions.
Show 2 fields
formulastringThe condition as a formula.
wordsstringThe condition in words.
coveragenumberThe share of the person's bets it matches (0.8 is 80%).
precisionnumberThe share of its games the person bet.
liftnumbernullablePrecision over the share of all games bet; 1.0 is chance.
matchesintegerTeam-games it matches.
bets_coveredintegerThe person's bets among them.
reasonstringnullableWhy there are no candidates, when there are none.
placedobjectThe placed window read: since and until, or null.
nextobjecttest_rule, which counts each candidate tested on the rules-tried ledger.
noticestringFound from the person's choices only, never from the results.
summarystringThe candidates in one sentence, from the fields.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large
ExampleLink to this section
POST https://api.askkelly.ai/v1/bets/find_rule
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"competition": "nba",
"market": "teaser"
}
{
"type": "https://docs.askkelly.ai/problems/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "market: String should match pattern '^(spread|moneyline|over|under)$'",
"param": "market",
"doc_url": "https://docs.askkelly.ai/problems/invalid_request",
"request_id": "req_cee6797059e0c015feb03175",
"retryable": false,
"display_message": "Something in that request was not understood."
}POST https://api.askkelly.ai/v1/bets/find_rule
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"competition": "nba",
"seasons": [
"2025-26"
]
}
{
"object": "bet_rule",
"competition": "nba",
"market": "spread",
"seasons": [
"2025-26"
],
"bets": {
"given": 0,
"used": 0,
"left_out": {}
},
"universe": 2,
"base_rate": 0,
"candidates": [],
"reason": "No spread bets on NBA games in your bet log: log or import at least 20 to find the rule behind them.",
"notice": "These rules describe which games you bet, found from your choices only, never from whether they won. Test one to see how it did.",
"placed": {
"since": null,
"until": null
},
"summary": "From 0 of your spread bets on NBA games (of 2 team-games Kelly held a line for): no rule found. No spread bets on NBA games in your bet log: log or import at least 20 to find the rule behind them."
}GET /v1/bets/summary
Get your totalsLink to this section
scope read:tracker · 0 credits, not charged during the beta · MCP tool get_my_bet_summary · status live
Your turnover, profit, ROI, money at risk and mean closing-line value for the bets that match, kept apart by currency, with profit per day, week, month and year in the time zone you name.
ParametersLink to this section
projectstring · queryOne of your projects (proj_…), or none for bets in no project.
pattern ^(none|proj_[0-9a-hjkmnp-tv-z]{20})$
statusstring · queryOne status, or settled for every settled bet.
One of: open, won, lost, push, void, half_won, half_lost, cashed_out, settled (open: new values may be added).
sportstring · queryOnly this sport.
max length 40
bookstring · queryOnly this book, by Kelly's ID or by name.
max length 80
tagstring · queryOnly bets with this tag.
max length 40
currencystring · queryOnly this currency.
pattern ^[A-Z]{3}$
game_idstring · queryOnly bets with a leg on this game.
pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
analyststring · queryOnly bets that tail this analyst's picks (anl_…).
pattern ^anl_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
sincestring · queryPlaced at or after.
format date-time
untilstring · queryPlaced before.
format date-time
tzstring · queryThe IANA time zone the periods are counted in.
max length 64 · default "America/New_York"
ResponseLink to this section
200 Your totals for the bets that match.
objectconstrequiredAlways bet_summary.
Always "bet_summary".
tzstringrequiredThe time zone the periods are counted in.
attributionstringrequiredThe odds attribution the closes carry.
currenciesarray of objectrequiredOne entry per currency, in currency order.
Show 16 fields
currencystringISO 4217.
betsintegerBets logged.
openintegerBets still open.
settledintegerBets settled.
staked_minorintegerCash staked on settled bets that had action (pushes, voids and free bets left out).
profit_minorintegerPayout less cash stake over settled bets.
roinumbernullableProfit over staked; null with nothing staked.
at_risk_minorintegerCash stakes of open bets.
clvobjectThe mean closing-line value over singles with a market close, and how many bets it covers.
expected_profit_minornullStake times Kelly's edge over bets logged from answers: shown on askkelly.ai only.
actual_profit_minorintegernullableProfit over the bets that carried Kelly's edge.
edge_betsintegerHow many settled bets carried Kelly's edge.
by_clvobjectSettled bets that beat the market close (closing-line value above zero) and those that didn't; bets with no close are in neither.
Show 2 fields
beatobjectBets that beat the close.
Show 4 fields
betsintegerSettled bets.
staked_minorintegerCash staked on bets that had action.
profit_minorintegerProfit.
roinumbernullableProfit over staked; null with nothing staked.
missedobjectBets that didn't.
Show 4 fields
betsintegerSettled bets.
staked_minorintegerCash staked on bets that had action.
profit_minorintegerProfit.
roinumbernullableProfit over staked; null with nothing staked.
recordobjectnullableWon, lost and pushed bets tested at the prices paid (F12.3), and the bets a record at this win rate needs before it separates from the break-even (F12.4); null with no decided bet.
Show 10 fields
winsintegerBets won.
lossesintegerBets lost.
pushesintegerPushes.
left_outintegerHalf results, voids and cash-outs, not tested.
win_ratenumberWins over wins and losses.
break_evennumberThe win rate the prices paid need: the average of each bet's 1 / decimal price.
over_break_evennumberWin rate minus break-even.
no_skill_match_probnumberThe chance a bettor with no skill, winning each bet at its break-even, wins at least as many.
significantbooleanWhether that chance is 5% or less.
bets_neededobjectnullableBets needed at this win rate: one_sided (z at 5%) and with_power (80% power); null at or under the break-even.
by_analystarray of objectThe bets that tail an analyst's pick (source_pick_id), one row per analyst, most profit first.
Show 11 fields
analyst_idstringThe analyst (anl_…).
analyststringnullableTheir name.
betsintegerBets logged.
openintegerBets still open.
settledintegerBets settled.
staked_minorintegerCash staked on settled bets that had action.
profit_minorintegerProfit.
roinumbernullableProfit over staked; null with nothing staked.
wonintegerBets won.
lostintegerBets lost.
pushintegerPushes.
by_periodobjectBets, staked and profit per day, ISO week, month and year of settlement in tz.
Show 4 fields
dayarray of objectBy day, oldest first.
Show 4 fields
periodstringThe period: 2026-10-11, 2026-W41, 2026-10 or 2026.
betsintegerBets settled in it.
staked_minorintegerCash staked on bets that had action.
profit_minorintegerProfit.
weekarray of objectBy week, oldest first.
Show 4 fields
periodstringThe period: 2026-10-11, 2026-W41, 2026-10 or 2026.
betsintegerBets settled in it.
staked_minorintegerCash staked on bets that had action.
profit_minorintegerProfit.
montharray of objectBy month, oldest first.
Show 4 fields
periodstringThe period: 2026-10-11, 2026-W41, 2026-10 or 2026.
betsintegerBets settled in it.
staked_minorintegerCash staked on bets that had action.
profit_minorintegerProfit.
yeararray of objectBy year, oldest first.
Show 4 fields
periodstringThe period: 2026-10-11, 2026-W41, 2026-10 or 2026.
betsintegerBets settled in it.
staked_minorintegerCash staked on bets that had action.
profit_minorintegerProfit.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled
ExampleLink to this section
GET https://api.askkelly.ai/v1/bets/summary?tz=America/New_York
Authorization: Bearer $KELLY_API_KEY{
"object": "bet_summary",
"tz": "America/New_York",
"currencies": [
{
"currency": "USD",
"bets": 1,
"open": 0,
"settled": 1,
"staked_minor": 5000,
"profit_minor": 4545,
"roi": 0.909,
"at_risk_minor": 0,
"clv": {
"mean": null,
"bets": 0
},
"expected_profit_minor": null,
"actual_profit_minor": null,
"edge_bets": 0,
"by_clv": {
"beat": {
"bets": 0,
"staked_minor": 0,
"profit_minor": 0,
"roi": null
},
"missed": {
"bets": 0,
"staked_minor": 0,
"profit_minor": 0,
"roi": null
}
},
"record": {
"wins": 1,
"losses": 0,
"pushes": 0,
"left_out": 0,
"win_rate": 1,
"break_even": 0.5238095238095235,
"over_break_even": 0.4761904761904765,
"no_skill_match_prob": 0.5238095238095235,
"significant": false,
"bets_needed": null
},
"by_analyst": [],
"by_period": {
"day": [
{
"period": "2026-10-04",
"bets": 1,
"staked_minor": 5000,
"profit_minor": 4545
}
],
"week": [
{
"period": "2026-W40",
"bets": 1,
"staked_minor": 5000,
"profit_minor": 4545
}
],
"month": [
{
"period": "2026-10",
"bets": 1,
"staked_minor": 5000,
"profit_minor": 4545
}
],
"year": [
{
"period": "2026",
"bets": 1,
"staked_minor": 5000,
"profit_minor": 4545
}
]
}
}
],
"attribution": "Odds data via The Odds API"
}GET /v1/bets/{bet_id}
Get a betLink to this section
scope read:tracker · 0 credits, not charged during the beta · status live
One of your bets with its legs. Anyone else's bet answers 404.
ParametersLink to this section
bet_idstring · pathrequiredThe bet's ID (tbet_…).
pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
ResponseLink to this section
200 The bet.
idstringrequiredThe bet's ID (tbet_…), a random handle.
pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
objectconstrequiredAlways bet.
Always "bet".
kindstringrequiredsingle, parlay or teaser.
One of: single, parlay, teaser (open: new values may be added).
statusstringrequiredopen until it settles.
One of: open, won, lost, push, void, half_won, half_lost, cashed_out (open: new values may be added).
placed_atstringrequiredWhen the bet was placed.
format date-time
settled_atstringnullableWhen it settled; null while open.
format date-time
settled_bystringnullableperson, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.
bookobjectrequiredThe book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).
placed_statestringnullableWhere it was placed, ISO 3166-2 (US-NJ).
currencystringrequiredISO 4217 currency of every amount.
stake_minorintegerrequiredThe stake the person placed, in minor units.
priceobjectrequiredThe price in the form the person gave it, echoed back.
price_decimalnumberrequiredThe price as decimal odds.
payout_minorintegernullableWhat the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.
profit_minorintegernullablePayout less the cash stake; null while open.
free_betbooleanrequiredA free (bonus) bet, whose stake was never the person's.
boostbooleanA price boost.
fair_price_decimalnullKelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.
edgenullKelly's edge when logged from an answer: shown on Kelly's site only.
clvnumbernullableThe closing-line value against the market close: price_decimal / close.market_decimal - 1 for a single, and for a parlay over its legs' closes multiplied (legs taken as independent); null until every leg's close is recorded, and for a teaser.
sourcestringrequiredWhere it was logged.
One of: answer, chat, manual, csv, api, mcp, sync (open: new values may be added).
project_idstringnullableThe person's project it belongs to.
conversation_idstringnullableThe saved chat it was logged from.
answer_idstringnullableThe answer it was logged from.
limit_minorintegernullableThe book's limit on this bet, when the person noted one.
tagsarray of stringrequiredThe person's tags.
notestringThe person's note.
import_idstringnullableThe CSV import it came from.
source_pick_idstringnullableThe analyst's pick it tails (apck_…), when the person logged one.
source_analyst_idstringnullableThat pick's analyst (anl_…).
created_atstringrequiredWhen it was logged.
format date-time
updated_atstringrequiredWhen it last changed.
format date-time
attributionstringrequiredThe odds attribution the closes carry.
legsarray of objectrequiredOne leg per selection, in ticket order.
Show 14 fields
seqintegerrequiredThe leg's place on the ticket, from 1.
selectionstringrequiredThe selection as the person wrote it, such as Chiefs -3.
market_kindstringrequiredThe kind of market.
One of: spread, total, moneyline, prop, future, other (open: new values may be added).
sportstringnullableThe sport, as given or from Kelly's game.
leaguestringnullableThe league, as given or from Kelly's game.
sidestringnullableThe side (home, away, over, under), when known.
linenumbernullableThe line the person took, such as -3 or 47.5.
price_decimalnumbernullableA parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.
game_idstringnullableKelly's game, when matched.
market_idstringnullableKelly's market, when matched.
selection_idstringnullableKelly's selection, when matched.
starts_atstringnullableThe game's start, when matched.
format date-time
resultstringrequiredThe leg's result: open until the person or the settle job decides it.
One of: open, won, lost, push, void, half_won, half_lost (open: new values may be added).
closeobjectrequiredThe close Kelly recorded at kick-off, once the game has started; every member is null until then, and for a leg not matched to Kelly's data.
Show 5 fields
price_decimalnullThe person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.
linenullThe person's own book's last line before kick-off: shown on askkelly.ai only.
market_decimalnumbernullableThe market close: the no-vig probability for this selection averaged over every book that quoted all sides, as decimal odds. Closing-line value is measured against it.
sourcestringnullableWhere the close came from.
atstringnullableWhen Kelly recorded the close.
format date-time
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · not_found
ExampleLink to this section
GET https://api.askkelly.ai/v1/bets/tbet_00000000000000000000
Authorization: Bearer $KELLY_API_KEY{
"type": "https://docs.askkelly.ai/problems/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "No such bet.",
"param": "bet_id",
"doc_url": "https://docs.askkelly.ai/problems/not_found",
"request_id": "req_26d819debb1ce7d90215a445",
"retryable": false,
"display_message": "That could not be found."
}GET https://api.askkelly.ai/v1/bets/tbet_gyswpkn4776tbf0aqz2z
Authorization: Bearer $KELLY_API_KEY{
"id": "tbet_gyswpkn4776tbf0aqz2z",
"object": "bet",
"kind": "single",
"status": "open",
"placed_at": "2026-10-04T16:45:00Z",
"settled_at": null,
"settled_by": null,
"book": {
"id": null,
"name": "DraftKings",
"venue_type": "sportsbook"
},
"placed_state": null,
"currency": "USD",
"stake_minor": 5000,
"price": {
"american": -110
},
"price_decimal": 1.90909090909091,
"payout_minor": null,
"profit_minor": null,
"free_bet": false,
"boost": false,
"fair_price_decimal": null,
"edge": null,
"clv": null,
"source": "api",
"project_id": null,
"conversation_id": null,
"answer_id": null,
"limit_minor": null,
"tags": [],
"note": "",
"import_id": null,
"source_pick_id": null,
"source_analyst_id": null,
"created_at": "2026-10-04T17:30:00Z",
"updated_at": "2026-10-04T17:30:00Z",
"legs": [
{
"seq": 1,
"selection": "Chiefs -3",
"market_kind": "spread",
"sport": null,
"league": null,
"side": null,
"line": -3,
"price_decimal": 1.90909090909091,
"game_id": null,
"market_id": null,
"selection_id": null,
"starts_at": null,
"result": "open",
"close": {
"price_decimal": null,
"line": null,
"market_decimal": null,
"source": null,
"at": null
}
}
],
"attribution": "Odds data via The Odds API"
}PATCH /v1/bets/{bet_id}
Change a betLink to this section
scope write:tracker · 0 credits, not charged during the beta · MCP tool update_my_bet · status live
Changes the fields you send. A settled bet's payout follows a new stake, price or free-bet flag. Needs your own live API key with write:tracker.
ParametersLink to this section
bet_idstring · pathrequiredThe bet's ID (tbet_…).
pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
Body, application/json (required):
legsarray of objectReplaces every leg.
min items 1
Show 10 fields
selectionstringrequiredThe selection in your own words, such as Chiefs -3.
min length 1 · max length 200
market_kindstringThe kind of market; default other.
One of: spread, total, moneyline, prop, future, other (open: new values may be added).
sportstringThe sport.
max length 40
leaguestringThe league.
max length 40
sidestringhome, away, over or under.
max length 40
linenumberThe line you took.
priceobjectA parlay leg's own price; a single takes the bet's. Exactly one of {"american": -110}, {"decimal": 1.91}, {"fractional": "10/11"} or {"cents": 52}.
game_idstringKelly's game.
pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
market_idstringKelly's market.
pattern ^mkt_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
selection_idstringKelly's selection: fills in the market, game, sport and start time.
pattern ^sel_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
priceobjectThe ticket's price. Exactly one of {"american": -110}, {"decimal": 1.91}, {"fractional": "10/11"} or {"cents": 52}.
stake_minorintegerThe stake, in minor units.
min 1
clear_projectbooleanTake the bet out of its project.
clear_source_pickbooleanUnlink the analyst's pick it tails.
bookstringThe book's name; book or book_id is required to log a bet.
min length 1 · max length 80
book_idstringKelly's book ID (bk_…).
pattern ^bk_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
venue_typestringDefault: the book's own kind, else sportsbook.
One of: sportsbook, exchange, prediction_market, dfs_pickem (open: new values may be added).
currencystringISO 4217; default USD.
pattern ^[A-Z]{3}$
placed_atstringWhen you placed it; default now.
format date-time
placed_statestringWhere you placed it, ISO 3166-2 (US-NJ).
pattern ^[A-Z]{2}-[A-Z0-9]{1,3}$
free_betbooleanA free (bonus) bet.
boostbooleanA price boost.
project_idstringOne of your projects.
pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
limit_minorintegerThe book's limit on this bet, in minor units.
min 1
source_pick_idstringThe analyst's pick it tails (apck_…), from list_analyst_picks: the bet then counts toward that analyst in the summary's by_analyst.
pattern ^apck_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
tagsarray of stringYour tags.
notestringYour note.
max length 1000
ResponseLink to this section
200 The bet as it now is.
idstringrequiredThe bet's ID (tbet_…), a random handle.
pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
objectconstrequiredAlways bet.
Always "bet".
kindstringrequiredsingle, parlay or teaser.
One of: single, parlay, teaser (open: new values may be added).
statusstringrequiredopen until it settles.
One of: open, won, lost, push, void, half_won, half_lost, cashed_out (open: new values may be added).
placed_atstringrequiredWhen the bet was placed.
format date-time
settled_atstringnullableWhen it settled; null while open.
format date-time
settled_bystringnullableperson, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.
bookobjectrequiredThe book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).
placed_statestringnullableWhere it was placed, ISO 3166-2 (US-NJ).
currencystringrequiredISO 4217 currency of every amount.
stake_minorintegerrequiredThe stake the person placed, in minor units.
priceobjectrequiredThe price in the form the person gave it, echoed back.
price_decimalnumberrequiredThe price as decimal odds.
payout_minorintegernullableWhat the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.
profit_minorintegernullablePayout less the cash stake; null while open.
free_betbooleanrequiredA free (bonus) bet, whose stake was never the person's.
boostbooleanA price boost.
fair_price_decimalnullKelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.
edgenullKelly's edge when logged from an answer: shown on Kelly's site only.
clvnumbernullableThe closing-line value against the market close: price_decimal / close.market_decimal - 1 for a single, and for a parlay over its legs' closes multiplied (legs taken as independent); null until every leg's close is recorded, and for a teaser.
sourcestringrequiredWhere it was logged.
One of: answer, chat, manual, csv, api, mcp, sync (open: new values may be added).
project_idstringnullableThe person's project it belongs to.
conversation_idstringnullableThe saved chat it was logged from.
answer_idstringnullableThe answer it was logged from.
limit_minorintegernullableThe book's limit on this bet, when the person noted one.
tagsarray of stringrequiredThe person's tags.
notestringThe person's note.
import_idstringnullableThe CSV import it came from.
source_pick_idstringnullableThe analyst's pick it tails (apck_…), when the person logged one.
source_analyst_idstringnullableThat pick's analyst (anl_…).
created_atstringrequiredWhen it was logged.
format date-time
updated_atstringrequiredWhen it last changed.
format date-time
attributionstringrequiredThe odds attribution the closes carry.
legsarray of objectrequiredOne leg per selection, in ticket order.
Show 14 fields
seqintegerrequiredThe leg's place on the ticket, from 1.
selectionstringrequiredThe selection as the person wrote it, such as Chiefs -3.
market_kindstringrequiredThe kind of market.
One of: spread, total, moneyline, prop, future, other (open: new values may be added).
sportstringnullableThe sport, as given or from Kelly's game.
leaguestringnullableThe league, as given or from Kelly's game.
sidestringnullableThe side (home, away, over, under), when known.
linenumbernullableThe line the person took, such as -3 or 47.5.
price_decimalnumbernullableA parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.
game_idstringnullableKelly's game, when matched.
market_idstringnullableKelly's market, when matched.
selection_idstringnullableKelly's selection, when matched.
starts_atstringnullableThe game's start, when matched.
format date-time
resultstringrequiredThe leg's result: open until the person or the settle job decides it.
One of: open, won, lost, push, void, half_won, half_lost (open: new values may be added).
closeobjectrequiredThe close Kelly recorded at kick-off, once the game has started; every member is null until then, and for a leg not matched to Kelly's data.
Show 5 fields
price_decimalnullThe person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.
linenullThe person's own book's last line before kick-off: shown on askkelly.ai only.
market_decimalnumbernullableThe market close: the no-vig probability for this selection averaged over every book that quoted all sides, as decimal odds. Closing-line value is measured against it.
sourcestringnullableWhere the close came from.
atstringnullableWhen Kelly recorded the close.
format date-time
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · not_found
ExampleLink to this section
PATCH https://api.askkelly.ai/v1/bets/tbet_gyswpkn4776tbf0aqz2z
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"note": "Took it before the move"
}
{
"id": "tbet_gyswpkn4776tbf0aqz2z",
"object": "bet",
"kind": "single",
"status": "open",
"placed_at": "2026-10-04T16:45:00Z",
"settled_at": null,
"settled_by": null,
"book": {
"id": null,
"name": "DraftKings",
"venue_type": "sportsbook"
},
"placed_state": null,
"currency": "USD",
"stake_minor": 5000,
"price": {
"american": -110
},
"price_decimal": 1.90909090909091,
"payout_minor": null,
"profit_minor": null,
"free_bet": false,
"boost": false,
"fair_price_decimal": null,
"edge": null,
"clv": null,
"source": "api",
"project_id": null,
"conversation_id": null,
"answer_id": null,
"limit_minor": null,
"tags": [],
"note": "Took it before the move",
"import_id": null,
"source_pick_id": null,
"source_analyst_id": null,
"created_at": "2026-10-04T17:30:00Z",
"updated_at": "2026-10-04T17:30:00Z",
"legs": [
{
"seq": 1,
"selection": "Chiefs -3",
"market_kind": "spread",
"sport": null,
"league": null,
"side": null,
"line": -3,
"price_decimal": 1.90909090909091,
"game_id": null,
"market_id": null,
"selection_id": null,
"starts_at": null,
"result": "open",
"close": {
"price_decimal": null,
"line": null,
"market_decimal": null,
"source": null,
"at": null
}
}
],
"attribution": "Odds data via The Odds API"
}DELETE /v1/bets/{bet_id}
Delete a betLink to this section
scope write:tracker · 0 credits, not charged during the beta · status live
Deletes the bet and its legs at once. Needs your own live API key with write:tracker.
ParametersLink to this section
bet_idstring · pathrequiredThe bet's ID (tbet_…).
pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
ResponseLink to this section
200 Deleted, with its legs.
idstringrequiredThe deleted bet's ID.
objectconstrequiredAlways bet.
Always "bet".
deletedconstrequiredAlways true.
Always true.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · not_found
ExampleLink to this section
DELETE https://api.askkelly.ai/v1/bets/tbet_gyswpkn4776tbf0aqz2z
Authorization: Bearer $KELLY_API_KEY{
"id": "tbet_gyswpkn4776tbf0aqz2z",
"object": "bet",
"deleted": true
}POST /v1/bets/{bet_id}/settle
Settle a betLink to this section
scope write:tracker · 0 credits, not charged during the beta · MCP tool settle_my_bet · status live
Records the result. The payout follows from the status unless you name it; a cash-out names it; open reopens the bet. Kelly settles bets matched to its data on its own once the game is final, and never changes a bet you settled. Needs your own live API key with write:tracker.
ParametersLink to this section
bet_idstring · pathrequiredThe bet's ID (tbet_…).
pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
Body, application/json (required):
statusstringThe result, or open to reopen the bet.
One of: open, won, lost, push, void, half_won, half_lost, cashed_out (open: new values may be added).
payout_minorintegerWhat the book paid, in minor units.
min 0
settled_atstringWhen it settled; default now.
format date-time
ResponseLink to this section
200 The bet as it now is.
idstringrequiredThe bet's ID (tbet_…), a random handle.
pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
objectconstrequiredAlways bet.
Always "bet".
kindstringrequiredsingle, parlay or teaser.
One of: single, parlay, teaser (open: new values may be added).
statusstringrequiredopen until it settles.
One of: open, won, lost, push, void, half_won, half_lost, cashed_out (open: new values may be added).
placed_atstringrequiredWhen the bet was placed.
format date-time
settled_atstringnullableWhen it settled; null while open.
format date-time
settled_bystringnullableperson, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.
bookobjectrequiredThe book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).
placed_statestringnullableWhere it was placed, ISO 3166-2 (US-NJ).
currencystringrequiredISO 4217 currency of every amount.
stake_minorintegerrequiredThe stake the person placed, in minor units.
priceobjectrequiredThe price in the form the person gave it, echoed back.
price_decimalnumberrequiredThe price as decimal odds.
payout_minorintegernullableWhat the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.
profit_minorintegernullablePayout less the cash stake; null while open.
free_betbooleanrequiredA free (bonus) bet, whose stake was never the person's.
boostbooleanA price boost.
fair_price_decimalnullKelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.
edgenullKelly's edge when logged from an answer: shown on Kelly's site only.
clvnumbernullableThe closing-line value against the market close: price_decimal / close.market_decimal - 1 for a single, and for a parlay over its legs' closes multiplied (legs taken as independent); null until every leg's close is recorded, and for a teaser.
sourcestringrequiredWhere it was logged.
One of: answer, chat, manual, csv, api, mcp, sync (open: new values may be added).
project_idstringnullableThe person's project it belongs to.
conversation_idstringnullableThe saved chat it was logged from.
answer_idstringnullableThe answer it was logged from.
limit_minorintegernullableThe book's limit on this bet, when the person noted one.
tagsarray of stringrequiredThe person's tags.
notestringThe person's note.
import_idstringnullableThe CSV import it came from.
source_pick_idstringnullableThe analyst's pick it tails (apck_…), when the person logged one.
source_analyst_idstringnullableThat pick's analyst (anl_…).
created_atstringrequiredWhen it was logged.
format date-time
updated_atstringrequiredWhen it last changed.
format date-time
attributionstringrequiredThe odds attribution the closes carry.
legsarray of objectrequiredOne leg per selection, in ticket order.
Show 14 fields
seqintegerrequiredThe leg's place on the ticket, from 1.
selectionstringrequiredThe selection as the person wrote it, such as Chiefs -3.
market_kindstringrequiredThe kind of market.
One of: spread, total, moneyline, prop, future, other (open: new values may be added).
sportstringnullableThe sport, as given or from Kelly's game.
leaguestringnullableThe league, as given or from Kelly's game.
sidestringnullableThe side (home, away, over, under), when known.
linenumbernullableThe line the person took, such as -3 or 47.5.
price_decimalnumbernullableA parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.
game_idstringnullableKelly's game, when matched.
market_idstringnullableKelly's market, when matched.
selection_idstringnullableKelly's selection, when matched.
starts_atstringnullableThe game's start, when matched.
format date-time
resultstringrequiredThe leg's result: open until the person or the settle job decides it.
One of: open, won, lost, push, void, half_won, half_lost (open: new values may be added).
closeobjectrequiredThe close Kelly recorded at kick-off, once the game has started; every member is null until then, and for a leg not matched to Kelly's data.
Show 5 fields
price_decimalnullThe person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.
linenullThe person's own book's last line before kick-off: shown on askkelly.ai only.
market_decimalnumbernullableThe market close: the no-vig probability for this selection averaged over every book that quoted all sides, as decimal odds. Closing-line value is measured against it.
sourcestringnullableWhere the close came from.
atstringnullableWhen Kelly recorded the close.
format date-time
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · not_found
ExampleLink to this section
POST https://api.askkelly.ai/v1/bets/tbet_gyswpkn4776tbf0aqz2z/settle
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"status": "won"
}
{
"id": "tbet_gyswpkn4776tbf0aqz2z",
"object": "bet",
"kind": "single",
"status": "won",
"placed_at": "2026-10-04T16:45:00Z",
"settled_at": "2026-10-04T17:30:00Z",
"settled_by": "person",
"book": {
"id": null,
"name": "DraftKings",
"venue_type": "sportsbook"
},
"placed_state": null,
"currency": "USD",
"stake_minor": 5000,
"price": {
"american": -110
},
"price_decimal": 1.90909090909091,
"payout_minor": 9545,
"profit_minor": 4545,
"free_bet": false,
"boost": false,
"fair_price_decimal": null,
"edge": null,
"clv": null,
"source": "api",
"project_id": null,
"conversation_id": null,
"answer_id": null,
"limit_minor": null,
"tags": [],
"note": "Took it before the move",
"import_id": null,
"source_pick_id": null,
"source_analyst_id": null,
"created_at": "2026-10-04T17:30:00Z",
"updated_at": "2026-10-04T17:30:00Z",
"legs": [
{
"seq": 1,
"selection": "Chiefs -3",
"market_kind": "spread",
"sport": null,
"league": null,
"side": null,
"line": -3,
"price_decimal": 1.90909090909091,
"game_id": null,
"market_id": null,
"selection_id": null,
"starts_at": null,
"result": "won",
"close": {
"price_decimal": null,
"line": null,
"market_decimal": null,
"source": null,
"at": null
}
}
],
"attribution": "Odds data via The Odds API"
}POST /v1/bet-slips
Fill a bet slipLink to this section
scope write:tracker · 0 credits, not charged during the beta · status live
Fills a bet slip at your book for one bet: in your own Chrome through Kelly's extension when it is open, else in Kelly's browser on your saved sign-in for that book. Kelly adds the selection, types the stake and checks the slip's price against the worst price you accept, then stops: you press Place on the book's own page. When the book shows its receipt, Kelly logs the bet in your bet log once, at the price the slip showed. Needs your own live API key with write:tracker.
ParametersLink to this section
Body, application/json (required):
selectionstringWhat the bet is on, as the book shows it, e.g. Kansas City Chiefs -3.5.
min length 1 · max length 200
bookstringThe book, e.g. DraftKings.
min length 1 · max length 80
priceobjectThe price you want. Exactly one of {"american": -110}, {"decimal": 1.91}, {"fractional": "10/11"} or {"cents": 52}.
worst_priceobjectThe worst price you accept; default the price itself. The slip is left unconfirmed (price_moved) when it shows worse. Exactly one of {"american": -110}, {"decimal": 1.91}, {"fractional": "10/11"} or {"cents": 52}.
stake_minorintegerThe stake, in minor units.
min 1
currencystringISO 4217; default USD.
pattern ^[A-Z]{3}$
urlstringThe book's page for the bet (an event page or add-to-slip link); default the book's own link for Kelly's selection, else its front page.
pattern ^https:// · max length 2048
market_kindstringDefault other.
One of: spread, total, moneyline, prop, future, other (open: new values may be added).
sportstringThe sport, e.g. nfl.
max length 40
sidestringhome, away, over, under, yes, no or draw.
max length 40
linenumberThe line, e.g. -3.5.
game_idstringKelly's game (gm_…).
pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
market_idstringKelly's market (mkt_…).
pattern ^mkt_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
selection_idstringKelly's selection (sel_…), which finds the book's own link.
pattern ^sel_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
viastringauto (default: your browser when it is open, else Kelly's), extension or hosted.
One of: auto, extension, hosted (open: new values may be added).
notestringYour note on the bet once logged.
max length 500
ResponseLink to this section
201 The slip, filled and waiting for your press on the book's page.
objectstringAlways bet_slip.
idstringThe slip's ID (slip_…).
statusstringready (the slip waits for the person's press) or price_moved (it shows a worse price than worst_price).
viastringextension (the person's own browser) or hosted (Kelly's browser on their sign-in).
sportsbookstringThe book, as the person named it.
selectionstringWhat the bet is on.
stake_minorintegerThe stake, in minor units.
currencystringISO 4217.
priceobjectThe price asked for, as given.
worst_priceobjectThe worst price accepted, as given.
price_seenstringnullableThe price the book's slip shows, as it shows it.
waits_untilstringUntil when the browser watches for the book's receipt.
format date-time
nextstringWhat the person does next: press Place on the book's page.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · not_found · attestation_required · upstream_error · upstream_timeout
ExampleLink to this section
POST https://api.askkelly.ai/v1/bet-slips
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"selection": "Kansas City Chiefs -3.5",
"book": "DraftKings",
"price": {
"american": -110
},
"stake_minor": 2500,
"url": "https://sportsbook.draftkings.com/event/chiefs-at-bills"
}
{
"type": "https://docs.askkelly.ai/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This needs the write:tracker scope.",
"param": "write:tracker",
"doc_url": "https://docs.askkelly.ai/problems/insufficient_scope",
"request_id": "req_7c0177989e3c04a7b07a6dbe",
"retryable": false,
"display_message": "This app needs one more permission to do that."
}POST https://api.askkelly.ai/v1/bet-slips
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"selection": "Kansas City Chiefs -3.5",
"book": "DraftKings",
"price": {
"american": -110
},
"stake_minor": 2500,
"url": "https://sportsbook.draftkings.com/event/chiefs-at-bills",
"worst_price": {
"american": 150
}
}
{
"type": "https://docs.askkelly.ai/problems/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "worst_price: a price no better than the bet's own price.",
"param": "worst_price",
"doc_url": "https://docs.askkelly.ai/problems/invalid_request",
"request_id": "req_8bdd70ddcb4a63fca3971c4e",
"retryable": false,
"display_message": "Something in that request was not understood."
}POST https://api.askkelly.ai/v1/bet-slips
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"selection": "Kansas City Chiefs -3.5",
"book": "DraftKings",
"price": {
"american": -110
},
"stake_minor": 2500,
"url": "https://sportsbook.draftkings.com/event/chiefs-at-bills"
}
{
"type": "https://docs.askkelly.ai/problems/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "No browser can fill this slip: the person opens Chrome with Kelly's extension (askkelly.ai › Account › Connected apps), or signs in to this book in Kelly's browser (askkelly.ai › Account › Betting & fantasy).",
"param": null,
"doc_url": "https://docs.askkelly.ai/problems/not_found",
"request_id": "req_c0fd399cd5b3afdb63861e28",
"retryable": false,
"display_message": "That could not be found."
}POST /v1/book-signups
Start sportsbook sign-upsLink to this section
scope write:tracker · 0 credits, not charged during the beta · status live
Opens a sign-up at each book in your own Chrome through Kelly's extension, one tab per book, and fills the form from the details you saved in the extension (they never reach Kelly) plus the welcome offer's promo code; each next step fills as it opens. Without books, every online sportsbook licensed in your state that isn't in your books yet. Kelly never types your password or Social Security digits, ticks the terms or presses Create account: you do, on each book's page, and when the book shows your new account, it joins your books. Needs your own live API key with write:tracker.
ParametersLink to this section
Body, application/json (required):
booksarray of stringThe books, by slug or name, e.g. ["fanduel", "DraftKings"]; default every online sportsbook licensed in the state that isn't in your books yet.
min items 1 · max items 20
statestringYour US state, e.g. NJ or US-NJ; default the state saved on your account.
max length 20
urlstringThe book's sign-up page, with exactly one book; default the book's front page, where Kelly presses its own Join link.
pattern ^https:// · max length 2048
ResponseLink to this section
201 Each book's sign-up, filled in your browser and waiting for your press of Create account.
objectstringAlways book_signups.
stateobjectnullableThe state the books were chosen for: code, name, listed (false when Kelly has no verified list of its licensed books yet, so the book's own location check decides) and its sign-up facts.
dataarray of objectOne sign-up per book.
Show 13 fields
objectstringAlways book_signup.
idstringnullableThe sign-up's ID (signup_…); null when no tab was opened.
sportsbookstringThe book's name.
slugstringThe book's slug, as GET /v1/books lists it.
statusstringfilled (the form waits for the person), no_details, not_allowed, old_extension, no_form, no_page, load_failed or no_answer.
filledarray of stringThe kinds of field Kelly filled, e.g. given_name, email, birth_date.
leftarray of stringThe kinds of field left for the person, e.g. password, ssn.
promo_codestringnullableThe welcome offer's code Kelly typed in, if it needs one.
offerobjectnullableThe welcome offer in the person's state, as get_legal_books shows it.
min_ageintegernullableThe book's minimum age in the state.
ssnstringnullableWhat the book asks of the Social Security number.
id_checkstringnullableWhen the book asks for a photo ID or selfie.
nextstringWhat the person does next.
has_morebooleanAlways false: every book's sign-up is in data.
next_cursorstringnullableAlways null.
waits_untilstringnullableUntil when the browser keeps filling each next step.
format date-time
nextstringWhat the person does next.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · not_found · upstream_error · upstream_timeout
ExampleLink to this section
POST https://api.askkelly.ai/v1/book-signups
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"books": [
"DraftKings"
],
"state": "OH"
}
{
"type": "https://docs.askkelly.ai/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This needs the write:tracker scope.",
"param": "write:tracker",
"doc_url": "https://docs.askkelly.ai/problems/insufficient_scope",
"request_id": "req_f5a87e9097b6b093ce6467f4",
"retryable": false,
"display_message": "This app needs one more permission to do that."
}POST https://api.askkelly.ai/v1/book-signups
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"books": [
"DraftKings",
"FanDuel"
],
"state": "OH",
"url": "https://sportsbook.draftkings.com/"
}
{
"type": "https://docs.askkelly.ai/problems/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "url: send it with exactly one book.",
"param": "url",
"doc_url": "https://docs.askkelly.ai/problems/invalid_request",
"request_id": "req_348f6cca377a95b9d19f6747",
"retryable": false,
"display_message": "Something in that request was not understood."
}POST https://api.askkelly.ai/v1/book-signups
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"books": [
"DraftKings"
],
"state": "OH"
}
{
"type": "https://docs.askkelly.ai/problems/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "No browser can open the sign-ups: the person opens Chrome with Kelly's extension (askkelly.ai › Account › Connected apps).",
"param": null,
"doc_url": "https://docs.askkelly.ai/problems/not_found",
"request_id": "req_18b94dde932e71824c383921",
"retryable": false,
"display_message": "That could not be found."
}GET /v1/me/results
Get your resultsLink to this section
scope read:tracker · 0 credits, not charged during the beta · MCP tool get_my_results · status live
Your record from your own bet log in one currency: profit, ROI with its 95% range, win rate against the break-even your prices need, closing-line value and what it predicts, and the luck read (how often a bettor with no edge does as well at your prices). Split it by sport, market, book, analyst and more, each row judged against luck with e-BH; add profit by day and your streaks. Every result carries its charts as Kelly Chart Specs: profit against what CLV predicts, drawdown, the luck funnel, ROI by split with ranges, profit by day, profit per bet and rolling ROI and CLV.
ParametersLink to this section
currencystring · queryThe currency (ISO 4217); left out, the one with the most settled bets.
pattern ^[A-Z]{3}$
viewsstring · queryComma list of summary, splits, series, streaks, bets; default summary.
max length 400
split_bystring · queryComma list of project, sport, league, market, book, source, tag, analyst, month, week, day_of_week, price_band, stake_band.
max length 400
chartsstring · queryComma list of equity, underwater, funnel, forest, calendar, histogram, rolling, all (the default) or none.
max length 400
sortstring · querySplit row order: natural, profit, roi, clv or bets.
One of: natural, profit, roi, clv, bets (open: new values may be added).
default "natural"
windowinteger · queryBets in the rolling chart's window, 10 to 500.
min 10 · max 500 · default 50
tzstring · queryThe IANA time zone days are counted in.
max length 64 · default "America/New_York"
startstring · queryGames on or after this day (in tz).
format date
endstring · queryGames on or before this day (in tz).
format date
sportsstring · queryComma list: only these sports.
max length 400
leaguesstring · queryComma list: only these leagues.
max length 400
marketsstring · queryComma list: only these markets.
max length 400
booksstring · queryComma list: only these books.
max length 400
tagsstring · queryComma list: only these tags.
max length 400
sourcesstring · queryComma list: only these sources.
max length 400
projectsstring · queryComma list: only these projects.
max length 400
ResponseLink to this section
200 Your results.
objectconstrequiredAlways my_results.
Always "my_results".
as_ofstringrequiredWhen Kelly worked it out.
format date-time
currencystringrequirednullableThe currency of every amount: the one asked for, else the one with the most settled bets; null with no bets.
currenciesarray of objectrequiredEvery currency in your bets: currency, bets and settled.
unitobjectnullableOne unit for the charts: size (the median stake of your settled bets, in major units) and basis.
tzstringrequiredThe time zone days, weeks and months are counted in.
bets_matchedintegerrequiredBets the filters kept.
summaryobjectThe whole record in major units: bets, settled, open, at_risk, profit, staked, roi and roi_interval (95%), bonus_profit, wins, losses, pushes, voids, cashed_out, win_rate, break_even, average_price_decimal, clv_mean, clv_stake_weighted, clv_interval, clv_beat_share, clv_bets, clv_missing, clv_predicted_profit, clv_actual_profit, luck (the luck read at the prices taken: no_skill_match_per_100, e_value, anytime_p, crossed, bets_to_tell), luck_left_out, first_date and last_date.
splitsobjectFor each split_by, its rows: by, key, label, verdict (beats break-even so far, can't tell from luck yet or no settled bets to test, judged together with e-BH) and summary.
seriesarray of objectProfit by settle day: day, profit, settled, cumulative_profit and cumulative_clv_predicted.
streaksobjectLongest win and loss runs, the current run and the biggest drawdown with its peak, trough and recovery.
bet_idsarray of stringThe matching bets' IDs, by game time.
chartsarray of objectrequiredKelly Chart Specs (KCS 1) of the record, in the order asked: equity (profit against what CLV predicts), underwater (drawdown), funnel (each split's ROI in the luck funnel), forest (ROI with its 95% range per split), calendar (profit by day), histogram (profit per bet) and rolling (ROI and CLV over the last window bets). Each carries its data rows, encodings, bands, rules, a summary and provenance; a chart with nothing to draw is left out.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled
ExampleLink to this section
GET https://api.askkelly.ai/v1/me/results?views=summary,splits&split_by=sport&charts=equity,forest
Authorization: Bearer $KELLY_API_KEY{
"object": "my_results",
"as_of": "2026-10-04T17:30:00Z",
"currency": "USD",
"currencies": [
{
"currency": "USD",
"bets": 1,
"settled": 1
}
],
"unit": {
"size": 50,
"basis": "median stake of your settled bets"
},
"tz": "America/New_York",
"bets_matched": 1,
"summary": {
"bets": 1,
"settled": 1,
"open": 0,
"at_risk": 0,
"profit": 45.45,
"staked": 50,
"roi": 0.909,
"roi_interval": [
0.8831800906825393,
0.9348199093174607
],
"bonus_profit": 0,
"wins": 1,
"losses": 0,
"pushes": 0,
"voids": 0,
"cashed_out": 0,
"win_rate": 1,
"break_even": 0.5238095238095235,
"average_price_decimal": 1.90909090909091,
"clv_mean": null,
"clv_stake_weighted": null,
"clv_interval": null,
"clv_beat_share": null,
"clv_bets": 0,
"clv_missing": 1,
"clv_points_mean": null,
"clv_points_bets": 0,
"clv_predicted_profit": null,
"clv_actual_profit": null,
"luck": {
"bets": 1,
"wins": 1,
"losses": 0,
"pushes": 0,
"win_rate": 1,
"break_even": 0.5238095238095235,
"no_skill_match_prob": 0.5238095238095235,
"no_skill_match_per_100": 52.38095238095235,
"e_value": 1.05,
"max_e_value": 1.05,
"anytime_p": 0.9523809523809523,
"crossed": false,
"bets_to_tell": null
},
"luck_left_out": 0,
"first_date": "2026-10-04",
"last_date": "2026-10-04"
},
"splits": {
"sport": [
{
"by": "sport",
"key": "",
"label": "not set",
"verdict": "can't tell from luck yet",
"summary": {
"bets": 1,
"settled": 1,
"open": 0,
"at_risk": 0,
"profit": 45.45,
"staked": 50,
"roi": 0.909,
"roi_interval": [
0.8831800906825393,
0.9348199093174607
],
"bonus_profit": 0,
"wins": 1,
"losses": 0,
"pushes": 0,
"voids": 0,
"cashed_out": 0,
"win_rate": 1,
"break_even": 0.5238095238095235,
"average_price_decimal": 1.90909090909091,
"clv_mean": null,
"clv_stake_weighted": null,
"clv_interval": null,
"clv_beat_share": null,
"clv_bets": 0,
"clv_missing": 1,
"clv_points_mean": null,
"clv_points_bets": 0,
"clv_predicted_profit": null,
"clv_actual_profit": null,
"luck": {
"bets": 1,
"wins": 1,
"losses": 0,
"pushes": 0,
"win_rate": 1,
"break_even": 0.5238095238095235,
"no_skill_match_prob": 0.5238095238095235,
"no_skill_match_per_100": 52.38095238095235,
"e_value": 1.05,
"max_e_value": 1.05,
"anytime_p": 0.9523809523809523,
"crossed": false,
"bets_to_tell": null
},
"luck_left_out": 0,
"first_date": "2026-10-04",
"last_date": "2026-10-04"
}
}
]
},
"charts": [
{
"kcs": 1,
"kind": "equity",
"title": "Profit against what CLV predicts",
"data": {
"columns": [
{
"id": "n",
"type": "int",
"label": "Bets settled"
},
{
"id": "date",
"type": "date",
"label": "Settled"
},
{
"id": "bet_id",
"type": "str",
"label": "Bet"
},
{
"id": "profit_u",
"type": "float",
"label": "Actual",
"unit": "units",
"format": "+.1f"
},
{
"id": "clv_predicted_u",
"type": "float",
"label": "CLV predicts",
"unit": "units",
"format": "+.1f"
},
{
"id": "profit",
"type": "float",
"label": "Actual (USD)",
"unit": "usd",
"format": "+.2f"
},
{
"id": "clv_predicted",
"type": "float",
"label": "CLV predicts (USD)",
"unit": "usd",
"format": "+.2f"
}
],
"rows": [
{
"n": 1,
"date": "2026-10-04",
"bet_id": "tbet_gyswpkn4776tbf0aqz2z",
"profit_u": 0.909,
"clv_predicted_u": 0,
"profit": 45.45,
"clv_predicted": 0
}
],
"key": "n"
},
"x": {
"field": "n",
"type": "quantitative",
"title": "Bets settled (n)"
},
"y": {
"field": "profit_u",
"type": "quantitative",
"title": "Profit",
"units": [
{
"id": "units",
"field": "profit_u",
"label": "Units (1u = 50.00 USD, the median stake)"
},
{
"id": "usd",
"field": "profit",
"label": "Dollars"
}
]
},
"series": [
{
"field": "profit_u",
"role": "market",
"label": "Actual profit",
"mark": "line"
},
{
"field": "clv_predicted_u",
"role": "model",
"label": "What CLV predicts",
"mark": "line",
"dash": true
}
],
"rules": [
{
"y": 0,
"label": "Break-even",
"role": "zero"
}
],
"tooltip": [
"n",
"date",
"profit_u",
"clv_predicted_u"
],
"summary": "Actual +0.9u over 1 settled bets; CLV predicts 0.0u, so the record is 0.9u ahead of what CLV predicts. 1 bet with no close add nothing to the CLV line.",
"provenance": {
"tool": "get_my_results",
"engine": "results-charts 1",
"as_of": "2026-10-04T17:30:00Z",
"sources": [
"bet log",
"closing lines"
],
"chart": "equity",
"args": {
"currency": "USD",
"split_by": [
"sport"
]
}
},
"rights": {
"export_rows": true,
"export_columns_blocked": []
}
},
{
"kcs": 1,
"kind": "forest",
"title": "ROI by sport",
"data": {
"columns": [
{
"id": "key",
"type": "str",
"label": "Key"
},
{
"id": "label",
"type": "str",
"label": "Sport"
},
{
"id": "roi",
"type": "float",
"label": "ROI",
"unit": "pct",
"format": "+.1%"
},
{
"id": "lo95",
"type": "float",
"label": "95% low",
"unit": "pct",
"format": "+.1%"
},
{
"id": "hi95",
"type": "float",
"label": "95% high",
"unit": "pct",
"format": "+.1%"
},
{
"id": "n_bets",
"type": "int",
"label": "Decided bets"
},
{
"id": "settled",
"type": "int",
"label": "Settled"
},
{
"id": "profit",
"type": "float",
"label": "Profit"
},
{
"id": "verdict",
"type": "str",
"label": "Verdict"
},
{
"id": "avg_decimal",
"type": "float",
"label": "Average decimal price",
"format": ".2f"
}
],
"rows": [
{
"key": "(none)",
"label": "not set",
"roi": 0.909,
"lo95": 0.88318,
"hi95": 0.93482,
"n_bets": 1,
"settled": 1,
"profit": 45.45,
"verdict": "can't tell from luck yet",
"avg_decimal": 1.909091
}
],
"key": "key"
},
"x": {
"field": "roi",
"type": "quantitative",
"title": "ROI",
"format": "+.0%"
},
"y": {
"field": "label",
"type": "nominal",
"title": "Sport"
},
"series": [
{
"field": "roi",
"role": "market",
"label": "ROI",
"mark": "point"
}
],
"intervals": [
{
"low": "lo95",
"high": "hi95",
"level": 0.95,
"label": "95% range"
}
],
"rules": [
{
"x": 0,
"label": "Break-even",
"role": "break_even"
}
],
"count": "n_bets",
"tooltip": [
"label",
"roi",
"lo95",
"hi95",
"n_bets",
"verdict"
],
"summary": "ROI with its 95% range for 1 row by sport; none can be told from luck yet after the e-BH check.",
"provenance": {
"tool": "get_my_results",
"engine": "results-charts 1",
"as_of": "2026-10-04T17:30:00Z",
"sources": [
"bet log"
],
"chart": "forest_sport",
"args": {
"currency": "USD",
"split_by": [
"sport"
]
}
},
"rights": {
"export_rows": true,
"export_columns_blocked": []
}
}
]
}Generated from Kelly API 2026-10-05.