Get crypto connection

Returns one crypto Connection (tracked address) and its nested accounts. Pass an account’s accountId to link_account (source: "crypto").

GET/v1/get_crypto_connection

Query

Field	Type	Required	Default	Description
addressId	string	Yes	—	Tracked address id from list_crypto_connections.

Response `data`

Field	Type	Description
addressId	string	Tracked address id (crypto connection id).
name	string	User label for the address.
address	string	On-chain wallet address.
chainFamily	string	Chain family (e.g. evm).
status	string	Address lifecycle status (active, paused, …).
needsSync	boolean	True when a balance/tx sync is pending.
accounts	array	Snapshot token/native accounts under this address (see nested fields).
accounts[].accountId	string	Pass to link_account with source crypto (same role as investment groupId).
accounts[].name	string	Token symbol or currency label.
accounts[].network	string	Network this snapshot was synced on.
accounts[].currency	string	Fiat/reporting currency for the balance.
accounts[].tokenSymbol	string	On-chain token symbol when applicable.
accounts[].balance	number	Latest synced balance.

Request

curl --request GET \
  --url 'https://api.getliquify.com/v1/get_crypto_connection?addressId=addr_01' \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "data": {
    "addressId": "addr_01",
    "name": "Hot wallet",
    "address": "0xabc…",
    "chainFamily": "evm",
    "status": "active",
    "needsSync": false,
    "accounts": [
      {
        "accountId": "clink_01",
        "name": "USDC",
        "network": "ethereum",
        "currency": "USD",
        "tokenSymbol": "USDC",
        "balance": 40
      }
    ]
  }
}

Query

Response data

Related

Response `data`