# calculations

Run betting and fantasy maths on your own numbers: odds, no-vig, value, parlays, hedges, stakes and records.

| Method | Path | Title | Access | Price | MCP tool |
| --- | --- | --- | --- | --- | --- |
| GET | [`/v1/calculations`](#list-calculations) | List calculations | public | 1 | none |
| GET | [`/v1/calculations/{calc}`](#get-calculation) | Get a calculation | public | 1 | none |
| POST | [`/v1/calculations/convert_odds:evaluate`](#evaluate-convert-odds) | Calculate: Convert odds | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/remove_vig:evaluate`](#evaluate-remove-vig) | Calculate: Remove the vig | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/bet_value:evaluate`](#evaluate-bet-value) | Calculate: Bet value | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/spread_and_total:evaluate`](#evaluate-spread-and-total) | Calculate: Spread, moneyline and totals | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/half_point_value:evaluate`](#evaluate-half-point-value) | Calculate: Half-point value | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/alternate_lines:evaluate`](#evaluate-alternate-lines) | Calculate: Alternate lines | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/prop_probability:evaluate`](#evaluate-prop-probability) | Calculate: Prop probability | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/futures_board:evaluate`](#evaluate-futures-board) | Calculate: Futures board | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/betting_splits:evaluate`](#evaluate-betting-splits) | Calculate: Betting splits | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/parlay:evaluate`](#evaluate-parlay) | Calculate: Parlay | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/correlated_parlay:evaluate`](#evaluate-correlated-parlay) | Calculate: Correlated parlay | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/teaser:evaluate`](#evaluate-teaser) | Calculate: Teaser | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/arbitrage:evaluate`](#evaluate-arbitrage) | Calculate: Arbitrage | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/middle:evaluate`](#evaluate-middle) | Calculate: Middle | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/hedge:evaluate`](#evaluate-hedge) | Calculate: Hedge | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/cash_out:evaluate`](#evaluate-cash-out) | Calculate: Cash-out value | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/bonus_bet:evaluate`](#evaluate-bonus-bet) | Calculate: Bonus bets | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/stake_size:evaluate`](#evaluate-stake-size) | Calculate: Stake size | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/bankroll_risk:evaluate`](#evaluate-bankroll-risk) | Calculate: Bankroll risk | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/closing_line_value:evaluate`](#evaluate-closing-line-value) | Calculate: Closing-line value | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/record_test:evaluate`](#evaluate-record-test) | Calculate: Record test | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/after_tax_break_even:evaluate`](#evaluate-after-tax-break-even) | Calculate: After-tax break-even | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/gambling_tax:evaluate`](#evaluate-gambling-tax) | Calculate: Gambling tax | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/regression_to_mean:evaluate`](#evaluate-regression-to-mean) | Calculate: Regression to the mean | public | 1 | `calculate_odds` |
| POST | [`/v1/calculations/pickem_entry:evaluate`](#evaluate-pickem-entry) | Calculate: Pick'em entry | public | 1 | `calculate_odds` |

`GET /v1/calculations`

## List calculations
public, no key needed · 1 credit, not charged during the beta · status live

Every calculation in catalogue order, with its family, status (the session that ships it and the nearest that works now, while it is not available), formula cards, stake policy, cost and evaluate route. Filter by `family` or `status`. One page holds them all.

### Parameters
- `family` string · query  
  Only this family.  
  One of: `prices_and_markets`, `combinations`, `positions_and_promotions`, `bankroll_records_forecasts`, `fantasy`, `contests_and_pools`, `long_tail` (open: new values may be added).
- `status` string · query  
  available or not_available.  
  One of: `available`, `not_available` (open: new values may be added).

### Response
`200` The calculations, in catalogue order.

- `object` const · required  
  Always calculation_list.  
  Always `"calculation_list"`.
- `count` integer · required  
  How many calculations match.
- `families` array of string · required  
  The families, in catalogue order.
- `data` array of object · required  
  The calculations.
  - `name` string · required  
    Its name, as the evaluate path and calculate_odds' `calc` spell it (bet_value).
  - `title` string · required  
    Its title (Bet value).
  - `family` string · required  
    Its family in the catalogue.  
    One of: `prices_and_markets`, `combinations`, `positions_and_promotions`, `bankroll_records_forecasts`, `fantasy`, `contests_and_pools`, `long_tail` (open: new values may be added).
  - `status` string · required  
    available, or not_available (listed, answering calc_not_available until it ships).  
    One of: `available`, `not_available` (open: new values may be added).
  - `session` string · nullable  
    The build session that ships it, while it is not available.
  - `nearest` string · nullable  
    The nearest calculation that works now, while it is not available.
  - `formulas` array of string · required  
    The formula cards it implements, with their versions (F1.4@1).
  - `stake_policy` string · required  
    none; price_arithmetic (stakes fixed by your own tickets, returned everywhere); or person_probability (a stake sized from a probability: only on Kelly's own site, signed in, and null here, D34).  
    One of: `none`, `price_arithmetic`, `person_probability` (open: new values may be added).
  - `simulates` string · nullable  
    Whether it simulates: optional, bootstrap or yes; null when it never does.
  - `credits` integer · required  
    Credits per call.
  - `credit_unit` const  
    What the credits are per: always call.  
    Always `"call"`.
  - `operation_id` string · required  
    Its evaluate operation (evaluate_bet_value).
  - `evaluate` string · required  
    Its evaluate route, method and path.
- `has_more` boolean · required  
  Always false: the list is never paged (API-PAGE-1).
- `next_cursor` string · required · nullable  
  Always null: the list is never paged (API-PAGE-1).
- `as_of` string  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

### 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/calculations?status=available
```

```json
{
  "object": "calculation_list",
  "count": 25,
  "families": [
    "prices_and_markets",
    "combinations",
    "positions_and_promotions",
    "bankroll_records_forecasts",
    "fantasy",
    "contests_and_pools",
    "long_tail"
  ],
  "data": [
    {
      "name": "convert_odds",
      "title": "Convert odds",
      "family": "prices_and_markets",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F1.1@1",
        "F1.2@1",
        "F1.3@1",
        "F1.4@1",
        "F1.5@1",
        "F1.6@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_convert_odds",
      "evaluate": "POST /v1/calculations/convert_odds:evaluate"
    },
    {
      "name": "remove_vig",
      "title": "Remove the vig",
      "family": "prices_and_markets",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F1.7@1",
        "F1.8@1",
        "F1.10@1",
        "F2.1@1",
        "F2.2@1",
        "F2.3@1",
        "F2.4@1",
        "F2.5@1",
        "F2.6@1",
        "F2.7@1",
        "F2.8@1",
        "F2.9@1",
        "F2.10@1",
        "F2.11@1",
        "F2.12@1",
        "F2.13@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_remove_vig",
      "evaluate": "POST /v1/calculations/remove_vig:evaluate"
    },
    {
      "name": "bet_value",
      "title": "Bet value",
      "family": "prices_and_markets",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F1.4@1",
        "F3.1@1",
        "F3.3@1",
        "F3.4@1",
        "F3.5@1",
        "F2.1@1",
        "F2.2@1",
        "F2.4@1",
        "F2.6@1",
        "F2.8@1",
        "F2.9@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_bet_value",
      "evaluate": "POST /v1/calculations/bet_value:evaluate"
    },
    {
      "name": "spread_and_total",
      "title": "Spread, moneyline and totals",
      "family": "prices_and_markets",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F4.1@1",
        "F4.2@1",
        "F4.3@1",
        "F4.4@1",
        "F4.5@1",
        "F4.12@1",
        "F4.13@1",
        "F4.14@1",
        "F4.15@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_spread_and_total",
      "evaluate": "POST /v1/calculations/spread_and_total:evaluate"
    },
    {
      "name": "half_point_value",
      "title": "Half-point value",
      "family": "prices_and_markets",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F4.6@1",
        "F4.7@1",
        "F4.8@1",
        "F4.9@1",
        "F4.11@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_half_point_value",
      "evaluate": "POST /v1/calculations/half_point_value:evaluate"
    },
    {
      "name": "alternate_lines",
      "title": "Alternate lines",
      "family": "prices_and_markets",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F4.10@1",
        "F19.12@1",
        "F36.5@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_alternate_lines",
      "evaluate": "POST /v1/calculations/alternate_lines:evaluate"
    },
    {
      "name": "prop_probability",
      "title": "Prop probability",
      "family": "prices_and_markets",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F19.1@1",
        "F19.2@1",
        "F19.3@1",
        "F19.4@1",
        "F19.5@1",
        "F19.6@1",
        "F19.7@1",
        "F19.8@1",
        "F19.9@1",
        "F19.10@1",
        "F19.11@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_prop_probability",
      "evaluate": "POST /v1/calculations/prop_probability:evaluate"
    },
    {
      "name": "futures_board",
      "title": "Futures board",
      "family": "prices_and_markets",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F8.1@1",
        "F8.2@1",
        "F8.3@1",
        "F8.5@1",
        "F8.6@1",
        "F9.4@1",
        "F9.5@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_futures_board",
      "evaluate": "POST /v1/calculations/futures_board:evaluate"
    },
    {
      "name": "betting_splits",
      "title": "Betting splits",
      "family": "prices_and_markets",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F1.12@1",
        "F1.7@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_betting_splits",
      "evaluate": "POST /v1/calculations/betting_splits:evaluate"
    },
    {
      "name": "parlay",
      "title": "Parlay",
      "family": "combinations",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F1.11@1",
        "F5.1@1",
        "F5.2@1",
        "F5.3@1",
        "F5.6@1",
        "F5.7@1",
        "F5.8@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_parlay",
      "evaluate": "POST /v1/calculations/parlay:evaluate"
    },
    {
      "name": "correlated_parlay",
      "title": "Correlated parlay",
      "family": "combinations",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F5.4@1",
        "F5.5@1",
        "F10.13@1"
      ],
      "stake_policy": "person_probability",
      "simulates": "optional",
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_correlated_parlay",
      "evaluate": "POST /v1/calculations/correlated_parlay:evaluate"
    },
    {
      "name": "teaser",
      "title": "Teaser",
      "family": "combinations",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F5.9@1",
        "F5.10@1",
        "F5.11@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_teaser",
      "evaluate": "POST /v1/calculations/teaser:evaluate"
    },
    {
      "name": "arbitrage",
      "title": "Arbitrage",
      "family": "positions_and_promotions",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F6.1@1",
        "F6.2@1"
      ],
      "stake_policy": "price_arithmetic",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_arbitrage",
      "evaluate": "POST /v1/calculations/arbitrage:evaluate"
    },
    {
      "name": "middle",
      "title": "Middle",
      "family": "positions_and_promotions",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F6.3@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_middle",
      "evaluate": "POST /v1/calculations/middle:evaluate"
    },
    {
      "name": "hedge",
      "title": "Hedge",
      "family": "positions_and_promotions",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F6.4@1",
        "F6.5@1",
        "F6.6@1",
        "F6.7@1",
        "F6.8@1"
      ],
      "stake_policy": "price_arithmetic",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_hedge",
      "evaluate": "POST /v1/calculations/hedge:evaluate"
    },
    {
      "name": "cash_out",
      "title": "Cash-out value",
      "family": "positions_and_promotions",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F6.9@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_cash_out",
      "evaluate": "POST /v1/calculations/cash_out:evaluate"
    },
    {
      "name": "bonus_bet",
      "title": "Bonus bets",
      "family": "positions_and_promotions",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F6.10@1",
        "F6.11@1",
        "F6.12@1",
        "F6.13@1",
        "F6.14@1",
        "F6.15@1",
        "F6.16@1"
      ],
      "stake_policy": "price_arithmetic",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_bonus_bet",
      "evaluate": "POST /v1/calculations/bonus_bet:evaluate"
    },
    {
      "name": "stake_size",
      "title": "Stake size",
      "family": "bankroll_records_forecasts",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F10.1@1",
        "F10.2@1",
        "F10.3@1",
        "F10.4@1",
        "F10.5@1",
        "F10.6@1",
        "F10.7@1",
        "F10.8@1",
        "F10.9@1",
        "F10.10@1",
        "F10.11@1",
        "F10.12@1",
        "F10.13@1",
        "F10.14@1",
        "F10.15@1",
        "F10.16@1",
        "F10.17@1",
        "F10.18@1",
        "F10.19@1",
        "F11.1@1",
        "F11.3@1",
        "F11.4@1",
        "F36.3@1",
        "F36.4@1"
      ],
      "stake_policy": "person_probability",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_stake_size",
      "evaluate": "POST /v1/calculations/stake_size:evaluate"
    },
    {
      "name": "bankroll_risk",
      "title": "Bankroll risk",
      "family": "bankroll_records_forecasts",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F11.1@1",
        "F11.2@1",
        "F11.3@1",
        "F11.4@1",
        "F11.5@1",
        "F11.6@1",
        "F11.7@1",
        "F11.8@1",
        "F11.9@1",
        "F11.10@1",
        "F11.11@1",
        "F11.12@1",
        "F11.13@1",
        "F11.14@1",
        "F14.1@1",
        "F14.2@1",
        "F14.3@1"
      ],
      "stake_policy": "none",
      "simulates": "optional",
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_bankroll_risk",
      "evaluate": "POST /v1/calculations/bankroll_risk:evaluate"
    },
    {
      "name": "closing_line_value",
      "title": "Closing-line value",
      "family": "bankroll_records_forecasts",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F3.6@1",
        "F3.7@1",
        "F3.8@1",
        "F3.9@1",
        "F12.7@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_closing_line_value",
      "evaluate": "POST /v1/calculations/closing_line_value:evaluate"
    },
    {
      "name": "record_test",
      "title": "Record test",
      "family": "bankroll_records_forecasts",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F3.2@1",
        "F12.1@1",
        "F12.2@1",
        "F12.3@1",
        "F12.4@1",
        "F12.5@1",
        "F12.6@1",
        "F12.7@1",
        "F12.8@1",
        "F12.9@1",
        "F12.10@1",
        "F12.11@1",
        "F12.12@1",
        "F12.13@1",
        "F12.14@1",
        "F36.1@1",
        "F36.2@1"
      ],
      "stake_policy": "none",
      "simulates": "bootstrap",
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_record_test",
      "evaluate": "POST /v1/calculations/record_test:evaluate"
    },
    {
      "name": "after_tax_break_even",
      "title": "After-tax break-even",
      "family": "bankroll_records_forecasts",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F14.7@1",
        "F14.8@1",
        "F14.9@1",
        "F14.10@1",
        "F14.11@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_after_tax_break_even",
      "evaluate": "POST /v1/calculations/after_tax_break_even:evaluate"
    },
    {
      "name": "gambling_tax",
      "title": "Gambling tax",
      "family": "bankroll_records_forecasts",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F14.7@1",
        "F14.9@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_gambling_tax",
      "evaluate": "POST /v1/calculations/gambling_tax:evaluate"
    },
    {
      "name": "regression_to_mean",
      "title": "Regression to the mean",
      "family": "fantasy",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F17.1@1",
        "F17.2@1",
        "F17.3@1",
        "F17.4@1",
        "F17.5@1"
      ],
      "stake_policy": "none",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_regression_to_mean",
      "evaluate": "POST /v1/calculations/regression_to_mean:evaluate"
    },
    {
      "name": "pickem_entry",
      "title": "Pick'em entry",
      "family": "contests_and_pools",
      "status": "available",
      "session": null,
      "nearest": null,
      "formulas": [
        "F33.1@1",
        "F33.2@1",
        "F33.3@1",
        "F33.4@1",
        "F33.5@1",
        "F33.6@1",
        "F33.7@1",
        "F33.8@1"
      ],
      "stake_policy": "person_probability",
      "simulates": null,
      "credits": 1,
      "credit_unit": "call",
      "operation_id": "evaluate_pickem_entry",
      "evaluate": "POST /v1/calculations/pickem_entry:evaluate"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "as_of": "2026-11-12T00:00:00Z",
  "source": "kelly",
  "attribution": null,
  "request_id": "req_dad0e7357ed9cb3e716b8a3b",
  "live_topics": [],
  "rg_line": null
}
```

Where each value comes from:

1. kelly · as of 2026-11-12T00:00:00Z

`GET /v1/calculations/{calc}`

## Get a calculation
public, no key needed · 1 credit, not charged during the beta · status live

One calculation's input and result schemas, its formula cards' worked examples, its cost and status. Each example's inputs are a body its evaluate route takes as they stand.

### Parameters
- `calc` string · path · required  
  The calculation's name (bet_value).  
  One of: `convert_odds`, `remove_vig`, `bet_value`, `spread_and_total`, `half_point_value`, `alternate_lines`, `prop_probability`, `futures_board`, `betting_splits`, `soccer_markets`, `dead_heat_each_way`, `exchange_fees`, `parlay`, `correlated_parlay`, `teaser`, `arbitrage`, `middle`, `hedge`, `cash_out`, `bonus_bet`, `stake_size`, `bankroll_risk`, `closing_line_value`, `record_test`, `forecast_score`, `forecast_blend`, `after_tax_break_even`, `gambling_tax`, `head_to_head`, `faab_bid`, `auction_inflation`, `regression_to_mean`, `contest_entry`, `pickem_entry`, `survivor_pool`, `pickem_pool`, `bracket_pool`, `calcutta`, `ats_contest` (open: new values may be added).

### Response
`200` The calculation.

- `object` const · required  
  Always calculation.  
  Always `"calculation"`.
- `name` string · required  
  Its name, as the evaluate path and calculate_odds' `calc` spell it (bet_value).
- `title` string · required  
  Its title (Bet value).
- `family` string · required  
  Its family in the catalogue.  
  One of: `prices_and_markets`, `combinations`, `positions_and_promotions`, `bankroll_records_forecasts`, `fantasy`, `contests_and_pools`, `long_tail` (open: new values may be added).
- `status` string · required  
  available, or not_available (listed, answering calc_not_available until it ships).  
  One of: `available`, `not_available` (open: new values may be added).
- `session` string · nullable  
  The build session that ships it, while it is not available.
- `nearest` string · nullable  
  The nearest calculation that works now, while it is not available.
- `formulas` array of string · required  
  The formula cards it implements, with their versions (F1.4@1).
- `stake_policy` string · required  
  none; price_arithmetic (stakes fixed by your own tickets, returned everywhere); or person_probability (a stake sized from a probability: only on Kelly's own site, signed in, and null here, D34).  
  One of: `none`, `price_arithmetic`, `person_probability` (open: new values may be added).
- `simulates` string · nullable  
  Whether it simulates: optional, bootstrap or yes; null when it never does.
- `credits` integer · required  
  Credits per call.
- `credit_unit` const  
  What the credits are per: always call.  
  Always `"call"`.
- `operation_id` string · required  
  Its evaluate operation (evaluate_bet_value).
- `evaluate` string · required  
  Its evaluate route, method and path.
- `input_schema` object · required  
  The request body evaluate takes, as JSON Schema 2020-12.
- `result_schema` object · required  
  The calculation_result evaluate returns, as JSON Schema 2020-12.
- `examples` array of object · required  
  Worked examples, each a body you can send.
  - `title` string · required  
    What it shows, with its answer.
  - `card` string · required  
    The formula card it comes from (F14.7).
  - `inputs` object · required  
    A request body evaluate takes as it stands.
- `as_of` string  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.

### 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/calculations/gambling_tax
```

