Skip to content
Kellydocs
Kellydocs

bets

Copy page

Log and read your own bets, their results and closing-line value.

On this page
MethodPathTitleAccessPriceMCP tool
GET/v1/betsList your betsread:tracker0list_my_bets
POST/v1/betsLog a betwrite:tracker0log_my_bet
POST/v1/bets/importImport bets from a CSVwrite:tracker0import_my_bets
POST/v1/bets/find_ruleFind the rule behind your betsread:tracker1find_rule_in_my_bets
GET/v1/bets/summaryGet your totalsread:tracker0get_my_bet_summary
GET/v1/bets/{bet_id}Get a betread:tracker0none
PATCH/v1/bets/{bet_id}Change a betwrite:tracker0update_my_bet
DELETE/v1/bets/{bet_id}Delete a betwrite:tracker0none
POST/v1/bets/{bet_id}/settleSettle a betwrite:tracker0settle_my_bet
POST/v1/bet-slipsFill a bet slipwrite:tracker0none
POST/v1/book-signupsStart sportsbook sign-upswrite:tracker0none
GET/v1/me/resultsGet your resultsread:tracker0get_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 · query

One of your projects (proj_…), or none for bets in no project.

pattern ^(none|proj_[0-9a-hjkmnp-tv-z]{20})$

statusstring · query

One 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 · query

Only this sport.

max length 40

bookstring · query

Only this book, by Kelly's ID or by name.

max length 80

tagstring · query

Only bets with this tag.

max length 40

currencystring · query

Only this currency.

pattern ^[A-Z]{3}$

game_idstring · query

Only bets with a leg on this game.

pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

analyststring · query

Only bets that tail this analyst's picks (anl_…).

pattern ^anl_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

sincestring · query

Placed at or after.

format date-time

untilstring · query

Placed before.

format date-time

limitinteger · query

Bets per page, 1 to 200.

min 1 · max 200 · default 50

cursorstring · query

The next_cursor of the page before.

max length 200

ResponseLink to this section

200 A page of your bets, newest placed first.

objectconstrequired

Always list.

Always "list".

dataarray of objectrequired

The page's bets, newest placed first.

Show 34 fields
idstringrequired

The bet's ID (tbet_…), a random handle.

pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

objectconstrequired

Always bet.

Always "bet".

kindstringrequired

single, parlay or teaser.

One of: single, parlay, teaser (open: new values may be added).

statusstringrequired

open until it settles.

One of: open, won, lost, push, void, half_won, half_lost, cashed_out (open: new values may be added).

placed_atstringrequired

When the bet was placed.

format date-time

settled_atstringnullable

When it settled; null while open.

format date-time

settled_bystringnullable

person, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.

bookobjectrequired

The book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).

placed_statestringnullable

Where it was placed, ISO 3166-2 (US-NJ).

currencystringrequired

ISO 4217 currency of every amount.

stake_minorintegerrequired

The stake the person placed, in minor units.

priceobjectrequired

The price in the form the person gave it, echoed back.

price_decimalnumberrequired

The price as decimal odds.

payout_minorintegernullable

What the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.

profit_minorintegernullable

Payout less the cash stake; null while open.

free_betbooleanrequired

A free (bonus) bet, whose stake was never the person's.

boostboolean

A price boost.

fair_price_decimalnull

Kelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.

edgenull

Kelly's edge when logged from an answer: shown on Kelly's site only.

clvnumbernullable

The 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.

sourcestringrequired

Where it was logged.

One of: answer, chat, manual, csv, api, mcp, sync (open: new values may be added).

project_idstringnullable

The person's project it belongs to.

conversation_idstringnullable

The saved chat it was logged from.

answer_idstringnullable

The answer it was logged from.

limit_minorintegernullable

The book's limit on this bet, when the person noted one.

tagsarray of stringrequired

The person's tags.

notestring

The person's note.

import_idstringnullable

The CSV import it came from.

source_pick_idstringnullable

The analyst's pick it tails (apck_…), when the person logged one.

source_analyst_idstringnullable

That pick's analyst (anl_…).

created_atstringrequired

When it was logged.

format date-time

updated_atstringrequired

When it last changed.

format date-time

attributionstringrequired

The odds attribution the closes carry.

legsarray of objectrequired

One leg per selection, in ticket order.

Show 14 fields
seqintegerrequired

The leg's place on the ticket, from 1.

selectionstringrequired

The selection as the person wrote it, such as Chiefs -3.

market_kindstringrequired

The kind of market.

One of: spread, total, moneyline, prop, future, other (open: new values may be added).

sportstringnullable

The sport, as given or from Kelly's game.

leaguestringnullable

The league, as given or from Kelly's game.

sidestringnullable

The side (home, away, over, under), when known.

linenumbernullable

The line the person took, such as -3 or 47.5.

price_decimalnumbernullable

A parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.

game_idstringnullable

Kelly's game, when matched.

market_idstringnullable

