---
title: "Raw wallet balances incl. frozen partitions"
method: GET
path: "/api/agent/wallet"
tags: ["reads"]
---

# Raw wallet balances incl. frozen partitions

`GET /api/agent/wallet`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/agent/wallet`
- Auth: HTTP bearer

USDT cash with its three frozen partitions (spot orders, PM, futures),
plus one optional coin asset if `coinId` is given. Requires scope `read`.

## Query parameters

- `coinId` string

## Response `200`

OK

- Wallet
  - `walletId` integer
  - `usdt` object: Cash (coinId 825). Frozen partitions are mutually exclusive buckets.
    - `coinId` '825'
    - `available` number: spendable cash
    - `frozen` number: reserved by open spot orders
    - `frozenPm` number: reserved by open PM positions
    - `frozenFutures` number: reserved as futures margin
    - `avgCostUsd` number
  - `coin` object, nullable: Present only when ?coinId was supplied.
    - `coinId` string
    - `available` number
    - `frozen` number
    - `avgCostUsd` number

## Other responses

- `401`: Missing/malformed or invalid/revoked API key
- `403`: API key missing the required scope
- `404`: No active mock_spot wallet for this user
- `429`: Rate limit exceeded for this API key (120 req/min baseline, 20 trade-writes/min). Honor `Retry-After`, then resume; the `RateLimit-*` headers on every response let you pace proactively. (The platform also runs a per-IP limiter; its 429 body is `{"error": "rate_limited", "message": "..."}`.)

---

[API](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api.md) · [All operations](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/revisions/28fb59f285fe?raw)