---
title: "Discover a wallet’s VT-quotable holdings (Alchemy ∩ token universe)"
method: GET
path: "/value-transfer/holdings"
tags: ["value-transfer"]
---

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

`GET /value-transfer/holdings`

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.

## Query parameters

- `address` string, required
- `chainIds` string[]

## Response `200`

Discovered holdings

- HoldingsResponseDto
  - `holdings` HoldingDto[], required
    - `chainId` number, required — chainId the token is on.
    - `chainName` string, required — Display name of the chain, so a new chain needs no client release.
    - `address` string, required — Token address
    - `symbol` string, required
    - `name` string, required
    - `decimals` number, required
    - `balance` string, required — Human readable balance
    - `balanceRaw` string, required — Balance in the token's native units
    - `usdValue` number, required — USD value of the balance
    - `priceUsd` object, nullable, required — USD price of one whole token. Null when unpriced — render the row without a USD value rather than substituting another source.
    - `logoUrl` object, nullable, required — Token logo. Null for roughly half of tokens — fall back to a letter avatar.
    - `action` 'transfer' | 'bridge' | 'convert', required — How this token reaches the DRE wallet on Base: transfer (already on Base), bridge (same asset exists on Base), or convert (swap to USDC)
    - `destination` HoldingDestinationDto, required
      - `chainId` number, required
      - `address` string, required — Destination token address, or 0x0…0 for a native gas token.
      - `symbol` string, required
      - `decimals` number, required
  - `supportedChainIds` string[], required — Chains this feature scans and can bridge from. Server-owned so adding a chain needs no client release.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/dre/apis/dre-api.md) · [All operations](https://skmtc.dev/dre/apis/dre-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dre/dre-api/revisions/5d14beb9482b/schema)