v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-013469188.5 KB

Utilities

List the QR/transfer token shortlist

Returns the curated per-chain token shortlist the QR / manual-transfer flow offers as "what are you sending?". That flow has no connected wallet to read balances from, so it needs a suggested set rather than a discovered one. Filtered against the authenticated project's depositWhitelist when one is configured, so the flow cannot offer a token the client would reject on arrival. This is a suggestion list, not a capability list — /chains remains the authority on what the service supports.

get/qr/tokens

Headers

x-api-keystring

API key for authentication (omit when sending Authorization)

Example:your-api-key

API key for authentication (omit when sending Authorization)

authorizationstring

Bearer platform token (e.g. forwarded by user-service). Takes precedence over x-api-key when both are present.

Example:Bearer eyJhbGciOi...

Bearer platform token (e.g. forwarded by user-service). Takes precedence over x-api-key when both are present.

Response

Token shortlist per chain

tokensobject required

Keyed by EVM chain id as a decimal string, plus "solana" and "hypercore". An empty array means the deposit whitelist disallows this chain entirely — clients should hide it rather than offer a chain with nothing to send, and it is reported even for chains this shortlist does not curate. An absent chain carries no opinion (it is allowed, but no shortlist is curated for it) and clients should keep whatever default they have for it; the two are not interchangeable.