Skip to main content
GET
/
x402
/
balance
/
{walletAddress}
/api/v1/x402/balance/{walletAddress}
curl --request GET \
  --url https://api.venice.ai/api/v1/x402/balance/{walletAddress} \
  --header 'X-Sign-In-With-X: <api-key>'
{
  "success": true,
  "data": {
    "walletAddress": "0xyour_wallet_address",
    "balanceUsd": 12.5,
    "canConsume": true,
    "minimumTopUpUsd": 5,
    "suggestedTopUpUsd": 10,
    "diemBalanceUsd": 5.25
  }
}

Authorizations

​
X-Sign-In-With-X
string
header
required

base64-encoded JSON SIWE payload message proving wallet ownership

Headers

​
X-Sign-In-With-X
string
required

base64-encoded JSON SIWE payload message proving wallet ownership

Example:

"siwx_example_token"

Path Parameters

​
walletAddress
string
required

Ethereum wallet address.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0xYOUR_WALLET_ADDRESS"

Response

Current x402 balance for the wallet.

​
success
enum<boolean>
required
Available options:
true
​
data
object
required