# bets

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

| Method | Path | Title | Access | Price | MCP tool |
| --- | --- | --- | --- | --- | --- |
| GET | [`/v1/bets`](#list-bets) | List your bets | `read:tracker` | 0 | `list_my_bets` |
| POST | [`/v1/bets`](#log-bet) | Log a bet | `write:tracker` | 0 | `log_my_bet` |
| POST | [`/v1/bets/import`](#import-bets) | Import bets from a CSV | `write:tracker` | 0 | `import_my_bets` |
| POST | [`/v1/bets/find_rule`](#find-rule-in-bets) | Find the rule behind your bets | `read:tracker` | 1 | `find_rule_in_my_bets` |
| GET | [`/v1/bets/summary`](#get-bet-summary) | Get your totals | `read:tracker` | 0 | `get_my_bet_summary` |
| GET | [`/v1/bets/{bet_id}`](#get-bet) | Get a bet | `read:tracker` | 0 | none |
| PATCH | [`/v1/bets/{bet_id}`](#update-bet) | Change a bet | `write:tracker` | 0 | `update_my_bet` |
| DELETE | [`/v1/bets/{bet_id}`](#delete-bet) | Delete a bet | `write:tracker` | 0 | none |
| POST | [`/v1/bets/{bet_id}/settle`](#settle-bet) | Settle a bet | `write:tracker` | 0 | `settle_my_bet` |
| POST | [`/v1/bet-slips`](#fill-bet-slip) | Fill a bet slip | `write:tracker` | 0 | none |
| POST | [`/v1/book-signups`](#start-book-signup) | Start sportsbook sign-ups | `write:tracker` | 0 | none |
| GET | [`/v1/me/results`](#get-my-results) | Get your results | `read:tracker` | 0 | `get_my_results` |

`GET /v1/bets`

## List your bets
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.

### Parameters
- `project` string · query  
  One of your projects (proj_…), or none for bets in no project.  
  pattern ^(none|proj_[0-9a-hjkmnp-tv-z]{20})$
- `status` string · 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).
- `sport` string · query  
  Only this sport.  
  max length 40
- `book` string · query  
  Only this book, by Kelly's ID or by name.  
  max length 80
- `tag` string · query  
  Only bets with this tag.  
  max length 40
- `currency` string · query  
  Only this currency.  
  pattern ^[A-Z]{3}$
- `game_id` string · query  
  Only bets with a leg on this game.  
  pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `analyst` string · query  
  Only bets that tail this analyst's picks (anl_…).  
  pattern ^anl_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `since` string · query  
  Placed at or after.  
  format date-time
- `until` string · query  
  Placed before.  
  format date-time
- `limit` integer · query  
  Bets per page, 1 to 200.  
  min 1 · max 200 · default 50
- `cursor` string · query  
  The next_cursor of the page before.  
  max length 200

### Response
`200` A page of your bets, newest placed first.

- `object` const · required  
  Always `list`.  
  Always `"list"`.
- `data` array of object · required  
  The page's bets, newest placed first.
  - `id` string · required  
    The bet's ID (tbet_…), a random handle.  
    pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `object` const · required  
    Always `bet`.  
    Always `"bet"`.
  - `kind` string · required  
    single, parlay or teaser.  
    One of: `single`, `parlay`, `teaser` (open: new values may be added).
  - `status` string · required  
    open until it settles.  
    One of: `open`, `won`, `lost`, `push`, `void`, `half_won`, `half_lost`, `cashed_out` (open: new values may be added).
  - `placed_at` string · required  
    When the bet was placed.  
    format date-time
  - `settled_at` string · nullable  
    When it settled; null while open.  
    format date-time
  - `settled_by` string · nullable  
    person, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.
  - `book` object · required  
    The book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).
  - `placed_state` string · nullable  
    Where it was placed, ISO 3166-2 (US-NJ).
  - `currency` string · required  
    ISO 4217 currency of every amount.
  - `stake_minor` integer · required  
    The stake the person placed, in minor units.
  - `price` object · required  
    The price in the form the person gave it, echoed back.
  - `price_decimal` number · required  
    The price as decimal odds.
  - `payout_minor` integer · nullable  
    What the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.
  - `profit_minor` integer · nullable  
    Payout less the cash stake; null while open.
  - `free_bet` boolean · required  
    A free (bonus) bet, whose stake was never the person's.
  - `boost` boolean  
    A price boost.
  - `fair_price_decimal` null  
    Kelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.
  - `edge` null  
    Kelly's edge when logged from an answer: shown on Kelly's site only.
  - `clv` number · nullable  
    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.
  - `source` string · required  
    Where it was logged.  
    One of: `answer`, `chat`, `manual`, `csv`, `api`, `mcp`, `sync` (open: new values may be added).
  - `project_id` string · nullable  
    The person's project it belongs to.
  - `conversation_id` string · nullable  
    The saved chat it was logged from.
  - `answer_id` string · nullable  
    The answer it was logged from.
  - `limit_minor` integer · nullable  
    The book's limit on this bet, when the person noted one.
  - `tags` array of string · required  
    The person's tags.
  - `note` string  
    The person's note.
  - `import_id` string · nullable  
    The CSV import it came from.
  - `source_pick_id` string · nullable  
    The analyst's pick it tails (apck_…), when the person logged one.
  - `source_analyst_id` string · nullable  
    That pick's analyst (anl_…).
  - `created_at` string · required  
    When it was logged.  
    format date-time
  - `updated_at` string · required  
    When it last changed.  
    format date-time
  - `attribution` string · required  
    The odds attribution the closes carry.
  - `legs` array of object · required  
    One leg per selection, in ticket order.
    - `seq` integer · required  
      The leg's place on the ticket, from 1.
    - `selection` string · required  
      The selection as the person wrote it, such as Chiefs -3.
    - `market_kind` string · required  
      The kind of market.  
      One of: `spread`, `total`, `moneyline`, `prop`, `future`, `other` (open: new values may be added).
    - `sport` string · nullable  
      The sport, as given or from Kelly's game.
    - `league` string · nullable  
      The league, as given or from Kelly's game.
    - `side` string · nullable  
      The side (home, away, over, under), when known.
    - `line` number · nullable  
      The line the person took, such as -3 or 47.5.
    - `price_decimal` number · nullable  
      A parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.
    - `game_id` string · nullable  
      Kelly's game, when matched.
    - `market_id` string · nullable  
      Kelly's market, when matched.
    - `selection_id` string · nullable  
      Kelly's selection, when matched.
    - `starts_at` string · nullable  
      The game's start, when matched.  
      format date-time
    - `result` string · required  
      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).
    - `close` object · required  
      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.
      - `price_decimal` null  
        The person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.
      - `line` null  
        The person's own book's last line before kick-off: shown on askkelly.ai only.
      - `market_decimal` number · nullable  
        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.
      - `source` string · nullable  
        Where the close came from.
      - `at` string · nullable  
        When Kelly recorded the close.  
        format date-time
- `has_more` boolean · required  
  Whether another page follows.
- `next_cursor` string · required · nullable  
  Pass as `cursor` for the next page.
- `attribution` string · required  
  The odds attribution the closes carry.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled)

### Example
```http
GET https://api.askkelly.ai/v1/bets?status=won&limit=10
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "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 bet
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.

### Parameters
Body, `application/json` (required):

- `legs` array of object  
  One leg per selection.  
  min items 1
  - `selection` string · required  
    The selection in your own words, such as Chiefs -3.  
    min length 1 · max length 200
  - `market_kind` string  
    The kind of market; default other.  
    One of: `spread`, `total`, `moneyline`, `prop`, `future`, `other` (open: new values may be added).
  - `sport` string  
    The sport.  
    max length 40
  - `league` string  
    The league.  
    max length 40
  - `side` string  
    home, away, over or under.  
    max length 40
  - `line` number  
    The line you took.
  - `price` object  
    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_id` string  
    Kelly's game.  
    pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `market_id` string  
    Kelly's market.  
    pattern ^mkt_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `selection_id` string  
    Kelly's selection: fills in the market, game, sport and start time.  
    pattern ^sel_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `kind` string  
  Default: single for one leg, parlay for more.  
  One of: `single`, `parlay`, `teaser` (open: new values may be added).
- `price` object  
  The ticket's price. Exactly one of `{"american": -110}`, `{"decimal": 1.91}`, `{"fractional": "10/11"}` or `{"cents": 52}`.
- `stake_minor` integer  
  The stake, in minor units.  
  min 1
- `book` string  
  The book's name; book or book_id is required to log a bet.  
  min length 1 · max length 80
- `book_id` string  
  Kelly's book ID (bk_…).  
  pattern ^bk_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `venue_type` string  
  Default: the book's own kind, else sportsbook.  
  One of: `sportsbook`, `exchange`, `prediction_market`, `dfs_pickem` (open: new values may be added).
- `currency` string  
  ISO 4217; default USD.  
  pattern ^[A-Z]{3}$
- `placed_at` string  
  When you placed it; default now.  
  format date-time
- `placed_state` string  
  Where you placed it, ISO 3166-2 (US-NJ).  
  pattern ^[A-Z]{2}-[A-Z0-9]{1,3}$
- `free_bet` boolean  
  A free (bonus) bet.
- `boost` boolean  
  A price boost.
- `project_id` string  
  One of your projects.  
  pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `limit_minor` integer  
  The book's limit on this bet, in minor units.  
  min 1
- `source_pick_id` string  
  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}$
- `tags` array of string  
  Your tags.
- `note` string  
  Your note.  
  max length 1000

### Response
`201` The bet as logged.

- `id` string · required  
  The bet's ID (tbet_…), a random handle.  
  pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `object` const · required  
  Always `bet`.  
  Always `"bet"`.
- `kind` string · required  
  single, parlay or teaser.  
  One of: `single`, `parlay`, `teaser` (open: new values may be added).
- `status` string · required  
  open until it settles.  
  One of: `open`, `won`, `lost`, `push`, `void`, `half_won`, `half_lost`, `cashed_out` (open: new values may be added).
- `placed_at` string · required  
  When the bet was placed.  
  format date-time
- `settled_at` string · nullable  
  When it settled; null while open.  
  format date-time
- `settled_by` string · nullable  
  person, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.
- `book` object · required  
  The book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).
- `placed_state` string · nullable  
  Where it was placed, ISO 3166-2 (US-NJ).
- `currency` string · required  
  ISO 4217 currency of every amount.
- `stake_minor` integer · required  
  The stake the person placed, in minor units.
- `price` object · required  
  The price in the form the person gave it, echoed back.
- `price_decimal` number · required  
  The price as decimal odds.
- `payout_minor` integer · nullable  
  What the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.
- `profit_minor` integer · nullable  
  Payout less the cash stake; null while open.
- `free_bet` boolean · required  
  A free (bonus) bet, whose stake was never the person's.
- `boost` boolean  
  A price boost.
- `fair_price_decimal` null  
  Kelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.
- `edge` null  
  Kelly's edge when logged from an answer: shown on Kelly's site only.
- `clv` number · nullable  
  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.
- `source` string · required  
  Where it was logged.  
  One of: `answer`, `chat`, `manual`, `csv`, `api`, `mcp`, `sync` (open: new values may be added).
- `project_id` string · nullable  
  The person's project it belongs to.
- `conversation_id` string · nullable  
  The saved chat it was logged from.
- `answer_id` string · nullable  
  The answer it was logged from.
- `limit_minor` integer · nullable  
  The book's limit on this bet, when the person noted one.
- `tags` array of string · required  
  The person's tags.
- `note` string  
  The person's note.
- `import_id` string · nullable  
  The CSV import it came from.
- `source_pick_id` string · nullable  
  The analyst's pick it tails (apck_…), when the person logged one.
- `source_analyst_id` string · nullable  
  That pick's analyst (anl_…).
- `created_at` string · required  
  When it was logged.  
  format date-time
- `updated_at` string · required  
  When it last changed.  
  format date-time
- `attribution` string · required  
  The odds attribution the closes carry.
- `legs` array of object · required  
  One leg per selection, in ticket order.
  - `seq` integer · required  
    The leg's place on the ticket, from 1.
  - `selection` string · required  
    The selection as the person wrote it, such as Chiefs -3.
  - `market_kind` string · required  
    The kind of market.  
    One of: `spread`, `total`, `moneyline`, `prop`, `future`, `other` (open: new values may be added).
  - `sport` string · nullable  
    The sport, as given or from Kelly's game.
  - `league` string · nullable  
    The league, as given or from Kelly's game.
  - `side` string · nullable  
    The side (home, away, over, under), when known.
  - `line` number · nullable  
    The line the person took, such as -3 or 47.5.
  - `price_decimal` number · nullable  
    A parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.
  - `game_id` string · nullable  
    Kelly's game, when matched.
  - `market_id` string · nullable  
    Kelly's market, when matched.
  - `selection_id` string · nullable  
    Kelly's selection, when matched.
  - `starts_at` string · nullable  
    The game's start, when matched.  
    format date-time
  - `result` string · required  
    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).
  - `close` object · required  
    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.
    - `price_decimal` null  
      The person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.
    - `line` null  
      The person's own book's last line before kick-off: shown on askkelly.ai only.
    - `market_decimal` number · nullable  
      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.
    - `source` string · nullable  
      Where the close came from.
    - `at` string · nullable  
      When Kelly recorded the close.  
      format date-time

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`payload_too_large`](/problems/payload_too_large) · [`not_found`](/problems/not_found) · [`attestation_required`](/problems/attestation_required)

### Example
```http
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"
}
```

```json
{
  "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."
}
```

```http
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
}
```

```json
{
  "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."
}
```

```http
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"
}
```

```json
{
  "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 CSV
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.

### Parameters
Body, `application/json` (required):

- `csv` string  
  The CSV file's text, its heading row included. At most 5 MB.  
  min length 1
- `book` string  
  The book, when the file has no book column.  
  min length 1 · max length 80
- `time_zone` string  
  The IANA zone for times the file gives without one.  
  max length 64 · default "America/New_York"
- `currency` string  
  ISO 4217, when the file has no currency column.  
  pattern ^[A-Z]{3}$ · default "USD"
- `dry_run` boolean  
  true: say what would be added and add nothing.  
  default false

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

- `object` const  
  Always bet_import.  
  Always `"bet_import"`.
- `dry_run` boolean  
  true: nothing was added.
- `rows` integer  
  Data rows read.
- `bets_found` integer  
  Bets read from the rows.
- `to_add` integer  
  Bets not yet in the log.
- `added` integer  
  Bets added (0 on a dry run).
- `already_logged` integer  
  Bets already in the log, left alone.
- `skipped_count` integer  
  Rows left out.
- `cut` integer  
  Bets past the most one import takes, for another file.
- `skipped` array of object  
  Up to 20 rows left out: row and reason.
  - `row` integer  
    The file's row number (the header is 1).
  - `reason` string  
    Why.
- `columns` object  
  Each field read, and the file's heading it was read from.
- `totals` object  
  Per currency, the new bets: bets, open, settled, staked_minor, profit_minor.
- `sample` array of object  
  Up to 10 of the new bets.
  - `what` string  
    What it is on.
  - `sportsbook` string  
    Where.
  - `placed_at` string · nullable  
    When placed.  
    format date-time
  - `price` object  
    The price as the file gave it.
  - `stake_minor` integer  
    The stake.
  - `status` string  
    open or the result.
  - `payout_minor` integer · nullable  
    What it returned.
  - `free_bet` boolean  
    A free bet.
  - `rows` array of integer  
    The file's rows it came from.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`payload_too_large`](/problems/payload_too_large) · [`not_found`](/problems/not_found) · [`attestation_required`](/problems/attestation_required)

### Example
```http
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"
}
```

```json
{
  "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": []
}
```

```http
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
}
```

```json
{
  "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
}
```

```http
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"
}
```

```json
{
  "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
      ]
    }
  ]
}
```

```http
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"
}
```

```json
{
  "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."
}
```

```http
POST https://api.askkelly.ai/v1/bets/import
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

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