Kelly's market, when matched.

selection_idstringnullable

Kelly's selection, when matched.

starts_atstringnullable

The game's start, when matched.

format date-time

resultstringrequired

The 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).

closeobjectrequired

The 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_decimalnull

The person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.

linenull

The person's own book's last line before kick-off: shown on askkelly.ai only.

market_decimalnumbernullable

The 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.

sourcestringnullable

Where the close came from.

atstringnullable

When Kelly recorded the close.

format date-time

has_morebooleanrequired

Whether another page follows.

next_cursorstringrequirednullable

Pass as cursor for the next page.

attributionstringrequired

The 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

Request
GET https://api.askkelly.ai/v1/bets?status=won&limit=10
Authorization: Bearer $KELLY_API_KEY
Response, 200
{
  "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 object

One leg per selection.

min items 1

Show 10 fields
selectionstringrequired

The selection in your own words, such as Chiefs -3.

min length 1 · max length 200

market_kindstring

The kind of market; default other.

One of: spread, total, moneyline, prop, future, other (open: new values may be added).

sportstring

The sport.

max length 40

leaguestring

The league.

max length 40

sidestring

home, away, over or under.

max length 40

linenumber

The line you took.

priceobject

A 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_idstring

Kelly's game.

pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

market_idstring

Kelly's market.

pattern ^mkt_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

selection_idstring

Kelly's selection: fills in the market, game, sport and start time.

pattern ^sel_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

kindstring

Default: single for one leg, parlay for more.

One of: single, parlay, teaser (open: new values may be added).

priceobject

The ticket's price. Exactly one of {"american": -110}, {"decimal": 1.91}, {"fractional": "10/11"} or {"cents": 52}.

stake_minorinteger

The stake, in minor units.

min 1

bookstring

The book's name; book or book_id is required to log a bet.

min length 1 · max length 80

book_idstring

Kelly's book ID (bk_…).

pattern ^bk_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

venue_typestring

Default: the book's own kind, else sportsbook.

One of: sportsbook, exchange, prediction_market, dfs_pickem (open: new values may be added).

currencystring

ISO 4217; default USD.

pattern ^[A-Z]{3}$

placed_atstring

When you placed it; default now.

format date-time

placed_statestring

Where you placed it, ISO 3166-2 (US-NJ).

pattern ^[A-Z]{2}-[A-Z0-9]{1,3}$

free_betboolean

A free (bonus) bet.

boostboolean

A price boost.

project_idstring

One of your projects.

pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

limit_minorinteger

The book's limit on this bet, in minor units.

min 1

source_pick_idstring

The 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 string

Your tags.

notestring

Your note.

max length 1000

ResponseLink to this section

201 The bet as logged.

idstringrequired

The bet's ID (tbet_…), a random handle.

pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

objectconstrequired

Always bet.

Always "bet".

kindstringrequired

single, parlay or teaser.

One of: single, parlay, teaser (open: new values may be added).

statusstringrequired

open until it settles.

One of: open, won, lost, push, void, half_won, half_lost, cashed_out (open: new values may be added).

placed_atstringrequired

When the bet was placed.

format date-time

settled_atstringnullable

When it settled; null while open.

format date-time

settled_bystringnullable

person, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.

bookobjectrequired

The book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).

placed_statestringnullable

Where it was placed, ISO 3166-2 (US-NJ).

currencystringrequired

ISO 4217 currency of every amount.

stake_minorintegerrequired

The stake the person placed, in minor units.

priceobjectrequired

The price in the form the person gave it, echoed back.

price_decimalnumberrequired

The price as decimal odds.

payout_minorintegernullable

What the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.

profit_minorintegernullable

Payout less the cash stake; null while open.

free_betbooleanrequired

A free (bonus) bet, whose stake was never the person's.

boostboolean

A price boost.

fair_price_decimalnull

Kelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.

edgenull

Kelly's edge when logged from an answer: shown on Kelly's site only.

clvnumbernullable

The 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.

sourcestringrequired

Where it was logged.

One of: answer, chat, manual, csv, api, mcp, sync (open: new values may be added).

project_idstringnullable

The person's project it belongs to.

conversation_idstringnullable

The saved chat it was logged from.

answer_idstringnullable

The answer it was logged from.

limit_minorintegernullable

The book's limit on this bet, when the person noted one.

tagsarray of stringrequired

The person's tags.

notestring

The person's note.

import_idstringnullable

The CSV import it came from.

source_pick_idstringnullable

The analyst's pick it tails (apck_…), when the person logged one.

source_analyst_idstringnullable

That pick's analyst (anl_…).

created_atstringrequired

When it was logged.

format date-time

updated_atstringrequired

When it last changed.

format date-time

attributionstringrequired

The odds attribution the closes carry.

legsarray of objectrequired

One leg per selection, in ticket order.

Show 14 fields
seqintegerrequired

The leg's place on the ticket, from 1.

