Skip to content
Kellydocs
Kellydocs

calculations

Copy page

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

On this page
MethodPathTitleAccessPriceMCP tool
GET/v1/calculationsList calculationspublic1none
GET/v1/calculations/{calc}Get a calculationpublic1none
POST/v1/calculations/convert_odds:evaluateCalculate: Convert oddspublic1calculate_odds
POST/v1/calculations/remove_vig:evaluateCalculate: Remove the vigpublic1calculate_odds
POST/v1/calculations/bet_value:evaluateCalculate: Bet valuepublic1calculate_odds
POST/v1/calculations/spread_and_total:evaluateCalculate: Spread, moneyline and totalspublic1calculate_odds
POST/v1/calculations/half_point_value:evaluateCalculate: Half-point valuepublic1calculate_odds
POST/v1/calculations/alternate_lines:evaluateCalculate: Alternate linespublic1calculate_odds
POST/v1/calculations/prop_probability:evaluateCalculate: Prop probabilitypublic1calculate_odds
POST/v1/calculations/futures_board:evaluateCalculate: Futures boardpublic1calculate_odds
POST/v1/calculations/betting_splits:evaluateCalculate: Betting splitspublic1calculate_odds
POST/v1/calculations/parlay:evaluateCalculate: Parlaypublic1calculate_odds
POST/v1/calculations/correlated_parlay:evaluateCalculate: Correlated parlaypublic1calculate_odds
POST/v1/calculations/teaser:evaluateCalculate: Teaserpublic1calculate_odds
POST/v1/calculations/arbitrage:evaluateCalculate: Arbitragepublic1calculate_odds
POST/v1/calculations/middle:evaluateCalculate: Middlepublic1calculate_odds
POST/v1/calculations/hedge:evaluateCalculate: Hedgepublic1calculate_odds
POST/v1/calculations/cash_out:evaluateCalculate: Cash-out valuepublic1calculate_odds
POST/v1/calculations/bonus_bet:evaluateCalculate: Bonus betspublic1calculate_odds
POST/v1/calculations/stake_size:evaluateCalculate: Stake sizepublic1calculate_odds
POST/v1/calculations/bankroll_risk:evaluateCalculate: Bankroll riskpublic1calculate_odds
POST/v1/calculations/closing_line_value:evaluateCalculate: Closing-line valuepublic1calculate_odds
POST/v1/calculations/record_test:evaluateCalculate: Record testpublic1calculate_odds
POST/v1/calculations/after_tax_break_even:evaluateCalculate: After-tax break-evenpublic1calculate_odds
POST/v1/calculations/gambling_tax:evaluateCalculate: Gambling taxpublic1calculate_odds
POST/v1/calculations/regression_to_mean:evaluateCalculate: Regression to the meanpublic1calculate_odds
POST/v1/calculations/pickem_entry:evaluateCalculate: Pick'em entrypublic1calculate_odds

GET /v1/calculations

List calculationsLink to this section

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.

ParametersLink to this section

familystring · 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).

statusstring · query

available or not_available.

One of: available, not_available (open: new values may be added).

ResponseLink to this section

200 The calculations, in catalogue order.

objectconstrequired

Always calculation_list.

Always "calculation_list".

countintegerrequired

How many calculations match.

familiesarray of stringrequired

The families, in catalogue order.

dataarray of objectrequired

The calculations.

Show 13 fields
namestringrequired

Its name, as the evaluate path and calculate_odds' calc spell it (bet_value).

titlestringrequired

Its title (Bet value).

familystringrequired

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

statusstringrequired

available, or not_available (listed, answering calc_not_available until it ships).

One of: available, not_available (open: new values may be added).

sessionstringnullable

The build session that ships it, while it is not available.

neareststringnullable

The nearest calculation that works now, while it is not available.

formulasarray of stringrequired

The formula cards it implements, with their versions (F1.4@1).

stake_policystringrequired

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

simulatesstringnullable

Whether it simulates: optional, bootstrap or yes; null when it never does.

creditsintegerrequired

Credits per call.

credit_unitconst

What the credits are per: always call.

Always "call".

operation_idstringrequired

Its evaluate operation (evaluate_bet_value).

evaluatestringrequired

Its evaluate route, method and path.

has_morebooleanrequired

Always false: the list is never paged (API-PAGE-1).

next_cursorstringrequirednullable

Always null: the list is never paged (API-PAGE-1).

as_ofstring

When the value was true; for a derived value, its newest input's time.

format date-time

sourcestring

Who produced the value, as shown to readers.

min length 1

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

rg_linestringnullable

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.

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled

ExampleLink to this section

Request
GET https://api.askkelly.ai/v1/calculations?status=available
Response, 200
{
  "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
}
  1. kelly · as of 2026-11-12T00:00:00Z

GET /v1/calculations/{calc}

Get a calculationLink to this section

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.

ParametersLink to this section

calcstring · pathrequired

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

ResponseLink to this section

200 The calculation.

objectconstrequired

Always calculation.

Always "calculation".

namestringrequired

Its name, as the evaluate path and calculate_odds' calc spell it (bet_value).

titlestringrequired

Its title (Bet value).

familystringrequired

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

statusstringrequired

available, or not_available (listed, answering calc_not_available until it ships).

One of: available, not_available (open: new values may be added).

sessionstringnullable

The build session that ships it, while it is not available.

neareststringnullable

The nearest calculation that works now, while it is not available.

formulasarray of stringrequired

The formula cards it implements, with their versions (F1.4@1).

stake_policystringrequired

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

simulatesstringnullable

Whether it simulates: optional, bootstrap or yes; null when it never does.

creditsintegerrequired

Credits per call.

credit_unitconst

What the credits are per: always call.

Always "call".

operation_idstringrequired

Its evaluate operation (evaluate_bet_value).

evaluatestringrequired

Its evaluate route, method and path.

input_schemaobjectrequired

The request body evaluate takes, as JSON Schema 2020-12.

result_schemaobjectrequired

The calculation_result evaluate returns, as JSON Schema 2020-12.

examplesarray of objectrequired

Worked examples, each a body you can send.

Show 3 fields
titlestringrequired

What it shows, with its answer.

cardstringrequired

The formula card it comes from (F14.7).

inputsobjectrequired

A request body evaluate takes as it stands.

as_ofstring

When the value was true; for a derived value, its newest input's time.

format date-time

sourcestring

Who produced the value, as shown to readers.

min length 1

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

rg_linestringnullable

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.

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · not_found

ExampleLink to this section

Request
GET https://api.askkelly.ai/v1/calculations/gambling_tax
Response, 200
{
  "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
}
  1. kelly · as of 2026-11-12T00:00:00Z