```json
{
  "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 bets
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.

### Parameters
Body, `application/json` (required):

- `competition` string  
  The competition's slug: nfl, nba, mlb, nhl, ncaaf, ncaab, wnba...  
  pattern ^[a-z0-9_]{2,24}$
- `market` string  
  spread, moneyline, over or under.  
  One of: `spread`, `moneyline`, `over`, `under` (open: new values may be added).  
  default "spread"
- `seasons` array of string  
  Seasons to read; default the seasons your bets fall in.  
  max items 25
- `since` string  
  Only bets placed at or after this time.  
  format date-time
- `until` string  
  Only bets placed before this time.  
  format date-time

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

- `object` const  
  Always bet_rule.  
  Always `"bet_rule"`.
- `competition` string  
  The competition.
- `market` string  
  spread, moneyline, over or under.
- `seasons` array of string  
  Seasons read.
- `bets` object  
  given, used, and left_out: each reason (side_unread, not_in_kellys_games, same_game_twice, other_market) and its count.
- `universe` integer  
  Team-games Kelly held a line for: every game the person could have bet.
- `base_rate` number · nullable  
  The share of those the person bet.
- `candidates` array of object  
  Up to three, each matching a different set of games.
  - `label` string  
    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).
  - `formula` string  
    The rule, ready for test_rule.
  - `conditions` array of object  
    Its conditions.
    - `formula` string  
      The condition as a formula.
    - `words` string  
      The condition in words.
  - `coverage` number  
    The share of the person's bets it matches (0.8 is 80%).
  - `precision` number  
    The share of its games the person bet.
  - `lift` number · nullable  
    Precision over the share of all games bet; 1.0 is chance.
  - `matches` integer  
    Team-games it matches.
  - `bets_covered` integer  
    The person's bets among them.
- `reason` string · nullable  
  Why there are no candidates, when there are none.
- `placed` object  
  The placed window read: since and until, or null.
- `next` object  
  test_rule, which counts each candidate tested on the rules-tried ledger.
- `notice` string  
  Found from the person's choices only, never from the results.
- `summary` string  
  The candidates in one sentence, from the fields.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`payload_too_large`](/problems/payload_too_large)

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

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

```json
{
  "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."
}
```

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

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

```json
{
  "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 totals
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.

### Parameters
- `project` string · query  
  One of your projects (proj_…), or none for bets in no project.  
  pattern ^(none|proj_[0-9a-hjkmnp-tv-z]{20})$
- `status` string · 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).
- `sport` string · query  
  Only this sport.  
  max length 40