selectionstringrequired

The selection as the person wrote it, such as Chiefs -3.

market_kindstringrequired

The kind of market.

One of: spread, total, moneyline, prop, future, other (open: new values may be added).

sportstringnullable

The sport, as given or from Kelly's game.

leaguestringnullable

The league, as given or from Kelly's game.

sidestringnullable

The side (home, away, over, under), when known.

linenumbernullable

The line the person took, such as -3 or 47.5.

price_decimalnumbernullable

A parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.

game_idstringnullable

Kelly's game, when matched.

market_idstringnullable

Kelly's market, when matched.

selection_idstringnullable

Kelly's selection, when matched.

starts_atstringnullable

The game's start, when matched.

format date-time

resultstringrequired

The 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).

closeobjectrequired

The 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_decimalnull

The person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.

linenull

The person's own book's last line before kick-off: shown on askkelly.ai only.

market_decimalnumbernullable

The 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.

sourcestringnullable

Where the close came from.

atstringnullable

When 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

Request
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" }

Response, 403
{
  "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."
}
Request
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 }

Response, 400
{
  "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."
}
Request
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" }

Response, 201
{
  "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):

csvstring

The CSV file's text, its heading row included. At most 5 MB.

min length 1

bookstring

The book, when the file has no book column.

min length 1 · max length 80

time_zonestring

The IANA zone for times the file gives without one.

max length 64 · default "America/New_York"

currencystring

ISO 4217, when the file has no currency column.

pattern ^[A-Z]{3}$ · default "USD"

dry_runboolean

true: say what would be added and add nothing.

default false

ResponseLink to this section

200 A dry run: what would be added. Nothing was.

objectconst

Always bet_import.

Always "bet_import".

dry_runboolean

true: nothing was added.

rowsinteger

Data rows read.

bets_foundinteger

Bets read from the rows.

to_addinteger

Bets not yet in the log.

addedinteger

Bets added (0 on a dry run).

already_loggedinteger

Bets already in the log, left alone.

skipped_countinteger

Rows left out.

cutinteger

Bets past the most one import takes, for another file.

skippedarray of object

Up to 20 rows left out: row and reason.

Show 2 fields
rowinteger

The file's row number (the header is 1).

reasonstring

Why.

columnsobject

Each field read, and the file's heading it was read from.

totalsobject

Per currency, the new bets: bets, open, settled, staked_minor, profit_minor.

samplearray of object

Up to 10 of the new bets.

Show 9 fields
whatstring

What it is on.

sportsbookstring

Where.

placed_atstringnullable

When placed.

format date-time

priceobject

The price as the file gave it.

stake_minorinteger

The stake.

statusstring

open or the result.

payout_minorintegernullable

What it returned.

free_betboolean

A free bet.

rowsarray of integer

The 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

Request
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" }

Response, 201
{
  "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": []
}
Request
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 }

Response, 200
{
  "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
}
Request
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" }

Response, 201
{
  "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
      ]
    }
  ]
}
Request
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" }

Response, 403
{
  "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."
}
Request
POST https://api.askkelly.ai/v1/bets/import
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "csv": "a,b\n1,2\n" }

Response, 400
{
  "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):

competitionstring

The competition's slug: nfl, nba, mlb, nhl, ncaaf, ncaab, wnba...

pattern ^[a-z0-9_]{2,24}$

marketstring

spread, moneyline, over or under.

One of: spread, moneyline, over, under (open: new values may be added).

default "spread"

seasonsarray of string

Seasons to read; default the seasons your bets fall in.

max items 25

sincestring

Only bets placed at or after this time.

format date-time

untilstring

Only bets placed before this time.

format date-time

ResponseLink to this section

200 Up to three rules that describe which games you bet.

objectconst

Always bet_rule.

Always "bet_rule".

competitionstring

The competition.

marketstring

spread, moneyline, over or under.

seasonsarray of string

Seasons read.

betsobject

given, used, and left_out: each reason (side_unread, not_in_kellys_games, same_game_twice, other_market) and its count.

universeinteger

Team-games Kelly held a line for: every game the person could have bet.

base_ratenumbernullable

The share of those the person bet.

candidatesarray of object

Up to three, each matching a different set of games.

Show 8 fields
labelstring

describes_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).

formulastring

The rule, ready for test_rule.

conditionsarray of object

Its conditions.

Show 2 fields
formulastring

The condition as a formula.

wordsstring

The condition in words.

coveragenumber

The share of the person's bets it matches (0.8 is 80%).

precisionnumber

The share of its games the person bet.

liftnumbernullable

Precision over the share of all games bet; 1.0 is chance.

matchesinteger

Team-games it matches.

bets_coveredinteger

The person's bets among them.

reasonstringnullable

Why there are no candidates, when there are none.

placedobject

The placed window read: since and until, or null.

nextobject

test_rule, which counts each candidate tested on the rules-tried ledger.

noticestring

