Skip to content
Kellydocs
Kellydocs

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
MethodPathTitleAccessPriceMCP tool
GET/v1/me/bankrollGet your bankrollread:tracker0get_my_bankroll
GET/v1/me/league-moneyGet your league moneyread:tracker0get_my_league_money
GET/v1/me/limitsCheck your limitsread:tracker0check_my_limits
POST/v1/me/books/{book_id}/importImport a book's historywrite:tracker0none

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.

objectconstrequired

Always bankroll.

Always "bankroll".

bankrollobjectrequired

Your 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
currencystringrequired

The account's currency, such as USD.

sourcestringrequirednullable

Where 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_minorintegerrequirednullable

Bankroll now: cash plus money at risk; null when none is recorded. In cents.

cash_minorintegernullable

Cash across the pots; null without pots. In cents.

at_risk_minorintegernullable

Money at risk in open bets; null without pots. In cents.

potsarray of objectrequired

The open pots, oldest first.

Show 7 fields
idstring

The pot's ID (pot_).

kindstring

book, exchange, prediction_market or cash.

namestring

The book's name, or cash (a cash pot's own label stays on askkelly.ai).

balance_minorinteger

Cash plus money at risk. In cents.

cash_minorinteger

Cash in the pot. In cents.

at_risk_minorinteger

Stakes of open bets. In cents.

last_checked_atstringnullable

The pot's last balance check, or null.

format date-time

projectsarray of object

Each project with a bankroll share.

Show 3 fields
idstring

The project's ID (proj_); its name stays on askkelly.ai.

pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

sharenumber

Its share of the bankroll, 0 to 1.

bankroll_minorintegernullable

That share of the bankroll; null while the bankroll is not above 0. In cents.

unclaimed_sharenumber

The share no project claims, 0 to 1.

resultobjectrequired

The betting result this week, month and year.

Show 3 fields
weekobject

One period, in the person's time zone.

Show 5 fields
startstring

The period's start.

format date-time

endstring

The period's end (exclusive).

format date-time

result_minorinteger

Betting result: the change in bankroll less deposits and withdrawals. In cents.

deposits_minorinteger

Deposits in the period. In cents.

withdrawals_minorinteger

Withdrawals in the period. In cents.

monthobject

One period, in the person's time zone.

Show 5 fields
startstring

The period's start.

format date-time

endstring

The period's end (exclusive).

format date-time

result_minorinteger

Betting result: the change in bankroll less deposits and withdrawals. In cents.

deposits_minorinteger

Deposits in the period. In cents.

withdrawals_minorinteger

Withdrawals in the period. In cents.

yearobject

One period, in the person's time zone.

Show 5 fields
startstring

The period's start.

format date-time

endstring

The period's end (exclusive).

format date-time

result_minorinteger

Betting result: the change in bankroll less deposits and withdrawals. In cents.

deposits_minorinteger

Deposits in the period. In cents.

withdrawals_minorinteger

Withdrawals in the period. In cents.

drawdownobjectrequired

The fall from the highest cumulative betting result.

Show 3 fields
peak_result_minorinteger

The highest cumulative result. In cents.

drawdown_minorinteger

The fall from it to now. In cents.

sharenumber

That fall's share of the bankroll at the peak, 0 to 1.

timezonestringrequired

Your time zone (IANA), which sets the periods.

as_ofstringrequired

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

format date-time

sourcestringrequired

Who produced the value, as shown to readers.

min length 1

request_idstringnullable

The 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

Request
GET https://api.askkelly.ai/v1/me/bankroll
Authorization: Bearer $KELLY_API_KEY
Response, 403
{
  "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."
}
Request
GET https://api.askkelly.ai/v1/me/bankroll
Authorization: Bearer $KELLY_API_KEY
Response, 200
{
  "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"
}
  1. 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.

objectconstrequired

Always league_money.

Always "league_money".

league_moneyobjectrequired

The person's league money.

Show 5 fields
currencystring

The account's currency.

leaguesarray of object

Each league.

Show 8 fields
keystring

A stable key for the league across seasons.

namestringnullable

The platform's name for a connected league; null for one the person named.

seasonsarray of object

Its seasons, oldest first.

Show 9 fields
seasoninteger

The season.

league_idstringnullable

The connected league (lg_…), or null for one the person named.

dues_minorinteger

Dues paid. In cents.

side_pots_minorinteger