- `book` string · query  
  Only this book, by Kelly's ID or by name.  
  max length 80
- `tag` string · query  
  Only bets with this tag.  
  max length 40
- `currency` string · query  
  Only this currency.  
  pattern ^[A-Z]{3}$
- `game_id` string · query  
  Only bets with a leg on this game.  
  pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `analyst` string · query  
  Only bets that tail this analyst's picks (anl_…).  
  pattern ^anl_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `since` string · query  
  Placed at or after.  
  format date-time
- `until` string · query  
  Placed before.  
  format date-time
- `tz` string · query  
  The IANA time zone the periods are counted in.  
  max length 64 · default "America/New_York"

### Response
`200` Your totals for the bets that match.

- `object` const · required  
  Always `bet_summary`.  
  Always `"bet_summary"`.
- `tz` string · required  
  The time zone the periods are counted in.
- `attribution` string · required  
  The odds attribution the closes carry.
- `currencies` array of object · required  
  One entry per currency, in currency order.
  - `currency` string  
    ISO 4217.
  - `bets` integer  
    Bets logged.
  - `open` integer  
    Bets still open.
  - `settled` integer  
    Bets settled.
  - `staked_minor` integer  
    Cash staked on settled bets that had action (pushes, voids and free bets left out).
  - `profit_minor` integer  
    Payout less cash stake over settled bets.
  - `roi` number · nullable  
    Profit over staked; null with nothing staked.
  - `at_risk_minor` integer  
    Cash stakes of open bets.
  - `clv` object  
    The mean closing-line value over singles with a market close, and how many bets it covers.
  - `expected_profit_minor` null  
    Stake times Kelly's edge over bets logged from answers: shown on askkelly.ai only.
  - `actual_profit_minor` integer · nullable  
    Profit over the bets that carried Kelly's edge.
  - `edge_bets` integer  
    How many settled bets carried Kelly's edge.
  - `by_clv` object  
    Settled bets that beat the market close (closing-line value above zero) and those that didn't; bets with no close are in neither.
    - `beat` object  
      Bets that beat the close.
      - `bets` integer  
        Settled bets.
      - `staked_minor` integer  
        Cash staked on bets that had action.
      - `profit_minor` integer  
        Profit.
      - `roi` number · nullable  
        Profit over staked; null with nothing staked.
    - `missed` object  
      Bets that didn't.
      - `bets` integer  
        Settled bets.
      - `staked_minor` integer  
        Cash staked on bets that had action.
      - `profit_minor` integer  
        Profit.
      - `roi` number · nullable  
        Profit over staked; null with nothing staked.
  - `record` object · nullable  
    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.
    - `wins` integer  
      Bets won.
    - `losses` integer  
      Bets lost.
    - `pushes` integer  
      Pushes.
    - `left_out` integer  
      Half results, voids and cash-outs, not tested.
    - `win_rate` number  
      Wins over wins and losses.
    - `break_even` number  
      The win rate the prices paid need: the average of each bet's 1 / decimal price.
    - `over_break_even` number  
      Win rate minus break-even.
    - `no_skill_match_prob` number  
      The chance a bettor with no skill, winning each bet at its break-even, wins at least as many.
    - `significant` boolean  
      Whether that chance is 5% or less.
    - `bets_needed` object · nullable  
      Bets needed at this win rate: one_sided (z at 5%) and with_power (80% power); null at or under the break-even.
  - `by_analyst` array of object  
    The bets that tail an analyst's pick (source_pick_id), one row per analyst, most profit first.
    - `analyst_id` string  
      The analyst (anl_…).
    - `analyst` string · nullable  
      Their name.
    - `bets` integer  
      Bets logged.
    - `open` integer  
      Bets still open.
    - `settled` integer  
      Bets settled.
    - `staked_minor` integer  
      Cash staked on settled bets that had action.
    - `profit_minor` integer  
      Profit.
    - `roi` number · nullable  
      Profit over staked; null with nothing staked.
    - `won` integer  
      Bets won.
    - `lost` integer  
      Bets lost.
    - `push` integer  
      Pushes.
  - `by_period` object  
    Bets, staked and profit per day, ISO week, month and year of settlement in `tz`.
    - `day` array of object  
      By day, oldest first.
      - `period` string  
        The period: 2026-10-11, 2026-W41, 2026-10 or 2026.
      - `bets` integer  
        Bets settled in it.
      - `staked_minor` integer  
        Cash staked on bets that had action.
      - `profit_minor` integer  
        Profit.
    - `week` array of object  
      By week, oldest first.
      - `period` string  
        The period: 2026-10-11, 2026-W41, 2026-10 or 2026.
      - `bets` integer  
        Bets settled in it.
      - `staked_minor` integer  
        Cash staked on bets that had action.
      - `profit_minor` integer  
        Profit.
    - `month` array of object  
      By month, oldest first.
      - `period` string  
        The period: 2026-10-11, 2026-W41, 2026-10 or 2026.
      - `bets` integer  
        Bets settled in it.
      - `staked_minor` integer  
        Cash staked on bets that had action.
      - `profit_minor` integer  
        Profit.
    - `year` array of object  
      By year, oldest first.
      - `period` string  
        The period: 2026-10-11, 2026-W41, 2026-10 or 2026.
      - `bets` integer  
        Bets settled in it.
      - `staked_minor` integer  
        Cash staked on bets that had action.
      - `profit_minor` integer  
        Profit.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled)