```json
{
  "object": "calculation",
  "name": "gambling_tax",
  "title": "Gambling tax",
  "family": "bankroll_records_forecasts",
  "status": "available",
  "session": null,
  "nearest": null,
  "formulas": [
    "F14.7@1",
    "F14.9@1"
  ],
  "stake_policy": "none",
  "simulates": null,
  "credits": 1,
  "credit_unit": "call",
  "operation_id": "evaluate_gambling_tax",
  "evaluate": "POST /v1/calculations/gambling_tax:evaluate",
  "input_schema": {
    "type": "object",
    "properties": {
      "winnings_minor": {
        "type": "integer",
        "minimum": 0,
        "description": "The year's gross winnings: the profit on every winning bet."
      },
      "losses_minor": {
        "type": "integer",
        "minimum": 0,
        "description": "The year's gross losses: the stakes on every losing bet."
      },
      "tax_year": {
        "type": "integer",
        "description": "The tax year, which sets the share of losses deductible.",
        "minimum": 2000,
        "maximum": 2100
      },
      "federal_rate": {
        "type": "number",
        "minimum": 0,
        "maximum": 1,
        "description": "The person's federal marginal rate."
      },
      "itemizer": {
        "type": "boolean",
        "default": true,
        "description": "Whether the person itemizes."
      },
      "state_rate": {
        "type": "number",
        "minimum": 0,
        "maximum": 1,
        "default": 0,
        "description": "The person's state rate on gambling income."
      },
      "state_deducts_losses": {
        "type": "boolean",
        "description": "Whether the state lets losses come off. Left out, the state tax is on all winnings and a warning says the rule is unknown."
      },
      "withheld_minor": {
        "type": "integer",
        "minimum": 0,
        "description": "Tax already withheld, such as on W-2Gs."
      },
      "currency": {
        "type": "string",
        "pattern": "^[A-Z]{3}$",
        "default": "USD",
        "description": "ISO 4217 currency code."
      }
    },
    "additionalProperties": false,
    "required": [
      "winnings_minor",
      "losses_minor",
      "tax_year",
      "federal_rate"
    ]
  },
  "result_schema": {
    "type": "object",
    "x-kelly-object": "calculation_result",
    "properties": {
      "object": {
        "type": "string",
        "const": "calculation_result",
        "description": "Always calculation_result."
      },
      "calc": {
        "type": "string",
        "const": "gambling_tax",
        "description": "The calculation."
      },
      "result": {
        "type": "object",
        "description": "The calculation's numbers",
        "properties": {
          "winnings_minor": {
            "type": "integer",
            "description": "Gross winnings. In minor units."
          },
          "losses_minor": {
            "type": "integer",
            "description": "Gross losses. In minor units."
          },
          "net_result_minor": {
            "type": "integer",
            "description": "Winnings minus losses: what was actually won. In minor units."
          },
          "loss_cap": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "The share of losses deductible in the tax year."
          },
          "deduction_minor": {
            "type": "integer",
            "description": "The losses deducted: the lower of the capped losses and the winnings. In minor units."
          },
          "taxable_minor": {
            "type": "integer",
            "description": "Taxable gambling income, federal. In minor units."
          },
          "taxed_not_won_minor": {
            "type": "integer",
            "description": "Taxable income beyond what was actually won (the loss cap's cost). In minor units."
          },
          "federal_tax_minor": {
            "type": "integer",
            "description": "Federal tax at the person's rate. In minor units."
          },
          "state_taxable_minor": {
            "type": "integer",
            "description": "The income the state rate applies to. In minor units."
          },
          "state_tax_minor": {
            "type": "integer",
            "description": "State tax at the person's rate. In minor units."
          },
          "total_tax_minor": {
            "type": "integer",
            "description": "Federal and state tax. In minor units."
          },
          "after_tax_minor": {
            "type": "integer",
            "description": "Winnings minus losses minus the tax. In minor units."
          },
          "withheld_minor": {
            "type": "integer",
            "description": "Tax already withheld. In minor units."
          },
          "set_aside_minor": {
            "type": "integer",
            "description": "The tax still to pay: the total less what was withheld, never below zero. In minor units."
          },
          "currency": {
            "type": "string",
            "description": "ISO 4217 currency code."
          }
        },
        "additionalProperties": false,
        "required": [
          "taxable_minor",
          "total_tax_minor"
        ]
      },
      "inputs_used": {
        "type": "array",
        "description": "Every input given, in the order given, with its source",
        "items": {
          "type": "object",
          "description": "One input",
          "properties": {
            "name": {
              "type": "string",
              "description": "The input's name."
            },
            "value": {
              "description": "The value used, as given."
            },
            "source": {
              "type": "string",
              "enum": [
                "person",
                "market",
                "kelly"
              ],
              "description": "Who supplied it: person, market or kelly."
            }
          },
          "additionalProperties": false,
          "required": [
            "name",
            "value",
            "source"
          ]
        }
      },
      "method_params": {
        "type": "object",
        "description": "Solved method parameters, such as power_k",
        "additionalProperties": {
          "type": "number"
        }
      },
      "diagnostics": {
        "type": "object",
        "description": "Solver diagnostics (iterations, converged)",
        "additionalProperties": {
          "type": [
            "number",
            "boolean"
          ]
        }
      },
      "warnings": {
        "type": "array",
        "description": "Warning codes",
        "items": {
          "type": "string"
        }
      },
      "formulas": {
        "type": "array",
        "description": "Formula cards used",
        "items": {
          "type": "string",
          "pattern": "^F[0-9]+\\.[0-9]+@[0-9]+$"
        }
      },
      "engine_build": {
        "type": "string",
        "description": "The engine build that computed it."
      },
      "api_version": {
        "type": [
          "string",
          "null"
        ],
        "description": "The API version that served it (set by the surface, K10)."
      },
      "rg_line": {
        "type": [
          "string",
          "null"
        ],
        "description": "The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine."
      },
      "assumptions": {
        "type": "array",
        "description": "Defaults applied",
        "items": {
          "type": "string"
        }
      },
      "as_of": {
        "type": "string",
        "format": "date-time",
        "x-kelly-rights": "envelope.as_of",
        "description": "When it was computed (UTC)."
      },
      "source": {
        "type": "string",
        "x-kelly-rights": "envelope.source",
        "description": "Who computed it, as shown to readers."
      },
      "attribution": {
        "type": [
          "string",
          "null"
        ],
        "x-kelly-rights": "envelope.attribution",
        "description": "Attribution the source's terms require."
      },
      "request_id": {
        "type": [
          "string",
          "null"
        ],
        "x-kelly-rights": "envelope.request_id",
        "description": "The request that produced this response."
      },
      "live_topics": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "x-kelly-rights": "envelope.live_topics",
        "description": "Kelly Wire topics that update this resource (API and cards only)."
      }
    },
    "required": [
      "object",
      "calc",
      "result",
      "inputs_used",
      "method_params",
      "warnings",
      "formulas",
      "engine_build",
      "assumptions"
    ],
    "additionalProperties": false
  },
  "examples": [
    {
      "title": "$25,000 won, $22,000 lost in 2026, itemizing at 24% and 5%: taxed on $5,200, $1,508 tax",
      "card": "F14.7",
      "inputs": {
        "winnings_minor": 2500000,
        "losses_minor": 2200000,
        "tax_year": 2026,
        "federal_rate": 0.24,
        "state_rate": 0.05,
        "state_deducts_losses": true
      }
    },
    {
      "title": "$10,000 won, $9,000 lost on the standard deduction at 22%: $2,200 tax",
      "card": "F14.9",
      "inputs": {
        "winnings_minor": 1000000,
        "losses_minor": 900000,
        "tax_year": 2026,
        "federal_rate": 0.22,
        "itemizer": false
      }
    }
  ],
  "as_of": "2026-11-12T00:00:00Z",
  "source": "kelly",
  "attribution": null,
  "request_id": "req_b5fdf275dc4007ad7789a0cf",
  "live_topics": [],
  "rg_line": null
}
```

Where each value comes from:

1. kelly · as of 2026-11-12T00:00:00Z

```http
GET https://api.askkelly.ai/v1/calculations/vlookup
```

```json
{
  "type": "https://docs.askkelly.ai/problems/not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "No calculation named vlookup; GET /v1/calculations lists them.",
  "param": "calc",
  "doc_url": "https://docs.askkelly.ai/problems/not_found",
  "request_id": "req_1ac43b5cdba7030590955e08",
  "retryable": false,
  "display_message": "That could not be found."
}
```

`POST /v1/calculations/convert_odds:evaluate`

## Calculate: Convert odds
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the convert odds calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `price` object  
  The price to convert.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `probability` number  
  A probability to price fairly (F1.5).
- `ticket_stake_minor` integer  
  A ticket's stake, for what it returns.  
  min 0
- `currency` string  
  ISO 4217 currency code.  
  pattern ^[A-Z]{3}$ · default "USD"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"convert_odds"`.
- `result` object · required  
  The calculation's numbers
  - `price` object  
    The price in every format
    - `american` number  
      American odds.
    - `decimal` number  
      Decimal odds.
    - `fractional` string  
      Fractional odds, nearest ladder fraction.
    - `cents` number  
      Contract price in cents per $1.
    - `implied_prob` number  
      Implied probability, 1 / decimal.  
      min 0 · max 1
  - `implied_prob` number  
    Implied probability at the price, vig in.  
    min 0 · max 1
  - `break_even` number  
    Break-even win rate at the price.  
    min 0 · max 1
  - `profit_per_unit` number  
    Profit on a winning stake of 1, O − 1 (0.9091 at −110).
  - `to_win_100` object  
    The bet that wins 100 in the currency (a bet of 110 at −110 wins 100)
    - `risk_minor` integer  
      The bet that wins 100. In minor units.
    - `profit_minor` integer  
      The profit, 100. In minor units.
  - `fair_price` object  
    The fair price for the probability
    - `decimal` number  
      Decimal odds.
    - `american` number  
      American odds.
  - `payout` object  
    What a winning ticket returns
    - `return_minor` integer  
      Total return, stake included. In minor units.
    - `profit_minor` integer  
      Profit. In minor units.
    - `currency` string  
      ISO 4217 currency code.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "price": {
    "american": -110
  }
}
```

```json
{
  "object": "calculation_result",
  "calc": "convert_odds",
  "result": {
    "price": {
      "american": -110,
      "decimal": 1.9090909090909092,
      "fractional": "10/11",
      "cents": 52.381,
      "implied_prob": 0.5238095238095238
    },
    "implied_prob": 0.5238095238095238,
    "break_even": 0.5238095238095238,
    "profit_per_unit": 0.9090909090909092,
    "to_win_100": {
      "risk_minor": 11000,
      "profit_minor": 10000
    }
  },
  "inputs_used": [
    {
      "name": "price",
      "value": {
        "american": -110
      },
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F1.1@1",
    "F1.4@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_caac054a2c94fd3c714ee1da",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/remove_vig:evaluate`

## Calculate: Remove the vig
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the remove the vig calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `prices` object  
  Every outcome's price, by name.
- `devig_method` string  
  De-vig method.  
  One of: `multiplicative`, `additive`, `power`, `shin`, `odds_ratio`, `probit`, `worst_case`, `balanced_books`, `jensen_shannon`, `ooepc` (open: new values may be added).  
  default "power"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"remove_vig"`.
- `result` object · required  
  The calculation's numbers
  - `fair_probs` object · required  
    Fair probability by outcome, in the order given
  - `implied_probs` object  
    Implied probability by outcome at the price given, vig in
  - `fair_prices` object  
    Fair price by outcome, the price with the vig removed; null for an outcome the method prices at zero
  - `side_hold` object  
    Each outcome's own hold: the share of its price that is vig
  - `cost_per_100_minor` object  
    What $100 on each outcome gives up on average at its fair probability, in cents
  - `method_range` object  
    Each outcome's fair probability, lowest and highest across the distinct de-vig methods
  - `booksum` number  
    Sum of implied probabilities.
  - `overround` number  
    Booksum minus 1.
  - `hold` number · required  
    The books' hold, 1 - 1/booksum.
  - `kept_per_100_minor` integer  
    What the book keeps of every $100 bet on the market when the action pays the same whichever side wins, in cents.
  - `by_method` object · nullable  
    Worst case: fair probabilities by method
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `devig_method` string · nullable  
  De-vig method behind the fair probabilities.
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "prices": {
    "fav": {
      "american": -150
    },
    "dog": {
      "american": 130
    }
  },
  "devig_method": "power"
}
```

```json
{
  "object": "calculation_result",
  "calc": "remove_vig",
  "result": {
    "fair_probs": {
      "fav": 0.5839826350363595,
      "dog": 0.4160173649636405
    },
    "booksum": 1.0347826086956524,
    "overround": 0.03478260869565242,
    "hold": 0.033613445378151474,
    "implied_probs": {
      "fav": 0.6000000000000001,
      "dog": 0.4347826086956522
    },
    "fair_prices": {
      "fav": {
        "decimal": 1.7123796839228598,
        "american": -140.37458150031765
      },
      "dog": {
        "decimal": 2.4037458150031767,
        "american": 140.37458150031767
      }
    },
    "side_hold": {
      "fav": 0.026695608272734206,
      "dog": 0.04316006058362687
    },
    "cost_per_100_minor": {
      "fav": 267,
      "dog": 432
    },
    "kept_per_100_minor": 336,
    "method_range": {
      "fav": {
        "low_prob": 0.5798319327731092,
        "high_prob": 0.5839826350363595,
        "price_at_low": {
          "decimal": 1.7246376811594204,
          "american": -137.99999999999997
        },
        "price_at_high": {
          "decimal": 1.7123796839228598,
          "american": -140.37458150031765
        }
      },
      "dog": {
        "low_prob": 0.4160173649636405,
        "high_prob": 0.4201680672268907,
        "price_at_low": {
          "decimal": 2.4037458150031767,
          "american": 140.37458150031767
        },
        "price_at_high": {
          "decimal": 2.3800000000000003,
          "american": 138.00000000000003
        }
      }
    },
    "by_method": null
  },
  "inputs_used": [
    {
      "name": "prices",
      "value": {
        "fav": {
          "american": -150
        },
        "dog": {
          "american": 130
        }
      },
      "source": "person"
    },
    {
      "name": "devig_method",
      "value": "power",
      "source": "person"
    }
  ],
  "devig_method": "power",
  "method_params": {
    "power_k": 1.052969949231005
  },
  "diagnostics": {
    "iterations": 61,
    "converged": true
  },
  "warnings": [],
  "formulas": [
    "F1.5@1",
    "F1.7@1",
    "F2.4@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_3941baca317af885cb036a72",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/bet_value:evaluate`

