moth docs
Reference Account

Account

Returns the signed-in account's balance and deposit address, and its spend by day and model.

GEThttps://api.runmoth.si/v1/account

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 the last 1 to 90 days, 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 here
429rate_limit_errorToo many reads from the key, so wait for retry-after
curl https://api.runmoth.si/v1/account \
  -H "Authorization: Bearer $MOTH_SESSION"
Response
{
  "account_id": "acct_…",
  "balance_usd": "12.418306",
  "deposit_address": "0x5aE1…c09B"
}