Billing & Treasury API
Read the account service balance and create treasury top-ups.
These account-wide Dashboard endpoints require a merchant JWT. They are not project-scoped customer payment APIs.
| Method | Path | Purpose |
|---|---|---|
GET | /billing/me | Balance, fee rate, monthly volume, and account status |
GET | /billing/ledger?page=1&limit=20 | Paginated append-only balance history |
POST | /treasury/deposits | Create an exact-amount top-up intent |
GET | /treasury/deposits | List top-up intents |
GET | /treasury/deposits/:id | Read one intent |
POST | /treasury/deposits/:id/cancel | Cancel a PENDING intent |
Money fields are decimal strings. Creating a deposit currently supports USDT on TRON and returns the shared deployment treasury address plus a permanently reserved unique expectedAmount. Send that amount exactly once before expiry. The nominal request is returned as requestedAmount; the unique exact amount is used only for durable on-chain attribution.