Found from the person's choices only, never from the results.

summarystring

The 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

Request
POST https://api.askkelly.ai/v1/bets/find_rule
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "competition": "nba", "market": "teaser" }

Response, 400
{
  "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."
}
Request
POST https://api.askkelly.ai/v1/bets/find_rule
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "competition": "nba", "seasons": [ "2025-26" ] }

Response, 200
{
  "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 · query

One of your projects (proj_…), or none for bets in no project.

pattern ^(none|proj_[0-9a-hjkmnp-tv-z]{20})$

statusstring · query

One 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 · query

Only this sport.

max length 40

bookstring · query

Only this book, by Kelly's ID or by name.

max length 80

tagstring · query

Only bets with this tag.

max length 40

currencystring · query

Only this currency.

pattern ^[A-Z]{3}$

game_idstring · query

Only bets with a leg on this game.

pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

analyststring · query

Only bets that tail this analyst's picks (anl_…).

pattern ^anl_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

sincestring · query

Placed at or after.

format date-time

untilstring · query

Placed before.

format date-time

tzstring · query

The 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.

objectconstrequired

Always bet_summary.

Always "bet_summary".

tzstringrequired

The time zone the periods are counted in.

attributionstringrequired

The odds attribution the closes carry.

currenciesarray of objectrequired

One entry per currency, in currency order.

Show 16 fields
currencystring

ISO 4217.

betsinteger

Bets logged.

openinteger

Bets still open.

settledinteger

Bets settled.

staked_minorinteger

Cash staked on settled bets that had action (pushes, voids and free bets left out).

profit_minorinteger

Payout less cash stake over settled bets.

roinumbernullable

Profit over staked; null with nothing staked.

at_risk_minorinteger

Cash stakes of open bets.

clvobject

The mean closing-line value over singles with a market close, and how many bets it covers.

expected_profit_minornull

Stake times Kelly's edge over bets logged from answers: shown on askkelly.ai only.

actual_profit_minorintegernullable

Profit over the bets that carried Kelly's edge.

edge_betsinteger

How many settled bets carried Kelly's edge.

by_clvobject

Settled 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
beatobject

Bets that beat the close.

Show 4 fields
betsinteger

Settled bets.

staked_minorinteger

Cash staked on bets that had action.

profit_minorinteger

Profit.

roinumbernullable

Profit over staked; null with nothing staked.

missedobject

Bets that didn't.

Show 4 fields
betsinteger

Settled bets.

staked_minorinteger

Cash staked on bets that had action.

profit_minorinteger

Profit.

roinumbernullable

Profit over staked; null with nothing staked.

recordobjectnullable

Won, 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
winsinteger

Bets won.

lossesinteger

Bets lost.

pushesinteger

Pushes.

left_outinteger

Half results, voids and cash-outs, not tested.

win_ratenumber

Wins over wins and losses.

break_evennumber

The win rate the prices paid need: the average of each bet's 1 / decimal price.

over_break_evennumber

Win rate minus break-even.

no_skill_match_probnumber

The chance a bettor with no skill, winning each bet at its break-even, wins at least as many.

significantboolean

Whether that chance is 5% or less.

bets_neededobjectnullable

Bets 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 object

The bets that tail an analyst's pick (source_pick_id), one row per analyst, most profit first.

Show 11 fields
analyst_idstring

The analyst (anl_…).

analyststringnullable

Their name.

betsinteger

Bets logged.

openinteger

Bets still open.

settledinteger

Bets settled.

staked_minorinteger

Cash staked on settled bets that had action.

profit_minorinteger

Profit.

roinumbernullable

Profit over staked; null with nothing staked.

woninteger

Bets won.

lostinteger

Bets lost.

pushinteger

Pushes.

by_periodobject

Bets, staked and profit per day, ISO week, month and year of settlement in tz.

Show 4 fields
dayarray of object

By day, oldest first.

Show 4 fields
periodstring

The period: 2026-10-11, 2026-W41, 2026-10 or 2026.

betsinteger

Bets settled in it.

staked_minorinteger

Cash staked on bets that had action.

profit_minorinteger

Profit.

weekarray of object

By week, oldest first.

Show 4 fields
periodstring

The period: 2026-10-11, 2026-W41, 2026-10 or 2026.

betsinteger

Bets settled in it.

staked_minorinteger

Cash staked on bets that had action.

profit_minorinteger

Profit.

montharray of object

By month, oldest first.

Show 4 fields
periodstring

The period: 2026-10-11, 2026-W41, 2026-10 or 2026.

betsinteger

Bets settled in it.

staked_minorinteger

Cash staked on bets that had action.

profit_minorinteger

Profit.

yeararray of object

By year, oldest first.

Show 4 fields
periodstring

The period: 2026-10-11, 2026-W41, 2026-10 or 2026.

betsinteger

Bets settled in it.

staked_minorinteger

Cash staked on bets that had action.

profit_minorinteger

Profit.

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

Request
GET https://api.askkelly.ai/v1/bets/summary?tz=America/New_York
Authorization: Bearer $KELLY_API_KEY
Response, 200
{
  "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 · pathrequired

The bet's ID (tbet_…).

pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

ResponseLink to this section

200 The bet.

idstringrequired

The bet's ID (tbet_…), a random handle.

pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

objectconstrequired

Always bet.

Always "bet".

kindstringrequired

single, parlay or teaser.

One of: single, parlay, teaser (open: new values may be added).

statusstringrequired

open until it settles.

One of: open, won, lost, push, void, half_won, half_lost, cashed_out (open: new values may be added).

placed_atstringrequired

When the bet was placed.

format date-time

settled_atstringnullable

When it settled; null while open.

format date-time

settled_bystringnullable

person, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.

bookobjectrequired

The book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).

placed_statestringnullable

Where it was placed, ISO 3166-2 (US-NJ).

currencystringrequired

ISO 4217 currency of every amount.

stake_minorintegerrequired

The stake the person placed, in minor units.

priceobjectrequired

The price in the form the person gave it, echoed back.

price_decimalnumberrequired

The price as decimal odds.

payout_minorintegernullable

What the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.

profit_minorintegernullable

Payout less the cash stake; null while open.

free_betbooleanrequired

A free (bonus) bet, whose stake was never the person's.

boostboolean

A price boost.

fair_price_decimalnull

Kelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.

edgenull

Kelly's edge when logged from an answer: shown on Kelly's site only.

clvnumbernullable

The 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.

sourcestringrequired

Where it was logged.

One of: answer, chat, manual, csv, api, mcp, sync (open: new values may be added).

project_idstringnullable

The person's project it belongs to.

conversation_idstringnullable

The saved chat it was logged from.

answer_idstringnullable

The answer it was logged from.

limit_minorintegernullable

The book's limit on this bet, when the person noted one.

tagsarray of stringrequired

The person's tags.

notestring

The person's note.

import_idstringnullable

The CSV import it came from.

source_pick_idstringnullable

The analyst's pick it tails (apck_…), when the person logged one.

source_analyst_idstringnullable

That pick's analyst (anl_…).

created_atstringrequired

When it was logged.

format date-time

updated_atstringrequired

When it last changed.

format date-time

attributionstringrequired

The odds attribution the closes carry.

legsarray of objectrequired

One leg per selection, in ticket order.

Show 14 fields
seqintegerrequired

The leg's place on the ticket, from 1.

selectionstringrequired

The selection as the person wrote it, such as Chiefs -3.

market_kindstringrequired

The kind of market.

One of: spread, total, moneyline, prop, future, other (open: new values may be added).

sportstringnullable

The sport, as given or from Kelly's game.

leaguestringnullable

The league, as given or from Kelly's game.

sidestringnullable

The side (home, away, over, under), when known.

linenumbernullable

The line the person took, such as -3 or 47.5.

price_decimalnumbernullable

A parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.

game_idstringnullable

Kelly's game, when matched.

market_idstringnullable

Kelly's market, when matched.

selection_idstringnullable

Kelly's selection, when matched.

starts_atstringnullable

The game's start, when matched.

format date-time

resultstringrequired

The 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).

