---
title: "Demo wallet balances on a test network"
method: GET
path: "/api/balances"
tags: ["demo"]
---

# Demo wallet balances on a test network

`GET /api/balances`

## Request

- Base URL: `https://yield.trdefi.com`
- URL: `https://yield.trdefi.com/api/balances`
- Auth: none required

Reads USDC / USDT / ETH balances for up to 10 addresses on a **test network**, so the demo page can show live wallet state. Not a general-purpose balance API. **Same-origin only** and rate limited.

## Query parameters

- `addresses` string, required

## Response `200`

Balances

- object

## Other responses

- `400`: Malformed or missing parameters
- `403`: Origin or scope not allowed — the endpoint is restricted to TRDEFI pages, or the key does not carry the `prepare` scope.
- `429`: Rate limit exceeded. `Retry-After` is always present.

---

[API](https://skmtc.dev/trdefi/apis/trdefi-liquidity-api.md) · [All operations](https://skmtc.dev/trdefi/apis/trdefi-liquidity-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trdefi/apis/trdefi-liquidity-api/revisions/0175596aa1cb?raw)