## Calculate: Bet value
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the bet value calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `price` object  
  The price the person is offered.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `selection` string  
  The outcome bet, a key of reference_prices.
- `reference_prices` object  
  A market's prices to take the fair probability from.
- `fair_prob` number  
  The person's own fair probability, instead of reference prices.
- `devig_method` string  
  De-vig method.  
  One of: `multiplicative`, `additive`, `power`, `shin`, `odds_ratio`, `probit`, `worst_case`, `balanced_books`, `jensen_shannon`, `ooepc`, `auto` (open: new values may be added).  
  default "worst_case"
- `push_prob` number  
  Probability of a push.  
  min 0
- `required_edge` number  
  Edge per unit the minimum price must leave.  
  min 0 · default 0

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"bet_value"`.
- `result` object · required  
  The calculation's numbers
  - `selection` string · nullable  
    The outcome bet.
  - `fair_prob` number · required  
    Fair probability of the outcome.  
    min 0 · max 1
  - `fair_method` string · nullable  
    The de-vig method that gave the fair probability.
  - `break_even` number · required  
    Break-even win rate at the price.  
    min 0 · max 1
  - `ev_per_unit` number · required  
    Expected value per unit staked.
  - `prob_over_break_even` number  
    Fair probability minus the break-even.
  - `min_price` object  
    The lowest price worth taking
    - `decimal` number  
      Decimal odds.
    - `american` number  
      American odds.
  - `reference_hold` number · nullable  
    Hold of the reference market.
  - `by_method` object · nullable  
    Fair probability by de-vig method
  - `ev_by_method` object · nullable  
    Expected value per unit by de-vig method
  - `ev_profile` object · nullable  
    What the EV means on the person's own numbers, per $100 staked (kmath.ev); null on a consensus reference
    - `ev_per_unit` number  
      Expected value per unit staked.
    - `ev_per_100_minor` integer  
      Expected profit per $100 bet, in cents.
    - `win_profit_per_100_minor` integer  
      What a winning $100 bet makes, in cents.
    - `break_even` number  
      Break-even win rate at the price.  
      min 0 · max 1
    - `win_prob_no_push` number  
      The win rate when the bet doesn't push.  
      min 0 · max 1
    - `edge` number  
      The win rate minus the break-even, in probability: how far it can fall before the EV is zero.
    - `outcomes` array of object  
      Each way the bet settles
      - `outcome` string  
        win, loss or push.  
        One of: `win`, `loss`, `push` (open: new values may be added).
      - `prob` number  
        Its chance.  
        min 0 · max 1
      - `per_100_minor` integer  
        What $100 makes or loses on it, in cents.
      - `contribution_minor` integer  
        Its share of the EV per $100 (chance × amount), in cents.
    - `sd_per_100_minor` integer  
      Standard deviation of one $100 bet's result, in cents.
    - `runs` array of object  
      Profit over runs of $100 bets
      - `bets` integer  
        Bets.  
        min 1
      - `mean_minor` integer  
        Expected profit, in cents.
      - `p10_minor` integer  
        10th percentile profit, in cents.
      - `p90_minor` integer  
        90th percentile profit, in cents.
      - `prob_profit` number  
        Chance of finishing ahead.  
        min 0 · max 1
      - `prob_loss` number  
        Chance of finishing behind.  
        min 0 · max 1
      - `prob_even` number  
        Chance of finishing exactly even.  
        min 0 · max 1
    - `ev_by_win_rate` array of object  
      EV per unit at each whole win rate around the break-even, the person's own in its place
      - `win_rate` number  
        The win rate.  
        min 0 · max 1
      - `ev_per_unit` number  
        Expected value per unit staked.
      - `yours` boolean  
        The person's own win rate.
    - `price_ladder` array of object  
      EV per unit at the neighbouring American prices at this win rate
      - `american` number  
        American odds.
      - `ev_per_unit` number  
        Expected value per unit staked.
      - `asked` boolean  
        The price asked about.
    - `bets_to_prove` integer · nullable  
      Bets before a record at this win rate separates from the break-even (one-sided 5%, 80% power); null without an edge.  
      min 1
    - `after_tax` array of object  
      EV per unit after US federal tax at each 2026 bracket
      - `tax_rate` number  
        The federal rate.  
        min 0 · max 1
      - `itemizing` number  
        EV per unit when losses are itemized (90% cap).
      - `not_itemizing` number  
        EV per unit when losses are not deducted.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `basis` string · required  
  Where the fair price came from.  
  One of: `person_prices`, `person_probability`, `kelly_consensus` (open: new values may be added).
- `devig_method` string · nullable  
  De-vig method behind the fair probabilities.
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "selection": "Bills",
  "price": {
    "american": 125
  },
  "reference_prices": {
    "Chiefs": {
      "american": -120
    },
    "Bills": {
      "american": 110
    }
  },
  "devig_method": "worst_case"
}
```

```json
{
  "object": "calculation_result",
  "calc": "bet_value",
  "result": {
    "selection": "Bills",
    "fair_prob": 0.4650207105320668,
    "fair_method": "power",
    "break_even": 0.4444444444444444,
    "ev_per_unit": 0.04629659869715019,
    "prob_over_break_even": 0.020576266087622364,
    "reference_hold": 0.021186440677966156,
    "min_price": {
      "decimal": 2.1504418563547874,
      "american": 115.04418563547874
    },
    "by_method": {
      "multiplicative": 0.4661016949152542,
      "additive": 0.4653679653679653,
      "power": 0.4650207105320668,
      "odds_ratio": 0.46535165408626805,
      "probit": 0.46535515211097567
    },
    "ev_by_method": {
      "multiplicative": 0.048728813559322015,
      "additive": 0.04707792207792205,
      "power": 0.04629659869715019,
      "odds_ratio": 0.047041221694103186,
      "probit": 0.047049092249695335
    },
    "ev_profile": {
      "ev_per_unit": 0.04629659869715019,
      "ev_per_100_minor": 463,
      "win_profit_per_100_minor": 12500,
      "break_even": 0.4444444444444444,
      "win_prob_no_push": 0.4650207105320668,
      "edge": 0.020576266087622364,
      "outcomes": [
        {
          "outcome": "win",
          "prob": 0.4650207105320668,
          "per_100_minor": 12500,
          "contribution_minor": 5813
        },
        {
          "outcome": "loss",
          "prob": 0.5349792894679333,
          "per_100_minor": -10000,
          "contribution_minor": -5350
        }
      ],
      "sd_per_100_minor": 11222,
      "runs": [
        {
          "bets": 100,
          "mean_minor": 46297,
          "p10_minor": -100000,
          "p90_minor": 192500,
          "prob_profit": 0.6551044312619692,
          "prob_loss": 0.3448955687380144,
          "prob_even": 1.6431300764452317e-14
        },
        {
          "bets": 500,
          "mean_minor": 231483,
          "p10_minor": -95000,
          "p90_minor": 557500,
          "prob_profit": 0.8152259213898209,
          "prob_loss": 0.18477407861011577,
          "prob_even": 6.336597913048081e-14
        },
        {
          "bets": 1000,
          "mean_minor": 462966,
          "p10_minor": 12500,
          "p90_minor": 912500,
          "prob_profit": 0.9034770377707871,
          "prob_loss": 0.09652296222890844,
          "prob_even": 3.044231533522179e-13
        }
      ],
      "ev_by_win_rate": [
        {
          "win_rate": 0.39,
          "ev_per_unit": -0.12249999999999994,
          "yours": false
        },
        {
          "win_rate": 0.4,
          "ev_per_unit": -0.09999999999999998,
          "yours": false
        },
        {
          "win_rate": 0.41,
          "ev_per_unit": -0.07750000000000001,
          "yours": false
        },
        {
          "win_rate": 0.42,
          "ev_per_unit": -0.05500000000000005,
          "yours": false
        },
        {
          "win_rate": 0.43,
          "ev_per_unit": -0.03249999999999997,
          "yours": false
        },
        {
          "win_rate": 0.44,
          "ev_per_unit": -0.010000000000000009,
          "yours": false
        },
        {
          "win_rate": 0.45,
          "ev_per_unit": 0.012499999999999956,
          "yours": false
        },
        {
          "win_rate": 0.46,
          "ev_per_unit": 0.03500000000000014,
          "yours": false
        },
        {
          "win_rate": 0.465021,
          "ev_per_unit": 0.04629725000000007,
          "yours": true
        },
        {
          "win_rate": 0.47,
          "ev_per_unit": 0.057499999999999885,
          "yours": false
        },
        {
          "win_rate": 0.48,
          "ev_per_unit": 0.08000000000000007,
          "yours": false
        },
        {
          "win_rate": 0.49,
          "ev_per_unit": 0.10250000000000004,
          "yours": false
        },
        {
          "win_rate": 0.5,
          "ev_per_unit": 0.125,
          "yours": false
        },
        {
          "win_rate": 0.51,
          "ev_per_unit": 0.14749999999999996,
          "yours": false
        },
        {
          "win_rate": 0.52,
          "ev_per_unit": 0.16999999999999993,
          "yours": false
        }
      ],
      "price_ladder": [
        {
          "american": 110,
          "ev_per_unit": -0.02345650788265974,
          "asked": false
        },
        {
          "american": 115,
          "ev_per_unit": -0.00020547235605650194,
          "asked": false
        },
        {
          "american": 120,
          "ev_per_unit": 0.023045563170546957,
          "asked": false
        },
        {
          "american": 125,
          "ev_per_unit": 0.04629659869715019,
          "asked": true
        },
        {
          "american": 130,
          "ev_per_unit": 0.06954763422375343,
          "asked": false
        },
        {
          "american": 135,
          "ev_per_unit": 0.09279866975035689,
          "asked": false
        },
        {
          "american": 140,
          "ev_per_unit": 0.11604970527696024,
          "asked": false
        }
      ],
      "bets_to_prove": 3615,
      "after_tax": [
        {
          "tax_rate": 0.1,
          "itemizing": 0.03631714593275581,
          "not_itemizing": -0.011830990119358176
        },
        {
          "tax_rate": 0.12,
          "itemizing": 0.03432125537987696,
          "not_itemizing": -0.02345650788265985
        },
        {
          "tax_rate": 0.22,
          "itemizing": 0.024341802615482577,
          "not_itemizing": -0.08158409669916816
        },
        {
          "tax_rate": 0.24,
          "itemizing": 0.022345912062603723,
          "not_itemizing": -0.09320961446246984
        },
        {
          "tax_rate": 0.32,
          "itemizing": 0.014362349851088252,
          "not_itemizing": -0.13971168551567653
        },
        {
          "tax_rate": 0.35,
          "itemizing": 0.011368514021769971,
          "not_itemizing": -0.157149962160629
        },
        {
          "tax_rate": 0.37,
          "itemizing": 0.009372623468891117,
          "not_itemizing": -0.16877547992393066
        }
      ]
    }
  },
  "inputs_used": [
    {
      "name": "selection",
      "value": "Bills",
      "source": "person"
    },
    {
      "name": "price",
      "value": {
        "american": 125
      },
      "source": "person"
    },
    {
      "name": "reference_prices",
      "value": {
        "Chiefs": {
          "american": -120
        },
        "Bills": {
          "american": 110
        }
      },
      "source": "person"
    },
    {
      "name": "devig_method",
      "value": "worst_case",
      "source": "person"
    }
  ],
  "basis": "person_prices",
  "devig_method": "worst_case",
  "method_params": {
    "power_k": 1.0319919074665864,
    "odds_ratio_c": 1.0444659357341866,
    "probit_c": 0.02723409726805246
  },
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F1.1@1",
    "F1.4@1",
    "F1.5@1",
    "F1.7@1",
    "F2.1@1",
    "F2.2@1",
    "F2.4@1",
    "F2.6@1",
    "F2.8@1",
    "F2.9@1",
    "F3.1@1",
    "F3.5@1",
    "F12.4@1",
    "F14.8@1",
    "F14.9@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_650900634467d22d3ffc753b",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/spread_and_total:evaluate`

## Calculate: Spread, moneyline and totals
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the spread, moneyline and totals calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `spread_home` number  
  The home team's handicap, book convention: -3 for a 3-point home favourite.
- `total` number  
  The game total.
- `p_home_ml` number  
  The home side's no-vig moneyline probability.
- `p_home_cover` number  
  The home side's no-vig cover probability at the spread (default one half).
- `p_over` number  
  The no-vig over probability at the total (default one half).

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"spread_and_total"`.
- `result` object · required  
  The calculation's numbers
  - `home_margin_mean` number · nullable  
    Expected home margin.
  - `home_cover` number · nullable  
    Home covers the spread.  
    min 0 · max 1
  - `spread_push` number · nullable  
    The spread pushes.  
    min 0 · max 1
  - `away_cover` number · nullable  
    Away covers the spread.  
    min 0 · max 1
  - `home_win` number · nullable  
    Home wins.  
    min 0 · max 1
  - `tie` number · nullable  
    The game ties.  
    min 0 · max 1
  - `away_win` number · nullable  
    Away wins.  
    min 0 · max 1
  - `home_ml_prob` number · nullable  
    Home moneyline probability, ties pushed.  
    min 0 · max 1
  - `away_ml_prob` number · nullable  
    Away moneyline probability, ties pushed.  
    min 0 · max 1
  - `home_ml_fair` object · nullable  
    Fair home moneyline
    - `decimal` number  
      Decimal odds.
    - `american` number  
      American odds.
  - `away_ml_fair` object · nullable  
    Fair away moneyline
    - `decimal` number  
      Decimal odds.
    - `american` number  
      American odds.
  - `total_mean` number · nullable  
    Expected total points.
  - `over` number · nullable  
    The over wins.  
    min 0 · max 1
  - `total_push` number · nullable  
    The total pushes.  
    min 0 · max 1
  - `under` number · nullable  
    The under wins.  
    min 0 · max 1
  - `home_team_total` number · nullable  
    Implied home team total.
  - `away_team_total` number · nullable  
    Implied away team total.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "spread_home": -3,
  "total": 47.5
}
```

```json
{
  "object": "calculation_result",
  "calc": "spread_and_total",
  "result": {
    "home_margin_mean": 3.0953267902530843,
    "home_cover": 0.4586150603187931,
    "spread_push": 0.08276987936241376,
    "away_cover": 0.4586150603187931,
    "home_win": 0.5912922433046552,
    "tie": 0.005793793640733332,
    "away_win": 0.40291396305461163,
    "home_ml_prob": 0.5947380327366268,
    "away_ml_prob": 0.40526196726337316,
    "total_mean": 48.04972924476459,
    "over": 0.4999999999999998,
    "total_push": 0,
    "under": 0.5,
    "home_team_total": 25.25,
    "away_team_total": 22.25,
    "home_ml_fair": {
      "decimal": 1.6814125631054757,
      "american": -146.75397169705693
    },
    "away_ml_fair": {
      "decimal": 2.4675397169705695,
      "american": 146.75397169705695
    }
  },
  "inputs_used": [
    {
      "name": "spread_home",
      "value": -3,
      "source": "person"
    },
    {
      "name": "total",
      "value": 47.5,
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F4.1@1",
    "F4.4@1",
    "F4.6@1",
    "F4.7@1",
    "F4.12@1",
    "F4.13@1",
    "F4.15@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_44331f127bc7ee61562f7593",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/half_point_value:evaluate`

## Calculate: Half-point value
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the half-point value calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `line` number  
  The spread, book convention: -3.
- `side` string  
  The side buying the half point.  
  One of: `favourite`, `underdog` (open: new values may be added).  
  default "favourite"