closeobjectrequired

The 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_decimalnull

The person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.

linenull

The person's own book's last line before kick-off: shown on askkelly.ai only.

market_decimalnumbernullable

The 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.

sourcestringnullable

Where the close came from.

atstringnullable

When 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

Request
GET https://api.askkelly.ai/v1/bets/tbet_00000000000000000000
Authorization: Bearer $KELLY_API_KEY
Response, 404
{
  "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."
}
Request
GET https://api.askkelly.ai/v1/bets/tbet_gyswpkn4776tbf0aqz2z
Authorization: Bearer $KELLY_API_KEY
Response, 200
{
  "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 · pathrequired

The bet's ID (tbet_…).

pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

Body, application/json (required):

legsarray of object

Replaces every leg.

min items 1

Show 10 fields
selectionstringrequired

The selection in your own words, such as Chiefs -3.

min length 1 · max length 200

market_kindstring

The kind of market; default other.

One of: spread, total, moneyline, prop, future, other (open: new values may be added).

sportstring

The sport.

max length 40

leaguestring

The league.

max length 40

sidestring

home, away, over or under.

max length 40

linenumber

The line you took.

priceobject

A 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_idstring

Kelly's game.

pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

market_idstring

Kelly's market.

pattern ^mkt_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

selection_idstring

Kelly's selection: fills in the market, game, sport and start time.

pattern ^sel_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

priceobject

The ticket's price. Exactly one of {"american": -110}, {"decimal": 1.91}, {"fractional": "10/11"} or {"cents": 52}.

stake_minorinteger

The stake, in minor units.

min 1

clear_projectboolean

Take the bet out of its project.

clear_source_pickboolean

Unlink the analyst's pick it tails.

bookstring

The book's name; book or book_id is required to log a bet.

min length 1 · max length 80

book_idstring

Kelly's book ID (bk_…).

pattern ^bk_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

venue_typestring

Default: the book's own kind, else sportsbook.

One of: sportsbook, exchange, prediction_market, dfs_pickem (open: new values may be added).

currencystring

ISO 4217; default USD.

pattern ^[A-Z]{3}$

placed_atstring

When you placed it; default now.

format date-time

placed_statestring

Where you placed it, ISO 3166-2 (US-NJ).

pattern ^[A-Z]{2}-[A-Z0-9]{1,3}$

free_betboolean

A free (bonus) bet.

boostboolean

A price boost.

project_idstring

One of your projects.

pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

limit_minorinteger

The book's limit on this bet, in minor units.

min 1

source_pick_idstring

The 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 string

Your tags.

notestring

Your note.

max length 1000

ResponseLink to this section

200 The bet as it now is.

idstringrequired

The bet's ID (tbet_…), a random handle.

pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

objectconstrequired

Always bet.

Always "bet".

kindstringrequired

single, parlay or teaser.

One of: single, parlay, teaser (open: new values may be added).

statusstringrequired

open until it settles.

One of: open, won, lost, push, void, half_won, half_lost, cashed_out (open: new values may be added).

placed_atstringrequired

When the bet was placed.

format date-time

settled_atstringnullable

When it settled; null while open.

format date-time

settled_bystringnullable

person, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.

bookobjectrequired

The book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).

