Wallet Endpoints

Circuit REST endpoints are grouped by resource: /v1/{resource}/{operation}. Wallet endpoints live under /v1/wallets/.

List User Wallets

Get all wallets associated with the authenticated user. Endpoint: GET /v1/wallets/list Request

Header	Description
`Authorization: Bearer {token}`	User’s API auth token acquired from authentication

Query Parameter	Description
`cache`	Optional boolean. When supported, allows cached wallet data.

cURL Example

curl -X GET "https://api.circuit.org/v1/wallets/list" \
  -H "Authorization: Bearer api_auth_token"

Response

Array<{
  id: number;
  name: string;
  type: string;
  address: string;
  createdAt: string;
  totalUsd: string;
  networks: string[];
  balances: Array<{
    network: string;
    type: "ERC20" | "SPL" | "native" | "ERC1155";
    address: string;
    tokenId: string | null;
    imageUrl: string | null;
    entryPriceUsd?: string;
    leverage?: string;
    priceUsd: string;
    name: string;
    symbol: string;
    decimals: number;
    amount: string;
    totalUsd: string;
  }>;
  agents: Array<{
    id: number;
    name: string;
    imageUrl: string | null;
    isHyperliquidAgent: boolean;
  }>;
}>

Empty wallets return [].

​List User Wallets

List User Wallets