bankroll
Copy page
Read your own bankroll and the limits you set, with your own key or a token you granted an AI app, and import a book's history with your own key.
On this page
| Method | Path | Title | Access | Price | MCP tool |
|---|---|---|---|---|---|
| GET | /v1/me/bankroll | Get your bankroll | read:tracker | 0 | get_my_bankroll |
| GET | /v1/me/league-money | Get your league money | read:tracker | 0 | get_my_league_money |
| GET | /v1/me/limits | Check your limits | read:tracker | 0 | check_my_limits |
| POST | /v1/me/books/{book_id}/import | Import a book's history | write:tracker | 0 | none |
GET /v1/me/bankroll
Get your bankrollLink to this section
scope read:tracker · 0 credits, not charged during the beta · MCP tool get_my_bankroll · status live
Your bankroll from your Kelly account: the total, each book or cash pot, money at risk, this week's, month's and year's betting result and the drawdown from the highest point. Deposits never count as winnings. Your own figures and IDs only: no note, cash-pot label or project name. Needs your own key or an OAuth token with read:tracker. Read only: the bankroll is written on askkelly.ai. Test-mode keys read the same account as live ones (it is your own data, not market data).
ResponseLink to this section
200 Your bankroll.
objectconstrequiredAlways bankroll.
Always "bankroll".
bankrollobjectrequiredYour bankroll: your own figures and IDs, with no note, cash-pot label or project name (the facts Kelly MCP's get_my_bankroll returns).
Show 11 fields
currencystringrequiredThe account's currency, such as USD.
sourcestringrequirednullableWhere the bankroll comes from: ledger (your pots and entries), settings (the bankroll typed in Settings) or null (none recorded). The envelope's source is the response's.
bankroll_minorintegerrequirednullableBankroll now: cash plus money at risk; null when none is recorded. In cents.
cash_minorintegernullableCash across the pots; null without pots. In cents.
at_risk_minorintegernullableMoney at risk in open bets; null without pots. In cents.
potsarray of objectrequiredThe open pots, oldest first.
Show 7 fields
idstringThe pot's ID (pot_).
kindstringbook, exchange, prediction_market or cash.
namestringThe book's name, or cash (a cash pot's own label stays on askkelly.ai).
balance_minorintegerCash plus money at risk. In cents.
cash_minorintegerCash in the pot. In cents.
at_risk_minorintegerStakes of open bets. In cents.
last_checked_atstringnullableThe pot's last balance check, or null.
format date-time
projectsarray of objectEach project with a bankroll share.
Show 3 fields
idstringThe project's ID (proj_); its name stays on askkelly.ai.
pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
bankroll_minorintegernullableThat share of the bankroll; null while the bankroll is not above 0. In cents.
resultobjectrequiredThe betting result this week, month and year.
Show 3 fields
weekobjectOne period, in the person's time zone.
Show 5 fields
startstringThe period's start.
format date-time
endstringThe period's end (exclusive).
format date-time
result_minorintegerBetting result: the change in bankroll less deposits and withdrawals. In cents.
deposits_minorintegerDeposits in the period. In cents.
withdrawals_minorintegerWithdrawals in the period. In cents.
monthobjectOne period, in the person's time zone.
Show 5 fields
startstringThe period's start.
format date-time
endstringThe period's end (exclusive).
format date-time
result_minorintegerBetting result: the change in bankroll less deposits and withdrawals. In cents.
deposits_minorintegerDeposits in the period. In cents.
withdrawals_minorintegerWithdrawals in the period. In cents.
yearobjectOne period, in the person's time zone.
Show 5 fields
startstringThe period's start.
format date-time
endstringThe period's end (exclusive).
format date-time
result_minorintegerBetting result: the change in bankroll less deposits and withdrawals. In cents.
deposits_minorintegerDeposits in the period. In cents.
withdrawals_minorintegerWithdrawals in the period. In cents.
drawdownobjectrequiredThe fall from the highest cumulative betting result.
Show 3 fields
peak_result_minorintegerThe highest cumulative result. In cents.
drawdown_minorintegerThe fall from it to now. In cents.
timezonestringrequiredYour time zone (IANA), which sets the periods.
as_ofstringrequiredWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringrequiredWho produced the value, as shown to readers.
min length 1
request_idstringnullableThe request that produced this response.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · insufficient_scope · not_entitled
ExampleLink to this section
GET https://api.askkelly.ai/v1/me/bankroll
Authorization: Bearer $KELLY_API_KEY{
"type": "https://docs.askkelly.ai/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This needs the read:tracker scope.",
"param": "read:tracker",
"doc_url": "https://docs.askkelly.ai/problems/insufficient_scope",
"request_id": "req_91a011dfa638e65883fbb907",
"retryable": false,
"display_message": "This app needs one more permission to do that."
}GET https://api.askkelly.ai/v1/me/bankroll
Authorization: Bearer $KELLY_API_KEY{
"object": "bankroll",
"bankroll": {
"currency": "USD",
"source": "ledger",
"bankroll_minor": 50000,
"cash_minor": 50000,
"at_risk_minor": 0,
"projects": [],
"unclaimed_share": 1,
"result": {
"week": {
"start": "2026-09-28T04:00:00+00:00",
"end": "2026-10-05T04:00:00+00:00",
"result_minor": 0,
"deposits_minor": 0,
"withdrawals_minor": 0
},
"month": {
"start": "2026-10-01T04:00:00+00:00",
"end": "2026-11-01T04:00:00+00:00",
"result_minor": 0,
"deposits_minor": 0,
"withdrawals_minor": 0
},
"year": {
"start": "2026-01-01T05:00:00+00:00",
"end": "2027-01-01T05:00:00+00:00",
"result_minor": 0,
"deposits_minor": 0,
"withdrawals_minor": 0
}
},
"drawdown": {
"peak_result_minor": 0,
"drawdown_minor": 0,
"share": 0
},
"timezone": "America/New_York",
"pots": [
{
"id": "pot_bay7vm65jgk4qta0haar",
"kind": "cash",
"name": "cash",
"balance_minor": 50000,
"cash_minor": 50000,
"at_risk_minor": 0,
"last_checked_at": null
}
]
},
"as_of": "2026-10-04T17:30:00+00:00",
"source": "kelly",
"request_id": "req_aca7b23c239ec5e3450557f3"
}- kelly · as of 2026-10-04T17:30:00+00:00
GET /v1/me/league-money
Get your league moneyLink to this section
scope read:tracker · 0 credits, not charged during the beta · MCP tool get_my_league_money · status live
The money you put into and took out of your fantasy leagues, from your Kelly account: dues, side pots and winnings by league and season, net and ROI, winnings by tax year, each league's payout table and a commissioner's ledger of what each team paid. Kept apart from your bankroll. Your own figures and IDs, and connected leagues' names; a league you named yourself reads by its key. Needs your own key or an OAuth token with read:tracker. Read only: league money is recorded on askkelly.ai or through Kelly MCP. Test-mode keys read the same account as live ones.
ResponseLink to this section
200 Your league money.
objectconstrequiredAlways league_money.
Always "league_money".
league_moneyobjectrequiredThe person's league money.
Show 5 fields
currencystringThe account's currency.
leaguesarray of objectEach league.
Show 8 fields
keystringA stable key for the league across seasons.
namestringnullableThe platform's name for a connected league; null for one the person named.
seasonsarray of objectIts seasons, oldest first.
Show 9 fields
seasonintegerThe season.
league_idstringnullableThe connected league (lg_…), or null for one the person named.
dues_minorintegerDues paid. In cents.
side_pots_minorintegerSide pots paid. In cents.
paid_minorintegerDues plus side pots. In cents.
winnings_minorintegerWinnings taken out. In cents.
net_minorintegerWinnings less paid. In cents.
roinumbernullableNet over paid; null with nothing paid.
membersarray of objectA commissioner's ledger: each team's paid_minor, payout_minor and owed_minor.
paid_minorintegerPaid in, every season. In cents.
winnings_minorintegerWon, every season. In cents.
net_minorintegerNet, every season. In cents.
roinumbernullableNet over paid.
seasons_in_profitintegerSeasons with a positive net.
totalsobjectpaid_minor, winnings_minor, net_minor and roi across every league.
tax_yearsarray of objectPer calendar year: winnings_minor received, paid_minor, and the payer's 1099-MISC reporting floor in cents where known.
payoutsarray of objectEach league-season's payout table: dues_minor, places_minor, weekly_high_minor, regular_season_winner_minor, teams and pot_minor.
as_ofstringrequiredWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringrequiredWho produced the value, as shown to readers.
min length 1
request_idstringnullableThe request that produced this response.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · insufficient_scope · not_entitled
ExampleLink to this section
GET https://api.askkelly.ai/v1/me/league-money
Authorization: Bearer $KELLY_API_KEY{
"type": "https://docs.askkelly.ai/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This needs the read:tracker scope.",
"param": "read:tracker",
"doc_url": "https://docs.askkelly.ai/problems/insufficient_scope",
"request_id": "req_13d4ca020bf6ffcf0e331267",
"retryable": false,
"display_message": "This app needs one more permission to do that."
}GET https://api.askkelly.ai/v1/me/league-money
Authorization: Bearer $KELLY_API_KEY{
"object": "league_money",
"league_money": {
"currency": "USD",
"leagues": [
{
"key": "lm_ee70df6638",
"name": null,
"seasons": [
{
"season": 2025,
"league_id": null,
"dues_minor": 10000,
"side_pots_minor": 0,
"paid_minor": 10000,
"winnings_minor": 35000,
"net_minor": 25000,
"roi": 2.5,
"members": []
},
{
"season": 2026,
"league_id": null,
"dues_minor": 10000,
"side_pots_minor": 0,
"paid_minor": 10000,
"winnings_minor": 0,
"net_minor": -10000,
"roi": -1,
"members": []
}
],
"paid_minor": 20000,
"winnings_minor": 35000,
"net_minor": 15000,
"roi": 0.75,
"seasons_in_profit": 1
}
],
"totals": {
"paid_minor": 20000,
"winnings_minor": 35000,
"net_minor": 15000,
"roi": 0.75
},
"tax_years": [
{
"year": 2025,
"winnings_minor": 0,
"paid_minor": 10000,
"payer_reporting_floor_minor": 60000
},
{
"year": 2026,
"winnings_minor": 35000,
"paid_minor": 10000,
"payer_reporting_floor_minor": 200000
}
],
"payouts": []
},
"as_of": "2026-10-04T17:30:00+00:00",
"source": "kelly",
"request_id": "req_b7cda6c47a006cfdccac717d"
}- kelly · as of 2026-10-04T17:30:00+00:00
GET /v1/me/limits
Check your limitsLink to this section
scope read:tracker · 0 credits, not charged during the beta · MCP tool check_my_limits · status live
The loss, deposit, at-risk and drawdown limits you set on your Kelly account and its projects, with how much of each is used and left now. Pass stake_minor to see each as it would stand with that stake placed, and project_id to include that project's limits. Needs your own key or an OAuth token with read:tracker. Read only: limits are set on askkelly.ai. Test-mode keys read the same account as live ones.
ParametersLink to this section
stake_minorinteger · queryA stake to test, in cents: each limit as it would stand with it placed (deposit limits don't move).
min 0
project_idstring · queryA project of yours (proj_): with stake_minor, its limits are tested too.
pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
ResponseLink to this section
200 Your limits and where they stand.
objectconstrequiredAlways limits.
Always "limits".
limitsobjectrequiredYour limits on the account and its projects, used and left now, or with a stake you are testing. Your own numbers only; a project reads as its ID (the facts Kelly MCP's check_my_limits returns).
Show 7 fields
accountobjectrequiredThe account's limits, in currency units.
Show 11 fields
daynumbernullableThe day limit in currency units, or null when unset.
weeknumbernullableThe week limit in currency units, or null when unset.
monthnumbernullableThe month limit in currency units, or null when unset.
seasonnumbernullableThe season limit in currency units, or null when unset.
at_risknumbernullableThe at risk limit in currency units, or null when unset.
deposit_daynumbernullableThe deposit day limit in currency units, or null when unset.
deposit_weeknumbernullableThe deposit week limit in currency units, or null when unset.
deposit_monthnumbernullableThe deposit month limit in currency units, or null when unset.
drawdownnumbernullableThe drawdown limit in currency units, or null when unset.
season_startstringnullableThe day the season limit's year starts; null for the calendar year.
format date
raisedobjectRaises and clears waiting, by limit.
projectsarray of objectrequiredEach open project's limits.
Show 2 fields
idstringThe project's ID (proj_); its name stays on askkelly.ai.
pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
limitsobjectThe project's limits, in currency units.
Show 11 fields
daynumbernullableThe day limit in currency units, or null when unset.
weeknumbernullableThe week limit in currency units, or null when unset.
monthnumbernullableThe month limit in currency units, or null when unset.
seasonnumbernullableThe season limit in currency units, or null when unset.
at_risknumbernullableThe at risk limit in currency units, or null when unset.
deposit_daynumbernullableThe deposit day limit in currency units, or null when unset.
deposit_weeknumbernullableThe deposit week limit in currency units, or null when unset.
deposit_monthnumbernullableThe deposit month limit in currency units, or null when unset.
drawdownnumbernullableThe drawdown limit in currency units, or null when unset.
season_startstringnullableThe day the season limit's year starts; null for the calendar year.
format date
raisedobjectRaises and clears waiting, by limit.
stake_minorintegerrequirednullableThe stake tested, or null. In cents.
project_idstringrequirednullableThe project the stake is in, or null.
pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
statusarray of objectrequiredEach limit set: the account's, then each project's. With stake_minor, the account's and project_id's only.
Show 12 fields
scopestringaccount or project.
One of: account, project (open: new values may be added).
project_idstringnullableThe project, for a project's limit.
pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
limitstringWhich limit: day, week, month, season, at_risk, deposit_day, deposit_week, deposit_month or drawdown.
kindstringWhat it measures: loss, deposit, at_risk or drawdown.
periodstringnullableThe period it runs in: day, week, month or season; null for at_risk and drawdown.
startstringnullableThe period's start.
format date-time
endstringnullableThe period's end (exclusive).
format date-time
limit_minorintegerThe limit. In cents.
used_minorintegerHow much is used (with stake_minor: as if that stake were placed). In cents.
left_minorintegerHow much is left, never below 0. In cents.
reachedbooleanUsed is at or past the limit.
raiseobjectnullableA raise or clear waiting, or null.
Show 2 fields
limit_minorintegernullableThe raised limit; null for a clear. In cents.
startsstringWhen it takes effect.
format date-time
any_reachedbooleanrequiredWhether any limit in status is reached.
timezonestringrequiredYour time zone (IANA), which sets the periods.
as_ofstringrequiredWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringrequiredWho produced the value, as shown to readers.
min length 1
request_idstringnullableThe request that produced this response.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · insufficient_scope · not_entitled · not_found
ExampleLink to this section
GET https://api.askkelly.ai/v1/me/limits?project_id=proj_00000000000000000000
Authorization: Bearer $KELLY_API_KEY{
"type": "https://docs.askkelly.ai/problems/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "No project with that project_id is yours.",
"param": "project_id",
"doc_url": "https://docs.askkelly.ai/problems/not_found",
"request_id": "req_193408d6d05d8a65c5b14a74",
"retryable": false,
"display_message": "That could not be found."
}GET https://api.askkelly.ai/v1/me/limits?stake_minor=2500
Authorization: Bearer $KELLY_API_KEY{
"object": "limits",
"limits": {
"account": {
"day": null,
"week": 100,
"month": null,
"season": null,
"at_risk": 20,
"deposit_day": null,
"deposit_week": null,
"deposit_month": null,
"drawdown": null,
"season_start": null,
"raised": {}
},
"projects": [],
"stake_minor": 2500,
"project_id": null,
"status": [
{
"scope": "account",
"project_id": null,
"limit": "week",
"kind": "loss",
"period": "week",
"start": "2026-09-28T04:00:00+00:00",
"end": "2026-10-05T04:00:00+00:00",
"limit_minor": 10000,
"used_minor": 2500,
"left_minor": 7500,
"reached": false,
"raise": null
},
{
"scope": "account",
"project_id": null,
"limit": "at_risk",
"kind": "at_risk",
"period": null,
"start": null,
"end": null,
"limit_minor": 2000,
"used_minor": 2500,
"left_minor": 0,
"reached": true,
"raise": null
}
],
"any_reached": true,
"timezone": "America/New_York"
},
"as_of": "2026-10-04T17:30:00+00:00",
"source": "kelly",
"request_id": "req_f70e5fac7bfba473a7cbec90"
}- kelly · as of 2026-10-04T17:30:00+00:00
POST /v1/me/books/{book_id}/import
Import a book's historyLink to this section
scope write:tracker · 0 credits, not charged during the beta · status live
Imports the transaction history CSV your book lets you download into that book's bankroll pot: its deposits, withdrawals and bonuses, each row once, however often you send the file. Bets and payouts in the file are left to your bet log. Rows before the pot's opening balance are skipped, a balance check you recorded still reads what you saw, and the file's newest balance, when it has a balance column, is recorded as a balance check. Send dry_run to see the report without writing. Needs your own live API key with write:tracker; an AI app can't import, and a test-mode key can't change your bankroll.
ParametersLink to this section
book_idstring · pathrequiredOne of your books (abk_…), a book Kelly carries. Anyone else's book, or one that doesn't exist, answers not_found.
pattern ^abk_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
Body, application/json (required):
csvstringThe CSV file's text, as the book exported it. The whole request is at most 4 MB.
min length 1
columnsobjectThe header of any column the file names differently from the usual names.
Show 7 fields
datestringThe date column's header.
typestringThe type column's header.
amountstringThe amount column's header.
creditstringThe credit column's header.
debitstringThe debit column's header.
balancestringThe balance column's header.
idstringThe id column's header.
kindsobjectWhat a type cell means, as the file writes it: deposit, withdrawal, bonus or skip.
timezonestringThe IANA zone for times without one; default your time zone preference, else America/New_York.
max length 64
dry_runbooleanReport without writing.
default false
ResponseLink to this section
200 A dry run: what would be written.
objectconstrequiredAlways book_import.
Always "book_import".
book_idstringrequiredYour book (abk_…).
pattern ^abk_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
pot_idstringrequirednullableThe book's bankroll pot (pot_…), made by the import when the book had none; null on a dry run before it exists.
dry_runbooleanrequiredTrue when nothing was written.
currencyconstrequiredThe bankroll's currency.
Always "USD".
timezonestringrequiredThe IANA zone times without one were read in.
columnsobjectrequiredThe file's header for each column it read, by role.
Show 7 fields
datestringThe header read as the date column.
typestringThe header read as the type column.
amountstringThe header read as the amount column.
creditstringThe header read as the credit column.
debitstringThe header read as the debit column.
balancestringThe header read as the balance column.
idstringThe header read as the id column.
linesintegerrequiredLines after the header, blank ones included.
min 0
importedobjectrequiredHow many rows of each kind were written (or would be, on a dry run).
Show 3 fields
depositsintegerrequiredDeposits.
min 0
withdrawalsintegerrequiredWithdrawals.
min 0
bonusesintegerrequiredBonuses.
min 0
amountsobjectrequiredWhat those rows add up to, in minor units of currency, each as a positive amount.
Show 3 fields
deposits_minorintegerrequiredMoney deposited.
min 0
withdrawals_minorintegerrequiredMoney withdrawn.
min 0
bonuses_minorintegerrequiredBonuses credited, net of any the file shows taken back.
min 0
skippedobjectrequiredRows not written, by reason.
Show 5 fields
duplicateintegerrequiredAlready imported, from this file or an earlier one.
min 0
before_potintegerrequiredDated before the pot's opening balance, which already holds them.
min 0
futureintegerrequiredDated after now.
min 0
not_moneyintegerrequiredNot a deposit, withdrawal or bonus: bets, payouts, and reversed, cancelled, failed, declined, rejected, pending or void rows.
min 0
invalidintegerrequiredA date, amount or balance that couldn't be read; problems lists the first of them.
min 0
restated_checksintegerrequiredBalance checks you recorded that were recorded again with the same balance and time, so each still reads what you saw.
min 0
balance_checkone of several shapesrequiredThe balance check recorded from the file's newest balance, or null when the file has no balance column or the pot already has a newer balance.
cash_minorintegerrequiredThe pot's cash after the import, in minor units.
at_risk_minorintegerrequiredThe pot's money at risk in open bets, in minor units.
problemsarray of objectrequiredThe first rows that couldn't be read, by line and field; never their content.
max items 20
Show 2 fields
lineintegerrequiredThe line in the file, from 1.
min 1
fieldstringrequiredThe field that couldn't be read.
One of: date, amount, balance (open: new values may be added).
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · insufficient_scope · not_entitled · not_found · payload_too_large
ExampleLink to this section
POST https://api.askkelly.ai/v1/me/books/abk_mw4vhfqmsjrkc3j2rq87/import
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"csv": "Sample Book transaction history (sample)\nDate,Type,Amount,Balance,Transaction ID\n2026-09-06 10:15,Deposit,$200.00,200.00,S-1001\n2026-09-06 13:00,Bet Placed,-50.00,150.00,S-1002\n2026-09-07 09:30,Bonus,25.00,175.00,S-1003\n2026-09-20 18:45,Withdrawal,-100.00,75.00,S-1004\n2026-09-21 08:00,Deposit Cancelled,50.00,75.00,S-1005\n",
"dry_run": true
}
{
"object": "book_import",
"book_id": "abk_mw4vhfqmsjrkc3j2rq87",
"pot_id": "pot_gbdhn3h9c9hqvp2jkq17",
"dry_run": true,
"currency": "USD",
"timezone": "America/New_York",
"columns": {
"date": "Date",
"type": "Type",
"amount": "Amount",
"balance": "Balance",
"id": "Transaction ID"
},
"lines": 5,
"imported": {
"deposits": 0,
"withdrawals": 0,
"bonuses": 0
},
"amounts": {
"deposits_minor": 0,
"withdrawals_minor": 0,
"bonuses_minor": 0
},
"skipped": {
"duplicate": 3,
"before_pot": 0,
"future": 0,
"not_money": 2,
"invalid": 0
},
"restated_checks": 0,
"balance_check": null,
"cash_minor": 7500,
"at_risk_minor": 0,
"problems": []
}POST https://api.askkelly.ai/v1/me/books/abk_mw4vhfqmsjrkc3j2rq87/import
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"csv": "Sample Book transaction history (sample)\nDate,Type,Amount,Balance,Transaction ID\n2026-09-06 10:15,Deposit,$200.00,200.00,S-1001\n2026-09-06 13:00,Bet Placed,-50.00,150.00,S-1002\n2026-09-07 09:30,Bonus,25.00,175.00,S-1003\n2026-09-20 18:45,Withdrawal,-100.00,75.00,S-1004\n2026-09-21 08:00,Deposit Cancelled,50.00,75.00,S-1005\n"
}
{
"object": "book_import",
"book_id": "abk_mw4vhfqmsjrkc3j2rq87",
"pot_id": "pot_gbdhn3h9c9hqvp2jkq17",
"dry_run": false,
"currency": "USD",
"timezone": "America/New_York",
"columns": {
"date": "Date",
"type": "Type",
"amount": "Amount",
"balance": "Balance",
"id": "Transaction ID"
},
"lines": 5,
"imported": {
"deposits": 1,
"withdrawals": 1,
"bonuses": 1
},
"amounts": {
"deposits_minor": 20000,
"withdrawals_minor": 10000,
"bonuses_minor": 2500
},
"skipped": {
"duplicate": 0,
"before_pot": 0,
"future": 0,
"not_money": 2,
"invalid": 0
},
"restated_checks": 0,
"balance_check": {
"id": "bke_34vd2dbdgsh8pdwkbk0r",
"balance_minor": 7500,
"occurred_at": "2026-09-21T12:00:00+00:00"
},
"cash_minor": 7500,
"at_risk_minor": 0,
"problems": []
}POST https://api.askkelly.ai/v1/me/books/abk_mw4vhfqmsjrkc3j2rq87/import
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"csv": "Sample Book transaction history (sample)\nDate,Type,Amount,Balance,Transaction ID\n2026-09-06 10:15,Deposit,$200.00,200.00,S-1001\n2026-09-06 13:00,Bet Placed,-50.00,150.00,S-1002\n2026-09-07 09:30,Bonus,25.00,175.00,S-1003\n2026-09-20 18:45,Withdrawal,-100.00,75.00,S-1004\n2026-09-21 08:00,Deposit Cancelled,50.00,75.00,S-1005\n"
}
{
"type": "https://docs.askkelly.ai/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This needs the write:tracker scope.",
"param": "write:tracker",
"doc_url": "https://docs.askkelly.ai/problems/insufficient_scope",
"request_id": "req_9669d164d5edcd66d6de08af",
"retryable": false,
"display_message": "This app needs one more permission to do that."
}POST https://api.askkelly.ai/v1/me/books/abk_00000000000000000000/import
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"csv": "Sample Book transaction history (sample)\nDate,Type,Amount,Balance,Transaction ID\n2026-09-06 10:15,Deposit,$200.00,200.00,S-1001\n2026-09-06 13:00,Bet Placed,-50.00,150.00,S-1002\n2026-09-07 09:30,Bonus,25.00,175.00,S-1003\n2026-09-20 18:45,Withdrawal,-100.00,75.00,S-1004\n2026-09-21 08:00,Deposit Cancelled,50.00,75.00,S-1005\n"
}
{
"type": "https://docs.askkelly.ai/problems/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "No book with that book_id is yours.",
"param": "book_id",
"doc_url": "https://docs.askkelly.ai/problems/not_found",
"request_id": "req_fcb0f8204486f856a40f5811",
"retryable": false,
"display_message": "That could not be found."
}Generated from Kelly API 2026-10-05.