---
title: "Your own wallet: addresses, visibility, live balances"
method: GET
path: "/api/wallet/me"
tags: ["wallet", "browser-session"]
---

# Your own wallet: addresses, visibility, live balances

`GET /api/wallet/me`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/wallet/me`
- Auth: API key in cookie `__session`

Clerk-session only, same-site only. Creates the member's wallet on first call if signup did not (idempotent). `balances.<chain>.ok:false` means the read failed and its amounts are null (unknown), never zero. `?balances=0` skips the balance reads. The agent-token path is the MCP tool `ic_wallet_get` (scope wallet:read). 404 unless wallets are enabled.

## Query parameters

- `balances` '0' | '1'

## Response `200`

Your wallet.

- WalletMeResponse
  - `ok` boolean, required
  - `wallet` WalletView, required
    - `icm` string, required: The member's stable IC member id (icm_<uuidv7>), the wallet login subject.
    - `network` 'testnet' | 'mainnet', required: testnet = Base Sepolia + Solana Devnet.
    - `base` object, required
      - `address` string: The Base smart-account address.
      - `owner_address` string: The EOA that owns the smart account.
      - `account` string: CAIP-10, e.g. eip155:8453:0x...
    - `solana` object, required
      - `address` string
      - `account` string: CAIP-10.
    - `public_visible` boolean, required: Whether the pay address is on the member's public profile. Default false.
    - `pay_note` string, nullable: What the member takes payment for, up to 80 chars.
    - `profile_url` string, nullable: /m/<handle>, or null without a handle.
    - `created_at` string, date-time
  - `balances` object, nullable
    - `base` WalletChainBalances
      - `chain` 'base' | 'solana', required
      - `network` string, required
      - `account` string, required: CAIP-10.
      - `ok` boolean, required: false = the read failed; usdc/native are then null (unknown), never zero.
      - `error` string
      - `usdc` object, nullable
        - `amount` string: Raw integer.
        - `decimals` integer
        - `display` string: Exact decimal.
        - `symbol` string
      - `native` object, nullable
        - `amount` string
        - `decimals` integer
        - `display` string
        - `symbol` string
    - `solana` WalletChainBalances
      - `chain` 'base' | 'solana', required
      - `network` string, required
      - `account` string, required: CAIP-10.
      - `ok` boolean, required: false = the read failed; usdc/native are then null (unknown), never zero.
      - `error` string
      - `usdc` object, nullable
        - `amount` string: Raw integer.
        - `decimals` integer
        - `display` string: Exact decimal.
        - `symbol` string
      - `native` object, nullable
        - `amount` string
        - `decimals` integer
        - `display` string
        - `symbol` string
    - `read_at` string, date-time

## Other responses

- `401`: Not signed in.
- `403`: Cross-site request refused.
- `404`: Wallets are not enabled on this deployment.
- `503`: The wallet provider could not be reached or wallets are not configured; retry after retry_after_seconds.

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)