Skip to main content
The wallet ledger. Every credit or debit that touched the balance, ordered by created_at desc. Mirrors the table at console.bytespike.ai/billing. Free.

​
When to use

  • Reconcile a Stripe receipt against the balance change
  • Export a CSV of transactions for accounting
  • Detect platform-admin adjustments (admin_credit / admin_debit)
For per-call spend (vs balance movement), use GET /me/usage. For per-key roll-up, use GET /balance.

​
Request

curl 'https://llm.bytespike.ai/api/v1/me/billing/transactions?page=1&page_size=50' \
  -H "Authorization: Bearer $BYTESPIKE_API_KEY"

​
Query parameters

ParamTypeNotes
pageintegerDefault 1.
page_sizeintegerDefault 50, max 200.
kindstringFilter: topup / refund / admin_credit / admin_debit / subscription_renew.
sincestringISO timestamp — only entries on/after this moment.
untilstringISO timestamp — only entries strictly before this moment.

​
Response

{
  "items": [
    {
      "id": 901234,
      "created_at": "2026-05-21T14:08:11Z",
      "kind": "topup",
      "amount_usd": 50.00,
      "balance_after_usd": 81.40,
      "source": {
        "provider": "stripe",
        "receipt_id": "ch_3PYj...mock-49",
        "method": "card_visa_4242"
      },
      "note": null
    },
    {
      "id": 901188,
      "created_at": "2026-05-15T08:14:02Z",
      "kind": "admin_credit",
      "amount_usd": 5.00,
      "balance_after_usd": 31.40,
      "source": {"actor": "ops@bytespike.ai"},
      "note": "Goodwill credit — failed Doubao call burst, ticket #312"
    }
  ],
  "total": 47,
  "page": 1,
  "page_size": 50
}

​
Response fields

FieldTypeNotes
items[].kindstringtopup (card / wire), refund (failed-call rebate), admin_credit / admin_debit, subscription_renew.
items[].amount_usdnumberSigned: positive for credits, negative for debits.
items[].balance_after_usdnumberSnapshot of the wallet after this entry posted. Useful for reconciliation.
items[].sourceobjectPer-kind shape — provider + receipt_id for topup; actor for admin entries.
items[].notestring | nullFree-form note attached at write time (admin entries only).
totalintegerTotal rows matching the filter (page-independent).

​
Errors

Statuserror.typeTrigger
400invalid_request_errorpage / page_size out of range, or since not parseable.
401authentication_errorMissing / revoked key.

​
Example — CSV export

import csv, requests, os, sys

headers = {"Authorization": f"Bearer {os.environ['BYTESPIKE_API_KEY']}"}
page, all_rows = 1, []
while True:
    r = requests.get(
        "https://llm.bytespike.ai/api/v1/me/billing/transactions",
        params={"page": page, "page_size": 200},
        headers=headers,
        timeout=10,
    ).json()
    all_rows.extend(r["items"])
    if page * r["page_size"] >= r["total"]:
        break
    page += 1

w = csv.DictWriter(sys.stdout, fieldnames=["created_at", "kind", "amount_usd", "balance_after_usd"])
w.writeheader()
for row in all_rows:
    w.writerow({k: row[k] for k in w.fieldnames})