placed_statestringnullable

Where it was placed, ISO 3166-2 (US-NJ).

currencystringrequired

ISO 4217 currency of every amount.

stake_minorintegerrequired

The stake the person placed, in minor units.

priceobjectrequired

The price in the form the person gave it, echoed back.

price_decimalnumberrequired

The price as decimal odds.

payout_minorintegernullable

What the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.

profit_minorintegernullable

Payout less the cash stake; null while open.

free_betbooleanrequired

A free (bonus) bet, whose stake was never the person's.

boostboolean

A price boost.

fair_price_decimalnull

Kelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.

edgenull

Kelly's edge when logged from an answer: shown on Kelly's site only.

clvnumbernullable

The 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.

sourcestringrequired

Where it was logged.

One of: answer, chat, manual, csv, api, mcp, sync (open: new values may be added).

project_idstringnullable

The person's project it belongs to.

conversation_idstringnullable

The saved chat it was logged from.

answer_idstringnullable

The answer it was logged from.

limit_minorintegernullable

The book's limit on this bet, when the person noted one.

tagsarray of stringrequired

The person's tags.

notestring

The person's note.

import_idstringnullable

The CSV import it came from.

source_pick_idstringnullable

The analyst's pick it tails (apck_…), when the person logged one.

source_analyst_idstringnullable

That pick's analyst (anl_…).

created_atstringrequired

When it was logged.

format date-time

updated_atstringrequired

When it last changed.

format date-time

attributionstringrequired

The odds attribution the closes carry.

legsarray of objectrequired

One leg per selection, in ticket order.

Show 14 fields
seqintegerrequired

The leg's place on the ticket, from 1.

selectionstringrequired

The selection as the person wrote it, such as Chiefs -3.

market_kindstringrequired

The kind of market.

One of: spread, total, moneyline, prop, future, other (open: new values may be added).

sportstringnullable

The sport, as given or from Kelly's game.

leaguestringnullable

The league, as given or from Kelly's game.

sidestringnullable

The side (home, away, over, under), when known.

linenumbernullable

The line the person took, such as -3 or 47.5.

price_decimalnumbernullable

A parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.

game_idstringnullable

Kelly's game, when matched.

market_idstringnullable

Kelly's market, when matched.

selection_idstringnullable

Kelly's selection, when matched.

starts_atstringnullable

The game's start, when matched.

format date-time

resultstringrequired

The 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).

closeobjectrequired

The 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_decimalnull

The person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.

linenull

The person's own book's last line before kick-off: shown on askkelly.ai only.

market_decimalnumbernullable

The 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.

sourcestringnullable

Where the close came from.

atstringnullable

When 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

Request
PATCH https://api.askkelly.ai/v1/bets/tbet_gyswpkn4776tbf0aqz2z
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "note": "Took it before the move" }