- `price` object  
  The price at the line before buying.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `buy_price` object  
  The price the book asks for the half point.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `pi` number  
  Probability the margin lands on the number crossed, if known.

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"half_point_value"`.
- `result` object · required  
  The calculation's numbers
  - `direction` string  
    off_the_number or onto_the_number.
  - `from_line` number  
    The line before buying.
  - `to_line` number  
    The line after buying.
  - `number` number  
    The number crossed.
  - `pi` number  
    Probability the margin lands on that number.  
    min 0 · max 1
  - `basis` string  
    Where pi came from: given, or the fitted model.
  - `break_even_decimal` number  
    The highest price worth paying, decimal.
  - `break_even_american` number  
    The highest price worth paying, American.
  - `win_prob_gain` number  
    Win probability the half point adds.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "line": -3,
  "price": {
    "american": -110
  },
  "pi": 0.102
}
```

```json
{
  "object": "calculation_result",
  "calc": "half_point_value",
  "result": {
    "direction": "off_the_number",
    "from_line": -3,
    "to_line": -2.5,
    "number": 3,
    "pi": 0.102,
    "basis": "f4_8_even_split",
    "break_even_decimal": 1.740801847879888,
    "break_even_american": -134.98886414253897,
    "win_prob_gain": 0.051000000000000045
  },
  "inputs_used": [
    {
      "name": "line",
      "value": -3,
      "source": "person"
    },
    {
      "name": "price",
      "value": {
        "american": -110
      },
      "source": "person"
    },
    {
      "name": "pi",
      "value": 0.102,
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F4.6@1",
    "F4.8@1",
    "F4.9@1",
    "F4.11@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "side=favourite (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_a5eb8df063c7fc6bcd83d492",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/alternate_lines:evaluate`

## Calculate: Alternate lines
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the alternate lines calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `main_line` number  
  The main line, book convention: -3.
- `main_prob` number  
  The side's no-vig probability at the main line.
- `alt_lines` array of number  
  Alternate lines to price, in the order wanted.  
  min items 1 · max items 20
- `alt_probs` array of number  
  The market's no-vig probability at each alternate line, in the same order.  
  min items 1

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"alternate_lines"`.
- `result` object · required  
  The calculation's numbers
  - `lines` array of object · required  
    Each alternate line, in the order given
    - `line` number  
      The alternate line.
    - `win` number  
      The side covers it.  
      min 0 · max 1
    - `push` number  
      It pushes.  
      min 0 · max 1
    - `lose` number  
      The side fails to cover it.  
      min 0 · max 1
    - `win_no_push` number  
      Covers, pushes removed.  
      min 0 · max 1
    - `fair` object  
      Fair price at that line
      - `decimal` number  
        Decimal odds.
      - `american` number  
        American odds.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "main_line": -3,
  "main_prob": 0.5,
  "alt_lines": [
    -7.5,
    3.5
  ]
}
```

```json
{
  "object": "calculation_result",
  "calc": "alternate_lines",
  "result": {
    "lines": [
      {
        "line": -7.5,
        "win": 0.3154325030479628,
        "push": 0,
        "lose": 0.6845674969520372,
        "win_no_push": 0.3154325030479628,
        "fair": {
          "decimal": 3.170250339889501,
          "american": 217.02503398895007
        }
      },
      {
        "line": 3.5,
        "win": 0.7179194684698756,
        "push": 0,
        "lose": 0.2820805315301244,
        "win_no_push": 0.7179194684698756,
        "fair": {
          "decimal": 1.392913890650342,
          "american": -254.508691037831
        }
      }
    ]
  },
  "inputs_used": [
    {
      "name": "main_line",
      "value": -3,
      "source": "person"
    },
    {
      "name": "main_prob",
      "value": 0.5,
      "source": "person"
    },
    {
      "name": "alt_lines",
      "value": [
        -7.5,
        3.5
      ],
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F4.10@1",
    "F19.12@1",
    "F36.5@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_1c188b938364401560052b03",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/prop_probability:evaluate`

## Calculate: Prop probability
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the prop probability calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `line` number  
  The prop line.
- `dist` string  
  The distribution.  
  One of: `poisson`, `negative_binomial`, `normal`, `empirical` (open: new values may be added).
- `mean` number  
  The mean.
- `dispersion` number  
  Negative binomial dispersion r.
- `sd` number  
  Normal standard deviation.
- `samples` array of number  
  Empirical samples.  
  min items 1
- `market_p_over` number  
  The no-vig over probability, to imply the mean.

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"prop_probability"`.
- `result` object · required  
  The calculation's numbers
  - `over` number · required  
    Probability of the over.  
    min 0 · max 1
  - `under` number · required  
    Probability of the under.  
    min 0 · max 1
  - `push` number  
    Probability of a push.  
    min 0 · max 1
  - `over_no_push` number  
    The over, pushes removed.  
    min 0 · max 1
  - `median` number  
    The distribution's median.
  - `mean` number · nullable  
    The mean used.
  - `sd` number · nullable  
    The standard deviation used.
  - `implied_mean` number · nullable  
    The mean the market's no-vig over probability implies.
  - `implied_median` number · nullable  
    The median at that mean.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "line": 4.5,
  "dist": "poisson",
  "mean": 4.8
}
```

```json
{
  "object": "calculation_result",
  "calc": "prop_probability",
  "result": {
    "over": 0.5237412463743916,
    "under": 0.47625875362560843,
    "push": 0,
    "over_no_push": 0.5237412463743916,
    "median": 5,
    "implied_mean": null,
    "implied_median": null,
    "mean": 4.8,
    "sd": 2.1908902300206643
  },
  "inputs_used": [
    {
      "name": "line",
      "value": 4.5,
      "source": "person"
    },
    {
      "name": "dist",
      "value": "poisson",
      "source": "person"
    },
    {
      "name": "mean",
      "value": 4.8,
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F19.1@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_a707dbddef781ad909b6c7e6",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/futures_board:evaluate`

## Calculate: Futures board
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the futures board calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `prices` object  
  Every outcome's price on the board, by name.
- `devig_method` string  
  De-vig method.  
  One of: `multiplicative`, `additive`, `power`, `shin`, `odds_ratio`, `probit`, `worst_case`, `balanced_books`, `jensen_shannon`, `ooepc`, `auto` (open: new values may be added).  
  default "power"
- `top_k` integer  
  Price finishing in the top k.  
  min 1
- `pairs` array of array  
  Head-to-head pairs to price, as [a, b] names, in order.

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"futures_board"`.
- `result` object · required  
  The calculation's numbers
  - `fair_probs` object · required  
    Fair probability by outcome, in the order given
  - `fair_prices` object  
    Fair price by outcome
  - `side_hold` object  
    Each outcome's own hold
  - `booksum` number  
    Sum of implied probabilities.
  - `overround` number  
    Booksum minus 1.
  - `hold` number  
    The board's hold.
  - `top_k` object · nullable  
    Finishing in the top k
    - `k` integer  
      k.
    - `probs` object  
      Probability by outcome
  - `head_to_head` array of object · nullable  
    Each pair, in the order given
    - `a` string  
      First outcome.
    - `b` string  
      Second outcome.
    - `p_a_ahead` number  
      Probability a finishes ahead of b.  
      min 0 · max 1
    - `fair_a` object  
      Fair price on a
      - `decimal` number  
        Decimal odds.
      - `american` number  
        American odds.
    - `fair_b` object  
      Fair price on b
      - `decimal` number  
        Decimal odds.
      - `american` number  
        American odds.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `devig_method` string · nullable  
  De-vig method behind the fair probabilities.
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "prices": {
    "A": {
      "fractional": "7/3"
    },
    "B": {
      "fractional": "3/1"
    },
    "C": {
      "fractional": "4/1"
    },
    "D": {
      "fractional": "17/3"
    },
    "E": {
      "fractional": "9/1"
    }
  },
  "top_k": 3,
  "pairs": [
    [
      "A",
      "B"
    ]
  ]
}
```

```json
{
  "object": "calculation_result",
  "calc": "futures_board",
  "result": {
    "fair_probs": {
      "A": 0.3,
      "B": 0.25,
      "C": 0.2,
      "D": 0.15,
      "E": 0.1
    },
    "fair_prices": {
      "A": {
        "decimal": 3.3333333333333335,
        "american": 233.33333333333334
      },
      "B": {
        "decimal": 4,
        "american": 300
      },
      "C": {
        "decimal": 5,
        "american": 400
      },
      "D": {
        "decimal": 6.666666666666667,
        "american": 566.6666666666667
      },
      "E": {
        "decimal": 10,
        "american": 900
      }
    },
    "side_hold": {
      "A": 0,
      "B": 0,
      "C": 0,
      "D": 0,
      "E": 0
    },
    "booksum": 1,
    "overround": 0,
    "hold": 0,
    "top_k": {
      "k": 3,
      "probs": {
        "A": 0.774553877495054,
        "B": 0.7132271323447792,
        "C": 0.6293118646059823,
        "D": 0.5142107892107891,
        "E": 0.36869633634339516
      }
    },
    "head_to_head": [
      {
        "a": "A",
        "b": "B",
        "p_a_ahead": 0.5454545454545454,
        "fair_a": {
          "decimal": 1.8333333333333335,
          "american": -119.99999999999999
        },
        "fair_b": {
          "decimal": 2.1999999999999997,
          "american": 119.99999999999997
        }
      }
    ]
  },
  "inputs_used": [
    {
      "name": "prices",
      "value": {
        "A": {
          "fractional": "7/3"
        },
        "B": {
          "fractional": "3/1"
        },
        "C": {
          "fractional": "4/1"
        },
        "D": {
          "fractional": "17/3"
        },
        "E": {
          "fractional": "9/1"
        }
      },
      "source": "person"
    },
    {
      "name": "top_k",
      "value": 3,
      "source": "person"
    },
    {
      "name": "pairs",
      "value": [
        [
          "A",
          "B"
        ]
      ],
      "source": "person"
    }
  ],
  "devig_method": "power",
  "method_params": {
    "power_k": 1
  },
  "diagnostics": {},
  "warnings": [
    "board_may_be_incomplete",
    "harville_overstates_favourites_in_lower_places"
  ],
  "formulas": [
    "F1.7@1",
    "F2.4@1",
    "F8.1@1",
    "F8.5@1",
    "F8.6@1",
    "F9.4@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "devig_method=power (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_2d13e4d55086fbc1ba808fcd",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/betting_splits:evaluate`

## Calculate: Betting splits
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the betting splits calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `prices` object  
  Every outcome's price, by name.
- `bets_share` object  
  Each outcome's share of tickets (bets%), 0-1, by the same names as prices.
- `money_share` object  
  Each outcome's share of money staked (money%, handle%), 0-1, by the same names. Leave out when the feed gives tickets only.
- `devig_method` string  
  De-vig method.  
  One of: `multiplicative`, `additive`, `power`, `shin`, `odds_ratio`, `probit`, `worst_case`, `balanced_books`, `jensen_shannon`, `ooepc` (open: new values may be added).  
  default "power"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"betting_splits"`.
- `result` object · required  
  The calculation's numbers
  - `by_outcome` object · required  
    Each outcome's split, in the order given
  - `market_hold` number · required  
    The market's hold, 1 - 1/booksum.
  - `book_expected_per_100` number · nullable  
    The book's expected result per 100 staked at the fair probabilities.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `devig_method` string · nullable  
  De-vig method behind the fair probabilities.
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "prices": {
    "NE": {
      "american": 130
    },
    "CHI": {
      "american": -158
    }
  },
  "bets_share": {
    "NE": 0.4,
    "CHI": 0.6
  },
  "money_share": {
    "NE": 0.63,
    "CHI": 0.37
  },
  "devig_method": "multiplicative"
}
```

```json
{
  "object": "calculation_result",
  "calc": "betting_splits",
  "result": {
    "by_outcome": {
      "NE": {
        "bets_share": 0.4,
        "money_share": 0.63,
        "share_gap": 0.22999999999999998,
        "average_bet_ratio": 2.554054054054054,
        "break_even": 0.4347826086956522,
        "fair_prob": 0.41519150305761193,
        "book_result_per_100": -44.899999999999984
      },
      "CHI": {
        "bets_share": 0.6,
        "money_share": 0.37,
        "share_gap": -0.22999999999999998,
        "average_bet_ratio": 0.39153439153439157,
        "break_even": 0.6124031007751938,
        "fair_prob": 0.5848084969423882,
        "book_result_per_100": 39.58227848101266
      }
    },
    "market_hold": 0.045059542967492705,
    "book_expected_per_100": 4.5059542967492705
  },
  "inputs_used": [
    {
      "name": "prices",
      "value": {
        "NE": {
          "american": 130
        },
        "CHI": {
          "american": -158
        }
      },
      "source": "person"
    },
    {
      "name": "bets_share",
      "value": {
        "NE": 0.4,
        "CHI": 0.6
      },
      "source": "person"
    },
    {
      "name": "money_share",
      "value": {
        "NE": 0.63,
        "CHI": 0.37
      },
      "source": "person"
    },
    {
      "name": "devig_method",
      "value": "multiplicative",
      "source": "person"
    }
  ],
  "devig_method": "multiplicative",
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F1.7@1",
    "F1.12@1",
    "F2.1@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_1228ca33626f3cc4bfaeaed8",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/parlay:evaluate`

## Calculate: Parlay
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the parlay calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `prices` array of object  
  Each leg's price, in order.  
  min items 1
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `probs` array of number  
  The person's probability for each leg, in price order.  
  min items 1
- `kind` string  
  Parlay, round robin, if-bet or reverse.  
  One of: `parlay`, `round_robin`, `if_bet`, `reverse` (open: new values may be added).  
  default "parlay"
- `sizes` array of integer  
  Round robin: parlay sizes, such as [2, 3].  
  min items 1
- `pushed` array of integer  
  Parlay: legs (by position) that pushed or were voided.
- `winners` array of integer  
  Round robin: legs (by position) that won, to settle it.
- `ticket_stake_minor` integer  
  Stake per ticket (per combination in a round robin).  
  min 0
- `currency` string  
  ISO 4217 currency code.  
  pattern ^[A-Z]{3}$ · default "USD"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"parlay"`.
- `result` object · required  
  The calculation's numbers
  - `kind` string · required  
    Parlay, round robin, if-bet or reverse.
  - `legs` integer · nullable  
    Number of legs.
  - `legs_settled` integer · nullable  
    Legs that still count after pushes.
  - `price` object · nullable  
    The parlay's price in every format
    - `american` number  
      American odds.
    - `decimal` number  
      Decimal odds.
    - `fractional` string  
      Fractional odds, nearest ladder fraction.
    - `cents` number  
      Contract price in cents per $1.
    - `implied_prob` number  
      Implied probability, 1 / decimal.  
      min 0 · max 1
  - `break_even` number · nullable  
    Break-even at the parlay's price.  
    min 0 · max 1
  - `p_all_win` number · nullable  
    Probability every leg wins.  
    min 0 · max 1
  - `outcome_count` object · nullable  
    Times in a hundred (N in 100)
    - `count` integer  
      How many times.
    - `per` integer  
      Out of how many.
    - `fewer_than_one` boolean  
      Whether it is fewer than one in that many.
  - `ev_per_unit` number · nullable  
    Expected value per unit staked.
  - `compounded_hold` number · nullable  
    Compounded hold, exact form: 1 minus the product of each leg's return.
  - `hold_shortcut` number · nullable  
    Compounded hold from the legs' holds (shortcut).
  - `hold_linear` number · nullable  
    The legs' holds summed (overstates).
  - `payout` object · nullable  
    What a winning ticket returns
    - `return_minor` integer  
      Total return, stake included. In minor units.
    - `profit_minor` integer  
      Profit. In minor units.
    - `currency` string  
      ISO 4217 currency code.
  - `combinations` array of object · nullable  
    Round robin: each combination, in input order
    - `legs` array of integer  
      Its legs, by position.
    - `decimal` number  
      Its decimal price.
    - `cashes` boolean · nullable  
      Whether it cashes, given the winners.
  - `count` integer · nullable  
    Round robin: number of combinations.
  - `total_stake_minor` integer · nullable  
    Round robin: total staked. In minor units.
  - `expected_return_minor` integer · nullable  
    Round robin: expected return. In minor units.
  - `p_any_cashes` number · nullable  
    Round robin: probability at least one combination cashes.  
    min 0 · max 1
  - `p_profit` number · nullable  
    Round robin: probability of a profit.  
    min 0 · max 1
  - `settled_return_minor` integer · nullable  
    Round robin: return given the winners. In minor units.
  - `settled_profit_minor` integer · nullable  
    Round robin: profit given the winners. In minor units.
  - `outcomes_minor` object · nullable  
    If-bet or reverse: net result by outcome, minor units
  - `probabilities` object · nullable  
    If-bet or reverse: probability by outcome
  - `max_exposure_minor` integer · nullable  
    If-bet: the most that can be lost. In minor units.
  - `ev_minor` integer · nullable  
    If-bet or reverse: expected value. In minor units.
  - `ev_straight_minor` integer · nullable  
    If-bet: expected value of two straight bets. In minor units.
  - `leg_rows` array of object · nullable  
    Parlay: each leg, in input order
    - `leg` integer | string · required  
      The leg's position (or name, for a map).
    - `price` object · required  
      The leg's price in every format
      - `american` number  
        American odds.
      - `decimal` number  
        Decimal odds.
      - `fractional` string  
        Fractional odds, nearest ladder fraction.
      - `cents` number  
        Contract price in cents per $1.
      - `implied_prob` number  
        Implied probability, 1 / decimal.  
        min 0 · max 1
    - `pushed` boolean · required  
      Whether the leg pushed or was voided.
    - `running_decimal` number · required  
      The parlay's decimal price after this leg (a pushed leg leaves it unchanged).
    - `running_break_even` number · required  
      The chance every leg so far wins at these prices (1 / running_decimal).  
      min 0 · max 1
    - `single_profit_minor` integer · required  
      What the leg alone, as a straight bet of single_ticket_minor, profits. In minor units.
  - `single_ticket_minor` integer · nullable  
    Parlay: the straight bet each leg is shown at (the person's stake, or $100). In minor units.
  - `payout_ladder` array of object · nullable  
    Parlay: what a winning ticket pays at $10, $25, $50, $100 and the person's stake
    - `ticket_minor` integer · required  
      The ticket amount. In minor units.
    - `return_minor` integer · required  
      Total return, stake included. In minor units.
    - `profit_minor` integer · required  
      Profit. In minor units.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "prices": [
    {
      "american": -110
    },
    {
      "american": 150
    },
    {
      "american": -200
    }
  ],
  "probs": [
    0.53,
    0.42,
    0.68
  ],
  "ticket_stake_minor": 10000
}
```