Side pots paid. In cents.

paid_minorinteger

Dues plus side pots. In cents.

winnings_minorinteger

Winnings taken out. In cents.

net_minorinteger

Winnings less paid. In cents.

roinumbernullable

Net over paid; null with nothing paid.

membersarray of object

A commissioner's ledger: each team's paid_minor, payout_minor and owed_minor.

paid_minorinteger

Paid in, every season. In cents.

winnings_minorinteger

Won, every season. In cents.

net_minorinteger

Net, every season. In cents.

roinumbernullable

Net over paid.

seasons_in_profitinteger

Seasons with a positive net.

totalsobject

paid_minor, winnings_minor, net_minor and roi across every league.

tax_yearsarray of object

Per calendar year: winnings_minor received, paid_minor, and the payer's 1099-MISC reporting floor in cents where known.

payoutsarray of object

Each league-season's payout table: dues_minor, places_minor, weekly_high_minor, regular_season_winner_minor, teams and pot_minor.

as_ofstringrequired

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

format date-time

sourcestringrequired

Who produced the value, as shown to readers.

min length 1

request_idstringnullable

The 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

Request
GET https://api.askkelly.ai/v1/me/league-money
Authorization: Bearer $KELLY_API_KEY
Response, 403
{
  "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."
}
Request
GET https://api.askkelly.ai/v1/me/league-money
Authorization: Bearer $KELLY_API_KEY
Response, 200
{
  "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"
}
  1. 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 · query

A stake to test, in cents: each limit as it would stand with it placed (deposit limits don't move).

min 0

project_idstring · query

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

objectconstrequired

Always limits.

Always "limits".

limitsobjectrequired

Your 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
accountobjectrequired

The account's limits, in currency units.

Show 11 fields
daynumbernullable

The day limit in currency units, or null when unset.

weeknumbernullable

The week limit in currency units, or null when unset.

monthnumbernullable

The month limit in currency units, or null when unset.

seasonnumbernullable

The season limit in currency units, or null when unset.

at_risknumbernullable

The at risk limit in currency units, or null when unset.

deposit_daynumbernullable

The deposit day limit in currency units, or null when unset.

deposit_weeknumbernullable

The deposit week limit in currency units, or null when unset.

deposit_monthnumbernullable

The deposit month limit in currency units, or null when unset.

drawdownnumbernullable

The drawdown limit in currency units, or null when unset.

season_startstringnullable

The day the season limit's year starts; null for the calendar year.

format date

raisedobject

Raises and clears waiting, by limit.

projectsarray of objectrequired

Each open project's limits.

Show 2 fields
idstring

The project's ID (proj_); its name stays on askkelly.ai.

pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

limitsobject

The project's limits, in currency units.

Show 11 fields
daynumbernullable

The day limit in currency units, or null when unset.

weeknumbernullable

The week limit in currency units, or null when unset.

monthnumbernullable

The month limit in currency units, or null when unset.

seasonnumbernullable

The season limit in currency units, or null when unset.

at_risknumbernullable

The at risk limit in currency units, or null when unset.

deposit_daynumbernullable

The deposit day limit in currency units, or null when unset.

deposit_weeknumbernullable

The deposit week limit in currency units, or null when unset.

deposit_monthnumbernullable

The deposit month limit in currency units, or null when unset.

drawdownnumbernullable

The drawdown limit in currency units, or null when unset.

season_startstringnullable

The day the season limit's year starts; null for the calendar year.

format date

raisedobject

Raises and clears waiting, by limit.

stake_minorintegerrequirednullable

The stake tested, or null. In cents.

project_idstringrequirednullable

The project the stake is in, or null.

pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

statusarray of objectrequired

Each limit set: the account's, then each project's. With stake_minor, the account's and project_id's only.

Show 12 fields
scopestring

account or project.

One of: account, project (open: new values may be added).

project_idstringnullable

The project, for a project's limit.

pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

limitstring

Which limit: day, week, month, season, at_risk, deposit_day, deposit_week, deposit_month or drawdown.

kindstring

What it measures: loss, deposit, at_risk or drawdown.

periodstringnullable

The period it runs in: day, week, month or season; null for at_risk and drawdown.

startstringnullable

The period's start.

format date-time

endstringnullable

The period's end (exclusive).

format date-time

limit_minorinteger

The limit. In cents.

used_minorinteger

How much is used (with stake_minor: as if that stake were placed). In cents.

left_minorinteger

How much is left, never below 0. In cents.

reachedboolean

Used is at or past the limit.

raiseobjectnullable

A raise or clear waiting, or null.

Show 2 fields
limit_minorintegernullable

The raised limit; null for a clear. In cents.

startsstring

When it takes effect.

format date-time

any_reachedbooleanrequired

Whether any limit in status is reached.

timezonestringrequired

Your time zone (IANA), which sets the periods.

as_ofstringrequired

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

format date-time

sourcestringrequired

Who produced the value, as shown to readers.

min length 1

request_idstringnullable

The 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

Request
GET https://api.askkelly.ai/v1/me/limits?project_id=proj_00000000000000000000
Authorization: Bearer $KELLY_API_KEY
Response, 404
{
  "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."
}
Request
GET https://api.askkelly.ai/v1/me/limits?stake_minor=2500
Authorization: Bearer $KELLY_API_KEY
Response, 200
{
  "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"
}
  1. 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 · pathrequired

One 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):