Response, 200
{
  "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 · pathrequired

The bet's ID (tbet_…).

pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

ResponseLink to this section

200 Deleted, with its legs.

idstringrequired

The deleted bet's ID.

objectconstrequired

Always bet.

Always "bet".

deletedconstrequired

Always 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

Request
DELETE https://api.askkelly.ai/v1/bets/tbet_gyswpkn4776tbf0aqz2z
Authorization: Bearer $KELLY_API_KEY
Response, 200
{
  "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 · pathrequired

The bet's ID (tbet_…).

pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

Body, application/json (required):

statusstring

The 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_minorinteger

What the book paid, in minor units.

min 0

settled_atstring

When it settled; default now.

format date-time

ResponseLink to this section

200 The bet as it now is.

idstringrequired

The bet's ID (tbet_…), a random handle.

pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

objectconstrequired

Always bet.

Always "bet".

kindstringrequired

single, parlay or teaser.

One of: single, parlay, teaser (open: new values may be added).

statusstringrequired

open until it settles.

One of: open, won, lost, push, void, half_won, half_lost, cashed_out (open: new values may be added).

placed_atstringrequired

When the bet was placed.

format date-time

settled_atstringnullable

When it settled; null while open.

format date-time

settled_bystringnullable

person, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.

bookobjectrequired

The book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).

placed_statestringnullable

Where it was placed, ISO 3166-2 (US-NJ).

currencystringrequired

ISO 4217 currency of every amount.

stake_minorintegerrequired

The stake the person placed, in minor units.

priceobjectrequired

The price in the form the person gave it, echoed back.

price_decimalnumberrequired

The price as decimal odds.

payout_minorintegernullable

What the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.

profit_minorintegernullable

Payout less the cash stake; null while open.

free_betbooleanrequired

A free (bonus) bet, whose stake was never the person's.

boostboolean

A price boost.

fair_price_decimalnull

Kelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.

edgenull

Kelly's edge when logged from an answer: shown on Kelly's site only.

clvnumbernullable

The 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.

sourcestringrequired

Where it was logged.

One of: answer, chat, manual, csv, api, mcp, sync (open: new values may be added).

project_idstringnullable

The person's project it belongs to.

conversation_idstringnullable

The saved chat it was logged from.

answer_idstringnullable

The answer it was logged from.

limit_minorintegernullable

The book's limit on this bet, when the person noted one.

tagsarray of stringrequired

The person's tags.

notestring

The person's note.

import_idstringnullable

The CSV import it came from.

source_pick_idstringnullable

The analyst's pick it tails (apck_…), when the person logged one.

source_analyst_idstringnullable

That pick's analyst (anl_…).

created_atstringrequired

When it was logged.

format date-time

updated_atstringrequired

When it last changed.

format date-time

attributionstringrequired

The odds attribution the closes carry.

legsarray of objectrequired

One leg per selection, in ticket order.

Show 14 fields
seqintegerrequired

The leg's place on the ticket, from 1.

selectionstringrequired

The selection as the person wrote it, such as Chiefs -3.

market_kindstringrequired

The kind of market.

One of: spread, total, moneyline, prop, future, other (open: new values may be added).

sportstringnullable

The sport, as given or from Kelly's game.

leaguestringnullable

The league, as given or from Kelly's game.

sidestringnullable

The side (home, away, over, under), when known.

linenumbernullable

The line the person took, such as -3 or 47.5.

price_decimalnumbernullable

A parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.

game_idstringnullable

Kelly's game, when matched.

market_idstringnullable

Kelly's market, when matched.

selection_idstringnullable

Kelly's selection, when matched.

starts_atstringnullable

The game's start, when matched.

format date-time

resultstringrequired

The 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).

closeobjectrequired

The 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_decimalnull

The person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.

linenull

The person's own book's last line before kick-off: shown on askkelly.ai only.

market_decimalnumbernullable

The 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.

sourcestringnullable

Where the close came from.

atstringnullable

When 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

Request
POST https://api.askkelly.ai/v1/bets/tbet_gyswpkn4776tbf0aqz2z/settle
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "status": "won" }