### Example
```http
GET https://api.askkelly.ai/v1/bets/summary?tz=America/New_York
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "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 bet
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.

### Parameters
- `bet_id` string · path · required  
  The bet's ID (tbet_…).  
  pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

### Response
`200` The bet.

- `id` string · required  
  The bet's ID (tbet_…), a random handle.  
  pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `object` const · required  
  Always `bet`.  
  Always `"bet"`.
- `kind` string · required  
  single, parlay or teaser.  
  One of: `single`, `parlay`, `teaser` (open: new values may be added).
- `status` string · required  
  open until it settles.  
  One of: `open`, `won`, `lost`, `push`, `void`, `half_won`, `half_lost`, `cashed_out` (open: new values may be added).
- `placed_at` string · required  
  When the bet was placed.  
  format date-time
- `settled_at` string · nullable  
  When it settled; null while open.  
  format date-time
- `settled_by` string · nullable  
  person, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.
- `book` object · required  
  The book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).
- `placed_state` string · nullable  
  Where it was placed, ISO 3166-2 (US-NJ).
- `currency` string · required  
  ISO 4217 currency of every amount.
- `stake_minor` integer · required  
  The stake the person placed, in minor units.
- `price` object · required  
  The price in the form the person gave it, echoed back.
- `price_decimal` number · required  
  The price as decimal odds.
- `payout_minor` integer · nullable  
  What the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.
- `profit_minor` integer · nullable  
  Payout less the cash stake; null while open.
- `free_bet` boolean · required  
  A free (bonus) bet, whose stake was never the person's.
- `boost` boolean  
  A price boost.
- `fair_price_decimal` null  
  Kelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.
- `edge` null  
  Kelly's edge when logged from an answer: shown on Kelly's site only.
- `clv` number · nullable  
  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.
- `source` string · required  
  Where it was logged.  
  One of: `answer`, `chat`, `manual`, `csv`, `api`, `mcp`, `sync` (open: new values may be added).
- `project_id` string · nullable  
  The person's project it belongs to.
- `conversation_id` string · nullable  
  The saved chat it was logged from.
- `answer_id` string · nullable  
  The answer it was logged from.
- `limit_minor` integer · nullable  
  The book's limit on this bet, when the person noted one.
- `tags` array of string · required  
  The person's tags.
- `note` string  
  The person's note.
- `import_id` string · nullable  
  The CSV import it came from.
- `source_pick_id` string · nullable  
  The analyst's pick it tails (apck_…), when the person logged one.
- `source_analyst_id` string · nullable  
  That pick's analyst (anl_…).
- `created_at` string · required  
  When it was logged.  
  format date-time
- `updated_at` string · required  
  When it last changed.  
  format date-time
- `attribution` string · required  
  The odds attribution the closes carry.
- `legs` array of object · required  
  One leg per selection, in ticket order.
  - `seq` integer · required  
    The leg's place on the ticket, from 1.
  - `selection` string · required  
    The selection as the person wrote it, such as Chiefs -3.
  - `market_kind` string · required  
    The kind of market.  
    One of: `spread`, `total`, `moneyline`, `prop`, `future`, `other` (open: new values may be added).
  - `sport` string · nullable  
    The sport, as given or from Kelly's game.
  - `league` string · nullable  
    The league, as given or from Kelly's game.
  - `side` string · nullable  
    The side (home, away, over, under), when known.
  - `line` number · nullable  
    The line the person took, such as -3 or 47.5.
  - `price_decimal` number · nullable  
    A parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.
  - `game_id` string · nullable  
    Kelly's game, when matched.
  - `market_id` string · nullable  
    Kelly's market, when matched.
  - `selection_id` string · nullable  
    Kelly's selection, when matched.
  - `starts_at` string · nullable  
    The game's start, when matched.  
    format date-time
  - `result` string · required  
    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).
  - `close` object · required  
    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.
    - `price_decimal` null  
      The person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.
    - `line` null  
      The person's own book's last line before kick-off: shown on askkelly.ai only.
    - `market_decimal` number · nullable  
      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.
    - `source` string · nullable  
      Where the close came from.
    - `at` string · nullable  
      When Kelly recorded the close.  
      format date-time

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`not_found`](/problems/not_found)

### Example
```http
GET https://api.askkelly.ai/v1/bets/tbet_00000000000000000000
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "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."
}
```

```http
GET https://api.askkelly.ai/v1/bets/tbet_gyswpkn4776tbf0aqz2z
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "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 bet
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.

