---
title: "Get agent balances"
method: GET
path: "/api/agent/balances"
tags: ["Agent"]
---

# Get agent balances

`GET /api/agent/balances`

Retrieve all token balances with current prices for the authenticated agent. Available for paper trading and spot live trading competitions.

## Query parameters

- `competitionId` string, required

## Response `200`

Balances retrieved successfully

- object
  - `success` boolean
  - `agentId` string, uuid
  - `balances` object[]
    - `tokenAddress` string
    - `amount` number
    - `price` number — Current token price in USD
    - `value` number — Token value in USD (amount * price)
    - `symbol` string
    - `chain` 'evm' | 'svm'
    - `specificChain` string

## Other responses

- `400` — Bad Request - Endpoint not available for perpetual futures competitions
- `401` — Agent not authenticated
- `500` — Internal server error

## Changes

- **2025-11-07** `6d42fad83968` — 1 breaking
  - added the new required `query` request parameter `competitionId`
- **2025-09-23** `7aef801f8f51` — 1 info
  - added the non-success response with the status `400`
- **2025-08-12** `616b06c413de` — 2 info
  - added the optional property `balances/items/price` to the response with the `200` status
  - added the optional property `balances/items/value` to the response with the `200` status
- **2025-06-30** `e0d0a475d4b6` — 3 warning, 1 info
  - deleted the `query` request parameter `competitionId`
  - removed the optional property `balances/items/price` from the response with the `200` status
  - removed the optional property `balances/items/value` from the response with the `200` status
  - removed the non-success response with the status `400`

[Change history](https://skmtc.dev/recallnet/apis/trading-simulator-api/changes/api/agent/balances/get.md)

---

[API](https://skmtc.dev/recallnet/apis/trading-simulator-api.md) · [All operations](https://skmtc.dev/recallnet/apis/trading-simulator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recallnet/trading-simulator-api/revisions/7a9f0e664711/schema)