---
title: "Get the user's wallet"
method: GET
path: "/api/v2/wallet"
tags: ["Wallet funding"]
---

# Get the user's wallet

`GET /api/v2/wallet`

The connected user's wallet and current balance — render it in your own wallet UI. Provisions the wallet on first read.

## Query parameters

- `user_id` string, required

## Response `200`

The wallet.

- Wallet
  - `object` 'wallet'
  - `user_id` string
  - `address` string — The wallet's on-chain address.
  - `balance_usdc` string — Current balance in USD, as a decimal string.
  - `balance_unavailable` boolean — Present and true when the balance could not be read right now — distinguish "no funds" from "couldn't read".
  - `status` string

## Other responses

- `400` — `invalid_request` — missing `user_id`.
- `401` — `unauthorized` — the platform access token is missing or expired. Exchange your client credentials for a fresh one.
- `404` — `connection_not_found` — no connection exists for that user under your client.
- `409` — `user_conflict` — the email on file in your organization belongs to a different account. Contact support.
- `503` — `wallet_unavailable` — wallets are temporarily unavailable.

---

[API](https://skmtc.dev/agentcard/apis/agentcard-api.md) · [All operations](https://skmtc.dev/agentcard/apis/agentcard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentcard/agentcard-api/revisions/638d12c8303f/schema)