```json
{
  "object": "calculation_result",
  "calc": "parlay",
  "result": {
    "legs": 3,
    "legs_settled": 3,
    "price": {
      "american": 615.91,
      "decimal": 7.15909090909091,
      "fractional": "271/44",
      "cents": 13.9683,
      "implied_prob": 0.13968253968253966
    },
    "break_even": 0.13968253968253966,
    "p_all_win": 0.151368,
    "outcome_count": {
      "count": 15,
      "per": 100,
      "fewer_than_one": false
    },
    "ev_per_unit": 0.08365727272727286,
    "compounded_hold": -0.08365727272727286,
    "hold_shortcut": null,
    "hold_linear": null,
    "payout": {
      "return_minor": 71591,
      "profit_minor": 61591,
      "currency": "USD"
    },
    "combinations": null,
    "count": null,
    "total_stake_minor": null,
    "expected_return_minor": null,
    "p_any_cashes": null,
    "p_profit": null,
    "settled_return_minor": null,
    "settled_profit_minor": null,
    "outcomes_minor": null,
    "probabilities": null,
    "max_exposure_minor": null,
    "ev_minor": null,
    "ev_straight_minor": null,
    "leg_rows": [
      {
        "leg": 0,
        "price": {
          "american": -110,
          "decimal": 1.9090909090909092,
          "fractional": "10/11",
          "cents": 52.381,
          "implied_prob": 0.5238095238095238
        },
        "pushed": false,
        "running_decimal": 1.9090909090909092,
        "running_break_even": 0.5238095238095238,
        "single_profit_minor": 9091
      },
      {
        "leg": 1,
        "price": {
          "american": 150,
          "decimal": 2.5,
          "fractional": "3/2",
          "cents": 40,
          "implied_prob": 0.4
        },
        "pushed": false,
        "running_decimal": 4.772727272727273,
        "running_break_even": 0.2095238095238095,
        "single_profit_minor": 15000
      },
      {
        "leg": 2,
        "price": {
          "american": -200,
          "decimal": 1.5,
          "fractional": "1/2",
          "cents": 66.6667,
          "implied_prob": 0.6666666666666666
        },
        "pushed": false,
        "running_decimal": 7.15909090909091,
        "running_break_even": 0.13968253968253966,
        "single_profit_minor": 5000
      }
    ],
    "payout_ladder": [
      {
        "ticket_minor": 1000,
        "return_minor": 7159,
        "profit_minor": 6159
      },
      {
        "ticket_minor": 2500,
        "return_minor": 17898,
        "profit_minor": 15398
      },
      {
        "ticket_minor": 5000,
        "return_minor": 35795,
        "profit_minor": 30795
      },
      {
        "ticket_minor": 10000,
        "return_minor": 71591,
        "profit_minor": 61591
      }
    ],
    "single_ticket_minor": 10000,
    "kind": "parlay"
  },
  "inputs_used": [
    {
      "name": "prices",
      "value": [
        {
          "american": -110
        },
        {
          "american": 150
        },
        {
          "american": -200
        }
      ],
      "source": "person"
    },
    {
      "name": "probs",
      "value": [
        0.53,
        0.42,
        0.68
      ],
      "source": "person"
    },
    {
      "name": "ticket_stake_minor",
      "value": 10000,
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F1.11@1",
    "F5.1@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "kind=parlay (default)",
    "currency=USD (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_b2f1a7a7d77b58c2b0bc68b0",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/correlated_parlay:evaluate`

## Calculate: Correlated parlay
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the correlated parlay calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings. A stake sized from a probability is null here: it is shown only on askkelly.ai, signed in (D34).

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

- `book_price` object  
  The book's price for the parlay.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `leg_probs` array of number  
  The person's probability for each leg.  
  min items 2
- `joint_prob` number  
  The person's probability that every leg wins.
- `correlation` number  
  The legs' correlation.  
  min -1 · max 1
- `correlation_kind` string  
  phi (two legs' win indicators) or latent (Gaussian copula).  
  One of: `latent`, `phi` (open: new values may be added).  
  default "latent"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"correlated_parlay"`.
- `result` object · required  
  The calculation's numbers
  - `book_price` object  
    The book's price
    - `decimal` number  
      Decimal odds.
    - `american` number  
      American odds.
  - `break_even` number  
    Break-even at the book's price.  
    min 0 · max 1
  - `independent_prob` number  
    Every leg wins, legs independent.  
    min 0 · max 1
  - `independent_price` object  
    Fair price if independent
    - `decimal` number  
      Decimal odds.
    - `american` number  
      American odds.
  - `joint_prob` number · required  
    Every leg wins, correlation included.  
    min 0 · max 1
  - `joint_source` string  
    Where the joint probability came from.
  - `fair_price` object  
    Fair price at the joint probability
    - `decimal` number  
      Decimal odds.
    - `american` number  
      American odds.
  - `ev_per_unit` number  
    Expected value per unit at the book's price.
  - `ev_if_independent` number  
    Expected value if the legs were independent.
  - `book_vs_independent` number  
    The book's price over the independent price.
  - `implied_phi` number · nullable  
    The phi at which the book's price breaks even.
  - `implied_latent_rho` number · nullable  
    The latent correlation at which the book's price breaks even.
  - `outcome_count` object  
    Times in a hundred (N in 100)
    - `count` integer  
      How many times.
    - `per` integer  
      Out of how many.
    - `fewer_than_one` boolean  
      Whether it is fewer than one in that many.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `stake_eligible` boolean · required  
  Whether a stake may rest on these inputs (D3, D26).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "book_price": {
    "american": 250
  },
  "leg_probs": [
    0.5,
    0.5
  ],
  "correlation": 0.4,
  "correlation_kind": "phi"
}
```

```json
{
  "object": "calculation_result",
  "calc": "correlated_parlay",
  "result": {
    "break_even": 0.2857142857142857,
    "independent_prob": 0.25,
    "joint_prob": 0.35,
    "joint_source": "phi",
    "ev_per_unit": 0.22499999999999987,
    "ev_if_independent": -0.125,
    "book_vs_independent": 0.875,
    "implied_phi": 0.1428571428571428,
    "implied_latent_rho": 0.22252093395631412,
    "outcome_count": {
      "count": 35,
      "per": 100,
      "fewer_than_one": false
    },
    "book_price": {
      "decimal": 3.5,
      "american": 250
    },
    "independent_price": {
      "decimal": 4,
      "american": 300
    },
    "fair_price": {
      "decimal": 2.857142857142857,
      "american": 185.71428571428572
    }
  },
  "inputs_used": [
    {
      "name": "book_price",
      "value": {
        "american": 250
      },
      "source": "person"
    },
    {
      "name": "leg_probs",
      "value": [
        0.5,
        0.5
      ],
      "source": "person"
    },
    {
      "name": "correlation",
      "value": 0.4,
      "source": "person"
    },
    {
      "name": "correlation_kind",
      "value": "phi",
      "source": "person"
    }
  ],
  "stake_eligible": true,
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F5.1@1",
    "F5.4@1",
    "F5.5@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_22a54f930c30afe791f365d7",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/teaser:evaluate`

## Calculate: Teaser
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the teaser calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `price` object  
  The teaser's price.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `leg_probs` array of number  
  The person's probability for each teased leg.  
  min items 2
- `push_probs` array of number  
  Each leg's push probability, in leg order.  
  min items 1
- `push_rule` string  
  How a push settles: reduce to fewer legs, or lose.  
  One of: `reduce`, `lose` (open: new values may be added).  
  default "reduce"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"teaser"`.
- `result` object · required  
  The calculation's numbers
  - `price` object  
    The teaser's price in every format
    - `american` number  
      American odds.
    - `decimal` number  
      Decimal odds.
    - `fractional` string  
      Fractional odds, nearest ladder fraction.
    - `cents` number  
      Contract price in cents per $1.
    - `implied_prob` number  
      Implied probability, 1 / decimal.  
      min 0 · max 1
  - `legs` integer  
    Number of legs.
  - `break_even_per_leg` number · required  
    Win rate each leg needs.  
    min 0 · max 1
  - `p_all_win` number  
    Probability every leg wins.  
    min 0 · max 1
  - `ev_per_unit` number  
    Expected value per unit staked.
  - `push_settlement` object · nullable  
    With pushes
    - `rule` string  
      The push rule.
    - `ev_per_unit` number  
      Expected value per unit with pushes.
    - `p_refund` number  
      Probability the ticket is refunded.  
      min 0 · max 1
    - `p_reduced` number  
      Probability it settles with fewer legs.  
      min 0 · max 1
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "price": {
    "american": -110
  },
  "leg_probs": [
    0.75,
    0.75
  ]
}
```

```json
{
  "object": "calculation_result",
  "calc": "teaser",
  "result": {
    "price": {
      "american": -110,
      "decimal": 1.9090909090909092,
      "fractional": "10/11",
      "cents": 52.381,
      "implied_prob": 0.5238095238095238
    },
    "legs": 2,
    "break_even_per_leg": 0.7237468644557459,
    "p_all_win": 0.5625,
    "ev_per_unit": 0.07386363636363646,
    "push_settlement": null
  },
  "inputs_used": [
    {
      "name": "price",
      "value": {
        "american": -110
      },
      "source": "person"
    },
    {
      "name": "leg_probs",
      "value": [
        0.75,
        0.75
      ],
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [
    "legs_assumed_independent"
  ],
  "formulas": [
    "F5.9@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_23ba171894618f75e5fd54e9",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/arbitrage:evaluate`

## Calculate: Arbitrage
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the arbitrage calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `prices` object  
  The best price on every outcome, by name.
- `total_stake_minor` integer  
  The total to stake across the outcomes.  
  min 1
- `selections` array of string  
  Dutching: the outcomes to back, by name.  
  min items 1
- `currency` string  
  ISO 4217 currency code.  
  pattern ^[A-Z]{3}$ · default "USD"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"arbitrage"`.
- `result` object · required  
  The calculation's numbers
  - `is_arbitrage` boolean · required  
    Whether the booksum of the outcomes backed is below 1.
  - `booksum` number · required  
    Sum of implied probabilities at the prices.
  - `payout_minor` integer  
    What any winning outcome pays. In minor units.
  - `profit_minor` integer  
    Profit on any winning outcome. In minor units.
  - `return_rate` number  
    Profit over the total staked.
  - `currency` string  
    ISO 4217 currency code.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `stake_eligible` boolean · required  
  Whether a stake may rest on these inputs (D3, D26).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `arithmetic_stakes` array of object  
  Stakes fixed by the person's own tickets, in ticket order
  - `ticket` string · required  
    Which ticket or outcome the amount goes on.
  - `amount_minor` integer · required  
    The amount in minor units.
  - `currency` string · required  
    ISO 4217 currency code.
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "prices": {
    "A": {
      "decimal": 2.05
    },
    "B": {
      "decimal": 2.02
    }
  },
  "total_stake_minor": 100000
}
```

```json
{
  "object": "calculation_result",
  "calc": "arbitrage",
  "result": {
    "is_arbitrage": true,
    "booksum": 0.9828543829992755,
    "payout_minor": 101744,
    "profit_minor": 1744,
    "return_rate": 0.017444717444717428,
    "currency": "USD"
  },
  "inputs_used": [
    {
      "name": "prices",
      "value": {
        "A": {
          "decimal": 2.05
        },
        "B": {
          "decimal": 2.02
        }
      },
      "source": "person"
    },
    {
      "name": "total_stake_minor",
      "value": 100000,
      "source": "person"
    }
  ],
  "stake_eligible": true,
  "method_params": {},
  "diagnostics": {},
  "arithmetic_stakes": [
    {
      "ticket": "A",
      "amount_minor": 49631,
      "currency": "USD"
    },
    {
      "ticket": "B",
      "amount_minor": 50369,
      "currency": "USD"
    }
  ],
  "warnings": [
    "void_or_limit_risk"
  ],
  "formulas": [
    "F6.1@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "currency=USD (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_76eddc3708984a9a66c28881",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/middle:evaluate`

## Calculate: Middle
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the middle calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `price_a` object  
  The first ticket's price.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `price_b` object  
  The second ticket's price.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `p_middle` number  
  Probability both tickets win.
- `stake_a_minor` integer  
  The first ticket's stake.  
  min 1
- `stake_b_minor` integer  
  The second ticket's stake.  
  min 1
- `p_a_only` number  
  Probability only the first ticket wins.
- `p_b_only` number  
  Probability only the second ticket wins.
- `p_push_a` number  
  Probability the first ticket pushes while the second wins.  
  min 0 · default 0
- `p_push_b` number  
  Probability the second ticket pushes while the first wins.  
  min 0 · default 0
- `currency` string  
  ISO 4217 currency code.  
  pattern ^[A-Z]{3}$ · default "USD"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"middle"`.
- `result` object · required  
  The calculation's numbers
  - `outcomes_minor` object  
    Net result by outcome, minor units
  - `probabilities` object  
    Probability by outcome
  - `ev_minor` integer · required  
    Expected value. In minor units.
  - `ev_per_unit_staked` number  
    Expected value per unit of the total staked.
  - `break_even_middle_prob` number  
    The landing probability at which the middle breaks even.  
    min 0 · max 1
  - `total_staked_minor` integer  
    Both stakes. In minor units.
  - `currency` string  
    ISO 4217 currency code.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "price_a": {
    "american": -110
  },
  "price_b": {
    "american": -110
  },
  "p_middle": 0.093,
  "stake_a_minor": 10000,
  "stake_b_minor": 10000
}
```

```json
{
  "object": "calculation_result",
  "calc": "middle",
  "result": {
    "outcomes_minor": {
      "both_win": 18182,
      "a_only": -909,
      "b_only": -909,
      "a_pushes_b_wins": 9091,
      "b_pushes_a_wins": 9091
    },
    "probabilities": {
      "both_win": 0.093,
      "a_only": 0.4535,
      "b_only": 0.4535,
      "a_pushes_b_wins": 0,
      "b_pushes_a_wins": 0
    },
    "ev_minor": 866,
    "ev_per_unit_staked": 0.04331818181818187,
    "break_even_middle_prob": 0.04761904761904757,
    "total_staked_minor": 20000,
    "currency": "USD"
  },
  "inputs_used": [
    {
      "name": "price_a",
      "value": {
        "american": -110
      },
      "source": "person"
    },
    {
      "name": "price_b",
      "value": {
        "american": -110
      },
      "source": "person"
    },
    {
      "name": "p_middle",
      "value": 0.093,
      "source": "person"
    },
    {
      "name": "stake_a_minor",
      "value": 10000,
      "source": "person"
    },
    {
      "name": "stake_b_minor",
      "value": 10000,
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F6.3@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "currency=USD (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_796d03351c69845758c54703",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/hedge:evaluate`

## Calculate: Hedge
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the hedge calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `ticket_stake_minor` integer  
  The original ticket's stake.  
  min 1
- `price_taken` object  
  The original ticket's price (a parlay's whole price for last_leg).
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `hedge_price` object  
  The price available on the other side.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `mode` string  
  Which hedge.  
  One of: `equal_profit`, `stake_back`, `partial`, `log_utility`, `last_leg`, `amount` (open: new values may be added).  
  default "equal_profit"
