Page the caller's credit movements
The append-only ledger of every credit movement on the caller's account, newest first: grants, purchases, and spends. A balance is always the sum of these rows, so this page can explain any balance without trusting a stored counter. A `delta` of 0 is a real row and means a free action — a security review sub-run, a price or chain read — that was still worth recording, so the history shows what the user did rather than only what they paid for.
The append-only ledger of every credit movement on the caller's account, newest first: grants, purchases, and spends. A balance is always the sum of these rows, so this page can explain any balance without trusting a stored counter.
A delta of 0 is a real row and means a free action — a security review sub-run, a price or chain read — that was still worth recording, so the history shows what the user did rather than only what they paid for.
Query Parameters
How many rows to return.
1 <= value <= 20050The nextCursor from the previous page.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/billing/ledger"{ "entries": [ { "id": "string", "delta": 0, "balanceKind": "allowance", "action": "string", "ref": "string", "createdAt": "2019-08-24T14:15:22Z" } ], "nextCursor": "string"}Read the caller's credit balance, tier, and next reset GET
Returns the two balances the caller's credits live in — `allowance` (the tier's monthly grant, spent first, never rolled over) and `purchased` (bought with money, never expires) — along with the tier their 7-day time-weighted $PUTTY holding resolves to, the tier above it, and when the allowance next resets. While the $PUTTY contract address is the zero address every caller is on `free`, whatever their snapshots say: there is no token to hold, so there is nothing to gate a tier on. `subsidyScalePercent` is below 100 when the global holder-subsidy cap is binding, which is why a holder's grant can be smaller than their tier's nominal allowance.
List the credit packs on sale GET
The credit packs a caller can buy, cheapest first, with the credits each buys when paid in a stablecoin and the (larger) number it buys when paid in $PUTTY. The `tokens` array is what `POST /billing/orders` accepts. Prices live here and in the dashboard, never on the marketing homepage.