x402

/api/v1/x402/balance/{walletAddress}

Get the x402 credit balance for a wallet address. Requires Sign-in-with-x authentication for the same EVM or Solana wallet.

get/api/v1/x402/balance/{walletAddress}

Request

  • Base URL: https://api.venice.ai
  • URL: https://api.venice.ai/api/v1/x402/balance/{walletAddress}
  • Auth: API key in header SIGN-IN-WITH-X

Path parameters

walletAddressstring required

EVM or Solana wallet address.

Example:0xYOUR_WALLET_ADDRESS

Headers

SIGN-IN-WITH-Xstring required
Example:siwx_example_token

base64-encoded JSON SIWX payload proving EVM or Solana wallet ownership. The legacy X-Sign-In-With-X header is also accepted during migration.

Response

Current x402 balance for the wallet.

successtrue required

Example response

{
  "data": {
    "walletAddress": "0xyour_wallet_address",
    "balanceUsd": 12.5,
    "canConsume": true,
    "minimumTopUpUsd": 5,
    "suggestedTopUpUsd": 10,
    "diemBalanceUsd": 5.25
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.