### Parameters
- `bet_id` string · path · required  
  The bet's ID (tbet_…).  
  pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

Body, `application/json` (required):

- `legs` array of object  
  Replaces every leg.  
  min items 1
  - `selection` string · required  
    The selection in your own words, such as Chiefs -3.  
    min length 1 · max length 200
  - `market_kind` string  
    The kind of market; default other.  
    One of: `spread`, `total`, `moneyline`, `prop`, `future`, `other` (open: new values may be added).
  - `sport` string  
    The sport.  
    max length 40
  - `league` string  
    The league.  
    max length 40
  - `side` string  
    home, away, over or under.  
    max length 40
  - `line` number  
    The line you took.
  - `price` object  
    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_id` string  
    Kelly's game.  
    pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `market_id` string  
    Kelly's market.  
    pattern ^mkt_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `selection_id` string  
    Kelly's selection: fills in the market, game, sport and start time.  
    pattern ^sel_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `price` object  
  The ticket's price. Exactly one of `{"american": -110}`, `{"decimal": 1.91}`, `{"fractional": "10/11"}` or `{"cents": 52}`.
- `stake_minor` integer  
  The stake, in minor units.  
  min 1
- `clear_project` boolean  
  Take the bet out of its project.
- `clear_source_pick` boolean  
  Unlink the analyst's pick it tails.
- `book` string  
  The book's name; book or book_id is required to log a bet.  
  min length 1 · max length 80
- `book_id` string  
  Kelly's book ID (bk_…).  
  pattern ^bk_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `venue_type` string  
  Default: the book's own kind, else sportsbook.  
  One of: `sportsbook`, `exchange`, `prediction_market`, `dfs_pickem` (open: new values may be added).
- `currency` string  
  ISO 4217; default USD.  
  pattern ^[A-Z]{3}$
- `placed_at` string  
  When you placed it; default now.  
  format date-time
- `placed_state` string  
  Where you placed it, ISO 3166-2 (US-NJ).  
  pattern ^[A-Z]{2}-[A-Z0-9]{1,3}$
- `free_bet` boolean  
  A free (bonus) bet.
- `boost` boolean  
  A price boost.
- `project_id` string  
  One of your projects.  
  pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `limit_minor` integer  
  The book's limit on this bet, in minor units.  
  min 1
- `source_pick_id` string  
  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}$
- `tags` array of string  
  Your tags.
- `note` string  
  Your note.  
  max length 1000

### Response
`200` The bet as it now is.

- `id` string · required  
  The bet's ID (tbet_…), a random handle.  
  pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `object` const · required  
  Always `bet`.  
  Always `"bet"`.
- `kind` string · required  
  single, parlay or teaser.  
  One of: `single`, `parlay`, `teaser` (open: new values may be added).
- `status` string · required  
  open until it settles.  
  One of: `open`, `won`, `lost`, `push`, `void`, `half_won`, `half_lost`, `cashed_out` (open: new values may be added).
- `placed_at` string · required  
  When the bet was placed.  
  format date-time
- `settled_at` string · nullable  
  When it settled; null while open.  
  format date-time
- `settled_by` string · nullable  
  person, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.
- `book` object · required  
  The book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).
- `placed_state` string · nullable  
  Where it was placed, ISO 3166-2 (US-NJ).
- `currency` string · required  
  ISO 4217 currency of every amount.
- `stake_minor` integer · required  
  The stake the person placed, in minor units.
- `price` object · required  
  The price in the form the person gave it, echoed back.
- `price_decimal` number · required  
  The price as decimal odds.
- `payout_minor` integer · nullable  
  What the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.
- `profit_minor` integer · nullable  
  Payout less the cash stake; null while open.
- `free_bet` boolean · required  
  A free (bonus) bet, whose stake was never the person's.
- `boost` boolean  
  A price boost.
- `fair_price_decimal` null  
  Kelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.
- `edge` null  
  Kelly's edge when logged from an answer: shown on Kelly's site only.
- `clv` number · nullable  
  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.
- `source` string · required  
  Where it was logged.  
  One of: `answer`, `chat`, `manual`, `csv`, `api`, `mcp`, `sync` (open: new values may be added).
- `project_id` string · nullable  
  The person's project it belongs to.
- `conversation_id` string · nullable  
  The saved chat it was logged from.
- `answer_id` string · nullable  
  The answer it was logged from.
- `limit_minor` integer · nullable  
  The book's limit on this bet, when the person noted one.
- `tags` array of string · required  
  The person's tags.
- `note` string  
  The person's note.
- `import_id` string · nullable  
  The CSV import it came from.
- `source_pick_id` string · nullable  
  The analyst's pick it tails (apck_…), when the person logged one.
- `source_analyst_id` string · nullable  
  That pick's analyst (anl_…).
- `created_at` string · required  
  When it was logged.  
  format date-time
- `updated_at` string · required  
  When it last changed.  
  format date-time
- `attribution` string · required  
  The odds attribution the closes carry.
- `legs` array of object · required  
  One leg per selection, in ticket order.
  - `seq` integer · required  
    The leg's place on the ticket, from 1.
  - `selection` string · required  
    The selection as the person wrote it, such as Chiefs -3.
  - `market_kind` string · required  
    The kind of market.  
    One of: `spread`, `total`, `moneyline`, `prop`, `future`, `other` (open: new values may be added).
  - `sport` string · nullable  
    The sport, as given or from Kelly's game.
  - `league` string · nullable  
    The league, as given or from Kelly's game.
  - `side` string · nullable  
    The side (home, away, over, under), when known.
  - `line` number · nullable  
    The line the person took, such as -3 or 47.5.
  - `price_decimal` number · nullable  
    A parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.
  - `game_id` string · nullable  
    Kelly's game, when matched.
  - `market_id` string · nullable  
    Kelly's market, when matched.
  - `selection_id` string · nullable  
    Kelly's selection, when matched.
  - `starts_at` string · nullable  
    The game's start, when matched.  
    format date-time
  - `result` string · required  
    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).
  - `close` object · required  
    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.
    - `price_decimal` null  
      The person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.
    - `line` null  
      The person's own book's last line before kick-off: shown on askkelly.ai only.
    - `market_decimal` number · nullable  
      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.
    - `source` string · nullable  
      Where the close came from.
    - `at` string · nullable  
      When Kelly recorded the close.  
      format date-time

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`payload_too_large`](/problems/payload_too_large) · [`not_found`](/problems/not_found)

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

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

```json
{
  "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 bet
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.

### Parameters
- `bet_id` string · path · required  
  The bet's ID (tbet_…).  
  pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

### Response
`200` Deleted, with its legs.

- `id` string · required  
  The deleted bet's ID.
- `object` const · required  
  Always `bet`.  
  Always `"bet"`.
- `deleted` const · required  
  Always true.  
  Always `true`.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`not_found`](/problems/not_found)

