ASasksurf
Wallet

Aggregated Wallet Detail

Returns a wallet's cross-chain portfolio with selectable sub-resources (balance, tokens, labels, NFTs). Always includes per-chain USD breakdown across 15+ EVM chains.

Available fields (via fields): balance, tokens, labels, nft.

Lookup: by address. Partial failures return available fields with per-field error info. Returns 422 if fields is invalid.

get/gateway/v1/wallet/detail

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

addressstring required

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

Example:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
chain'ethereum' | 'polygon' | 'bsc' | 'avalanche' | 'arbitrum' | 'optimism' | 'fantom' | 'base' | 'solana'

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

Example:ethereum
fieldsstring

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

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataObjectResponseWalletDetailBody.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.