---
title: "Get TRC-20 token balances by address"
method: GET
path: "/v1/accounts/{address}/trc20/balance"
---

# Get TRC-20 token balances by address

`GET /v1/accounts/{address}/trc20/balance`

## Request

- Base URL: `https://api.shasta.trongrid.io`
- URL: `https://api.shasta.trongrid.io/v1/accounts/{address}/trc20/balance`
- Auth: none declared
- TypeScript: <https://skmtc.dev/trongrid/apis/trongrid-v1-api/docs/v1/accounts/:address/trc20/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `address` string, required

## Query parameters

- `contract_address` string
- `limit` integer
- `fingerprint` string

## Response `200`

Successful response.

- object: TRC-20 balance(s) for an address.
  - `data` object[]
  - `success` boolean
  - `meta` Meta: TronGrid response envelope — pagination + timing metadata. Present on every successful TronGrid v1 response.
    - `at` integer: Server timestamp when the response was generated. (Unit: millisecond)
    - `page_size` integer: Number of items returned in this page.
    - `fingerprint` string: Opaque pagination cursor. Pass back as the `fingerprint` query parameter to fetch the next page.
    - `links` object: Pagination links.
      - `next` string: URL for the next page (empty if this is the last page).

---

[API](https://skmtc.dev/trongrid/apis/trongrid-v1-api.md) - [All operations](https://skmtc.dev/trongrid/apis/trongrid-v1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trongrid/apis/trongrid-v1-api/revisions/22cc4dd60c4c?raw)