- `partial_share` number  
  Partial: the share of an equal-profit hedge.  
  min 0 · max 1
- `hedge_stake_minor` integer  
  Amount: the hedge the person names.  
  min 0
- `probability` number  
  The person's probability the original ticket wins.
- `bankroll_minor` integer  
  Log-utility hedge: the person's bankroll, the open ticket excluded.  
  min 1
- `no_vig_prob` number  
  Log-utility hedge: the no-vig probability, now, that the original ticket wins, to shrink toward (D26).
- `shrink_weight` number  
  Log-utility hedge: weight on the person's probability when shrinking.  
  min 0 · max 1 · default 0.5
- `currency` string  
  ISO 4217 currency code.  
  pattern ^[A-Z]{3}$ · default "USD"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"hedge"`.
- `result` object · required  
  The calculation's numbers
  - `mode` string · required  
    Which hedge.
  - `ticket_return_minor` integer  
    What the original ticket returns if it wins. In minor units.
  - `outcomes_minor` object  
    Net result either way, minor units
    - `ticket_wins` integer  
      If the original ticket wins.
    - `hedge_wins` integer  
      If the hedge wins.
  - `equal_profit_outcome_minor` integer  
    Profit locked either way by the equal-profit hedge. In minor units.
  - `hedge_price` object  
    The hedge's price
    - `decimal` number  
      Decimal odds.
    - `american` number  
      American odds.
  - `expected_cost_minor` integer · nullable  
    What the hedge costs in expectation at the person's probability. In minor units.
  - `sized` null  
    Null off askkelly.ai: stake mode is first-party only (D34).
  - `weak` null  
    Null off askkelly.ai: stake mode is first-party only (D34).
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `stake_eligible` boolean · required  
  Whether a stake may rest on these inputs (D3, D26).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `stake` null  
  Null off askkelly.ai: stake mode is first-party only (D34).
- `stake_minor` null  
  Null off askkelly.ai: stake mode is first-party only (D34).
- `kelly_criterion_fraction` null  
  Null off askkelly.ai: stake mode is first-party only (D34).
- `arithmetic_stakes` array of object  
  Stakes fixed by the person's own tickets, in ticket order
  - `ticket` string · required  
    Which ticket or outcome the amount goes on.
  - `amount_minor` integer · required  
    The amount in minor units.
  - `currency` string · required  
    ISO 4217 currency code.
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "ticket_stake_minor": 10000,
  "price_taken": {
    "american": 2000
  },
  "hedge_price": {
    "american": -150
  },
  "probability": 0.4201681
}
```

```json
{
  "object": "calculation_result",
  "calc": "hedge",
  "result": {
    "mode": "equal_profit",
    "ticket_return_minor": 210000,
    "outcomes_minor": {
      "ticket_wins": 74000,
      "hedge_wins": 74000
    },
    "equal_profit_outcome_minor": 74000,
    "hedge_price": {
      "decimal": 1.6666666666666665,
      "american": -150.00000000000003
    },
    "expected_cost_minor": 4235,
    "sized": null,
    "weak": null
  },
  "inputs_used": [
    {
      "name": "ticket_stake_minor",
      "value": 10000,
      "source": "person"
    },
    {
      "name": "price_taken",
      "value": {
        "american": 2000
      },
      "source": "person"
    },
    {
      "name": "hedge_price",
      "value": {
        "american": -150
      },
      "source": "person"
    },
    {
      "name": "probability",
      "value": 0.4201681,
      "source": "person"
    }
  ],
  "stake_eligible": true,
  "method_params": {},
  "diagnostics": {},
  "stake": null,
  "stake_minor": null,
  "kelly_criterion_fraction": null,
  "arithmetic_stakes": [
    {
      "ticket": "hedge",
      "amount_minor": 126000,
      "currency": "USD"
    }
  ],
  "warnings": [],
  "formulas": [
    "F6.4@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "mode=equal_profit (default)",
    "currency=USD (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_d8230745d9be426acc8c0121",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/cash_out:evaluate`

## Calculate: Cash-out value
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the cash-out value calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `offer_minor` integer  
  The cash-out offer.  
  min 0
- `ticket_stake_minor` integer  
  The ticket's stake.  
  min 1
- `price_taken` object  
  The ticket's price.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `fair_prob` number  
  The ticket's fair probability now.
- `hedge_price` object  
  The price on the other side, to compare a hedge.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `currency` string  
  ISO 4217 currency code.  
  pattern ^[A-Z]{3}$ · default "USD"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"cash_out"`.
- `result` object · required  
  The calculation's numbers
  - `fair_value_minor` integer · required  
    The ticket's fair value now. In minor units.
  - `offer_minor` integer  
    The offer. In minor units.
  - `gives_up_minor` integer  
    What the offer gives up against fair value. In minor units.
  - `margin` number  
    The offer's cut, 1 - offer / fair value.
  - `ticket_return_minor` integer  
    What the ticket returns if it wins. In minor units.
  - `hedge_value_minor` integer · nullable  
    What an equal-profit hedge makes instead, win or lose. In minor units.
  - `offer_vs_hedge_minor` integer · nullable  
    The offer minus the hedge's locked value. In minor units.
  - `currency` string  
    ISO 4217 currency code.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "offer_minor": 115000,
  "ticket_stake_minor": 10000,
  "price_taken": {
    "american": 2000
  },
  "fair_prob": 0.6,
  "hedge_price": {
    "american": 140
  }
}
```

```json
{
  "object": "calculation_result",
  "calc": "cash_out",
  "result": {
    "fair_value_minor": 126000,
    "offer_minor": 115000,
    "gives_up_minor": 11000,
    "margin": 0.08730158730158732,
    "ticket_return_minor": 210000,
    "hedge_value_minor": 122500,
    "offer_vs_hedge_minor": -7500,
    "currency": "USD"
  },
  "inputs_used": [
    {
      "name": "offer_minor",
      "value": 115000,
      "source": "person"
    },
    {
      "name": "ticket_stake_minor",
      "value": 10000,
      "source": "person"
    },
    {
      "name": "price_taken",
      "value": {
        "american": 2000
      },
      "source": "person"
    },
    {
      "name": "fair_prob",
      "value": 0.6,
      "source": "person"
    },
    {
      "name": "hedge_price",
      "value": {
        "american": 140
      },
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F6.9@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "currency=USD (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_b4a346c49e976b32161a7ac6",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/bonus_bet:evaluate`

## Calculate: Bonus bets
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the bonus bets calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `kind` string  
  The promotion.  
  One of: `free_bet_conversion`, `qualifying_bet`, `no_sweat`, `boost`, `rollover` (open: new values may be added).
- `amount_minor` integer  
  The free bet, stake, back stake or bonus.  
  min 0
- `bonus_price` object  
  The price the bonus or back bet is placed at.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `hedge_price` object  
  Free-bet conversion at a sportsbook: the price on the other side.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `lay_price` object  
  Exchange lay price (free-bet conversion or a qualifying bet).
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `commission` number  
  Exchange commission on net winnings.  
  min 0 · default 0
- `stake_returned` boolean  
  Free bet: whether a win returns the stake.  
  default false
- `probability` number  
  The person's probability the bet wins.
- `conversion_rate` number  
  No-sweat: the share of a refunded bonus the person expects to keep.
- `boost` number  
  Boost: the profit boost, 0.5 for 50%.
- `rollover` number  
  Rollover: times the bonus must be wagered.
- `currency` string  
  ISO 4217 currency code.  
  pattern ^[A-Z]{3}$ · default "USD"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"bonus_bet"`.
- `result` object · required  
  The calculation's numbers
  - `kind` string · required  
    The promotion.
  - `outcomes_minor` object · nullable  
    Net result by outcome, minor units
  - `profit_minor` integer · nullable  
    Profit locked either way. In minor units.
  - `conversion` number · nullable  
    Share of the free bet kept.
  - `ceiling` number · nullable  
    The most any conversion at this price can keep.
  - `liability_minor` integer · nullable  
    The lay's liability. In minor units.
  - `qualifying_loss_minor` integer · nullable  
    A qualifying bet's result either way. In minor units.
  - `ev_minor` integer · nullable  
    Expected value. In minor units.
  - `ev_cash_part_minor` integer · nullable  
    No-sweat: expected value of the cash bet. In minor units.
  - `ev_refund_part_minor` integer · nullable  
    No-sweat: expected value of the refund. In minor units.
  - `boosted_price` object · nullable  
    The boosted price
    - `decimal` number  
      Decimal odds.
    - `american` number  
      American odds.
  - `break_even` number · nullable  
    Break-even at the boosted price.  
    min 0 · max 1
  - `ev_per_unit` number · nullable  
    Expected value per unit at the boosted price.
  - `wagering_required_minor` integer · nullable  
    Rollover: total wagering required. In minor units.
  - `expected_loss_per_unit` number · nullable  
    Rollover: expected loss per unit wagered.
  - `rollover_cost_minor` integer · nullable  
    Rollover: expected cost of the wagering. In minor units.
  - `currency` string  
    ISO 4217 currency code.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `stake_eligible` boolean · required  
  Whether a stake may rest on these inputs (D3, D26).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `arithmetic_stakes` array of object  
  Stakes fixed by the person's own tickets, in ticket order
  - `ticket` string · required  
    Which ticket or outcome the amount goes on.
  - `amount_minor` integer · required  
    The amount in minor units.
  - `currency` string · required  
    ISO 4217 currency code.
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "kind": "free_bet_conversion",
  "amount_minor": 1000,
  "bonus_price": {
    "american": 250
  },
  "hedge_price": {
    "american": -280
  }
}
```

```json
{
  "object": "calculation_result",
  "calc": "bonus_bet",
  "result": {
    "kind": "free_bet_conversion",
    "outcomes_minor": {
      "bonus_wins": 658,
      "hedge_wins": 658
    },
    "profit_minor": 658,
    "conversion": 0.6578947368421053,
    "ceiling": 0.7142857142857143,
    "liability_minor": null,
    "qualifying_loss_minor": null,
    "ev_minor": null,
    "ev_cash_part_minor": null,
    "ev_refund_part_minor": null,
    "boosted_price": null,
    "break_even": null,
    "ev_per_unit": null,
    "wagering_required_minor": null,
    "expected_loss_per_unit": null,
    "rollover_cost_minor": null,
    "currency": "USD"
  },
  "inputs_used": [
    {
      "name": "kind",
      "value": "free_bet_conversion",
      "source": "person"
    },
    {
      "name": "amount_minor",
      "value": 1000,
      "source": "person"
    },
    {
      "name": "bonus_price",
      "value": {
        "american": 250
      },
      "source": "person"
    },
    {
      "name": "hedge_price",
      "value": {
        "american": -280
      },
      "source": "person"
    }
  ],
  "stake_eligible": true,
  "method_params": {},
  "diagnostics": {},
  "arithmetic_stakes": [
    {
      "ticket": "hedge",
      "amount_minor": 1842,
      "currency": "USD"
    }
  ],
  "warnings": [],
  "formulas": [
    "F6.10@1",
    "F6.11@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "currency=USD (default)",
    "stake_returned=False (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_e79305398df62cc860201272",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/stake_size:evaluate`

## Calculate: Stake size
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the stake size calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings. A stake sized from a probability is null here: it is shown only on askkelly.ai, signed in (D34).

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

- `probability` number  
  The person's own probability.
- `price` object  
  The price the person is getting.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `bankroll_minor` integer  
  The person's bankroll.  
  min 1
- `currency` string  
  ISO 4217 currency code.  
  pattern ^[A-Z]{3}$ · default "USD"
- `fraction` number  
  Share of the Kelly criterion (D26: 0.2 to 0.5).  
  min 0.2 · max 0.5 · default 0.25
- `no_vig_prob` number  
  The no-vig market probability to shrink toward.
- `reference_prices` object  
  A market's prices, to take the no-vig probability from.
- `selection` string  
  With reference_prices: the outcome bet.
- `devig_method` string  
  De-vig method.  
  One of: `multiplicative`, `additive`, `power`, `shin`, `odds_ratio`, `probit`, `worst_case`, `balanced_books`, `jensen_shannon`, `ooepc` (open: new values may be added).  
  default "power"
- `shrink_weight` number  
  Weight on the person's probability when shrinking (D26).  
  min 0 · max 1 · default 0.5
- `cap_bet` number  
  Largest share of bankroll on one bet (D26: 1%, at most 2%).  
  max 0.02 · default 0.01
- `cap_slate` number  
  Largest share of bankroll on a slate (D26: 10%, at most 15%).  
  max 0.15 · default 0.1
- `slate_exposure` number  
  Share of bankroll already staked on the slate.  
  min 0 · max 1 · default 0
- `push_prob` number  
  Probability of a push.  
  min 0 · default 0

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"stake_size"`.
- `result` object · required  
  The calculation's numbers
  - `break_even` number · required  
    Break-even win rate at the price.  
    min 0 · max 1
  - `no_vig_prob` number · nullable  
    The no-vig market probability shrunk toward.  
    min 0 · max 1
  - `shrink_weight` number · required  
    Weight on the person's probability.
  - `fraction_applied` number  
    Share of the Kelly criterion applied.
  - `caps` object  
    The caps applied
    - `bet` number  
      Largest share of bankroll on one bet.
    - `slate` number  
      Largest share of bankroll on a slate.
    - `slate_exposure` number  
      Share already staked on the slate.
  - `expected_value` number  
    Expected value per unit at the shrunk probability.
  - `growth_curve` array of object  
    Growth kept by share of the Kelly criterion (the growth-curve explainer, D3)
    - `fraction` number  
      Share of the Kelly criterion.
    - `growth_share` number  
      Share of the full Kelly criterion's growth kept.
  - `ceiling_fraction` null  
    Null off askkelly.ai: stake mode is first-party only (D34).
  - `stake_fraction` null  
    Null off askkelly.ai: stake mode is first-party only (D34).
  - `cap_applied` null  
    Null off askkelly.ai: stake mode is first-party only (D34).
  - `weak` null  
    Null off askkelly.ai: stake mode is first-party only (D34).
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `stake_eligible` boolean · required  
  Whether a stake may rest on these inputs (D3, D26).
- `basis` string · required  
  Where the fair price came from.  
  One of: `person_prices`, `person_probability`, `kelly_consensus` (open: new values may be added).
- `devig_method` string · nullable  
  De-vig method behind the fair probabilities.
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `shrink_applied` boolean  
  Whether the probability was shrunk toward the no-vig market (D26).
- `shrunk_prob` number  
  The person's probability, shrunk toward the no-vig market.  
  min 0 · max 1
- `ev_vs_no_vig` number · nullable  
  EV per unit at the person's price against the no-vig market (D34).
- `drawdown_by_fraction` array of object  
  Drawdown risk by share of the Kelly criterion
  - `fraction` number · required  
    Share of the Kelly criterion (0.25 is a quarter).
  - `drawdown` number · required  
    The drawdown, as a share of bankroll.  
    min 0 · max 1
  - `probability` number · required  
    Probability of ever falling that far (Thorp's lognormal approximation).  
    min 0 · max 1
- `stake` null  
  Null off askkelly.ai: stake mode is first-party only (D34).
- `stake_minor` null  
  Null off askkelly.ai: stake mode is first-party only (D34).
- `kelly_criterion_fraction` null  
  Null off askkelly.ai: stake mode is first-party only (D34).
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "probability": 0.55,
  "price": {
    "american": -110
  },
  "bankroll_minor": 200000,
  "no_vig_prob": 0.5
}
```

