Sign in
Wallets

Get wallet by ID

Returns wallet metadata, custody provider, public key, and by default the current SOL balance for a specific wallet ID. Set includeBalance=false for metadata-only reads that must not call Solana RPC or pricing services. This endpoint requires authenticated access.

get/v1/wallets/{walletId}

Path parameters

walletIdstring required

Provider wallet ID — the walletId field returned by GET /v1/wallets.

Example:privy_wallet_123

Provider wallet ID — the walletId field returned by GET /v1/wallets.

Query parameters

includeBalance'true' | 'false'

Whether to resolve the current SOL balance. Defaults to true; false returns metadata without balance RPC or pricing calls.

Example:false

Whether to resolve the current SOL balance. Defaults to true; false returns metadata without balance RPC or pricing calls.

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

Wallet details

Example response

{
  "data": {
    "wallet": {
      "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",
      "balance": {
        "token": "SOL",
        "mint": "So11111111111111111111111111111111111111112",
        "amount": "123456789",
        "uiAmount": "0.123456789",
        "decimals": 9
      }
    }
  },
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}

Changes