Skip to main content
GET
/
gateway
/
v1
/
wallet
/
detail
Aggregated Wallet Detail
curl --request GET \
  --url https://api.ask.surf/gateway/v1/wallet/detail
{
  "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_tokens": [
      {
        "balance": "<string>",
        "is_verified": true,
        "price": 123,
        "symbol": "<string>",
        "token_address": "<string>",
        "usd_value": 123,
        "chain": "<string>",
        "logo_url": "<string>",
        "name": "<string>"
      }
    ],
    "nft": [
      {
        "contract_address": "<string>",
        "token_id": "<string>",
        "chain": "<string>",
        "collection_name": "<string>",
        "image_url": "<string>",
        "name": "<string>",
        "usd_price": 123
      }
    ],
    "sol_tokens": [
      {
        "balance": "<string>",
        "decimals": 123,
        "symbol": "<string>",
        "token_address": "<string>",
        "name": "<string>"
      }
    ]
  },
  "meta": {
    "cached": true,
    "credits_used": 123
  },
  "$schema": "<string>"
}

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

OK

data
object
required
meta
object
required
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

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