csvstring

The CSV file's text, as the book exported it. The whole request is at most 4 MB.

min length 1

columnsobject

The header of any column the file names differently from the usual names.

Show 7 fields
datestring

The date column's header.

typestring

The type column's header.

amountstring

The amount column's header.

creditstring

The credit column's header.

debitstring

The debit column's header.

balancestring

The balance column's header.

idstring

The id column's header.

kindsobject

What a type cell means, as the file writes it: deposit, withdrawal, bonus or skip.

timezonestring

The IANA zone for times without one; default your time zone preference, else America/New_York.

max length 64

dry_runboolean

Report without writing.

default false

ResponseLink to this section

200 A dry run: what would be written.

objectconstrequired

Always book_import.

Always "book_import".

book_idstringrequired

Your book (abk_…).

pattern ^abk_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

pot_idstringrequirednullable

The book's bankroll pot (pot_…), made by the import when the book had none; null on a dry run before it exists.

dry_runbooleanrequired

True when nothing was written.

currencyconstrequired

The bankroll's currency.

Always "USD".

timezonestringrequired

The IANA zone times without one were read in.

columnsobjectrequired

The file's header for each column it read, by role.

Show 7 fields
datestring

The header read as the date column.

typestring

The header read as the type column.

amountstring

The header read as the amount column.

creditstring

The header read as the credit column.

debitstring

The header read as the debit column.

balancestring

The header read as the balance column.

idstring

The header read as the id column.

linesintegerrequired

Lines after the header, blank ones included.

min 0

importedobjectrequired

How many rows of each kind were written (or would be, on a dry run).

Show 3 fields
depositsintegerrequired

Deposits.

min 0

withdrawalsintegerrequired

Withdrawals.

min 0

bonusesintegerrequired

Bonuses.

min 0

amountsobjectrequired

What those rows add up to, in minor units of currency, each as a positive amount.

Show 3 fields
deposits_minorintegerrequired

Money deposited.

min 0

withdrawals_minorintegerrequired

Money withdrawn.

min 0

bonuses_minorintegerrequired

Bonuses credited, net of any the file shows taken back.

min 0

skippedobjectrequired

Rows not written, by reason.

Show 5 fields
duplicateintegerrequired

Already imported, from this file or an earlier one.

min 0

before_potintegerrequired

Dated before the pot's opening balance, which already holds them.

min 0

futureintegerrequired

Dated after now.

min 0

not_moneyintegerrequired

Not a deposit, withdrawal or bonus: bets, payouts, and reversed, cancelled, failed, declined, rejected, pending or void rows.

min 0

invalidintegerrequired

A date, amount or balance that couldn't be read; problems lists the first of them.

min 0

restated_checksintegerrequired

Balance 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 shapesrequired

The 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_minorintegerrequired

The pot's cash after the import, in minor units.

at_risk_minorintegerrequired

The pot's money at risk in open bets, in minor units.

problemsarray of objectrequired

The first rows that couldn't be read, by line and field; never their content.

max items 20

Show 2 fields
lineintegerrequired

The line in the file, from 1.

min 1

fieldstringrequired

The 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

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

Response, 200
{
  "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": []
}
Request
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" }

Response, 201
{
  "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": []
}
Request
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" }

Response, 403
{
  "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."
}
Request
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" }

Response, 404
{
  "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.

Support: support@askkelly.ai · Security and disclosure