calculations
Copy page
Run betting and fantasy maths on your own numbers: odds, no-vig, value, parlays, hedges, stakes and records.
On this page
- List calculations
- Parameters
- Response
- Errors
- Example
- Get a calculation
- Parameters
- Response
- Errors
- Example
- Calculate: Convert odds
- Parameters
- Response
- Errors
- Example
- Calculate: Remove the vig
- Parameters
- Response
- Errors
- Example
- Calculate: Bet value
- Parameters
- Response
- Errors
- Example
- Calculate: Spread, moneyline and totals
- Parameters
- Response
- Errors
- Example
- Calculate: Half-point value
- Parameters
- Response
- Errors
- Example
- Calculate: Alternate lines
- Parameters
- Response
- Errors
- Example
- Calculate: Prop probability
- Parameters
- Response
- Errors
- Example
- Calculate: Futures board
- Parameters
- Response
- Errors
- Example
- Calculate: Betting splits
- Parameters
- Response
- Errors
- Example
- Calculate: Parlay
- Parameters
- Response
- Errors
- Example
- Calculate: Correlated parlay
- Parameters
- Response
- Errors
- Example
- Calculate: Teaser
- Parameters
- Response
- Errors
- Example
- Calculate: Arbitrage
- Parameters
- Response
- Errors
- Example
- Calculate: Middle
- Parameters
- Response
- Errors
- Example
- Calculate: Hedge
- Parameters
- Response
- Errors
- Example
- Calculate: Cash-out value
- Parameters
- Response
- Errors
- Example
- Calculate: Bonus bets
- Parameters
- Response
- Errors
- Example
- Calculate: Stake size
- Parameters
- Response
- Errors
- Example
- Calculate: Bankroll risk
- Parameters
- Response
- Errors
- Example
- Calculate: Closing-line value
- Parameters
- Response
- Errors
- Example
- Calculate: Record test
- Parameters
- Response
- Errors
- Example
- Calculate: After-tax break-even
- Parameters
- Response
- Errors
- Example
- Calculate: Gambling tax
- Parameters
- Response
- Errors
- Example
- Calculate: Regression to the mean
- Parameters
- Response
- Errors
- Example
- Calculate: Pick'em entry
- Parameters
- Response
- Errors
- Example
| Method | Path | Title | Access | Price | MCP tool |
|---|---|---|---|---|---|
| GET | /v1/calculations | List calculations | public | 1 | none |
| GET | /v1/calculations/{calc} | Get a calculation | public | 1 | none |
| POST | /v1/calculations/convert_odds:evaluate | Calculate: Convert odds | public | 1 | calculate_odds |
| POST | /v1/calculations/remove_vig:evaluate | Calculate: Remove the vig | public | 1 | calculate_odds |
| POST | /v1/calculations/bet_value:evaluate | Calculate: Bet value | public | 1 | calculate_odds |
| POST | /v1/calculations/spread_and_total:evaluate | Calculate: Spread, moneyline and totals | public | 1 | calculate_odds |
| POST | /v1/calculations/half_point_value:evaluate | Calculate: Half-point value | public | 1 | calculate_odds |
| POST | /v1/calculations/alternate_lines:evaluate | Calculate: Alternate lines | public | 1 | calculate_odds |
| POST | /v1/calculations/prop_probability:evaluate | Calculate: Prop probability | public | 1 | calculate_odds |
| POST | /v1/calculations/futures_board:evaluate | Calculate: Futures board | public | 1 | calculate_odds |
| POST | /v1/calculations/betting_splits:evaluate | Calculate: Betting splits | public | 1 | calculate_odds |
| POST | /v1/calculations/parlay:evaluate | Calculate: Parlay | public | 1 | calculate_odds |
| POST | /v1/calculations/correlated_parlay:evaluate | Calculate: Correlated parlay | public | 1 | calculate_odds |
| POST | /v1/calculations/teaser:evaluate | Calculate: Teaser | public | 1 | calculate_odds |
| POST | /v1/calculations/arbitrage:evaluate | Calculate: Arbitrage | public | 1 | calculate_odds |
| POST | /v1/calculations/middle:evaluate | Calculate: Middle | public | 1 | calculate_odds |
| POST | /v1/calculations/hedge:evaluate | Calculate: Hedge | public | 1 | calculate_odds |
| POST | /v1/calculations/cash_out:evaluate | Calculate: Cash-out value | public | 1 | calculate_odds |
| POST | /v1/calculations/bonus_bet:evaluate | Calculate: Bonus bets | public | 1 | calculate_odds |
| POST | /v1/calculations/stake_size:evaluate | Calculate: Stake size | public | 1 | calculate_odds |
| POST | /v1/calculations/bankroll_risk:evaluate | Calculate: Bankroll risk | public | 1 | calculate_odds |
| POST | /v1/calculations/closing_line_value:evaluate | Calculate: Closing-line value | public | 1 | calculate_odds |
| POST | /v1/calculations/record_test:evaluate | Calculate: Record test | public | 1 | calculate_odds |
| POST | /v1/calculations/after_tax_break_even:evaluate | Calculate: After-tax break-even | public | 1 | calculate_odds |
| POST | /v1/calculations/gambling_tax:evaluate | Calculate: Gambling tax | public | 1 | calculate_odds |
| POST | /v1/calculations/regression_to_mean:evaluate | Calculate: Regression to the mean | public | 1 | calculate_odds |
| POST | /v1/calculations/pickem_entry:evaluate | Calculate: Pick'em entry | public | 1 | calculate_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 · queryOnly 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 · queryavailable or not_available.
One of: available, not_available (open: new values may be added).
ResponseLink to this section
200 The calculations, in catalogue order.
objectconstrequiredAlways calculation_list.
Always "calculation_list".
countintegerrequiredHow many calculations match.
familiesarray of stringrequiredThe families, in catalogue order.
dataarray of objectrequiredThe calculations.
Show 13 fields
namestringrequiredIts name, as the evaluate path and calculate_odds' calc spell it (bet_value).
titlestringrequiredIts title (Bet value).
familystringrequiredIts 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).
statusstringrequiredavailable, or not_available (listed, answering calc_not_available until it ships).
One of: available, not_available (open: new values may be added).
sessionstringnullableThe build session that ships it, while it is not available.
neareststringnullableThe nearest calculation that works now, while it is not available.
formulasarray of stringrequiredThe formula cards it implements, with their versions (F1.4@1).
stake_policystringrequirednone; 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).
simulatesstringnullableWhether it simulates: optional, bootstrap or yes; null when it never does.
creditsintegerrequiredCredits per call.
credit_unitconstWhat the credits are per: always call.
Always "call".
operation_idstringrequiredIts evaluate operation (evaluate_bet_value).
evaluatestringrequiredIts evaluate route, method and path.
has_morebooleanrequiredAlways false: the list is never paged (API-PAGE-1).
next_cursorstringrequirednullableAlways null: the list is never paged (API-PAGE-1).
as_ofstringWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringWho produced the value, as shown to readers.
min length 1
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly Wire topics that update this resource (API and cards only).
rg_linestringnullableThe 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
GET https://api.askkelly.ai/v1/calculations?status=available{
"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
}- 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 · pathrequiredThe 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.
objectconstrequiredAlways calculation.
Always "calculation".
namestringrequiredIts name, as the evaluate path and calculate_odds' calc spell it (bet_value).
titlestringrequiredIts title (Bet value).
familystringrequiredIts 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).
statusstringrequiredavailable, or not_available (listed, answering calc_not_available until it ships).
One of: available, not_available (open: new values may be added).
sessionstringnullableThe build session that ships it, while it is not available.
neareststringnullableThe nearest calculation that works now, while it is not available.
formulasarray of stringrequiredThe formula cards it implements, with their versions (F1.4@1).
stake_policystringrequirednone; 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).
simulatesstringnullableWhether it simulates: optional, bootstrap or yes; null when it never does.
creditsintegerrequiredCredits per call.
credit_unitconstWhat the credits are per: always call.
Always "call".
operation_idstringrequiredIts evaluate operation (evaluate_bet_value).
evaluatestringrequiredIts evaluate route, method and path.
input_schemaobjectrequiredThe request body evaluate takes, as JSON Schema 2020-12.
result_schemaobjectrequiredThe calculation_result evaluate returns, as JSON Schema 2020-12.
examplesarray of objectrequiredWorked examples, each a body you can send.
Show 3 fields
titlestringrequiredWhat it shows, with its answer.
cardstringrequiredThe formula card it comes from (F14.7).
inputsobjectrequiredA request body evaluate takes as it stands.
as_ofstringWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringWho produced the value, as shown to readers.
min length 1
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly Wire topics that update this resource (API and cards only).
rg_linestringnullableThe 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
GET https://api.askkelly.ai/v1/calculations/gambling_tax{
"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
}- kelly · as of 2026-11-12T00:00:00Z
GET https://api.askkelly.ai/v1/calculations/vlookup{
"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):
priceobjectThe price to convert.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
probabilitynumberA probability to price fairly (F1.5).
ticket_stake_minorintegerA ticket's stake, for what it returns.
min 0
currencystringISO 4217 currency code.
pattern ^[A-Z]{3}$ · default "USD"
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "convert_odds".
resultobjectrequiredThe calculation's numbers
Show 7 fields
priceobjectThe price in every format
Show 5 fields
americannumberAmerican odds.
decimalnumberDecimal odds.
fractionalstringFractional odds, nearest ladder fraction.
centsnumberContract price in cents per $1.
implied_probnumberImplied probability, 1 / decimal.
min 0 · max 1
implied_probnumberImplied probability at the price, vig in.
min 0 · max 1
break_evennumberBreak-even win rate at the price.
min 0 · max 1
profit_per_unitnumberProfit on a winning stake of 1, O − 1 (0.9091 at −110).
to_win_100objectThe bet that wins 100 in the currency (a bet of 110 at −110 wins 100)
Show 2 fields
risk_minorintegerThe bet that wins 100. In minor units.
profit_minorintegerThe profit, 100. In minor units.
fair_priceobjectThe fair price for the probability
Show 2 fields
decimalnumberDecimal odds.
americannumberAmerican odds.
payoutobjectWhat a winning ticket returns
Show 3 fields
return_minorintegerTotal return, stake included. In minor units.
profit_minorintegerProfit. In minor units.
currencystringISO 4217 currency code.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
POST https://api.askkelly.ai/v1/calculations/convert_odds:evaluate
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"price": {
"american": -110
}
}
{
"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": []
}- 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):
pricesobjectEvery outcome's price, by name.
devig_methodstringDe-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.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "remove_vig".
resultobjectrequiredThe calculation's numbers
Show 11 fields
fair_probsobjectrequiredFair probability by outcome, in the order given
implied_probsobjectImplied probability by outcome at the price given, vig in
fair_pricesobjectFair price by outcome, the price with the vig removed; null for an outcome the method prices at zero
side_holdobjectEach outcome's own hold: the share of its price that is vig
cost_per_100_minorobjectWhat $100 on each outcome gives up on average at its fair probability, in cents
method_rangeobjectEach outcome's fair probability, lowest and highest across the distinct de-vig methods
booksumnumberSum of implied probabilities.
overroundnumberBooksum minus 1.
holdnumberrequiredThe books' hold, 1 - 1/booksum.
kept_per_100_minorintegerWhat the book keeps of every $100 bet on the market when the action pays the same whichever side wins, in cents.
by_methodobjectnullableWorst case: fair probabilities by method
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
devig_methodstringnullableDe-vig method behind the fair probabilities.
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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"
}
{
"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": []
}- 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):
priceobjectThe price the person is offered.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
selectionstringThe outcome bet, a key of reference_prices.
reference_pricesobjectA market's prices to take the fair probability from.
fair_probnumberThe person's own fair probability, instead of reference prices.
devig_methodstringDe-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_probnumberProbability of a push.
min 0
required_edgenumberEdge per unit the minimum price must leave.
min 0 · default 0
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "bet_value".
resultobjectrequiredThe calculation's numbers
Show 11 fields
selectionstringnullableThe outcome bet.
fair_probnumberrequiredFair probability of the outcome.
min 0 · max 1
fair_methodstringnullableThe de-vig method that gave the fair probability.
break_evennumberrequiredBreak-even win rate at the price.
min 0 · max 1
ev_per_unitnumberrequiredExpected value per unit staked.
prob_over_break_evennumberFair probability minus the break-even.
min_priceobjectThe lowest price worth taking
Show 2 fields
decimalnumberDecimal odds.
americannumberAmerican odds.
reference_holdnumbernullableHold of the reference market.
by_methodobjectnullableFair probability by de-vig method
ev_by_methodobjectnullableExpected value per unit by de-vig method
ev_profileobjectnullableWhat the EV means on the person's own numbers, per $100 staked (kmath.ev); null on a consensus reference
Show 13 fields
ev_per_unitnumberExpected value per unit staked.
ev_per_100_minorintegerExpected profit per $100 bet, in cents.
win_profit_per_100_minorintegerWhat a winning $100 bet makes, in cents.
break_evennumberBreak-even win rate at the price.
min 0 · max 1
win_prob_no_pushnumberThe win rate when the bet doesn't push.
min 0 · max 1
edgenumberThe win rate minus the break-even, in probability: how far it can fall before the EV is zero.
outcomesarray of objectEach way the bet settles
Show 4 fields
outcomestringwin, loss or push.
One of: win, loss, push (open: new values may be added).
probnumberIts chance.
min 0 · max 1
per_100_minorintegerWhat $100 makes or loses on it, in cents.
contribution_minorintegerIts share of the EV per $100 (chance × amount), in cents.
sd_per_100_minorintegerStandard deviation of one $100 bet's result, in cents.
runsarray of objectProfit over runs of $100 bets
Show 7 fields
betsintegerBets.
min 1
mean_minorintegerExpected profit, in cents.
p10_minorinteger10th percentile profit, in cents.
p90_minorinteger90th percentile profit, in cents.
prob_profitnumberChance of finishing ahead.
min 0 · max 1
prob_lossnumberChance of finishing behind.
min 0 · max 1
prob_evennumberChance of finishing exactly even.
min 0 · max 1
ev_by_win_ratearray of objectEV per unit at each whole win rate around the break-even, the person's own in its place
Show 3 fields
win_ratenumberThe win rate.
min 0 · max 1
ev_per_unitnumberExpected value per unit staked.
yoursbooleanThe person's own win rate.
price_ladderarray of objectEV per unit at the neighbouring American prices at this win rate
Show 3 fields
americannumberAmerican odds.
ev_per_unitnumberExpected value per unit staked.
askedbooleanThe price asked about.
bets_to_proveintegernullableBets 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 objectEV per unit after US federal tax at each 2026 bracket
Show 3 fields
tax_ratenumberThe federal rate.
min 0 · max 1
itemizingnumberEV per unit when losses are itemized (90% cap).
not_itemizingnumberEV per unit when losses are not deducted.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
basisstringrequiredWhere the fair price came from.
One of: person_prices, person_probability, kelly_consensus (open: new values may be added).
devig_methodstringnullableDe-vig method behind the fair probabilities.
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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"
}
{
"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": []
}- 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_homenumberThe home team's handicap, book convention: -3 for a 3-point home favourite.
totalnumberThe game total.
p_home_mlnumberThe home side's no-vig moneyline probability.
p_home_covernumberThe home side's no-vig cover probability at the spread (default one half).
p_overnumberThe no-vig over probability at the total (default one half).
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "spread_and_total".
resultobjectrequiredThe calculation's numbers
Show 17 fields
home_margin_meannumbernullableExpected home margin.
home_covernumbernullableHome covers the spread.
min 0 · max 1
spread_pushnumbernullableThe spread pushes.
min 0 · max 1
away_covernumbernullableAway covers the spread.
min 0 · max 1
home_winnumbernullableHome wins.
min 0 · max 1
tienumbernullableThe game ties.
min 0 · max 1
away_winnumbernullableAway wins.
min 0 · max 1
home_ml_probnumbernullableHome moneyline probability, ties pushed.
min 0 · max 1
away_ml_probnumbernullableAway moneyline probability, ties pushed.
min 0 · max 1
home_ml_fairobjectnullableFair home moneyline
Show 2 fields
decimalnumberDecimal odds.
americannumberAmerican odds.
away_ml_fairobjectnullableFair away moneyline
Show 2 fields
decimalnumberDecimal odds.
americannumberAmerican odds.
total_meannumbernullableExpected total points.
overnumbernullableThe over wins.
min 0 · max 1
total_pushnumbernullableThe total pushes.
min 0 · max 1
undernumbernullableThe under wins.
min 0 · max 1
home_team_totalnumbernullableImplied home team total.
away_team_totalnumbernullableImplied away team total.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- 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):
linenumberThe spread, book convention: -3.
sidestringThe side buying the half point.
One of: favourite, underdog (open: new values may be added).
default "favourite"
priceobjectThe price at the line before buying.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
buy_priceobjectThe price the book asks for the half point.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
pinumberProbability the margin lands on the number crossed, if known.
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "half_point_value".
resultobjectrequiredThe calculation's numbers
Show 9 fields
directionstringoff_the_number or onto_the_number.
from_linenumberThe line before buying.
to_linenumberThe line after buying.
numbernumberThe number crossed.
pinumberProbability the margin lands on that number.
min 0 · max 1
basisstringWhere pi came from: given, or the fitted model.
break_even_decimalnumberThe highest price worth paying, decimal.
break_even_americannumberThe highest price worth paying, American.
win_prob_gainnumberWin probability the half point adds.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- 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_linenumberThe main line, book convention: -3.
main_probnumberThe side's no-vig probability at the main line.
alt_linesarray of numberAlternate lines to price, in the order wanted.
min items 1 · max items 20
alt_probsarray of numberThe 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.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "alternate_lines".
resultobjectrequiredThe calculation's numbers
Show 1 field
linesarray of objectrequiredEach alternate line, in the order given
Show 6 fields
linenumberThe alternate line.
winnumberThe side covers it.
min 0 · max 1
pushnumberIt pushes.
min 0 · max 1
losenumberThe side fails to cover it.
min 0 · max 1
win_no_pushnumberCovers, pushes removed.
min 0 · max 1
fairobjectFair price at that line
Show 2 fields
decimalnumberDecimal odds.
americannumberAmerican odds.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
]
}
{
"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": []
}- 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):
linenumberThe prop line.
diststringThe distribution.
One of: poisson, negative_binomial, normal, empirical (open: new values may be added).
meannumberThe mean.
dispersionnumberNegative binomial dispersion r.
sdnumberNormal standard deviation.
samplesarray of numberEmpirical samples.
min items 1
market_p_overnumberThe no-vig over probability, to imply the mean.
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "prop_probability".
resultobjectrequiredThe calculation's numbers
Show 9 fields
overnumberrequiredProbability of the over.
min 0 · max 1
undernumberrequiredProbability of the under.
min 0 · max 1
pushnumberProbability of a push.
min 0 · max 1
over_no_pushnumberThe over, pushes removed.
min 0 · max 1
mediannumberThe distribution's median.
meannumbernullableThe mean used.
sdnumbernullableThe standard deviation used.
implied_meannumbernullableThe mean the market's no-vig over probability implies.
implied_mediannumbernullableThe median at that mean.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- 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):
pricesobjectEvery outcome's price on the board, by name.
devig_methodstringDe-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_kintegerPrice finishing in the top k.
min 1
pairsarray of arrayHead-to-head pairs to price, as [a, b] names, in order.
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "futures_board".
resultobjectrequiredThe calculation's numbers
Show 8 fields
fair_probsobjectrequiredFair probability by outcome, in the order given
fair_pricesobjectFair price by outcome
side_holdobjectEach outcome's own hold
booksumnumberSum of implied probabilities.
overroundnumberBooksum minus 1.
holdnumberThe board's hold.
top_kobjectnullableFinishing in the top k
Show 2 fields
kintegerk.
probsobjectProbability by outcome
head_to_headarray of objectnullableEach pair, in the order given
Show 5 fields
astringFirst outcome.
bstringSecond outcome.
p_a_aheadnumberProbability a finishes ahead of b.
min 0 · max 1
fair_aobjectFair price on a
Show 2 fields
decimalnumberDecimal odds.
americannumberAmerican odds.
fair_bobjectFair price on b
Show 2 fields
decimalnumberDecimal odds.
americannumberAmerican odds.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
devig_methodstringnullableDe-vig method behind the fair probabilities.
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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"
]
]
}
{
"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": []
}- 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):
pricesobjectEvery outcome's price, by name.
devig_methodstringDe-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.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "betting_splits".
resultobjectrequiredThe calculation's numbers
Show 3 fields
by_outcomeobjectrequiredEach outcome's split, in the order given
market_holdnumberrequiredThe market's hold, 1 - 1/booksum.
book_expected_per_100numbernullableThe book's expected result per 100 staked at the fair probabilities.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
devig_methodstringnullableDe-vig method behind the fair probabilities.
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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"
}
{
"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": []
}- 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 objectEach leg's price, in order.
min items 1
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
probsarray of numberThe person's probability for each leg, in price order.
min items 1
kindstringParlay, round robin, if-bet or reverse.
One of: parlay, round_robin, if_bet, reverse (open: new values may be added).
default "parlay"
sizesarray of integerRound robin: parlay sizes, such as [2, 3].
min items 1
pushedarray of integerParlay: legs (by position) that pushed or were voided.
winnersarray of integerRound robin: legs (by position) that won, to settle it.
ticket_stake_minorintegerStake per ticket (per combination in a round robin).
min 0
currencystringISO 4217 currency code.
pattern ^[A-Z]{3}$ · default "USD"
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "parlay".
resultobjectrequiredThe calculation's numbers
Show 28 fields
kindstringrequiredParlay, round robin, if-bet or reverse.
legsintegernullableNumber of legs.
legs_settledintegernullableLegs that still count after pushes.
priceobjectnullableThe parlay's price in every format
Show 5 fields
americannumberAmerican odds.
decimalnumberDecimal odds.
fractionalstringFractional odds, nearest ladder fraction.
centsnumberContract price in cents per $1.
implied_probnumberImplied probability, 1 / decimal.
min 0 · max 1
break_evennumbernullableBreak-even at the parlay's price.
min 0 · max 1
p_all_winnumbernullableProbability every leg wins.
min 0 · max 1
outcome_countobjectnullableTimes in a hundred (N in 100)
Show 3 fields
countintegerHow many times.
perintegerOut of how many.
fewer_than_onebooleanWhether it is fewer than one in that many.
ev_per_unitnumbernullableExpected value per unit staked.
compounded_holdnumbernullableCompounded hold, exact form: 1 minus the product of each leg's return.
hold_shortcutnumbernullableCompounded hold from the legs' holds (shortcut).
hold_linearnumbernullableThe legs' holds summed (overstates).
payoutobjectnullableWhat a winning ticket returns
Show 3 fields
return_minorintegerTotal return, stake included. In minor units.
profit_minorintegerProfit. In minor units.
currencystringISO 4217 currency code.
combinationsarray of objectnullableRound robin: each combination, in input order
Show 3 fields
legsarray of integerIts legs, by position.
decimalnumberIts decimal price.
cashesbooleannullableWhether it cashes, given the winners.
countintegernullableRound robin: number of combinations.
total_stake_minorintegernullableRound robin: total staked. In minor units.
expected_return_minorintegernullableRound robin: expected return. In minor units.
p_any_cashesnumbernullableRound robin: probability at least one combination cashes.
min 0 · max 1
p_profitnumbernullableRound robin: probability of a profit.
min 0 · max 1
settled_return_minorintegernullableRound robin: return given the winners. In minor units.
settled_profit_minorintegernullableRound robin: profit given the winners. In minor units.
outcomes_minorobjectnullableIf-bet or reverse: net result by outcome, minor units
probabilitiesobjectnullableIf-bet or reverse: probability by outcome
max_exposure_minorintegernullableIf-bet: the most that can be lost. In minor units.
ev_minorintegernullableIf-bet or reverse: expected value. In minor units.
ev_straight_minorintegernullableIf-bet: expected value of two straight bets. In minor units.
leg_rowsarray of objectnullableParlay: each leg, in input order
Show 6 fields
leginteger | stringrequiredThe leg's position (or name, for a map).
priceobjectrequiredThe leg's price in every format
Show 5 fields
americannumberAmerican odds.
decimalnumberDecimal odds.
fractionalstringFractional odds, nearest ladder fraction.
centsnumberContract price in cents per $1.
implied_probnumberImplied probability, 1 / decimal.
min 0 · max 1
pushedbooleanrequiredWhether the leg pushed or was voided.
running_decimalnumberrequiredThe parlay's decimal price after this leg (a pushed leg leaves it unchanged).
running_break_evennumberrequiredThe chance every leg so far wins at these prices (1 / running_decimal).
min 0 · max 1
single_profit_minorintegerrequiredWhat the leg alone, as a straight bet of single_ticket_minor, profits. In minor units.
single_ticket_minorintegernullableParlay: the straight bet each leg is shown at (the person's stake, or $100). In minor units.
payout_ladderarray of objectnullableParlay: what a winning ticket pays at $10, $25, $50, $100 and the person's stake
Show 3 fields
ticket_minorintegerrequiredThe ticket amount. In minor units.
return_minorintegerrequiredTotal return, stake included. In minor units.
profit_minorintegerrequiredProfit. In minor units.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- 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):
ResponseLink to this section
200 The calculation's result.
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
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"
}
{
"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": []
}- 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):
ResponseLink to this section
200 The calculation's result.
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
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
]
}
{
"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": []
}- 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):
pricesobjectThe best price on every outcome, by name.
total_stake_minorintegerThe total to stake across the outcomes.
min 1
selectionsarray of stringDutching: the outcomes to back, by name.
min items 1
currencystringISO 4217 currency code.
pattern ^[A-Z]{3}$ · default "USD"
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "arbitrage".
resultobjectrequiredThe calculation's numbers
Show 6 fields
is_arbitragebooleanrequiredWhether the booksum of the outcomes backed is below 1.
booksumnumberrequiredSum of implied probabilities at the prices.
payout_minorintegerWhat any winning outcome pays. In minor units.
profit_minorintegerProfit on any winning outcome. In minor units.
return_ratenumberProfit over the total staked.
currencystringISO 4217 currency code.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
stake_eligiblebooleanrequiredWhether a stake may rest on these inputs (D3, D26).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
arithmetic_stakesarray of objectStakes fixed by the person's own tickets, in ticket order
Show 3 fields
ticketstringrequiredWhich ticket or outcome the amount goes on.
amount_minorintegerrequiredThe amount in minor units.
currencystringrequiredISO 4217 currency code.
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- 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_aobjectThe first ticket's price.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
price_bobjectThe second ticket's price.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
p_middlenumberProbability both tickets win.
stake_a_minorintegerThe first ticket's stake.
min 1
stake_b_minorintegerThe second ticket's stake.
min 1
p_a_onlynumberProbability only the first ticket wins.
p_b_onlynumberProbability only the second ticket wins.
p_push_anumberProbability the first ticket pushes while the second wins.
min 0 · default 0
p_push_bnumberProbability the second ticket pushes while the first wins.
min 0 · default 0
currencystringISO 4217 currency code.
pattern ^[A-Z]{3}$ · default "USD"
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "middle".
resultobjectrequiredThe calculation's numbers
Show 7 fields
outcomes_minorobjectNet result by outcome, minor units
probabilitiesobjectProbability by outcome
ev_minorintegerrequiredExpected value. In minor units.
ev_per_unit_stakednumberExpected value per unit of the total staked.
break_even_middle_probnumberThe landing probability at which the middle breaks even.
min 0 · max 1
total_staked_minorintegerBoth stakes. In minor units.
currencystringISO 4217 currency code.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- 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_minorintegerThe original ticket's stake.
min 1
price_takenobjectThe original ticket's price (a parlay's whole price for last_leg).
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
hedge_priceobjectThe price available on the other side.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
modestringWhich hedge.
One of: equal_profit, stake_back, partial, log_utility, last_leg, amount (open: new values may be added).
default "equal_profit"
hedge_stake_minorintegerAmount: the hedge the person names.
min 0
probabilitynumberThe person's probability the original ticket wins.
bankroll_minorintegerLog-utility hedge: the person's bankroll, the open ticket excluded.
min 1
no_vig_probnumberLog-utility hedge: the no-vig probability, now, that the original ticket wins, to shrink toward (D26).
shrink_weightnumberLog-utility hedge: weight on the person's probability when shrinking.
min 0 · max 1 · default 0.5
currencystringISO 4217 currency code.
pattern ^[A-Z]{3}$ · default "USD"
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "hedge".
resultobjectrequiredThe calculation's numbers
Show 8 fields
modestringrequiredWhich hedge.
ticket_return_minorintegerWhat the original ticket returns if it wins. In minor units.
outcomes_minorobjectNet result either way, minor units
Show 2 fields
ticket_winsintegerIf the original ticket wins.
hedge_winsintegerIf the hedge wins.
equal_profit_outcome_minorintegerProfit locked either way by the equal-profit hedge. In minor units.
hedge_priceobjectThe hedge's price
Show 2 fields
decimalnumberDecimal odds.
americannumberAmerican odds.
expected_cost_minorintegernullableWhat the hedge costs in expectation at the person's probability. In minor units.
sizednullNull off askkelly.ai: stake mode is first-party only (D34).
weaknullNull off askkelly.ai: stake mode is first-party only (D34).
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
stake_eligiblebooleanrequiredWhether a stake may rest on these inputs (D3, D26).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
stakenullNull off askkelly.ai: stake mode is first-party only (D34).
stake_minornullNull off askkelly.ai: stake mode is first-party only (D34).
kelly_criterion_fractionnullNull off askkelly.ai: stake mode is first-party only (D34).
arithmetic_stakesarray of objectStakes fixed by the person's own tickets, in ticket order
Show 3 fields
ticketstringrequiredWhich ticket or outcome the amount goes on.
amount_minorintegerrequiredThe amount in minor units.
currencystringrequiredISO 4217 currency code.
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- 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_minorintegerThe cash-out offer.
min 0
ticket_stake_minorintegerThe ticket's stake.
min 1
price_takenobjectThe ticket's price.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
fair_probnumberThe ticket's fair probability now.
hedge_priceobjectThe price on the other side, to compare a hedge.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
currencystringISO 4217 currency code.
pattern ^[A-Z]{3}$ · default "USD"
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "cash_out".
resultobjectrequiredThe calculation's numbers
Show 8 fields
fair_value_minorintegerrequiredThe ticket's fair value now. In minor units.
offer_minorintegerThe offer. In minor units.
gives_up_minorintegerWhat the offer gives up against fair value. In minor units.
marginnumberThe offer's cut, 1 - offer / fair value.
ticket_return_minorintegerWhat the ticket returns if it wins. In minor units.
hedge_value_minorintegernullableWhat an equal-profit hedge makes instead, win or lose. In minor units.
offer_vs_hedge_minorintegernullableThe offer minus the hedge's locked value. In minor units.
currencystringISO 4217 currency code.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
}
{
"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": []
}- 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):
kindstringThe promotion.
One of: free_bet_conversion, qualifying_bet, no_sweat, boost, rollover (open: new values may be added).
amount_minorintegerThe free bet, stake, back stake or bonus.
min 0
bonus_priceobjectThe price the bonus or back bet is placed at.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
hedge_priceobjectFree-bet conversion at a sportsbook: the price on the other side.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
lay_priceobjectExchange lay price (free-bet conversion or a qualifying bet).
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
commissionnumberExchange commission on net winnings.
min 0 · default 0
stake_returnedbooleanFree bet: whether a win returns the stake.
default false
probabilitynumberThe person's probability the bet wins.
conversion_ratenumberNo-sweat: the share of a refunded bonus the person expects to keep.
boostnumberBoost: the profit boost, 0.5 for 50%.
rollovernumberRollover: times the bonus must be wagered.
currencystringISO 4217 currency code.
pattern ^[A-Z]{3}$ · default "USD"
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "bonus_bet".
resultobjectrequiredThe calculation's numbers
Show 17 fields
kindstringrequiredThe promotion.
outcomes_minorobjectnullableNet result by outcome, minor units
profit_minorintegernullableProfit locked either way. In minor units.
conversionnumbernullableShare of the free bet kept.
ceilingnumbernullableThe most any conversion at this price can keep.
liability_minorintegernullableThe lay's liability. In minor units.
qualifying_loss_minorintegernullableA qualifying bet's result either way. In minor units.
ev_minorintegernullableExpected value. In minor units.
ev_cash_part_minorintegernullableNo-sweat: expected value of the cash bet. In minor units.
ev_refund_part_minorintegernullableNo-sweat: expected value of the refund. In minor units.
boosted_priceobjectnullableThe boosted price
Show 2 fields
decimalnumberDecimal odds.
americannumberAmerican odds.
break_evennumbernullableBreak-even at the boosted price.
min 0 · max 1
ev_per_unitnumbernullableExpected value per unit at the boosted price.
wagering_required_minorintegernullableRollover: total wagering required. In minor units.
expected_loss_per_unitnumbernullableRollover: expected loss per unit wagered.
rollover_cost_minorintegernullableRollover: expected cost of the wagering. In minor units.
currencystringISO 4217 currency code.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
stake_eligiblebooleanrequiredWhether a stake may rest on these inputs (D3, D26).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
arithmetic_stakesarray of objectStakes fixed by the person's own tickets, in ticket order
Show 3 fields
ticketstringrequiredWhich ticket or outcome the amount goes on.
amount_minorintegerrequiredThe amount in minor units.
currencystringrequiredISO 4217 currency code.
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
}
{
"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": []
}- 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):
probabilitynumberThe person's own probability.
priceobjectThe price the person is getting.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
bankroll_minorintegerThe person's bankroll.
min 1
currencystringISO 4217 currency code.
pattern ^[A-Z]{3}$ · default "USD"
fractionnumberShare of the Kelly criterion (D26: 0.2 to 0.5).
min 0.2 · max 0.5 · default 0.25
no_vig_probnumberThe no-vig market probability to shrink toward.
reference_pricesobjectA market's prices, to take the no-vig probability from.
selectionstringWith reference_prices: the outcome bet.
devig_methodstringDe-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_weightnumberWeight on the person's probability when shrinking (D26).
min 0 · max 1 · default 0.5
cap_betnumberLargest share of bankroll on one bet (D26: 1%, at most 2%).
max 0.02 · default 0.01
cap_slatenumberLargest share of bankroll on a slate (D26: 10%, at most 15%).
max 0.15 · default 0.1
slate_exposurenumberShare of bankroll already staked on the slate.
min 0 · max 1 · default 0
push_probnumberProbability of a push.
min 0 · default 0
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "stake_size".
resultobjectrequiredThe calculation's numbers
Show 11 fields
break_evennumberrequiredBreak-even win rate at the price.
min 0 · max 1
no_vig_probnumbernullableThe no-vig market probability shrunk toward.
min 0 · max 1
shrink_weightnumberrequiredWeight on the person's probability.
fraction_appliednumberShare of the Kelly criterion applied.
capsobjectThe caps applied
Show 3 fields
betnumberLargest share of bankroll on one bet.
slatenumberLargest share of bankroll on a slate.
slate_exposurenumberShare already staked on the slate.
expected_valuenumberExpected value per unit at the shrunk probability.
growth_curvearray of objectGrowth kept by share of the Kelly criterion (the growth-curve explainer, D3)
Show 2 fields
fractionnumberShare of the Kelly criterion.
ceiling_fractionnullNull off askkelly.ai: stake mode is first-party only (D34).
stake_fractionnullNull off askkelly.ai: stake mode is first-party only (D34).
cap_appliednullNull off askkelly.ai: stake mode is first-party only (D34).
weaknullNull off askkelly.ai: stake mode is first-party only (D34).
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
stake_eligiblebooleanrequiredWhether a stake may rest on these inputs (D3, D26).
basisstringrequiredWhere the fair price came from.
One of: person_prices, person_probability, kelly_consensus (open: new values may be added).
devig_methodstringnullableDe-vig method behind the fair probabilities.
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
shrink_appliedbooleanWhether the probability was shrunk toward the no-vig market (D26).
shrunk_probnumberThe person's probability, shrunk toward the no-vig market.
min 0 · max 1
ev_vs_no_vignumbernullableEV per unit at the person's price against the no-vig market (D34).
drawdown_by_fractionarray of objectDrawdown risk by share of the Kelly criterion
Show 3 fields
fractionnumberrequiredShare of the Kelly criterion (0.25 is a quarter).
drawdownnumberrequiredThe drawdown, as a share of bankroll.
min 0 · max 1
probabilitynumberrequiredProbability of ever falling that far (Thorp's lognormal approximation).
min 0 · max 1
stakenullNull off askkelly.ai: stake mode is first-party only (D34).
stake_minornullNull off askkelly.ai: stake mode is first-party only (D34).
kelly_criterion_fractionnullNull off askkelly.ai: stake mode is first-party only (D34).
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- 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):
kindstringWhich risk.
One of: ruin, drawdown, goal, losing_season, progression (open: new values may be added).
probabilitynumberThe person's win probability.
priceobjectThe price bet.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
fractionnumberShare of the Kelly criterion.
floornumberThe floor, as a share of the starting bankroll.
default 0.5
goalnumberGoal: a multiple of the starting bankroll.
default 2
tolerancenumberDrawdown: the chance of ever reaching the floor the person accepts.
basisstringDrawdown: 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"
strategystringGoal: 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_betsintegerNumber of bets.
min 1
bankroll_unitsnumberBankroll in betting units.
target_unitsnumberTarget in betting units.
stake_unitsnumberGoal with flat bets: units per bet.
systemstringProgression: martingale or fixed_fraction.
One of: martingale, fixed_fraction (open: new values may be added).
base_unitsnumberMartingale: the base bet in units.
doublingsintegerMartingale: doublings allowed before the cap.
min 1
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "bankroll_risk".
resultobjectrequiredThe calculation's numbers
Show 33 fields
kindstringrequiredWhich risk.
probabilitynumbernullableThe headline probability for this risk.
min 0 · max 1
outcome_countobjectnullableTimes in a hundred (N in 100)
Show 3 fields
countintegerHow many times.
perintegerOut of how many.
fewer_than_onebooleanWhether it is fewer than one in that many.
lundberg_exponentnumbernullableRuin: the Lundberg exponent.
ruin_boundnumbernullableRuin: the Lundberg bound on ever being ruined.
min 0 · max 1
bound_is_exactbooleannullableRuin: whether the bound is exact here.
diffusion_infinitenumbernullableRuin: diffusion approximation, any horizon.
min 0 · max 1
diffusion_finitenumbernullableRuin: diffusion approximation within n bets.
min 0 · max 1
exact_finitenumbernullableRuin: exact within n bets.
min 0 · max 1
reach_targetnumbernullableReaching the target first.
min 0 · max 1
expected_betsnumbernullableExpected bets until ruin or the target.
floornumbernullableDrawdown: the floor.
multiplenumbernullableShare of the Kelly criterion used.
within_n_betsobjectnullableDrawdown within n bets
Show 5 fields
touch_probnumberTouching the floor.
min 0 · max 1
end_below_floor_probnumberEnding below the floor.
min 0 · max 1
end_below_start_probnumberEnding below the start.
min 0 · max 1
end_double_probnumberEnding doubled.
min 0 · max 1
median_multiplenumberMedian ending multiple.
budget_multiplenumbernullableDrawdown budget: the share of the Kelly criterion it allows.
rck_multiplenumbernullableDrawdown budget: risk-constrained Kelly criterion as a share.
expected_max_drawdownobjectnullableFlat stakes: expected maximum drawdown, in units
Show 5 fields
mean_per_betnumberMean result per bet.
sd_per_betnumberSD per bet.
xnumberThe scaled horizon.
large_xnumberLarge-horizon form.
small_xnumberSmall-horizon form.
bets_to_goalnumbernullableGoal: median bets to reach it.
ruin_before_targetnumbernullableGoal with flat bets: ruin first.
min 0 · max 1
expected_handle_unitsnumbernullableGoal: expected total wagered, units.
expected_final_unitsnumbernullableGoal with flat bets: expected final bankroll, units.
zero_edge_benchmarknumbernullableGoal: the chance at zero edge.
min 0 · max 1
exactnumbernullableLosing season: exact.
min 0 · max 1
normalnumbernullableLosing season: normal approximation.
min 0 · max 1
bust_probnumbernullableMartingale: busting a cycle.
min 0 · max 1
expected_wager_unitsnumbernullableMartingale: expected wagered per cycle, units.
ev_per_cycle_unitsnumbernullableMartingale: expected result per cycle, units.
return_per_dollarnumbernullableExpected return per unit wagered.
flat_meannumbernullableFixed fraction: flat bets' mean ending multiple.
fraction_meannumbernullableFixed fraction: mean ending multiple.
flat_mediannumbernullableFixed fraction: flat bets' median ending multiple.
fraction_mediannumbernullableFixed fraction: median ending multiple.
kelly_criterion_fractionnullNull off askkelly.ai: stake mode is first-party only (D34).
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- 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_takenobjectThe price the bet was taken at.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
close_probnumberThe fair closing probability.
close_pricesobjectThe closing market's prices, by outcome.
selectionstringWith close_prices: the outcome bet.
devig_methodstringDe-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 numberPrice-based CLVs of a set of bets, for their significance.
min items 2
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "closing_line_value".
resultobjectrequiredThe calculation's numbers
Show 8 fields
close_probnumbernullableThe fair closing probability.
min 0 · max 1
clv_pricenumbernullablePrice-based CLV: close probability times the price taken, minus 1.
clv_probnumbernullableProbability-based CLV: close probability minus the break-even.
expected_roinumbernullableThe return the CLV implies.
break_even_takennumbernullableBreak-even at the price taken.
min 0 · max 1
fair_close_priceobjectnullableFair closing price
Show 2 fields
decimalnumberDecimal odds.
americannumberAmerican odds.
raw_clvnumbernullableCLV against the vigged close (overstates).
significanceobjectnullableA CLV sample's significance
Show 7 fields
nintegerBets.
meannumberMean CLV.
sdnumberSD of CLV.
std_errornumberStandard error.
tnumbert statistic.
ci95array of number95% interval.
min items 2 · max items 2
bets_needednumbernullableBets a t of 2 needs at this mean and spread.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
basisstringrequiredWhere the fair price came from.
One of: person_prices, person_probability, kelly_consensus (open: new values may be added).
devig_methodstringnullableDe-vig method behind the fair probabilities.
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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"
}
{
"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": []
}- 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):
winsintegerWins.
min 0
lossesintegerLosses.
min 0
pushesintegerPushes.
min 0 · default 0
priceobjectThe price every bet was taken at.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
pricesarray of objectEach bet's price, in order (wins first, then losses).
min items 1
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
testsintegerHow many records or angles were tried (multiple comparisons).
min 1 · default 1
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "record_test".
resultobjectrequiredThe calculation's numbers
Show 20 fields
winsintegerWins.
lossesintegerLosses.
pushesintegerPushes.
unitsnumberProfit in flat-bet units.
roinumberReturn on the amount staked.
win_ratenumberrequiredWins over wins plus losses.
min 0 · max 1
break_evennumberrequiredThe break-even win rate.
min 0 · max 1
over_break_evennumberWin rate minus the break-even.
no_skill_match_probnumberHow often a bettor at the break-even does this well.
min 0 · max 1
no_skill_match_per_100numberThe same, in 100.
coin_match_probnumberHow often a 50% picker does this well.
min 0 · max 1
coin_match_per_100numberThe same, in 100.
znumberz against the break-even.
normal_pnumberOne-sided p-value, normal approximation.
min 0 · max 1
roi_std_errornumberStandard error of the ROI.
roi_intervalarray of number95% interval for the ROI.
min items 2 · max items 2
significantbooleanWhether the record beats the break-even at 5%.
sample_neededobjectnullableBets needed to show this win rate
Show 5 fields
one_sidednumberOne-sided at 5%.
with_powernumberWith 80% power.
two_senumberBy the 2-SE rule.
hoeffding_one_sidednumberBy Hoeffding's bound.
at_win_ratenumberThe win rate assumed.
min 0 · max 1
multiple_comparisonsobjectnullableControl for the number of tests
Show 6 fields
testsintegerTests tried.
bonferroni_thresholdnumberBonferroni p threshold.
bonferroni_survivesbooleanSurvives Bonferroni.
bonferroni_adjusted_pnumberBonferroni-adjusted p-value.
benjamini_hochberg_survives_alonebooleanSurvives Benjamini-Hochberg on its own.
familywise_error_uncorrectednumberChance of a false positive among the tests, uncorrected.
test_martingaleobjectnullableTest martingale (e-process)
Show 6 fields
e_valuenumberThe e-value.
anytime_p_boundnumberAnytime-valid p bound.
crossed_at_endbooleanWhether it crossed 1/alpha.
stake_rulestringThe betting rule.
betting_fractionnumberThe test's betting fraction (a test parameter, not a stake).
orderedbooleanWhether the bets were in time order.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
}
{
"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": []
}- 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):
priceobjectThe price.
Show 4 fields
americannumberAmerican odds: -110, +125. None lies strictly between -100 and +100.
decimalnumberDecimal odds, stake included: 1.91.
fractionalstringFractional odds: "5/2".
pattern ^[0-9]+/[0-9]+$
centsnumberA prediction-market contract price in cents per $1.
tax_ratenumberMarginal tax rate.
min 0 · max 1 · default 0
itemizerbooleanWhether the person itemizes.
default true
loss_capnumberShare of losses deductible (0.9 from tax year 2026).
min 0 · max 1 · default 0.9
fee_minorintegerA per-wager fee.
min 0
ticket_stake_minorintegerThe stake the fee applies to.
min 1
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "after_tax_break_even".
resultobjectrequiredThe calculation's numbers
Show 5 fields
break_evennumberrequiredWin rate needed after tax and fees.
min 0 · max 1
pre_tax_break_evennumberWin rate needed before tax.
min 0 · max 1
risenumberHow much tax and fees raise the break-even.
roi_needednumberPre-tax return needed to break even after tax.
fee_cost_per_unitnumberThe fee per unit staked.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- 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_minorintegerThe year's gross winnings: the profit on every winning bet.
min 0
losses_minorintegerThe year's gross losses: the stakes on every losing bet.
min 0
tax_yearintegerThe tax year, which sets the share of losses deductible.
min 2000 · max 2100
federal_ratenumberThe person's federal marginal rate.
min 0 · max 1
itemizerbooleanWhether the person itemizes.
default true
state_ratenumberThe person's state rate on gambling income.
min 0 · max 1 · default 0
state_deducts_lossesbooleanWhether the state lets losses come off. Left out, the state tax is on all winnings and a warning says the rule is unknown.
withheld_minorintegerTax already withheld, such as on W-2Gs.
min 0
currencystringISO 4217 currency code.
pattern ^[A-Z]{3}$ · default "USD"
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "gambling_tax".
resultobjectrequiredThe calculation's numbers
Show 15 fields
winnings_minorintegerGross winnings. In minor units.
losses_minorintegerGross losses. In minor units.
net_result_minorintegerWinnings minus losses: what was actually won. In minor units.
loss_capnumberThe share of losses deductible in the tax year.
min 0 · max 1
deduction_minorintegerThe losses deducted: the lower of the capped losses and the winnings. In minor units.
taxable_minorintegerrequiredTaxable gambling income, federal. In minor units.
taxed_not_won_minorintegerTaxable income beyond what was actually won (the loss cap's cost). In minor units.
federal_tax_minorintegerFederal tax at the person's rate. In minor units.
state_taxable_minorintegerThe income the state rate applies to. In minor units.
state_tax_minorintegerState tax at the person's rate. In minor units.
total_tax_minorintegerrequiredFederal and state tax. In minor units.
after_tax_minorintegerWinnings minus losses minus the tax. In minor units.
withheld_minorintegerTax already withheld. In minor units.
set_aside_minorintegerThe tax still to pay: the total less what was withheld, never below zero. In minor units.
currencystringISO 4217 currency code.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- Kelly · as of 2026-10-04T17:30:00Z
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"
}
{
"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):
observednumberThe observed rate or average.
nnumberThe sample size behind it.
prior_meannumberThe population mean.
knumberThe stabilisation point.
reliabilitynumberThe stat's reliability at reliability_at trials, instead of k.
reliability_atnumberThe sample size the reliability was measured at.
target_reliabilitynumberThe reliability to report the trials needed for.
default 0.7
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "regression_to_mean".
resultobjectrequiredThe calculation's numbers
Show 8 fields
estimatenumberrequiredThe true-talent estimate.
data_weightnumberWeight on the observed value, n / (n + k).
min 0 · max 1
prior_weightnumberWeight on the population mean.
min 0 · max 1
regressionnumberHow far the estimate moved toward the mean.
knumberThe stabilisation point used.
stabilisation_pointnumberTrials at which the data and the mean weigh the same.
trials_for_targetnumberTrials needed for the target reliability.
target_reliabilitynumberThe target reliability.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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
}
{
"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": []
}- 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 numberThe person's probability for each pick, in order.
min items 2 · max items 8
payout_tableobjectMultiplier by number of hits, such as {"6": 37.5}.
formatstringEntry format.
One of: power, flex (open: new values may be added).
default "power"
entry_fee_minorintegerThe entry fee.
min 1 · default 1000
latent_correlationnumberCorrelation between picks (one-factor copula).
min -1 · max 1 · default 0
currencystringISO 4217 currency code.
pattern ^[A-Z]{3}$ · default "USD"
ResponseLink to this section
200 The calculation's result.
objectconstrequiredAlways calculation_result.
Always "calculation_result".
calcconstrequiredThe calculation.
Always "pickem_entry".
resultobjectrequiredThe calculation's numbers
Show 14 fields
legsintegerNumber of picks.
formatstringEntry format.
hitsobjectProbability of each number of hits
p_all_hitnumberEvery pick hits.
min 0 · max 1
p_any_payoutnumberThe entry pays anything.
min 0 · max 1
expected_multiplenumberExpected payout multiple.
ev_per_unitnumberrequiredExpected value per unit of entry fee.
expected_return_minorintegerExpected return per entry. In minor units.
expected_cost_minorintegerExpected cost per entry (negative is a gain). In minor units.
break_even_legnumbernullableWin rate each pick needs, for equal picks.
min 0 · max 1
break_even_all_hitnumbernullablePower: probability every pick must hit to break even.
min 0 · max 1
all_hit_countobjectTimes in a hundred (N in 100)
Show 3 fields
countintegerHow many times.
perintegerOut of how many.
fewer_than_onebooleanWhether it is fewer than one in that many.
return_distributionarray of objectPayout multiples and their probabilities
Show 2 fields
multiplenumberThe multiple.
pnumberIts probability.
min 0 · max 1
currencystringISO 4217 currency code.
inputs_usedarray of objectrequiredEvery input given, in the order given, with its source
Show 3 fields
namestringrequiredThe input's name.
valueanyrequiredThe value used, as given.
sourcestringrequiredWho supplied it: person, market or kelly.
One of: person, market, kelly (open: new values may be added).
stake_eligiblebooleanrequiredWhether a stake may rest on these inputs (D3, D26).
method_paramsobjectrequiredSolved method parameters, such as power_k
diagnosticsobjectSolver diagnostics (iterations, converged)
warningsarray of stringrequiredWarning codes
formulasarray of stringrequiredFormula cards used
engine_buildstringrequiredThe engine build that computed it.
api_versionstringnullableThe API version that served it (set by the surface, K10).
rg_linestringnullableThe cost line (D19, COMP-1) on wagering results; set by the surface from brand.toml [cost_line] (K10). Null from the engine.
assumptionsarray of stringrequiredDefaults applied
as_ofstringWhen it was computed (UTC).
format date-time
sourcestringWho computed it, as shown to readers.
attributionstringnullableAttribution the source's terms require.
request_idstringnullableThe request that produced this response.
live_topicsarray of stringKelly 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
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"
}
{
"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": []
}- Kelly · as of 2026-10-04T17:30:00Z
Generated from Kelly API 2026-10-05.