### Example
```http
DELETE https://api.askkelly.ai/v1/bets/tbet_gyswpkn4776tbf0aqz2z
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "id": "tbet_gyswpkn4776tbf0aqz2z",
  "object": "bet",
  "deleted": true
}
```

`POST /v1/bets/{bet_id}/settle`

## Settle a bet
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.

### Parameters
- `bet_id` string · path · required  
  The bet's ID (tbet_…).  
  pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

Body, `application/json` (required):

- `status` string  
  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_minor` integer  
  What the book paid, in minor units.  
  min 0
- `settled_at` string  
  When it settled; default now.  
  format date-time

### Response
`200` The bet as it now is.

- `id` string · required  
  The bet's ID (tbet_…), a random handle.  
  pattern ^tbet_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `object` const · required  
  Always `bet`.  
  Always `"bet"`.
- `kind` string · required  
  single, parlay or teaser.  
  One of: `single`, `parlay`, `teaser` (open: new values may be added).
- `status` string · required  
  open until it settles.  
  One of: `open`, `won`, `lost`, `push`, `void`, `half_won`, `half_lost`, `cashed_out` (open: new values may be added).
- `placed_at` string · required  
  When the bet was placed.  
  format date-time
- `settled_at` string · nullable  
  When it settled; null while open.  
  format date-time
- `settled_by` string · nullable  
  person, kelly when the settle job decided it from the final score, or book when the person's own book settled a synced bet.
- `book` object · required  
  The book: Kelly's ID when it carries the book, the name, and the venue type (sportsbook, exchange, prediction_market, dfs_pickem).
- `placed_state` string · nullable  
  Where it was placed, ISO 3166-2 (US-NJ).
- `currency` string · required  
  ISO 4217 currency of every amount.
- `stake_minor` integer · required  
  The stake the person placed, in minor units.
- `price` object · required  
  The price in the form the person gave it, echoed back.
- `price_decimal` number · required  
  The price as decimal odds.
- `payout_minor` integer · nullable  
  What the settled bet returned: the stake back plus winnings, or winnings only on a free bet; null while open.
- `profit_minor` integer · nullable  
  Payout less the cash stake; null while open.
- `free_bet` boolean · required  
  A free (bonus) bet, whose stake was never the person's.
- `boost` boolean  
  A price boost.
- `fair_price_decimal` null  
  Kelly's fair price when the bet was logged from an answer: shown on askkelly.ai only.
- `edge` null  
  Kelly's edge when logged from an answer: shown on Kelly's site only.
- `clv` number · nullable  
  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.
- `source` string · required  
  Where it was logged.  
  One of: `answer`, `chat`, `manual`, `csv`, `api`, `mcp`, `sync` (open: new values may be added).
- `project_id` string · nullable  
  The person's project it belongs to.
- `conversation_id` string · nullable  
  The saved chat it was logged from.
- `answer_id` string · nullable  
  The answer it was logged from.
- `limit_minor` integer · nullable  
  The book's limit on this bet, when the person noted one.
- `tags` array of string · required  
  The person's tags.
- `note` string  
  The person's note.
- `import_id` string · nullable  
  The CSV import it came from.
- `source_pick_id` string · nullable  
  The analyst's pick it tails (apck_…), when the person logged one.
- `source_analyst_id` string · nullable  
  That pick's analyst (anl_…).
- `created_at` string · required  
  When it was logged.  
  format date-time
- `updated_at` string · required  
  When it last changed.  
  format date-time
- `attribution` string · required  
  The odds attribution the closes carry.
- `legs` array of object · required  
  One leg per selection, in ticket order.
  - `seq` integer · required  
    The leg's place on the ticket, from 1.
  - `selection` string · required  
    The selection as the person wrote it, such as Chiefs -3.
  - `market_kind` string · required  
    The kind of market.  
    One of: `spread`, `total`, `moneyline`, `prop`, `future`, `other` (open: new values may be added).
  - `sport` string · nullable  
    The sport, as given or from Kelly's game.
  - `league` string · nullable  
    The league, as given or from Kelly's game.
  - `side` string · nullable  
    The side (home, away, over, under), when known.
  - `line` number · nullable  
    The line the person took, such as -3 or 47.5.
  - `price_decimal` number · nullable  
    A parlay leg's own price, as decimal odds; null on a single, which takes the bet's price.
  - `game_id` string · nullable  
    Kelly's game, when matched.
  - `market_id` string · nullable  
    Kelly's market, when matched.
  - `selection_id` string · nullable  
    Kelly's selection, when matched.
  - `starts_at` string · nullable  
    The game's start, when matched.  
    format date-time
  - `result` string · required  
    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).
  - `close` object · required  
    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.
    - `price_decimal` null  
      The person's own book's last price before kick-off: a per-book price, shown on askkelly.ai only.
    - `line` null  
      The person's own book's last line before kick-off: shown on askkelly.ai only.
    - `market_decimal` number · nullable  
      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.
    - `source` string · nullable  
      Where the close came from.
    - `at` string · nullable  
      When Kelly recorded the close.  
      format date-time

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`payload_too_large`](/problems/payload_too_large) · [`not_found`](/problems/not_found)

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

{
  "status": "won"
}
```