```json
{
  "object": "calculation_result",
  "calc": "stake_size",
  "result": {
    "break_even": 0.5238095238095238,
    "no_vig_prob": 0.5,
    "shrink_weight": 0.5,
    "fraction_applied": 0.25,
    "caps": {
      "bet": 0.01,
      "slate": 0.1,
      "slate_exposure": 0
    },
    "expected_value": 0.0022727272727273706,
    "growth_curve": [
      {
        "fraction": 0.25,
        "growth_share": 0.43747832519403684
      },
      {
        "fraction": 0.5,
        "growth_share": 0.7499806438779627
      },
      {
        "fraction": 0.75,
        "growth_share": 0.9374927078375935
      },
      {
        "fraction": 1,
        "growth_share": 1
      }
    ],
    "ceiling_fraction": null,
    "stake_fraction": null,
    "cap_applied": null,
    "weak": null
  },
  "inputs_used": [
    {
      "name": "probability",
      "value": 0.55,
      "source": "person"
    },
    {
      "name": "price",
      "value": {
        "american": -110
      },
      "source": "person"
    },
    {
      "name": "bankroll_minor",
      "value": 200000,
      "source": "person"
    },
    {
      "name": "no_vig_prob",
      "value": 0.5,
      "source": "person"
    }
  ],
  "stake_eligible": true,
  "basis": "person_probability",
  "devig_method": null,
  "method_params": {},
  "diagnostics": {},
  "shrink_applied": true,
  "shrunk_prob": 0.525,
  "ev_vs_no_vig": -0.045454545454545414,
  "drawdown_by_fraction": [
    {
      "fraction": 0.25,
      "drawdown": 0.5,
      "probability": 0.0078125
    },
    {
      "fraction": 0.5,
      "drawdown": 0.5,
      "probability": 0.125
    },
    {
      "fraction": 1,
      "drawdown": 0.5,
      "probability": 0.5
    }
  ],
  "stake": null,
  "stake_minor": null,
  "kelly_criterion_fraction": null,
  "warnings": [
    "stake_first_party_only"
  ],
  "formulas": [
    "F10.1@1",
    "F10.3@1",
    "F10.5@1",
    "F10.6@1",
    "F10.19@1",
    "F10.22@1",
    "F11.1@1",
    "F11.4@1",
    "F11.13@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "currency=USD (default)",
    "fraction=0.25 (default)",
    "shrink_weight=0.5 (default)",
    "cap_bet=0.01 (default)",
    "cap_slate=0.1 (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_cae0e5d6deac759a397cfbe1",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/bankroll_risk:evaluate`

## Calculate: Bankroll risk
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the bankroll risk calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `kind` string  
  Which risk.  
  One of: `ruin`, `drawdown`, `goal`, `losing_season`, `progression` (open: new values may be added).
- `probability` number  
  The person's win probability.
- `price` object  
  The price bet.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `fraction` number  
  Share of the Kelly criterion.
- `floor` number  
  The floor, as a share of the starting bankroll.  
  default 0.5
- `goal` number  
  Goal: a multiple of the starting bankroll.  
  default 2
- `tolerance` number  
  Drawdown: the chance of ever reaching the floor the person accepts.
- `basis` string  
  Drawdown: kelly_criterion (by share of the Kelly criterion) or flat stakes.  
  One of: `kelly_criterion`, `flat` (open: new values may be added).  
  default "kelly_criterion"
- `strategy` string  
  Goal: kelly_criterion (a share of it), flat or bold play.  
  One of: `kelly_criterion`, `flat`, `bold` (open: new values may be added).  
  default "kelly_criterion"
- `n_bets` integer  
  Number of bets.  
  min 1
- `bankroll_units` number  
  Bankroll in betting units.
- `target_units` number  
  Target in betting units.
- `stake_units` number  
  Goal with flat bets: units per bet.
- `system` string  
  Progression: martingale or fixed_fraction.  
  One of: `martingale`, `fixed_fraction` (open: new values may be added).
- `base_units` number  
  Martingale: the base bet in units.
- `doublings` integer  
  Martingale: doublings allowed before the cap.  
  min 1
- `share` number  
  Fixed fraction: share of bankroll per bet.

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"bankroll_risk"`.
- `result` object · required  
  The calculation's numbers
  - `kind` string · required  
    Which risk.
  - `probability` number · nullable  
    The headline probability for this risk.  
    min 0 · max 1
  - `outcome_count` object · nullable  
    Times in a hundred (N in 100)
    - `count` integer  
      How many times.
    - `per` integer  
      Out of how many.
    - `fewer_than_one` boolean  
      Whether it is fewer than one in that many.
  - `lundberg_exponent` number · nullable  
    Ruin: the Lundberg exponent.
  - `ruin_bound` number · nullable  
    Ruin: the Lundberg bound on ever being ruined.  
    min 0 · max 1
  - `bound_is_exact` boolean · nullable  
    Ruin: whether the bound is exact here.
  - `diffusion_infinite` number · nullable  
    Ruin: diffusion approximation, any horizon.  
    min 0 · max 1
  - `diffusion_finite` number · nullable  
    Ruin: diffusion approximation within n bets.  
    min 0 · max 1
  - `exact_finite` number · nullable  
    Ruin: exact within n bets.  
    min 0 · max 1
  - `reach_target` number · nullable  
    Reaching the target first.  
    min 0 · max 1
  - `expected_bets` number · nullable  
    Expected bets until ruin or the target.
  - `floor` number · nullable  
    Drawdown: the floor.
  - `multiple` number · nullable  
    Share of the Kelly criterion used.
  - `within_n_bets` object · nullable  
    Drawdown within n bets
    - `touch_prob` number  
      Touching the floor.  
      min 0 · max 1
    - `end_below_floor_prob` number  
      Ending below the floor.  
      min 0 · max 1
    - `end_below_start_prob` number  
      Ending below the start.  
      min 0 · max 1
    - `end_double_prob` number  
      Ending doubled.  
      min 0 · max 1
    - `median_multiple` number  
      Median ending multiple.
  - `budget_multiple` number · nullable  
    Drawdown budget: the share of the Kelly criterion it allows.
  - `rck_multiple` number · nullable  
    Drawdown budget: risk-constrained Kelly criterion as a share.
  - `expected_max_drawdown` object · nullable  
    Flat stakes: expected maximum drawdown, in units
    - `mean_per_bet` number  
      Mean result per bet.
    - `sd_per_bet` number  
      SD per bet.
    - `x` number  
      The scaled horizon.
    - `large_x` number  
      Large-horizon form.
    - `small_x` number  
      Small-horizon form.
  - `bets_to_goal` number · nullable  
    Goal: median bets to reach it.
  - `ruin_before_target` number · nullable  
    Goal with flat bets: ruin first.  
    min 0 · max 1
  - `expected_handle_units` number · nullable  
    Goal: expected total wagered, units.
  - `expected_final_units` number · nullable  
    Goal with flat bets: expected final bankroll, units.
  - `zero_edge_benchmark` number · nullable  
    Goal: the chance at zero edge.  
    min 0 · max 1
  - `exact` number · nullable  
    Losing season: exact.  
    min 0 · max 1
  - `normal` number · nullable  
    Losing season: normal approximation.  
    min 0 · max 1
  - `bust_prob` number · nullable  
    Martingale: busting a cycle.  
    min 0 · max 1
  - `expected_wager_units` number · nullable  
    Martingale: expected wagered per cycle, units.
  - `ev_per_cycle_units` number · nullable  
    Martingale: expected result per cycle, units.
  - `return_per_dollar` number · nullable  
    Expected return per unit wagered.
  - `flat_mean` number · nullable  
    Fixed fraction: flat bets' mean ending multiple.
  - `fraction_mean` number · nullable  
    Fixed fraction: mean ending multiple.
  - `flat_median` number · nullable  
    Fixed fraction: flat bets' median ending multiple.
  - `fraction_median` number · nullable  
    Fixed fraction: median ending multiple.
  - `kelly_criterion_fraction` null  
    Null off askkelly.ai: stake mode is first-party only (D34).
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "kind": "drawdown",
  "probability": 0.55,
  "price": {
    "american": -110
  },
  "fraction": 0.5,
  "floor": 0.5
}
```

```json
{
  "object": "calculation_result",
  "calc": "bankroll_risk",
  "result": {
    "kind": "drawdown",
    "probability": 0.125,
    "outcome_count": {
      "count": 13,
      "per": 100,
      "fewer_than_one": false
    },
    "lundberg_exponent": null,
    "ruin_bound": null,
    "bound_is_exact": null,
    "diffusion_infinite": null,
    "diffusion_finite": null,
    "exact_finite": null,
    "reach_target": null,
    "expected_bets": null,
    "floor": 0.5,
    "multiple": 0.5,
    "within_n_bets": null,
    "budget_multiple": null,
    "rck_multiple": null,
    "expected_max_drawdown": null,
    "bets_to_goal": null,
    "ruin_before_target": null,
    "expected_handle_units": null,
    "expected_final_units": null,
    "zero_edge_benchmark": null,
    "exact": null,
    "normal": null,
    "bust_prob": null,
    "expected_wager_units": null,
    "ev_per_cycle_units": null,
    "return_per_dollar": null,
    "flat_mean": null,
    "fraction_mean": null,
    "flat_median": null,
    "fraction_median": null,
    "kelly_criterion_fraction": null
  },
  "inputs_used": [
    {
      "name": "kind",
      "value": "drawdown",
      "source": "person"
    },
    {
      "name": "probability",
      "value": 0.55,
      "source": "person"
    },
    {
      "name": "price",
      "value": {
        "american": -110
      },
      "source": "person"
    },
    {
      "name": "fraction",
      "value": 0.5,
      "source": "person"
    },
    {
      "name": "floor",
      "value": 0.5,
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [
    "stake_first_party_only"
  ],
  "formulas": [
    "F11.1@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "basis=kelly_criterion (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_ffc996da0ad0e842fec72462",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/closing_line_value:evaluate`

## Calculate: Closing-line value
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the closing-line value calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `price_taken` object  
  The price the bet was taken at.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `close_prob` number  
  The fair closing probability.
- `close_prices` object  
  The closing market's prices, by outcome.
- `selection` string  
  With close_prices: the outcome bet.
- `devig_method` string  
  De-vig method.  
  One of: `multiplicative`, `additive`, `power`, `shin`, `odds_ratio`, `probit`, `worst_case`, `balanced_books`, `jensen_shannon`, `ooepc`, `auto` (open: new values may be added).  
  default "power"
- `clvs` array of number  
  Price-based CLVs of a set of bets, for their significance.  
  min items 2

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"closing_line_value"`.
- `result` object · required  
  The calculation's numbers
  - `close_prob` number · nullable  
    The fair closing probability.  
    min 0 · max 1
  - `clv_price` number · nullable  
    Price-based CLV: close probability times the price taken, minus 1.
  - `clv_prob` number · nullable  
    Probability-based CLV: close probability minus the break-even.
  - `expected_roi` number · nullable  
    The return the CLV implies.
  - `break_even_taken` number · nullable  
    Break-even at the price taken.  
    min 0 · max 1
  - `fair_close_price` object · nullable  
    Fair closing price
    - `decimal` number  
      Decimal odds.
    - `american` number  
      American odds.
  - `raw_clv` number · nullable  
    CLV against the vigged close (overstates).
  - `significance` object · nullable  
    A CLV sample's significance
    - `n` integer  
      Bets.
    - `mean` number  
      Mean CLV.
    - `sd` number  
      SD of CLV.
    - `std_error` number  
      Standard error.
    - `t` number  
      t statistic.
    - `ci95` array of number  
      95% interval.  
      min items 2 · max items 2
    - `bets_needed` number · nullable  
      Bets a t of 2 needs at this mean and spread.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `basis` string · required  
  Where the fair price came from.  
  One of: `person_prices`, `person_probability`, `kelly_consensus` (open: new values may be added).
- `devig_method` string · nullable  
  De-vig method behind the fair probabilities.
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "price_taken": {
    "american": 110
  },
  "close_prices": {
    "fav": {
      "american": -120
    },
    "dog": {
      "american": 100
    }
  },
  "selection": "dog",
  "devig_method": "multiplicative"
}
```

```json
{
  "object": "calculation_result",
  "calc": "closing_line_value",
  "result": {
    "close_prob": 0.4782608695652174,
    "clv_price": 0.004347826086956497,
    "clv_prob": 0.0020703933747412417,
    "expected_roi": 0.004347826086956608,
    "break_even_taken": 0.47619047619047616,
    "fair_close_price": {
      "decimal": 2.090909090909091,
      "american": 109.09090909090908
    },
    "raw_clv": 0.050000000000000044,
    "significance": null
  },
  "inputs_used": [
    {
      "name": "price_taken",
      "value": {
        "american": 110
      },
      "source": "person"
    },
    {
      "name": "close_prices",
      "value": {
        "fav": {
          "american": -120
        },
        "dog": {
          "american": 100
        }
      },
      "source": "person"
    },
    {
      "name": "selection",
      "value": "dog",
      "source": "person"
    },
    {
      "name": "devig_method",
      "value": "multiplicative",
      "source": "person"
    }
  ],
  "basis": "person_prices",
  "devig_method": "multiplicative",
  "method_params": {},
  "diagnostics": {},
  "warnings": [
    "raw_clv_includes_margin"
  ],
  "formulas": [
    "F1.7@1",
    "F2.1@1",
    "F3.6@1",
    "F3.7@1",
    "F3.8@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_1aa39e902c103c264324dc38",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/record_test:evaluate`

## Calculate: Record test
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the record test calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `wins` integer  
  Wins.  
  min 0
- `losses` integer  
  Losses.  
  min 0
- `pushes` integer  
  Pushes.  
  min 0 · default 0
- `price` object  
  The price every bet was taken at.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `prices` array of object  
  Each bet's price, in order (wins first, then losses).  
  min items 1
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `tests` integer  
  How many records or angles were tried (multiple comparisons).  
  min 1 · default 1

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"record_test"`.
- `result` object · required  
  The calculation's numbers
  - `wins` integer  
    Wins.
  - `losses` integer  
    Losses.
  - `pushes` integer  
    Pushes.
  - `units` number  
    Profit in flat-bet units.
  - `roi` number  
    Return on the amount staked.
  - `win_rate` number · required  
    Wins over wins plus losses.  
    min 0 · max 1
  - `break_even` number · required  
    The break-even win rate.  
    min 0 · max 1
  - `over_break_even` number  
    Win rate minus the break-even.
  - `no_skill_match_prob` number  
    How often a bettor at the break-even does this well.  
    min 0 · max 1
  - `no_skill_match_per_100` number  
    The same, in 100.
  - `coin_match_prob` number  
    How often a 50% picker does this well.  
    min 0 · max 1
  - `coin_match_per_100` number  
    The same, in 100.
  - `z` number  
    z against the break-even.
  - `normal_p` number  
    One-sided p-value, normal approximation.  
    min 0 · max 1
  - `roi_std_error` number  
    Standard error of the ROI.
  - `roi_interval` array of number  
    95% interval for the ROI.  
    min items 2 · max items 2
  - `significant` boolean  
    Whether the record beats the break-even at 5%.
  - `sample_needed` object · nullable  
    Bets needed to show this win rate
    - `one_sided` number  
      One-sided at 5%.
    - `with_power` number  
      With 80% power.
    - `two_se` number  
      By the 2-SE rule.
    - `hoeffding_one_sided` number  
      By Hoeffding's bound.
    - `at_win_rate` number  
      The win rate assumed.  
      min 0 · max 1
  - `multiple_comparisons` object · nullable  
    Control for the number of tests
    - `tests` integer  
      Tests tried.
    - `bonferroni_threshold` number  
      Bonferroni p threshold.
    - `bonferroni_survives` boolean  
      Survives Bonferroni.
    - `bonferroni_adjusted_p` number  
      Bonferroni-adjusted p-value.
    - `benjamini_hochberg_survives_alone` boolean  
      Survives Benjamini-Hochberg on its own.
    - `familywise_error_uncorrected` number  
      Chance of a false positive among the tests, uncorrected.
  - `test_martingale` object · nullable  
    Test martingale (e-process)
    - `e_value` number  
      The e-value.
    - `anytime_p_bound` number  
      Anytime-valid p bound.
    - `crossed_at_end` boolean  
      Whether it crossed 1/alpha.
    - `stake_rule` string  
      The betting rule.
    - `betting_fraction` number  
      The test's betting fraction (a test parameter, not a stake).
    - `ordered` boolean  
      Whether the bets were in time order.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "wins": 550,
  "losses": 450,
  "price": {
    "american": -110
  }
}
```