Response, 200
{
  "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):

selectionstring

What the bet is on, as the book shows it, e.g. Kansas City Chiefs -3.5.

min length 1 · max length 200

bookstring

The book, e.g. DraftKings.

min length 1 · max length 80

priceobject

The price you want. Exactly one of {"american": -110}, {"decimal": 1.91}, {"fractional": "10/11"} or {"cents": 52}.

worst_priceobject

The 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_minorinteger

The stake, in minor units.

min 1

currencystring

ISO 4217; default USD.

pattern ^[A-Z]{3}$

urlstring

The 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_kindstring

Default other.

One of: spread, total, moneyline, prop, future, other (open: new values may be added).

sportstring

The sport, e.g. nfl.

max length 40

sidestring

home, away, over, under, yes, no or draw.

max length 40

linenumber

The line, e.g. -3.5.

game_idstring

Kelly's game (gm_…).

pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

market_idstring

Kelly's market (mkt_…).

pattern ^mkt_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

selection_idstring

Kelly's selection (sel_…), which finds the book's own link.

pattern ^sel_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

viastring

auto (default: your browser when it is open, else Kelly's), extension or hosted.

One of: auto, extension, hosted (open: new values may be added).

notestring

Your 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.

objectstring

Always bet_slip.

idstring

The slip's ID (slip_…).

statusstring

ready (the slip waits for the person's press) or price_moved (it shows a worse price than worst_price).

viastring

extension (the person's own browser) or hosted (Kelly's browser on their sign-in).

sportsbookstring

The book, as the person named it.

selectionstring

What the bet is on.

stake_minorinteger

The stake, in minor units.

currencystring

ISO 4217.

priceobject

The price asked for, as given.

worst_priceobject

The worst price accepted, as given.

price_seenstringnullable

The price the book's slip shows, as it shows it.

waits_untilstring

Until when the browser watches for the book's receipt.

format date-time

nextstring

What 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

Request
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" }

Response, 403
{
  "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."
}
Request
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 } }

Response, 400
{
  "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."
}
Request
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" }

Response, 404
{
  "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 string

The 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

statestring

Your US state, e.g. NJ or US-NJ; default the state saved on your account.

max length 20

urlstring

The 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.

objectstring

Always book_signups.

stateobjectnullable

The 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 object

One sign-up per book.

Show 13 fields
objectstring

Always book_signup.

idstringnullable

The sign-up's ID (signup_…); null when no tab was opened.

sportsbookstring

The book's name.

slugstring

The book's slug, as GET /v1/books lists it.

statusstring

filled (the form waits for the person), no_details, not_allowed, old_extension, no_form, no_page, load_failed or no_answer.

filledarray of string

The kinds of field Kelly filled, e.g. given_name, email, birth_date.

leftarray of string

The kinds of field left for the person, e.g. password, ssn.

promo_codestringnullable

The welcome offer's code Kelly typed in, if it needs one.

offerobjectnullable

The welcome offer in the person's state, as get_legal_books shows it.

min_ageintegernullable

The book's minimum age in the state.

ssnstringnullable

What the book asks of the Social Security number.

id_checkstringnullable

When the book asks for a photo ID or selfie.

nextstring

What the person does next.

has_moreboolean

Always false: every book's sign-up is in data.

next_cursorstringnullable

Always null.

waits_untilstringnullable

Until when the browser keeps filling each next step.

format date-time

nextstring

What 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

Request
POST https://api.askkelly.ai/v1/book-signups
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "books": [ "DraftKings" ], "state": "OH" }

Response, 403
{
  "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."
}
Request
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/" }

Response, 400
{
  "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."
}
Request
POST https://api.askkelly.ai/v1/book-signups
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "books": [ "DraftKings" ], "state": "OH" }

Response, 404
{
  "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 · query

The currency (ISO 4217); left out, the one with the most settled bets.

pattern ^[A-Z]{3}$

viewsstring · query

Comma list of summary, splits, series, streaks, bets; default summary.

max length 400

split_bystring · query

Comma list of project, sport, league, market, book, source, tag, analyst, month, week, day_of_week, price_band, stake_band.

max length 400

chartsstring · query

Comma list of equity, underwater, funnel, forest, calendar, histogram, rolling, all (the default) or none.

max length 400

sortstring · query

Split row order: natural, profit, roi, clv or bets.

One of: natural, profit, roi, clv, bets (open: new values may be added).

default "natural"

windowinteger · query

Bets in the rolling chart's window, 10 to 500.

min 10 · max 500 · default 50

tzstring · query

The IANA time zone days are counted in.

max length 64 · default "America/New_York"

startstring · query

Games on or after this day (in tz).

format date

endstring · query

Games on or before this day (in tz).

format date

sportsstring · query

Comma list: only these sports.

max length 400

leaguesstring · query

Comma list: only these leagues.

max length 400

marketsstring · query

Comma list: only these markets.

max length 400

booksstring · query

Comma list: only these books.

max length 400

tagsstring · query

Comma list: only these tags.

max length 400

sourcesstring · query

Comma list: only these sources.

max length 400

projectsstring · query

Comma list: only these projects.

max length 400

ResponseLink to this section

200 Your results.

objectconstrequired

Always my_results.

Always "my_results".

as_ofstringrequired

When Kelly worked it out.

format date-time

currencystringrequirednullable

The currency of every amount: the one asked for, else the one with the most settled bets; null with no bets.

currenciesarray of objectrequired

Every currency in your bets: currency, bets and settled.

unitobjectnullable

One unit for the charts: size (the median stake of your settled bets, in major units) and basis.

tzstringrequired

The time zone days, weeks and months are counted in.

bets_matchedintegerrequired

Bets the filters kept.

summaryobject

The 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.

splitsobject

For 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 object

Profit by settle day: day, profit, settled, cumulative_profit and cumulative_clv_predicted.

streaksobject

Longest win and loss runs, the current run and the biggest drawdown with its peak, trough and recovery.

bet_idsarray of string

The matching bets' IDs, by game time.

chartsarray of objectrequired

Kelly 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

Request
GET https://api.askkelly.ai/v1/me/results?views=summary,splits&split_by=sport&charts=equity,forest
Authorization: Bearer $KELLY_API_KEY
Response, 200
{
  "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.

Support: support@askkelly.ai · Security and disclosure