Wallet Detail

GET /gateway/v1/wallet/detail

Aggregated Wallet Detail

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/wallet/detail

200

{
  "data": {
    "active_chains": [
      {
        "chain": "<string>",
        "usd_value": 123,
        "chain_id": 123
      }
    ],
    "approvals": [
      {
        "balance": 123,
        "chain": "<string>",
        "spenders": [
          {
            "allowance": 123,
            "spender_address": "<string>",
            "spender_name": "<string>"
          }
        ],
        "symbol": "<string>",
        "token_address": "<string>",
        "name": "<string>"
      }
    ],
    "errors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ],
    "evm_balance": {
      "address": "<string>",
      "total_usd": 123,
      "chain_balances": [
        {
          "chain": "<string>",
          "usd_value": 123,
          "chain_id": 123
        }
      ]
    },
    "evm_tokens": [
      {
        "balance": "<string>",
        "is_verified": true,
        "price": 123,
        "symbol": "<string>",
        "token_address": "<string>",
        "usd_value": 123,
        "chain": "<string>",
        "logo_url": "<string>",
        "name": "<string>"
      }
    ],
    "labels": {
      "address": "<string>",
      "labels": [
        {
          "label": "<string>",
          "confidence": 123
        }
      ],
      "entity_name": "<string>",
      "entity_type": "<string>"
    },
    "nft": [
      {
        "contract_address": "<string>",
        "token_id": "<string>",
        "chain": "<string>",
        "collection_name": "<string>",
        "image_url": "<string>",
        "name": "<string>",
        "usd_price": 123
      }
    ],
    "sol_balance": {
      "address": "<string>",
      "sol_balance": "<string>"
    },
    "sol_tokens": [
      {
        "balance": "<string>",
        "decimals": 123,
        "symbol": "<string>",
        "token_address": "<string>",
        "name": "<string>"
      }
    ]
  },
  "meta": {
    "cached": true,
    "credits_used": 123
  },
  "$schema": "https://example.com/schemas/DataObjectResponseWalletDetailBody.json"
}

Query Parameters

address · string · required

Wallet address (0x hex for EVM, base58 for Solana)

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

chain · enum<string>

Chain filter for tokens, nft, and approvals. When omitted, inferred from address format: 0x addresses query all EVM chains, base58 addresses query Solana.

Available options: ethereum, polygon, bsc, avalanche, arbitrum, optimism, fantom, base, solana

Example:

"ethereum"

fields · string · default: balance,tokens,labels,nft

Comma-separated sub-resources to include. Valid: balance, tokens, labels, nft, approvals. The active_chains field is always returned. approvals is opt-in (not in default) as it triggers additional upstream calls.

Example:

"balance,labels,approvals"

Response

200

application/json

OK

data · object · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataObjectResponseWalletDetailBody.json"