Wallet Management

How to inspect, filter, and manage wallet data after a wallet has already been created.

This page covers wallet-level read and operational methods. It does not cover AMP asset issuance, restrictions, reissuance, or burns. Those flows live under Tokenization Overview.

Before you begin

complete Setup and Installation
create the wallet first with Wallet Onboarding Workflow
use the request helper from Making Requests

List wallets

const result = await broadcastRequest({
  action: 'get',
  resource: '/wallets',
  details: {},
})

const wallets = result.details

Filter wallets

const result = await broadcastRequest({
  action: 'get',
  resource: '/wallets',
  details: {
    filters: {
      name: 'ops',
      signer_id: signerId,
      user_id: userId,
      address: '...',
    },
  },
})

Use filters when you need to locate wallets by owner, signer, label, or known address data.

Read one wallet

const result = await broadcastRequest({
  action: 'get',
  resource: `/wallets/${walletId}`,
  details: {},
})

This is the best method when you need the wallet descriptor, network, type, and linked signer information.

Read wallet balances

const result = await broadcastRequest({
  action: 'get',
  resource: `/wallets/${walletId}/balances`,
})

Use this to:

confirm funding
check multi-asset Liquid balances
inspect operational holdings before creating new spend requests

Generate a receive address

const result = await broadcastRequest({
  action: 'add',
  resource: `/wallets/${walletId}/addresses`,
  details: {
    type: 'receive',
    index: 1,
  },
})

console.log(result.details.address)