API

List crypto connections

User crypto Connections (tracked addresses) with nested accounts (accountId).

Returns every crypto Connection (tracked address) for the user, each with nested accounts. Use get_crypto_connection for one address. Pass an account’s accountId to link_account (source: "crypto"). Adding addresses / sync-now stays in-app.

GET/v1/list_crypto_connections

Query

FieldTypeRequiredDefaultDescription
(none)———No parameters.

Response data

FieldTypeDescription
itemsarrayCrypto connections (tracked addresses) owned by the authenticated user.

Item fields

FieldTypeDescription
addressIdstringTracked address id (crypto connection id).
namestringUser label for the address.
addressstringOn-chain wallet address.
chainFamilystringChain family (e.g. evm).
statusstringAddress lifecycle status (active, paused, …).
needsSyncbooleanTrue when a balance/tx sync is pending.
accountsarraySnapshot token/native accounts under this address (see nested fields).
accounts[].accountIdstringPass to link_account with source crypto (same role as investment groupId).
accounts[].namestringToken symbol or currency label.
accounts[].networkstringNetwork this snapshot was synced on.
accounts[].currencystringFiat/reporting currency for the balance.
accounts[].tokenSymbolstringOn-chain token symbol when applicable.
accounts[].balancenumberLatest synced balance.