Account
Moth DocsReference
GEThttps://api.runmoth.si/v1
/accountReturns the signed-in account's balance and deposit address, and its spend by day and model.
curl https://api.runmoth.si/v1/account \
-H "Authorization: Bearer $MOTH_SESSION"Response
{
"account_id": "acct_…",
"balance_usd": "12.418306",
"deposit_address": "0x5aE1…c09B"
}Both account endpoints take a wallet session from sign-in, not a key. A key reads the same balance through usage.
balance_usd already leaves out the holds still open, and deposit_address is the account's own USDG address on Robinhood Chain, or null while deposits aren't open.
Spend by day and model
GET /account/usage?days=30 lists the account's spend for today and the days before it, 1 to 90 whole days in UTC and 30 by default, as one row per day and model, newest day first.
json
{
"data": [
{
"day": "2026-10-30",
"model": "gemini-3.8-flash",
"requests": 31,
"input_tokens": 21890,
"output_tokens": 4410,
"units": 0,
"spent_usd": "0.016477"
}
]
}Errors
401authentication_errorNo live wallet session was sent, and a key can't be used here429rate_limit_errorToo many reads from the key, so wait for retry-after