```json
{
  "object": "calculation_result",
  "calc": "record_test",
  "result": {
    "wins": 550,
    "losses": 450,
    "pushes": 0,
    "units": 50.00000000000006,
    "roi": 0.05000000000000006,
    "win_rate": 0.55,
    "break_even": 0.5238095238095238,
    "over_break_even": 0.02619047619047621,
    "no_skill_match_prob": 0.051793451172939015,
    "no_skill_match_per_100": 5.179345117293901,
    "coin_match_prob": 0.0008652680424881513,
    "coin_match_per_100": 0.08652680424881513,
    "z": 1.6583123951776972,
    "normal_p": 0.04862721421950189,
    "roi_std_error": 0.03004909986918748,
    "significant": false,
    "roi_interval": [
      -0.008895153511454638,
      0.10889515351145476
    ],
    "sample_needed": {
      "one_sided": 976.2092699367881,
      "with_power": 2242.297516904423,
      "two_se": 1457.8512396694198,
      "hoeffding_one_sided": 2183.666004359187,
      "at_win_rate": 0.55
    },
    "multiple_comparisons": null,
    "test_martingale": {
      "e_value": 3.9215498264653212,
      "anytime_p_bound": 0.25500122253995366,
      "crossed_at_end": false,
      "stake_rule": "fixed",
      "betting_fraction": 0.05,
      "ordered": false
    }
  },
  "inputs_used": [
    {
      "name": "wins",
      "value": 550,
      "source": "person"
    },
    {
      "name": "losses",
      "value": 450,
      "source": "person"
    },
    {
      "name": "price",
      "value": {
        "american": -110
      },
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [
    "fixed_n_p_value"
  ],
  "formulas": [
    "F3.2@1",
    "F12.1@1",
    "F12.3@1",
    "F12.4@1",
    "F36.1@1",
    "F36.2@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_8c3b552a4a202ed37c43a4bd",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/after_tax_break_even:evaluate`

## Calculate: After-tax break-even
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the after-tax break-even calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `price` object  
  The price.
  - `american` number  
    American odds: -110, +125. None lies strictly between -100 and +100.
  - `decimal` number  
    Decimal odds, stake included: 1.91.
  - `fractional` string  
    Fractional odds: "5/2".  
    pattern ^[0-9]+/[0-9]+$
  - `cents` number  
    A prediction-market contract price in cents per $1.
- `tax_rate` number  
  Marginal tax rate.  
  min 0 · max 1 · default 0
- `itemizer` boolean  
  Whether the person itemizes.  
  default true
- `loss_cap` number  
  Share of losses deductible (0.9 from tax year 2026).  
  min 0 · max 1 · default 0.9
- `fee_minor` integer  
  A per-wager fee.  
  min 0
- `ticket_stake_minor` integer  
  The stake the fee applies to.  
  min 1

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"after_tax_break_even"`.
- `result` object · required  
  The calculation's numbers
  - `break_even` number · required  
    Win rate needed after tax and fees.  
    min 0 · max 1
  - `pre_tax_break_even` number  
    Win rate needed before tax.  
    min 0 · max 1
  - `rise` number  
    How much tax and fees raise the break-even.
  - `roi_needed` number  
    Pre-tax return needed to break even after tax.
  - `fee_cost_per_unit` number  
    The fee per unit staked.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available) · [`needs_jurisdiction`](/problems/needs_jurisdiction)

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

{
  "price": {
    "american": -110
  },
  "tax_rate": 0.24
}
```

```json
{
  "object": "calculation_result",
  "calc": "after_tax_break_even",
  "result": {
    "break_even": 0.5315581854043392,
    "pre_tax_break_even": 0.5238095238095238,
    "rise": 0.007748661594815354,
    "roi_needed": 0.014792899408283988,
    "fee_cost_per_unit": 0
  },
  "inputs_used": [
    {
      "name": "price",
      "value": {
        "american": -110
      },
      "source": "person"
    },
    {
      "name": "tax_rate",
      "value": 0.24,
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F14.8@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_baacde397b01eb22bfbe4988",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/gambling_tax:evaluate`

## Calculate: Gambling tax
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the gambling tax calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `winnings_minor` integer  
  The year's gross winnings: the profit on every winning bet.  
  min 0
- `losses_minor` integer  
  The year's gross losses: the stakes on every losing bet.  
  min 0
- `tax_year` integer  
  The tax year, which sets the share of losses deductible.  
  min 2000 · max 2100
- `federal_rate` number  
  The person's federal marginal rate.  
  min 0 · max 1
- `itemizer` boolean  
  Whether the person itemizes.  
  default true
- `state_rate` number  
  The person's state rate on gambling income.  
  min 0 · max 1 · default 0
- `state_deducts_losses` boolean  
  Whether the state lets losses come off. Left out, the state tax is on all winnings and a warning says the rule is unknown.
- `withheld_minor` integer  
  Tax already withheld, such as on W-2Gs.  
  min 0
- `currency` string  
  ISO 4217 currency code.  
  pattern ^[A-Z]{3}$ · default "USD"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"gambling_tax"`.
- `result` object · required  
  The calculation's numbers
  - `winnings_minor` integer  
    Gross winnings. In minor units.
  - `losses_minor` integer  
    Gross losses. In minor units.
  - `net_result_minor` integer  
    Winnings minus losses: what was actually won. In minor units.
  - `loss_cap` number  
    The share of losses deductible in the tax year.  
    min 0 · max 1
  - `deduction_minor` integer  
    The losses deducted: the lower of the capped losses and the winnings. In minor units.
  - `taxable_minor` integer · required  
    Taxable gambling income, federal. In minor units.
  - `taxed_not_won_minor` integer  
    Taxable income beyond what was actually won (the loss cap's cost). In minor units.
  - `federal_tax_minor` integer  
    Federal tax at the person's rate. In minor units.
  - `state_taxable_minor` integer  
    The income the state rate applies to. In minor units.
  - `state_tax_minor` integer  
    State tax at the person's rate. In minor units.
  - `total_tax_minor` integer · required  
    Federal and state tax. In minor units.
  - `after_tax_minor` integer  
    Winnings minus losses minus the tax. In minor units.
  - `withheld_minor` integer  
    Tax already withheld. In minor units.
  - `set_aside_minor` integer  
    The tax still to pay: the total less what was withheld, never below zero. In minor units.
  - `currency` string  
    ISO 4217 currency code.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "winnings_minor": 2500000,
  "losses_minor": 2200000,
  "tax_year": 2026,
  "federal_rate": 0.24,
  "state_rate": 0.05,
  "state_deducts_losses": true
}
```

```json
{
  "object": "calculation_result",
  "calc": "gambling_tax",
  "result": {
    "winnings_minor": 2500000,
    "losses_minor": 2200000,
    "net_result_minor": 300000,
    "loss_cap": 0.9,
    "deduction_minor": 1980000,
    "taxable_minor": 520000,
    "taxed_not_won_minor": 220000,
    "federal_tax_minor": 124800,
    "state_taxable_minor": 520000,
    "state_tax_minor": 26000,
    "total_tax_minor": 150800,
    "after_tax_minor": 149200,
    "withheld_minor": 0,
    "set_aside_minor": 150800,
    "currency": "USD"
  },
  "inputs_used": [
    {
      "name": "winnings_minor",
      "value": 2500000,
      "source": "person"
    },
    {
      "name": "losses_minor",
      "value": 2200000,
      "source": "person"
    },
    {
      "name": "tax_year",
      "value": 2026,
      "source": "person"
    },
    {
      "name": "federal_rate",
      "value": 0.24,
      "source": "person"
    },
    {
      "name": "state_rate",
      "value": 0.05,
      "source": "person"
    },
    {
      "name": "state_deducts_losses",
      "value": true,
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F14.7@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "currency=USD (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_57141b19d08dee4e58b89bf8",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

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

{
  "winnings_minor": 2500000,
  "losses_minor": 2200000,
  "tax_year": 2026,
  "federal_rate": 0.24,
  "state_rate": 0.05,
  "state_deducts_losses": true,
  "filing_status": "single"
}
```

```json
{
  "type": "https://docs.askkelly.ai/problems/invalid_inputs",
  "title": "Invalid calculation inputs",
  "status": 422,
  "code": "invalid_inputs",
  "detail": "Additional properties are not allowed ('filing_status' was unexpected)",
  "param": "filing_status",
  "doc_url": "https://docs.askkelly.ai/problems/invalid_inputs",
  "request_id": "req_e770000fd96970058372de82",
  "retryable": false,
  "display_message": "One of those numbers could not be read.",
  "schema": "calculation/gambling_tax",
  "example": {
    "winnings_minor": 2500000,
    "losses_minor": 2200000,
    "tax_year": 2026,
    "federal_rate": 0.24,
    "state_rate": 0.05,
    "state_deducts_losses": true
  }
}
```

`POST /v1/calculations/regression_to_mean:evaluate`

## Calculate: Regression to the mean
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the regression to the mean calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings.

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

- `observed` number  
  The observed rate or average.
- `n` number  
  The sample size behind it.
- `prior_mean` number  
  The population mean.
- `k` number  
  The stabilisation point.
- `reliability` number  
  The stat's reliability at reliability_at trials, instead of k.
- `reliability_at` number  
  The sample size the reliability was measured at.
- `target_reliability` number  
  The reliability to report the trials needed for.  
  default 0.7

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"regression_to_mean"`.
- `result` object · required  
  The calculation's numbers
  - `estimate` number · required  
    The true-talent estimate.
  - `data_weight` number  
    Weight on the observed value, n / (n + k).  
    min 0 · max 1
  - `prior_weight` number  
    Weight on the population mean.  
    min 0 · max 1
  - `regression` number  
    How far the estimate moved toward the mean.
  - `k` number  
    The stabilisation point used.
  - `stabilisation_point` number  
    Trials at which the data and the mean weigh the same.
  - `trials_for_target` number  
    Trials needed for the target reliability.
  - `target_reliability` number  
    The target reliability.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "observed": 0.6172839506172839,
  "n": 162,
  "prior_mean": 0.5,
  "k": 74.3
}
```

```json
{
  "object": "calculation_result",
  "calc": "regression_to_mean",
  "result": {
    "estimate": 0.5804062632247143,
    "data_weight": 0.6855691917054592,
    "prior_weight": 0.31443080829454084,
    "regression": 0.03687768739256958,
    "k": 74.3,
    "stabilisation_point": 74.3,
    "trials_for_target": 173.36666666666665,
    "target_reliability": 0.7
  },
  "inputs_used": [
    {
      "name": "observed",
      "value": 0.6172839506172839,
      "source": "person"
    },
    {
      "name": "n",
      "value": 162,
      "source": "person"
    },
    {
      "name": "prior_mean",
      "value": 0.5,
      "source": "person"
    },
    {
      "name": "k",
      "value": 74.3,
      "source": "person"
    }
  ],
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F17.1@1",
    "F17.2@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_cfe2ee5c742cb2a9db900b5c",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

`POST /v1/calculations/pickem_entry:evaluate`

## Calculate: Pick'em entry
public, no key needed · 1 credit, not charged during the beta · MCP tool `calculate_odds` · status live

Runs the pick'em entry calculation on the numbers you send, through the same engine as Ask Kelly and askkelly.ai's calculators. The result lists every input with its source, the formulas used and their versions, and any warnings. A stake sized from a probability is null here: it is shown only on askkelly.ai, signed in (D34).

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

- `leg_probs` array of number  
  The person's probability for each pick, in order.  
  min items 2 · max items 8
- `payout_table` object  
  Multiplier by number of hits, such as {"6": 37.5}.
- `format` string  
  Entry format.  
  One of: `power`, `flex` (open: new values may be added).  
  default "power"
- `entry_fee_minor` integer  
  The entry fee.  
  min 1 · default 1000
- `latent_correlation` number  
  Correlation between picks (one-factor copula).  
  min -1 · max 1 · default 0
- `currency` string  
  ISO 4217 currency code.  
  pattern ^[A-Z]{3}$ · default "USD"

### Response
`200` The calculation's result.

- `object` const · required  
  Always calculation_result.  
  Always `"calculation_result"`.
- `calc` const · required  
  The calculation.  
  Always `"pickem_entry"`.
- `result` object · required  
  The calculation's numbers
  - `legs` integer  
    Number of picks.
  - `format` string  
    Entry format.
  - `hits` object  
    Probability of each number of hits
  - `p_all_hit` number  
    Every pick hits.  
    min 0 · max 1
  - `p_any_payout` number  
    The entry pays anything.  
    min 0 · max 1
  - `expected_multiple` number  
    Expected payout multiple.
  - `ev_per_unit` number · required  
    Expected value per unit of entry fee.
  - `expected_return_minor` integer  
    Expected return per entry. In minor units.
  - `expected_cost_minor` integer  
    Expected cost per entry (negative is a gain). In minor units.
  - `break_even_leg` number · nullable  
    Win rate each pick needs, for equal picks.  
    min 0 · max 1
  - `break_even_all_hit` number · nullable  
    Power: probability every pick must hit to break even.  
    min 0 · max 1
  - `all_hit_count` object  
    Times in a hundred (N in 100)
    - `count` integer  
      How many times.
    - `per` integer  
      Out of how many.
    - `fewer_than_one` boolean  
      Whether it is fewer than one in that many.
  - `return_distribution` array of object  
    Payout multiples and their probabilities
    - `multiple` number  
      The multiple.
    - `p` number  
      Its probability.  
      min 0 · max 1
  - `currency` string  
    ISO 4217 currency code.
- `inputs_used` array of object · required  
  Every input given, in the order given, with its source
  - `name` string · required  
    The input's name.
  - `value` any · required  
    The value used, as given.
  - `source` string · required  
    Who supplied it: person, market or kelly.  
    One of: `person`, `market`, `kelly` (open: new values may be added).
- `stake_eligible` boolean · required  
  Whether a stake may rest on these inputs (D3, D26).
- `method_params` object · required  
  Solved method parameters, such as power_k
- `diagnostics` object  
  Solver diagnostics (iterations, converged)
- `warnings` array of string · required  
  Warning codes
- `formulas` array of string · required  
  Formula cards used
- `engine_build` string · required  
  The engine build that computed it.
- `api_version` string · nullable  
  The API version that served it (set by the surface, K10).
- `rg_line` string · nullable  
  The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
- `assumptions` array of string · required  
  Defaults applied
- `as_of` string  
  When it was computed (UTC).  
  format date-time
- `source` string  
  Who computed it, as shown to readers.
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).

### 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) · [`invalid_inputs`](/problems/invalid_inputs) · [`calc_not_available`](/problems/calc_not_available)

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

{
  "leg_probs": [
    0.55,
    0.55,
    0.55,
    0.55,
    0.55,
    0.55
  ],
  "payout_table": {
    "6": 37.5
  },
  "format": "power"
}
```

```json
{
  "object": "calculation_result",
  "calc": "pickem_entry",
  "result": {
    "legs": 6,
    "format": "power",
    "p_all_hit": 0.027680640625000016,
    "p_any_payout": 0.027680640625000016,
    "expected_multiple": 1.0380240234375007,
    "ev_per_unit": 0.038024023437500665,
    "expected_return_minor": 1038,
    "expected_cost_minor": -38,
    "break_even_leg": 0.5465897149024526,
    "break_even_all_hit": 0.02666666666666667,
    "all_hit_count": {
      "count": 3,
      "per": 100,
      "fewer_than_one": false
    },
    "hits": {
      "0": 0.008303765624999994,
      "1": 0.060894281249999974,
      "2": 0.18606585937499995,
      "3": 0.3032184375,
      "4": 0.27795023437500005,
      "5": 0.13588678125000003,
      "6": 0.027680640625000016
    },
    "return_distribution": [
      {
        "multiple": 0,
        "p": 0.9723193593749999
      },
      {
        "multiple": 37.5,
        "p": 0.027680640625000016
      }
    ],
    "currency": "USD"
  },
  "inputs_used": [
    {
      "name": "leg_probs",
      "value": [
        0.55,
        0.55,
        0.55,
        0.55,
        0.55,
        0.55
      ],
      "source": "person"
    },
    {
      "name": "payout_table",
      "value": {
        "6": 37.5
      },
      "source": "person"
    },
    {
      "name": "format",
      "value": "power",
      "source": "person"
    }
  ],
  "stake_eligible": true,
  "method_params": {},
  "diagnostics": {},
  "warnings": [],
  "formulas": [
    "F33.1@1",
    "F33.2@1",
    "F33.3@1"
  ],
  "engine_build": "kmath 2026.10.1",
  "api_version": "2026-10-05",
  "rg_line": "21+ · Help: 1-800-MY-RESET",
  "assumptions": [
    "entry_fee_minor=1000 (default)",
    "currency=USD (default)"
  ],
  "as_of": "2026-10-04T17:30:00Z",
  "source": "Kelly",
  "attribution": null,
  "request_id": "req_bdae1230e6626c5d66a959c6",
  "live_topics": []
}
```

Where each value comes from:

1. Kelly · as of 2026-10-04T17:30:00Z

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
