Skip to main content
POST
X402 Balance

Body

application/json

Wallet-signature auth payload for a free, read-only balance check

address
string
required

EVM wallet address that signed the message (0x...).

issued_at
string
required

ISO-8601 UTC timestamp included in the signed message.

nonce
string
required

Random single-use nonce included in the signed message.

signature
string
required

EIP-191 personal_sign signature of the canonical message.

Response

Successful Response

wallet
string
required

Lowercased wallet address (verified from the signature).

project_id
string<uuid>
required

Wallet-derived project the balance belongs to.

total_credits_usd
number
required

Total spendable credit balance in USD.

additional_credits_usd
number
required

Standalone (x402 top-up / one_off) credit balance in USD.