Wallets

List wallets

Lists wallets across all active providers for the requested scope. Use provider to filter to a specific provider.

get/v1/wallets

Query parameters

provider'local' | 'fireblocks' | 'privy' | 'coinbase_cdp' | 'para' | 'turnkey' | 'dfns' | 'ibm_haven' | 'anchorage'

Wallet signing provider.

Example:privy

Wallet signing provider.

includeAllProvidersboolean

includeBalancesboolean

view'summary'

Headers

x-project-idstring

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Example:prj_example

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Response

Wallets

Example response

{
  "data": {
    "wallets": [
      {
        "id": "cw_example",
        "custodyConfigId": "cfg_example",
        "provider": "privy",
        "isDefaultProvider": true,
        "walletId": "privy_wallet_123",
        "publicKey": "So11111111111111111111111111111111111111112",
        "label": "Root Signing Wallet",
        "purpose": "root",
        "status": "active",
        "createdAt": "2025-01-01T00:00:00.000Z",
        "balances": [
          {
            "token": "USDC",
            "mint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
            "amount": "1250000",
            "uiAmount": "1.25",
            "decimals": 6,
            "usdPrice": 1,
            "usdValue": 125.5
          }
        ]
      }
    ]
  },
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}

Changes