```json
{
  "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 slip
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.

### Parameters
Body, `application/json` (required):

- `selection` string  
  What the bet is on, as the book shows it, e.g. Kansas City Chiefs -3.5.  
  min length 1 · max length 200
- `book` string  
  The book, e.g. DraftKings.  
  min length 1 · max length 80
- `price` object  
  The price you want. Exactly one of `{"american": -110}`, `{"decimal": 1.91}`, `{"fractional": "10/11"}` or `{"cents": 52}`.
- `worst_price` object  
  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_minor` integer  
  The stake, in minor units.  
  min 1
- `currency` string  
  ISO 4217; default USD.  
  pattern ^[A-Z]{3}$
- `url` string  
  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_kind` string  
  Default other.  
  One of: `spread`, `total`, `moneyline`, `prop`, `future`, `other` (open: new values may be added).
- `sport` string  
  The sport, e.g. nfl.  
  max length 40
- `side` string  
  home, away, over, under, yes, no or draw.  
  max length 40
- `line` number  
  The line, e.g. -3.5.
- `game_id` string  
  Kelly's game (gm_…).  
  pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `market_id` string  
  Kelly's market (mkt_…).  
  pattern ^mkt_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `selection_id` string  
  Kelly's selection (sel_…), which finds the book's own link.  
  pattern ^sel_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `via` string  
  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).
- `note` string  
  Your note on the bet once logged.  
  max length 500

### Response
`201` The slip, filled and waiting for your press on the book's page.

- `object` string  
  Always bet_slip.
- `id` string  
  The slip's ID (slip_…).
- `status` string  
  ready (the slip waits for the person's press) or price_moved (it shows a worse price than worst_price).
- `via` string  
  extension (the person's own browser) or hosted (Kelly's browser on their sign-in).
- `sportsbook` string  
  The book, as the person named it.
- `selection` string  
  What the bet is on.
- `stake_minor` integer  
  The stake, in minor units.
- `currency` string  
  ISO 4217.
- `price` object  
  The price asked for, as given.
- `worst_price` object  
  The worst price accepted, as given.
- `price_seen` string · nullable  
  The price the book's slip shows, as it shows it.
- `waits_until` string  
  Until when the browser watches for the book's receipt.  
  format date-time
- `next` string  
  What the person does next: press Place on the book's page.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`payload_too_large`](/problems/payload_too_large) · [`not_found`](/problems/not_found) · [`attestation_required`](/problems/attestation_required) · [`upstream_error`](/problems/upstream_error) · [`upstream_timeout`](/problems/upstream_timeout)

### Example
```http
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"
}
```

```json
{
  "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."
}
```

```http
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
  }
}
```

```json
{
  "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."
}
```

```http
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"
}
```

```json
{
  "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-ups
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.

### Parameters
Body, `application/json` (required):

- `books` array 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
- `state` string  
  Your US state, e.g. NJ or US-NJ; default the state saved on your account.  
  max length 20
- `url` string  
  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

### Response
`201` Each book's sign-up, filled in your browser and waiting for your press of Create account.

- `object` string  
  Always book_signups.
- `state` object · nullable  
  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.
- `data` array of object  
  One sign-up per book.
  - `object` string  
    Always book_signup.
  - `id` string · nullable  
    The sign-up's ID (signup_…); null when no tab was opened.
  - `sportsbook` string  
    The book's name.
  - `slug` string  
    The book's slug, as GET /v1/books lists it.
  - `status` string  
    filled (the form waits for the person), no_details, not_allowed, old_extension, no_form, no_page, load_failed or no_answer.
  - `filled` array of string  
    The kinds of field Kelly filled, e.g. given_name, email, birth_date.
  - `left` array of string  
    The kinds of field left for the person, e.g. password, ssn.
  - `promo_code` string · nullable  
    The welcome offer's code Kelly typed in, if it needs one.
  - `offer` object · nullable  
    The welcome offer in the person's state, as get_legal_books shows it.
  - `min_age` integer · nullable  
    The book's minimum age in the state.
  - `ssn` string · nullable  
    What the book asks of the Social Security number.
  - `id_check` string · nullable  
    When the book asks for a photo ID or selfie.
  - `next` string  
    What the person does next.
- `has_more` boolean  
  Always false: every book's sign-up is in data.
- `next_cursor` string · nullable  
  Always null.
- `waits_until` string · nullable  
  Until when the browser keeps filling each next step.  
  format date-time
- `next` string  
  What the person does next.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`payload_too_large`](/problems/payload_too_large) · [`not_found`](/problems/not_found) · [`upstream_error`](/problems/upstream_error) · [`upstream_timeout`](/problems/upstream_timeout)

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

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