Request
GET https://api.askkelly.ai/v1/calculations/vlookup
Response, 404
{
  "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 oddsLink to this section

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.

ParametersLink to this section

Body, application/json (required):

priceobject

The price to convert.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

probabilitynumber

A probability to price fairly (F1.5).

ticket_stake_minorinteger

A ticket's stake, for what it returns.

min 0

currencystring

ISO 4217 currency code.

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

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "convert_odds".

resultobjectrequired

The calculation's numbers

Show 7 fields
priceobject

The price in every format

Show 5 fields
americannumber

American odds.

decimalnumber

Decimal odds.

fractionalstring

Fractional odds, nearest ladder fraction.

centsnumber

Contract price in cents per $1.

implied_probnumber

Implied probability, 1 / decimal.

min 0 · max 1

implied_probnumber

Implied probability at the price, vig in.

min 0 · max 1

break_evennumber

Break-even win rate at the price.

min 0 · max 1

profit_per_unitnumber

Profit on a winning stake of 1, O − 1 (0.9091 at −110).

to_win_100object

The bet that wins 100 in the currency (a bet of 110 at −110 wins 100)

Show 2 fields
risk_minorinteger

The bet that wins 100. In minor units.

profit_minorinteger

The profit, 100. In minor units.

fair_priceobject

The fair price for the probability

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

payoutobject

What a winning ticket returns

Show 3 fields
return_minorinteger

Total return, stake included. In minor units.

profit_minorinteger

Profit. In minor units.

currencystring

ISO 4217 currency code.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/remove_vig:evaluate

Calculate: Remove the vigLink to this section

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.

ParametersLink to this section

Body, application/json (required):

pricesobject

Every outcome's price, by name.

devig_methodstring

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"

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "remove_vig".

resultobjectrequired

The calculation's numbers

Show 11 fields
fair_probsobjectrequired

Fair probability by outcome, in the order given

implied_probsobject

Implied probability by outcome at the price given, vig in

fair_pricesobject

Fair price by outcome, the price with the vig removed; null for an outcome the method prices at zero

side_holdobject

Each outcome's own hold: the share of its price that is vig

cost_per_100_minorobject

What $100 on each outcome gives up on average at its fair probability, in cents

method_rangeobject

Each outcome's fair probability, lowest and highest across the distinct de-vig methods

booksumnumber

Sum of implied probabilities.

overroundnumber

Booksum minus 1.

holdnumberrequired

The books' hold, 1 - 1/booksum.

kept_per_100_minorinteger

What the book keeps of every $100 bet on the market when the action pays the same whichever side wins, in cents.

by_methodobjectnullable

Worst case: fair probabilities by method

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

devig_methodstringnullable

De-vig method behind the fair probabilities.

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/bet_value:evaluate

Calculate: Bet valueLink to this section

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.

ParametersLink to this section

Body, application/json (required):

priceobject

The price the person is offered.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

selectionstring

The outcome bet, a key of reference_prices.

reference_pricesobject

A market's prices to take the fair probability from.

fair_probnumber

The person's own fair probability, instead of reference prices.

devig_methodstring

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_probnumber

Probability of a push.

min 0

required_edgenumber

Edge per unit the minimum price must leave.

min 0 · default 0

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "bet_value".

resultobjectrequired

The calculation's numbers

Show 11 fields
selectionstringnullable

The outcome bet.

fair_probnumberrequired

Fair probability of the outcome.

min 0 · max 1

fair_methodstringnullable

The de-vig method that gave the fair probability.

break_evennumberrequired

Break-even win rate at the price.

min 0 · max 1

ev_per_unitnumberrequired

Expected value per unit staked.

prob_over_break_evennumber

Fair probability minus the break-even.

min_priceobject

The lowest price worth taking

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

reference_holdnumbernullable

Hold of the reference market.

by_methodobjectnullable

Fair probability by de-vig method

ev_by_methodobjectnullable

Expected value per unit by de-vig method

ev_profileobjectnullable

What the EV means on the person's own numbers, per $100 staked (kmath.ev); null on a consensus reference

Show 13 fields
ev_per_unitnumber

Expected value per unit staked.

ev_per_100_minorinteger

Expected profit per $100 bet, in cents.

win_profit_per_100_minorinteger

What a winning $100 bet makes, in cents.

break_evennumber

Break-even win rate at the price.

min 0 · max 1

win_prob_no_pushnumber

The win rate when the bet doesn't push.

min 0 · max 1

edgenumber

The win rate minus the break-even, in probability: how far it can fall before the EV is zero.

outcomesarray of object

Each way the bet settles

Show 4 fields
outcomestring

win, loss or push.

One of: win, loss, push (open: new values may be added).

probnumber

Its chance.

min 0 · max 1

per_100_minorinteger

What $100 makes or loses on it, in cents.

contribution_minorinteger

Its share of the EV per $100 (chance × amount), in cents.

sd_per_100_minorinteger

Standard deviation of one $100 bet's result, in cents.

runsarray of object

Profit over runs of $100 bets

Show 7 fields
betsinteger

Bets.

min 1

mean_minorinteger

Expected profit, in cents.

p10_minorinteger

10th percentile profit, in cents.

p90_minorinteger

90th percentile profit, in cents.

prob_profitnumber

Chance of finishing ahead.

min 0 · max 1

prob_lossnumber

Chance of finishing behind.

min 0 · max 1

prob_evennumber

Chance of finishing exactly even.

min 0 · max 1

ev_by_win_ratearray of object

EV per unit at each whole win rate around the break-even, the person's own in its place

Show 3 fields
win_ratenumber

The win rate.

min 0 · max 1

ev_per_unitnumber

Expected value per unit staked.

yoursboolean

The person's own win rate.

price_ladderarray of object

EV per unit at the neighbouring American prices at this win rate

Show 3 fields
americannumber

American odds.

ev_per_unitnumber

Expected value per unit staked.

askedboolean

The price asked about.

bets_to_proveintegernullable

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_taxarray of object

EV per unit after US federal tax at each 2026 bracket

Show 3 fields
tax_ratenumber

The federal rate.

min 0 · max 1

itemizingnumber

EV per unit when losses are itemized (90% cap).

not_itemizingnumber

EV per unit when losses are not deducted.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

basisstringrequired

Where the fair price came from.

One of: person_prices, person_probability, kelly_consensus (open: new values may be added).

devig_methodstringnullable

De-vig method behind the fair probabilities.

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/spread_and_total:evaluate

Calculate: Spread, moneyline and totalsLink to this section

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.

ParametersLink to this section

Body, application/json (required):

spread_homenumber

The home team's handicap, book convention: -3 for a 3-point home favourite.

totalnumber

The game total.

p_home_mlnumber

The home side's no-vig moneyline probability.

p_home_covernumber

The home side's no-vig cover probability at the spread (default one half).

p_overnumber

The no-vig over probability at the total (default one half).

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "spread_and_total".

resultobjectrequired

The calculation's numbers

Show 17 fields
home_margin_meannumbernullable

Expected home margin.

home_covernumbernullable

Home covers the spread.

min 0 · max 1

spread_pushnumbernullable

The spread pushes.

min 0 · max 1

away_covernumbernullable

Away covers the spread.

min 0 · max 1

home_winnumbernullable

Home wins.

min 0 · max 1

tienumbernullable

The game ties.

min 0 · max 1

away_winnumbernullable

Away wins.

min 0 · max 1

home_ml_probnumbernullable

Home moneyline probability, ties pushed.

min 0 · max 1

away_ml_probnumbernullable

Away moneyline probability, ties pushed.

min 0 · max 1

home_ml_fairobjectnullable

Fair home moneyline

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

away_ml_fairobjectnullable

Fair away moneyline

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

total_meannumbernullable

Expected total points.

overnumbernullable

The over wins.

min 0 · max 1

total_pushnumbernullable

The total pushes.

min 0 · max 1

undernumbernullable

The under wins.

min 0 · max 1

home_team_totalnumbernullable

Implied home team total.

away_team_totalnumbernullable

Implied away team total.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/half_point_value:evaluate

Calculate: Half-point valueLink to this section

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.

ParametersLink to this section

Body, application/json (required):

linenumber

The spread, book convention: -3.

sidestring

The side buying the half point.

One of: favourite, underdog (open: new values may be added).

default "favourite"

priceobject

The price at the line before buying.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

buy_priceobject

The price the book asks for the half point.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

pinumber

Probability the margin lands on the number crossed, if known.

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "half_point_value".

resultobjectrequired

The calculation's numbers

Show 9 fields
directionstring

off_the_number or onto_the_number.

from_linenumber

The line before buying.

to_linenumber

The line after buying.

numbernumber

The number crossed.

pinumber

Probability the margin lands on that number.

min 0 · max 1

basisstring

Where pi came from: given, or the fitted model.

break_even_decimalnumber

The highest price worth paying, decimal.

break_even_americannumber

The highest price worth paying, American.

win_prob_gainnumber

Win probability the half point adds.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/alternate_lines:evaluate

Calculate: Alternate linesLink to this section

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.

ParametersLink to this section

Body, application/json (required):

main_linenumber

The main line, book convention: -3.

main_probnumber

The side's no-vig probability at the main line.

alt_linesarray of number

Alternate lines to price, in the order wanted.

min items 1 · max items 20

alt_probsarray of number

The market's no-vig probability at each alternate line, in the same order.

min items 1

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "alternate_lines".

resultobjectrequired

The calculation's numbers

Show 1 field
linesarray of objectrequired

Each alternate line, in the order given

Show 6 fields
linenumber

The alternate line.

winnumber

The side covers it.

min 0 · max 1

pushnumber

It pushes.

min 0 · max 1

losenumber

The side fails to cover it.

min 0 · max 1

win_no_pushnumber

Covers, pushes removed.

min 0 · max 1

fairobject

Fair price at that line

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/prop_probability:evaluate

Calculate: Prop probabilityLink to this section

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.

ParametersLink to this section

Body, application/json (required):

linenumber

The prop line.

diststring

The distribution.

One of: poisson, negative_binomial, normal, empirical (open: new values may be added).

meannumber

The mean.

dispersionnumber

Negative binomial dispersion r.

sdnumber

Normal standard deviation.

samplesarray of number

Empirical samples.

min items 1

market_p_overnumber

The no-vig over probability, to imply the mean.

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "prop_probability".

resultobjectrequired

The calculation's numbers

Show 9 fields
overnumberrequired

Probability of the over.

min 0 · max 1

undernumberrequired

Probability of the under.

min 0 · max 1

pushnumber

Probability of a push.

min 0 · max 1

over_no_pushnumber

The over, pushes removed.

min 0 · max 1

mediannumber

The distribution's median.

meannumbernullable

The mean used.

sdnumbernullable

The standard deviation used.

implied_meannumbernullable

The mean the market's no-vig over probability implies.

implied_mediannumbernullable

The median at that mean.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/futures_board:evaluate

Calculate: Futures boardLink to this section

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.

ParametersLink to this section

Body, application/json (required):

pricesobject

Every outcome's price on the board, by name.

devig_methodstring

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_kinteger

Price finishing in the top k.

min 1

pairsarray of array

Head-to-head pairs to price, as [a, b] names, in order.

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "futures_board".

resultobjectrequired

The calculation's numbers

Show 8 fields
fair_probsobjectrequired

Fair probability by outcome, in the order given

fair_pricesobject

Fair price by outcome

side_holdobject

Each outcome's own hold

booksumnumber

Sum of implied probabilities.

overroundnumber

Booksum minus 1.

holdnumber

The board's hold.

top_kobjectnullable

Finishing in the top k

Show 2 fields
kinteger

k.

probsobject

Probability by outcome

head_to_headarray of objectnullable

Each pair, in the order given

Show 5 fields
astring

First outcome.

bstring

Second outcome.

p_a_aheadnumber

Probability a finishes ahead of b.

min 0 · max 1

fair_aobject

Fair price on a

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

fair_bobject

Fair price on b

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

devig_methodstringnullable

De-vig method behind the fair probabilities.

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/betting_splits:evaluate

Calculate: Betting splitsLink to this section

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.

ParametersLink to this section

Body, application/json (required):

pricesobject

Every outcome's price, by name.

bets_shareobject

Each outcome's share of tickets (bets%), 0-1, by the same names as prices.

money_shareobject

Each outcome's share of money staked (money%, handle%), 0-1, by the same names. Leave out when the feed gives tickets only.

devig_methodstring

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"

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "betting_splits".

resultobjectrequired

The calculation's numbers

Show 3 fields
by_outcomeobjectrequired

Each outcome's split, in the order given

market_holdnumberrequired

The market's hold, 1 - 1/booksum.

book_expected_per_100numbernullable

The book's expected result per 100 staked at the fair probabilities.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

devig_methodstringnullable

De-vig method behind the fair probabilities.

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/parlay:evaluate

Calculate: ParlayLink to this section

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.

ParametersLink to this section

Body, application/json (required):

pricesarray of object

Each leg's price, in order.

min items 1

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

probsarray of number

The person's probability for each leg, in price order.

min items 1

kindstring

Parlay, round robin, if-bet or reverse.

One of: parlay, round_robin, if_bet, reverse (open: new values may be added).

default "parlay"

sizesarray of integer

Round robin: parlay sizes, such as [2, 3].

min items 1

pushedarray of integer

Parlay: legs (by position) that pushed or were voided.

winnersarray of integer

Round robin: legs (by position) that won, to settle it.

ticket_stake_minorinteger

Stake per ticket (per combination in a round robin).

min 0

currencystring

ISO 4217 currency code.

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

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "parlay".

resultobjectrequired

The calculation's numbers

Show 28 fields
kindstringrequired

Parlay, round robin, if-bet or reverse.

legsintegernullable

Number of legs.

legs_settledintegernullable

Legs that still count after pushes.

priceobjectnullable

The parlay's price in every format

Show 5 fields
americannumber

American odds.

decimalnumber

Decimal odds.

fractionalstring

Fractional odds, nearest ladder fraction.

centsnumber

Contract price in cents per $1.

implied_probnumber

Implied probability, 1 / decimal.

min 0 · max 1

break_evennumbernullable

Break-even at the parlay's price.

min 0 · max 1

p_all_winnumbernullable

Probability every leg wins.

min 0 · max 1

outcome_countobjectnullable

Times in a hundred (N in 100)

Show 3 fields
countinteger

How many times.

perinteger

Out of how many.

fewer_than_oneboolean

Whether it is fewer than one in that many.

ev_per_unitnumbernullable

Expected value per unit staked.

compounded_holdnumbernullable

Compounded hold, exact form: 1 minus the product of each leg's return.

hold_shortcutnumbernullable

Compounded hold from the legs' holds (shortcut).

hold_linearnumbernullable

The legs' holds summed (overstates).

payoutobjectnullable

What a winning ticket returns

Show 3 fields
return_minorinteger

Total return, stake included. In minor units.

profit_minorinteger

Profit. In minor units.

currencystring

ISO 4217 currency code.

combinationsarray of objectnullable

Round robin: each combination, in input order

Show 3 fields
legsarray of integer

Its legs, by position.

decimalnumber

Its decimal price.

cashesbooleannullable

Whether it cashes, given the winners.

countintegernullable

Round robin: number of combinations.

total_stake_minorintegernullable

Round robin: total staked. In minor units.

expected_return_minorintegernullable

Round robin: expected return. In minor units.

p_any_cashesnumbernullable

Round robin: probability at least one combination cashes.

min 0 · max 1

p_profitnumbernullable

Round robin: probability of a profit.

min 0 · max 1

settled_return_minorintegernullable

Round robin: return given the winners. In minor units.

settled_profit_minorintegernullable

Round robin: profit given the winners. In minor units.

outcomes_minorobjectnullable

If-bet or reverse: net result by outcome, minor units

probabilitiesobjectnullable

If-bet or reverse: probability by outcome

max_exposure_minorintegernullable

If-bet: the most that can be lost. In minor units.

ev_minorintegernullable

If-bet or reverse: expected value. In minor units.

ev_straight_minorintegernullable

If-bet: expected value of two straight bets. In minor units.

leg_rowsarray of objectnullable

Parlay: each leg, in input order

Show 6 fields
leginteger | stringrequired

The leg's position (or name, for a map).

priceobjectrequired

The leg's price in every format

Show 5 fields
americannumber

American odds.

decimalnumber

Decimal odds.

fractionalstring

Fractional odds, nearest ladder fraction.

centsnumber

Contract price in cents per $1.

implied_probnumber

Implied probability, 1 / decimal.

min 0 · max 1

pushedbooleanrequired

Whether the leg pushed or was voided.

running_decimalnumberrequired

The parlay's decimal price after this leg (a pushed leg leaves it unchanged).

running_break_evennumberrequired

The chance every leg so far wins at these prices (1 / running_decimal).

min 0 · max 1

single_profit_minorintegerrequired

What the leg alone, as a straight bet of single_ticket_minor, profits. In minor units.

single_ticket_minorintegernullable

Parlay: the straight bet each leg is shown at (the person's stake, or $100). In minor units.

payout_ladderarray of objectnullable

Parlay: what a winning ticket pays at $10, $25, $50, $100 and the person's stake

Show 3 fields
ticket_minorintegerrequired

The ticket amount. In minor units.

return_minorintegerrequired

Total return, stake included. In minor units.

profit_minorintegerrequired

Profit. In minor units.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/correlated_parlay:evaluate

Calculate: Correlated parlayLink to this section

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

ParametersLink to this section

Body, application/json (required):

book_priceobject

The book's price for the parlay.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

leg_probsarray of number

The person's probability for each leg.

min items 2

joint_probnumber

The person's probability that every leg wins.

correlationnumber

The legs' correlation.

min -1 · max 1

correlation_kindstring

phi (two legs' win indicators) or latent (Gaussian copula).

One of: latent, phi (open: new values may be added).

default "latent"

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "correlated_parlay".

resultobjectrequired

The calculation's numbers

Show 13 fields
book_priceobject

The book's price

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

break_evennumber

Break-even at the book's price.

min 0 · max 1

independent_probnumber

Every leg wins, legs independent.

min 0 · max 1

independent_priceobject

Fair price if independent

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

joint_probnumberrequired

Every leg wins, correlation included.

min 0 · max 1

joint_sourcestring

Where the joint probability came from.

fair_priceobject

Fair price at the joint probability

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

ev_per_unitnumber

Expected value per unit at the book's price.

ev_if_independentnumber

Expected value if the legs were independent.

book_vs_independentnumber

The book's price over the independent price.

implied_phinumbernullable

The phi at which the book's price breaks even.

implied_latent_rhonumbernullable

The latent correlation at which the book's price breaks even.

outcome_countobject

Times in a hundred (N in 100)

Show 3 fields
countinteger

How many times.

perinteger

Out of how many.

fewer_than_oneboolean

Whether it is fewer than one in that many.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

stake_eligiblebooleanrequired

Whether a stake may rest on these inputs (D3, D26).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/teaser:evaluate

Calculate: TeaserLink to this section

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.

ParametersLink to this section

Body, application/json (required):

priceobject

The teaser's price.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

leg_probsarray of number

The person's probability for each teased leg.

min items 2

push_probsarray of number

Each leg's push probability, in leg order.

min items 1

push_rulestring

How a push settles: reduce to fewer legs, or lose.

One of: reduce, lose (open: new values may be added).

default "reduce"

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "teaser".

resultobjectrequired

The calculation's numbers

Show 6 fields
priceobject

The teaser's price in every format

Show 5 fields
americannumber

American odds.

decimalnumber

Decimal odds.

fractionalstring

Fractional odds, nearest ladder fraction.

centsnumber

Contract price in cents per $1.

implied_probnumber

Implied probability, 1 / decimal.

min 0 · max 1

legsinteger

Number of legs.

break_even_per_legnumberrequired

Win rate each leg needs.

min 0 · max 1

p_all_winnumber

Probability every leg wins.

min 0 · max 1

ev_per_unitnumber

Expected value per unit staked.

push_settlementobjectnullable

With pushes

Show 4 fields
rulestring

The push rule.

ev_per_unitnumber

Expected value per unit with pushes.

p_refundnumber

Probability the ticket is refunded.

min 0 · max 1

p_reducednumber

Probability it settles with fewer legs.

min 0 · max 1

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/arbitrage:evaluate

Calculate: ArbitrageLink to this section

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.

ParametersLink to this section

Body, application/json (required):

pricesobject

The best price on every outcome, by name.

total_stake_minorinteger

The total to stake across the outcomes.

min 1

selectionsarray of string

Dutching: the outcomes to back, by name.

min items 1

currencystring

ISO 4217 currency code.

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

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "arbitrage".

resultobjectrequired

The calculation's numbers

Show 6 fields
is_arbitragebooleanrequired

Whether the booksum of the outcomes backed is below 1.

booksumnumberrequired

Sum of implied probabilities at the prices.

payout_minorinteger

What any winning outcome pays. In minor units.

profit_minorinteger

Profit on any winning outcome. In minor units.

return_ratenumber

Profit over the total staked.

currencystring

ISO 4217 currency code.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

stake_eligiblebooleanrequired

Whether a stake may rest on these inputs (D3, D26).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

arithmetic_stakesarray of object

Stakes fixed by the person's own tickets, in ticket order

Show 3 fields
ticketstringrequired

Which ticket or outcome the amount goes on.

amount_minorintegerrequired

The amount in minor units.

currencystringrequired

ISO 4217 currency code.

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/middle:evaluate

Calculate: MiddleLink to this section

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.

ParametersLink to this section

Body, application/json (required):

price_aobject

The first ticket's price.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

price_bobject

The second ticket's price.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

p_middlenumber

Probability both tickets win.

stake_a_minorinteger

The first ticket's stake.

min 1

stake_b_minorinteger

The second ticket's stake.

min 1

p_a_onlynumber

Probability only the first ticket wins.

p_b_onlynumber

Probability only the second ticket wins.

p_push_anumber

Probability the first ticket pushes while the second wins.

min 0 · default 0

p_push_bnumber

Probability the second ticket pushes while the first wins.

min 0 · default 0

currencystring

ISO 4217 currency code.

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

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "middle".

resultobjectrequired

The calculation's numbers

Show 7 fields
outcomes_minorobject

Net result by outcome, minor units

probabilitiesobject

Probability by outcome

ev_minorintegerrequired

Expected value. In minor units.

ev_per_unit_stakednumber

Expected value per unit of the total staked.

break_even_middle_probnumber

The landing probability at which the middle breaks even.

min 0 · max 1

total_staked_minorinteger

Both stakes. In minor units.

currencystring

ISO 4217 currency code.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/hedge:evaluate

Calculate: HedgeLink to this section

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.

ParametersLink to this section

Body, application/json (required):

ticket_stake_minorinteger

The original ticket's stake.

min 1

price_takenobject

The original ticket's price (a parlay's whole price for last_leg).

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

hedge_priceobject

The price available on the other side.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

modestring

Which hedge.

One of: equal_profit, stake_back, partial, log_utility, last_leg, amount (open: new values may be added).

default "equal_profit"

partial_sharenumber

Partial: the share of an equal-profit hedge.

min 0 · max 1

hedge_stake_minorinteger

Amount: the hedge the person names.

min 0

probabilitynumber

The person's probability the original ticket wins.

bankroll_minorinteger

Log-utility hedge: the person's bankroll, the open ticket excluded.

min 1

no_vig_probnumber

Log-utility hedge: the no-vig probability, now, that the original ticket wins, to shrink toward (D26).

shrink_weightnumber

Log-utility hedge: weight on the person's probability when shrinking.

min 0 · max 1 · default 0.5

currencystring

ISO 4217 currency code.

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

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "hedge".

resultobjectrequired

The calculation's numbers

Show 8 fields
modestringrequired

Which hedge.

ticket_return_minorinteger

What the original ticket returns if it wins. In minor units.

outcomes_minorobject

Net result either way, minor units

Show 2 fields
ticket_winsinteger

If the original ticket wins.

hedge_winsinteger

If the hedge wins.

equal_profit_outcome_minorinteger

Profit locked either way by the equal-profit hedge. In minor units.

hedge_priceobject

The hedge's price

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

expected_cost_minorintegernullable

What the hedge costs in expectation at the person's probability. In minor units.

sizednull

Null off askkelly.ai: stake mode is first-party only (D34).

weaknull

Null off askkelly.ai: stake mode is first-party only (D34).

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

stake_eligiblebooleanrequired

Whether a stake may rest on these inputs (D3, D26).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

stakenull

Null off askkelly.ai: stake mode is first-party only (D34).

stake_minornull

Null off askkelly.ai: stake mode is first-party only (D34).

kelly_criterion_fractionnull

Null off askkelly.ai: stake mode is first-party only (D34).

arithmetic_stakesarray of object

Stakes fixed by the person's own tickets, in ticket order

Show 3 fields
ticketstringrequired

Which ticket or outcome the amount goes on.

amount_minorintegerrequired

The amount in minor units.

currencystringrequired

ISO 4217 currency code.

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/cash_out:evaluate

Calculate: Cash-out valueLink to this section

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.

ParametersLink to this section

Body, application/json (required):

offer_minorinteger

The cash-out offer.

min 0

ticket_stake_minorinteger

The ticket's stake.

min 1

price_takenobject

The ticket's price.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

fair_probnumber

The ticket's fair probability now.

hedge_priceobject

The price on the other side, to compare a hedge.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

currencystring

ISO 4217 currency code.

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

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "cash_out".

resultobjectrequired

The calculation's numbers

Show 8 fields
fair_value_minorintegerrequired

The ticket's fair value now. In minor units.

offer_minorinteger

The offer. In minor units.

gives_up_minorinteger

What the offer gives up against fair value. In minor units.

marginnumber

The offer's cut, 1 - offer / fair value.

ticket_return_minorinteger

What the ticket returns if it wins. In minor units.

hedge_value_minorintegernullable

What an equal-profit hedge makes instead, win or lose. In minor units.

offer_vs_hedge_minorintegernullable

The offer minus the hedge's locked value. In minor units.

currencystring

ISO 4217 currency code.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/bonus_bet:evaluate

Calculate: Bonus betsLink to this section

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.

ParametersLink to this section

Body, application/json (required):

kindstring

The promotion.

One of: free_bet_conversion, qualifying_bet, no_sweat, boost, rollover (open: new values may be added).

amount_minorinteger

The free bet, stake, back stake or bonus.

min 0

bonus_priceobject

The price the bonus or back bet is placed at.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

hedge_priceobject

Free-bet conversion at a sportsbook: the price on the other side.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

lay_priceobject

Exchange lay price (free-bet conversion or a qualifying bet).

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

commissionnumber

Exchange commission on net winnings.

min 0 · default 0

stake_returnedboolean

Free bet: whether a win returns the stake.

default false

probabilitynumber

The person's probability the bet wins.

conversion_ratenumber

No-sweat: the share of a refunded bonus the person expects to keep.

boostnumber

Boost: the profit boost, 0.5 for 50%.

rollovernumber

Rollover: times the bonus must be wagered.

currencystring

ISO 4217 currency code.

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

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "bonus_bet".

resultobjectrequired

The calculation's numbers

Show 17 fields
kindstringrequired

The promotion.

outcomes_minorobjectnullable

Net result by outcome, minor units

profit_minorintegernullable

Profit locked either way. In minor units.

conversionnumbernullable

Share of the free bet kept.

ceilingnumbernullable

The most any conversion at this price can keep.

liability_minorintegernullable

The lay's liability. In minor units.

qualifying_loss_minorintegernullable

A qualifying bet's result either way. In minor units.

ev_minorintegernullable

Expected value. In minor units.

ev_cash_part_minorintegernullable

No-sweat: expected value of the cash bet. In minor units.

ev_refund_part_minorintegernullable

No-sweat: expected value of the refund. In minor units.

boosted_priceobjectnullable

The boosted price

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

break_evennumbernullable

Break-even at the boosted price.

min 0 · max 1

ev_per_unitnumbernullable

Expected value per unit at the boosted price.

wagering_required_minorintegernullable

Rollover: total wagering required. In minor units.

expected_loss_per_unitnumbernullable

Rollover: expected loss per unit wagered.

rollover_cost_minorintegernullable

Rollover: expected cost of the wagering. In minor units.

currencystring

ISO 4217 currency code.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

stake_eligiblebooleanrequired

Whether a stake may rest on these inputs (D3, D26).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

arithmetic_stakesarray of object

Stakes fixed by the person's own tickets, in ticket order

Show 3 fields
ticketstringrequired

Which ticket or outcome the amount goes on.

amount_minorintegerrequired

The amount in minor units.

currencystringrequired

ISO 4217 currency code.

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/stake_size:evaluate

Calculate: Stake sizeLink to this section

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

ParametersLink to this section

Body, application/json (required):

probabilitynumber

The person's own probability.

priceobject

The price the person is getting.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

bankroll_minorinteger

The person's bankroll.

min 1

currencystring

ISO 4217 currency code.

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

fractionnumber

Share of the Kelly criterion (D26: 0.2 to 0.5).

min 0.2 · max 0.5 · default 0.25

no_vig_probnumber

The no-vig market probability to shrink toward.

reference_pricesobject

A market's prices, to take the no-vig probability from.

selectionstring

With reference_prices: the outcome bet.

devig_methodstring

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_weightnumber

Weight on the person's probability when shrinking (D26).

min 0 · max 1 · default 0.5

cap_betnumber

Largest share of bankroll on one bet (D26: 1%, at most 2%).

max 0.02 · default 0.01

cap_slatenumber

Largest share of bankroll on a slate (D26: 10%, at most 15%).

max 0.15 · default 0.1

slate_exposurenumber

Share of bankroll already staked on the slate.

min 0 · max 1 · default 0

push_probnumber

Probability of a push.

min 0 · default 0

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "stake_size".

resultobjectrequired

The calculation's numbers

Show 11 fields
break_evennumberrequired

Break-even win rate at the price.

min 0 · max 1

no_vig_probnumbernullable

The no-vig market probability shrunk toward.

min 0 · max 1

shrink_weightnumberrequired

Weight on the person's probability.

fraction_appliednumber

Share of the Kelly criterion applied.

capsobject

The caps applied

Show 3 fields
betnumber

Largest share of bankroll on one bet.

slatenumber

Largest share of bankroll on a slate.

slate_exposurenumber

Share already staked on the slate.

expected_valuenumber

Expected value per unit at the shrunk probability.

growth_curvearray of object

Growth kept by share of the Kelly criterion (the growth-curve explainer, D3)

Show 2 fields
fractionnumber

Share of the Kelly criterion.

growth_sharenumber

Share of the full Kelly criterion's growth kept.

ceiling_fractionnull

Null off askkelly.ai: stake mode is first-party only (D34).

stake_fractionnull

Null off askkelly.ai: stake mode is first-party only (D34).

cap_appliednull

Null off askkelly.ai: stake mode is first-party only (D34).

weaknull

Null off askkelly.ai: stake mode is first-party only (D34).

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

stake_eligiblebooleanrequired

Whether a stake may rest on these inputs (D3, D26).

basisstringrequired

Where the fair price came from.

One of: person_prices, person_probability, kelly_consensus (open: new values may be added).

devig_methodstringnullable

De-vig method behind the fair probabilities.

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

shrink_appliedboolean

Whether the probability was shrunk toward the no-vig market (D26).

shrunk_probnumber

The person's probability, shrunk toward the no-vig market.

min 0 · max 1

ev_vs_no_vignumbernullable

EV per unit at the person's price against the no-vig market (D34).

drawdown_by_fractionarray of object

Drawdown risk by share of the Kelly criterion

Show 3 fields
fractionnumberrequired

Share of the Kelly criterion (0.25 is a quarter).

drawdownnumberrequired

The drawdown, as a share of bankroll.

min 0 · max 1

probabilitynumberrequired

Probability of ever falling that far (Thorp's lognormal approximation).

min 0 · max 1

stakenull

Null off askkelly.ai: stake mode is first-party only (D34).

stake_minornull

Null off askkelly.ai: stake mode is first-party only (D34).

kelly_criterion_fractionnull

Null off askkelly.ai: stake mode is first-party only (D34).

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/bankroll_risk:evaluate

Calculate: Bankroll riskLink to this section

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.

ParametersLink to this section

Body, application/json (required):

kindstring

Which risk.

One of: ruin, drawdown, goal, losing_season, progression (open: new values may be added).

probabilitynumber

The person's win probability.

priceobject

The price bet.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

fractionnumber

Share of the Kelly criterion.

floornumber

The floor, as a share of the starting bankroll.

default 0.5

goalnumber

Goal: a multiple of the starting bankroll.

default 2

tolerancenumber

Drawdown: the chance of ever reaching the floor the person accepts.

basisstring

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"

strategystring

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_betsinteger

Number of bets.

min 1

bankroll_unitsnumber

Bankroll in betting units.

target_unitsnumber

Target in betting units.

stake_unitsnumber

Goal with flat bets: units per bet.

systemstring

Progression: martingale or fixed_fraction.

One of: martingale, fixed_fraction (open: new values may be added).

base_unitsnumber

Martingale: the base bet in units.

doublingsinteger

Martingale: doublings allowed before the cap.

min 1

sharenumber

Fixed fraction: share of bankroll per bet.

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "bankroll_risk".

resultobjectrequired

The calculation's numbers

Show 33 fields
kindstringrequired

Which risk.

probabilitynumbernullable

The headline probability for this risk.

min 0 · max 1

outcome_countobjectnullable

Times in a hundred (N in 100)

Show 3 fields
countinteger

How many times.

perinteger

Out of how many.

fewer_than_oneboolean

Whether it is fewer than one in that many.

lundberg_exponentnumbernullable

Ruin: the Lundberg exponent.

ruin_boundnumbernullable

Ruin: the Lundberg bound on ever being ruined.

min 0 · max 1

bound_is_exactbooleannullable

Ruin: whether the bound is exact here.

diffusion_infinitenumbernullable

Ruin: diffusion approximation, any horizon.

min 0 · max 1

diffusion_finitenumbernullable

Ruin: diffusion approximation within n bets.

min 0 · max 1

exact_finitenumbernullable

Ruin: exact within n bets.

min 0 · max 1

reach_targetnumbernullable

Reaching the target first.

min 0 · max 1

expected_betsnumbernullable

Expected bets until ruin or the target.

floornumbernullable

Drawdown: the floor.

multiplenumbernullable

Share of the Kelly criterion used.

within_n_betsobjectnullable

Drawdown within n bets

Show 5 fields
touch_probnumber

Touching the floor.

min 0 · max 1

end_below_floor_probnumber

Ending below the floor.

min 0 · max 1

end_below_start_probnumber

Ending below the start.

min 0 · max 1

end_double_probnumber

Ending doubled.

min 0 · max 1

median_multiplenumber

Median ending multiple.

budget_multiplenumbernullable

Drawdown budget: the share of the Kelly criterion it allows.

rck_multiplenumbernullable

Drawdown budget: risk-constrained Kelly criterion as a share.

expected_max_drawdownobjectnullable

Flat stakes: expected maximum drawdown, in units

Show 5 fields
mean_per_betnumber

Mean result per bet.

sd_per_betnumber

SD per bet.

xnumber

The scaled horizon.

large_xnumber

Large-horizon form.

small_xnumber

Small-horizon form.

bets_to_goalnumbernullable

Goal: median bets to reach it.

ruin_before_targetnumbernullable

Goal with flat bets: ruin first.

min 0 · max 1

expected_handle_unitsnumbernullable

Goal: expected total wagered, units.

expected_final_unitsnumbernullable

Goal with flat bets: expected final bankroll, units.

zero_edge_benchmarknumbernullable

Goal: the chance at zero edge.

min 0 · max 1

exactnumbernullable

Losing season: exact.

min 0 · max 1

normalnumbernullable

Losing season: normal approximation.

min 0 · max 1

bust_probnumbernullable

Martingale: busting a cycle.

min 0 · max 1

expected_wager_unitsnumbernullable

Martingale: expected wagered per cycle, units.

ev_per_cycle_unitsnumbernullable

Martingale: expected result per cycle, units.

return_per_dollarnumbernullable

Expected return per unit wagered.

flat_meannumbernullable

Fixed fraction: flat bets' mean ending multiple.

fraction_meannumbernullable

Fixed fraction: mean ending multiple.

flat_mediannumbernullable

Fixed fraction: flat bets' median ending multiple.

fraction_mediannumbernullable

Fixed fraction: median ending multiple.

kelly_criterion_fractionnull

Null off askkelly.ai: stake mode is first-party only (D34).

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/closing_line_value:evaluate

Calculate: Closing-line valueLink to this section

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.

ParametersLink to this section

Body, application/json (required):

price_takenobject

The price the bet was taken at.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

close_probnumber

The fair closing probability.

close_pricesobject

The closing market's prices, by outcome.

selectionstring

With close_prices: the outcome bet.

devig_methodstring

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"

clvsarray of number

Price-based CLVs of a set of bets, for their significance.

min items 2

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "closing_line_value".

resultobjectrequired

The calculation's numbers

Show 8 fields
close_probnumbernullable

The fair closing probability.

min 0 · max 1

clv_pricenumbernullable

Price-based CLV: close probability times the price taken, minus 1.

clv_probnumbernullable

Probability-based CLV: close probability minus the break-even.

expected_roinumbernullable

The return the CLV implies.

break_even_takennumbernullable

Break-even at the price taken.

min 0 · max 1

fair_close_priceobjectnullable

Fair closing price

Show 2 fields
decimalnumber

Decimal odds.

americannumber

American odds.

raw_clvnumbernullable

CLV against the vigged close (overstates).

significanceobjectnullable

A CLV sample's significance

Show 7 fields
ninteger

Bets.

meannumber

Mean CLV.

sdnumber

SD of CLV.

std_errornumber

Standard error.

tnumber

t statistic.

ci95array of number

95% interval.

min items 2 · max items 2

bets_needednumbernullable

Bets a t of 2 needs at this mean and spread.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

basisstringrequired

Where the fair price came from.

One of: person_prices, person_probability, kelly_consensus (open: new values may be added).

devig_methodstringnullable

De-vig method behind the fair probabilities.

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/record_test:evaluate

Calculate: Record testLink to this section

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.

ParametersLink to this section

Body, application/json (required):

winsinteger

Wins.

min 0

lossesinteger

Losses.

min 0

pushesinteger

Pushes.

min 0 · default 0

priceobject

The price every bet was taken at.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

pricesarray of object

Each bet's price, in order (wins first, then losses).

min items 1

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

testsinteger

How many records or angles were tried (multiple comparisons).

min 1 · default 1

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "record_test".

resultobjectrequired

The calculation's numbers

Show 20 fields
winsinteger

Wins.

lossesinteger

Losses.

pushesinteger

Pushes.

unitsnumber

Profit in flat-bet units.

roinumber

Return on the amount staked.

win_ratenumberrequired

Wins over wins plus losses.

min 0 · max 1

break_evennumberrequired

The break-even win rate.

min 0 · max 1

over_break_evennumber

Win rate minus the break-even.

no_skill_match_probnumber

How often a bettor at the break-even does this well.

min 0 · max 1

no_skill_match_per_100number

The same, in 100.

coin_match_probnumber

How often a 50% picker does this well.

min 0 · max 1

coin_match_per_100number

The same, in 100.

znumber

z against the break-even.

normal_pnumber

One-sided p-value, normal approximation.

min 0 · max 1

roi_std_errornumber

Standard error of the ROI.

roi_intervalarray of number

95% interval for the ROI.

min items 2 · max items 2

significantboolean

Whether the record beats the break-even at 5%.

sample_neededobjectnullable

Bets needed to show this win rate

Show 5 fields
one_sidednumber

One-sided at 5%.

with_powernumber

With 80% power.

two_senumber

By the 2-SE rule.

hoeffding_one_sidednumber

By Hoeffding's bound.

at_win_ratenumber

The win rate assumed.

min 0 · max 1

multiple_comparisonsobjectnullable

Control for the number of tests

Show 6 fields
testsinteger

Tests tried.

bonferroni_thresholdnumber

Bonferroni p threshold.

bonferroni_survivesboolean

Survives Bonferroni.

bonferroni_adjusted_pnumber

Bonferroni-adjusted p-value.

benjamini_hochberg_survives_aloneboolean

Survives Benjamini-Hochberg on its own.

familywise_error_uncorrectednumber

Chance of a false positive among the tests, uncorrected.

test_martingaleobjectnullable

Test martingale (e-process)

Show 6 fields
e_valuenumber

The e-value.

anytime_p_boundnumber

Anytime-valid p bound.

crossed_at_endboolean

Whether it crossed 1/alpha.

stake_rulestring

The betting rule.

betting_fractionnumber

The test's betting fraction (a test parameter, not a stake).

orderedboolean

Whether the bets were in time order.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/after_tax_break_even:evaluate

Calculate: After-tax break-evenLink to this section

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.

ParametersLink to this section

Body, application/json (required):

priceobject

The price.

Show 4 fields
americannumber

American odds: -110, +125. None lies strictly between -100 and +100.

decimalnumber

Decimal odds, stake included: 1.91.

fractionalstring

Fractional odds: "5/2".

pattern ^[0-9]+/[0-9]+$

centsnumber

A prediction-market contract price in cents per $1.

tax_ratenumber

Marginal tax rate.

min 0 · max 1 · default 0

itemizerboolean

Whether the person itemizes.

default true

loss_capnumber

Share of losses deductible (0.9 from tax year 2026).

min 0 · max 1 · default 0.9

fee_minorinteger

A per-wager fee.

min 0

ticket_stake_minorinteger

The stake the fee applies to.

min 1

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "after_tax_break_even".

resultobjectrequired

The calculation's numbers

Show 5 fields
break_evennumberrequired

Win rate needed after tax and fees.

min 0 · max 1

pre_tax_break_evennumber

Win rate needed before tax.

min 0 · max 1

risenumber

How much tax and fees raise the break-even.

roi_needednumber

Pre-tax return needed to break even after tax.

fee_cost_per_unitnumber

The fee per unit staked.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available · needs_jurisdiction

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/gambling_tax:evaluate

Calculate: Gambling taxLink to this section

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.

ParametersLink to this section

Body, application/json (required):

winnings_minorinteger

The year's gross winnings: the profit on every winning bet.

min 0

losses_minorinteger

The year's gross losses: the stakes on every losing bet.

min 0

tax_yearinteger

The tax year, which sets the share of losses deductible.

min 2000 · max 2100

federal_ratenumber

The person's federal marginal rate.

min 0 · max 1

itemizerboolean

Whether the person itemizes.

default true

state_ratenumber

The person's state rate on gambling income.

min 0 · max 1 · default 0

state_deducts_lossesboolean

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_minorinteger

Tax already withheld, such as on W-2Gs.

min 0

currencystring

ISO 4217 currency code.

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

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "gambling_tax".

resultobjectrequired

The calculation's numbers

Show 15 fields
winnings_minorinteger

Gross winnings. In minor units.

losses_minorinteger

Gross losses. In minor units.

net_result_minorinteger

Winnings minus losses: what was actually won. In minor units.

loss_capnumber

The share of losses deductible in the tax year.

min 0 · max 1

deduction_minorinteger

The losses deducted: the lower of the capped losses and the winnings. In minor units.

taxable_minorintegerrequired

Taxable gambling income, federal. In minor units.

taxed_not_won_minorinteger

Taxable income beyond what was actually won (the loss cap's cost). In minor units.

federal_tax_minorinteger

Federal tax at the person's rate. In minor units.

state_taxable_minorinteger

The income the state rate applies to. In minor units.

state_tax_minorinteger

State tax at the person's rate. In minor units.

total_tax_minorintegerrequired

Federal and state tax. In minor units.

after_tax_minorinteger

Winnings minus losses minus the tax. In minor units.

withheld_minorinteger

Tax already withheld. In minor units.

set_aside_minorinteger

The tax still to pay: the total less what was withheld, never below zero. In minor units.

currencystring

ISO 4217 currency code.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z
Request
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" }

Response, 422
{
  "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 meanLink to this section

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.

ParametersLink to this section

Body, application/json (required):

observednumber

The observed rate or average.

nnumber

The sample size behind it.

prior_meannumber

The population mean.

knumber

The stabilisation point.

reliabilitynumber

The stat's reliability at reliability_at trials, instead of k.

reliability_atnumber

The sample size the reliability was measured at.

target_reliabilitynumber

The reliability to report the trials needed for.

default 0.7

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "regression_to_mean".

resultobjectrequired

The calculation's numbers

Show 8 fields
estimatenumberrequired

The true-talent estimate.

data_weightnumber

Weight on the observed value, n / (n + k).

min 0 · max 1

prior_weightnumber

Weight on the population mean.

min 0 · max 1

regressionnumber

How far the estimate moved toward the mean.

knumber

The stabilisation point used.

stabilisation_pointnumber

Trials at which the data and the mean weigh the same.

trials_for_targetnumber

Trials needed for the target reliability.

target_reliabilitynumber

The target reliability.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

POST /v1/calculations/pickem_entry:evaluate

Calculate: Pick'em entryLink to this section

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

ParametersLink to this section

Body, application/json (required):

leg_probsarray of number

The person's probability for each pick, in order.

min items 2 · max items 8

payout_tableobject

Multiplier by number of hits, such as {"6": 37.5}.

formatstring

Entry format.

One of: power, flex (open: new values may be added).

default "power"

entry_fee_minorinteger

The entry fee.

min 1 · default 1000

latent_correlationnumber

Correlation between picks (one-factor copula).

min -1 · max 1 · default 0

currencystring

ISO 4217 currency code.

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

ResponseLink to this section

200 The calculation's result.

objectconstrequired

Always calculation_result.

Always "calculation_result".

calcconstrequired

The calculation.

Always "pickem_entry".

resultobjectrequired

The calculation's numbers

Show 14 fields
legsinteger

Number of picks.

formatstring

Entry format.

hitsobject

Probability of each number of hits

p_all_hitnumber

Every pick hits.

min 0 · max 1

p_any_payoutnumber

The entry pays anything.

min 0 · max 1

expected_multiplenumber

Expected payout multiple.

ev_per_unitnumberrequired

Expected value per unit of entry fee.

expected_return_minorinteger

Expected return per entry. In minor units.

expected_cost_minorinteger

Expected cost per entry (negative is a gain). In minor units.

break_even_legnumbernullable

Win rate each pick needs, for equal picks.

min 0 · max 1

break_even_all_hitnumbernullable

Power: probability every pick must hit to break even.

min 0 · max 1

all_hit_countobject

Times in a hundred (N in 100)

Show 3 fields
countinteger

How many times.

perinteger

Out of how many.

fewer_than_oneboolean

Whether it is fewer than one in that many.

return_distributionarray of object

Payout multiples and their probabilities

Show 2 fields
multiplenumber

The multiple.

pnumber

Its probability.

min 0 · max 1

currencystring

ISO 4217 currency code.

inputs_usedarray of objectrequired

Every input given, in the order given, with its source

Show 3 fields
namestringrequired

The input's name.

valueanyrequired

The value used, as given.

sourcestringrequired

Who supplied it: person, market or kelly.

One of: person, market, kelly (open: new values may be added).

stake_eligiblebooleanrequired

Whether a stake may rest on these inputs (D3, D26).

method_paramsobjectrequired

Solved method parameters, such as power_k

diagnosticsobject

Solver diagnostics (iterations, converged)

warningsarray of stringrequired

Warning codes

formulasarray of stringrequired

Formula cards used

engine_buildstringrequired

The engine build that computed it.

api_versionstringnullable

The API version that served it (set by the surface, K10).

rg_linestringnullable

The cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.

assumptionsarray of stringrequired

Defaults applied

as_ofstring

When it was computed (UTC).

format date-time

sourcestring

Who computed it, as shown to readers.

attributionstringnullable

Attribution the source's terms require.

request_idstringnullable

The request that produced this response.

live_topicsarray of string

Kelly Wire topics that update this resource (API and cards only).

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · invalid_inputs · calc_not_available

ExampleLink to this section

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

Response, 200
{
  "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": []
}
  1. Kelly · as of 2026-10-04T17:30:00Z

Generated from Kelly API 2026-10-05.

Support: support@askkelly.ai · Security and disclosure