— API · ACCOUNT

Unified Account

Earned, spent, and withdrawable USDC balances for a wallet. withdrawable_atomic is net seller earnings on ledger rows where settlement_id IS NULL — unsettled balance eligible for payout, not a rolling time window.

WITHDRAWABLE
settlement_id IS NULL
net seller rows not yet settled
FIELDS
7
wallet · earned · spent · withdrawable · payout_chain · endpoints_count · scopes?
AUTH
Bearer
balance:read or wallet signature

Overview

Single GET /v1/account route. Auth via Bearer balance:read scope or wallet stats signature (wallet, sig, ts query params). Returns seven core fields plus optional scopes when using Bearer.

GET/v1/account

Unified account balance

Bearer balance:read or ?wallet=&sig=&ts= stats signature

Error codes
400 invalid_wallet401 invalid_api_key401 invalid_signature401 invalid_timestamp401 unauthorized403 insufficient_scope500 internal_error

Request → Response

Requestapplication/json
GET /v1/account
Authorization: Bearer t402_live_…

# or wallet signature:
GET /v1/account?wallet=0xD6E8…2878&sig=0x…&ts=1717000000
Responseapplication/json
HTTP/1.1 200 OK
Content-Type: application/json

{
  "wallet": "0xD6E8aF2F65B4C9ACC7BF14A3096056e89E312878",
  "earned_atomic": "1234500",
  "spent_atomic": "98000",
  "withdrawable_atomic": "560000",
  "payout_chain": "base",
  "endpoints_count": 7,
  "scopes": [
    "read",
    "balance:read",
    "endpoints:write"
  ]
}
IMPLEMENTATION
curl -X GET "https://api.tools402.dev/v1/account" \
  -H "Authorization: Bearer t402_live_…"
# or wallet signature: ?wallet=0x…&sig=0x…&ts=1717000000