Discover a wallet’s VT-quotable holdings (Alchemy ∩ token universe)

Server-side wallet discovery: Alchemy balances intersected with the VT universe, enriched with decimals + USD price, spam and zero balances dropped. Cached briefly per address.

get/value-transfer/holdings

Query parameters

addressstring required

Wallet address to discover holdings for.

chainIdsstring[]

Comma separated viem chainIds to scan (defaults to all supported chains).

Response

Discovered holdings

supportedChainIdsstring[] required

Chains this feature scans and can bridge from. Server-owned so adding a chain needs no client release.

Example response

{
  "holdings": [
    {
      "chainId": 8453,
      "chainName": "Arbitrum",
      "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "balance": "12.34",
      "balanceRaw": "12340000",
      "usdValue": 12.34,
      "action": "bridge",
      "destination": {
        "chainId": 8453,
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "symbol": "USDC",
        "decimals": 6
      }
    }
  ],
  "supportedChainIds": [
    1,
    8453,
    42161,
    143
  ]
}

Changes

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