```json
{
  "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."
}
```

```http
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/"
}
```

```json
{
  "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."
}
```

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

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

```json
{
  "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 results
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.

### Parameters
- `currency` string · query  
  The currency (ISO 4217); left out, the one with the most settled bets.  
  pattern ^[A-Z]{3}$
- `views` string · query  
  Comma list of summary, splits, series, streaks, bets; default summary.  
  max length 400
- `split_by` string · query  
  Comma list of project, sport, league, market, book, source, tag, analyst, month, week, day_of_week, price_band, stake_band.  
  max length 400
- `charts` string · query  
  Comma list of equity, underwater, funnel, forest, calendar, histogram, rolling, all (the default) or none.  
  max length 400
- `sort` string · 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"
- `window` integer · query  
  Bets in the rolling chart's window, 10 to 500.  
  min 10 · max 500 · default 50
- `tz` string · query  
  The IANA time zone days are counted in.  
  max length 64 · default "America/New_York"
- `start` string · query  
  Games on or after this day (in tz).  
  format date
- `end` string · query  
  Games on or before this day (in tz).  
  format date
- `sports` string · query  
  Comma list: only these sports.  
  max length 400
- `leagues` string · query  
  Comma list: only these leagues.  
  max length 400
- `markets` string · query  
  Comma list: only these markets.  
  max length 400
- `books` string · query  
  Comma list: only these books.  
  max length 400
- `tags` string · query  
  Comma list: only these tags.  
  max length 400
- `sources` string · query  
  Comma list: only these sources.  
  max length 400
- `projects` string · query  
  Comma list: only these projects.  
  max length 400

### Response
`200` Your results.

- `object` const · required  
  Always my_results.  
  Always `"my_results"`.
- `as_of` string · required  
  When Kelly worked it out.  
  format date-time
- `currency` string · required · nullable  
  The currency of every amount: the one asked for, else the one with the most settled bets; null with no bets.
- `currencies` array of object · required  
  Every currency in your bets: currency, bets and settled.
- `unit` object · nullable  
  One unit for the charts: size (the median stake of your settled bets, in major units) and basis.
- `tz` string · required  
  The time zone days, weeks and months are counted in.
- `bets_matched` integer · required  
  Bets the filters kept.
- `summary` object  
  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.
- `splits` object  
  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.
- `series` array of object  
  Profit by settle day: day, profit, settled, cumulative_profit and cumulative_clv_predicted.
- `streaks` object  
  Longest win and loss runs, the current run and the biggest drawdown with its peak, trough and recovery.
- `bet_ids` array of string  
  The matching bets' IDs, by game time.
- `charts` array of object · required  
  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.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled)

### Example
```http
GET https://api.askkelly.ai/v1/me/results?views=summary,splits&split_by=sport&charts=equity,forest
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "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.

---

Generated from Kelly API 2026-10-05

Support: support@askkelly.ai · Security and disclosure: https://docs.askkelly.ai/security

Data is the edge. Odds are information, not advice · 21+ · Get help
