---
title: "Get TRC-20 token holder balances"
method: GET
path: "/v1/contracts/{contractAddress}/tokens"
---

# Get TRC-20 token holder balances

`GET /v1/contracts/{contractAddress}/tokens`

## Path parameters

- `contractAddress` string, required

## Query parameters

- `fingerprint` string
- `limit` integer
- `order_by` string

## Response `200`

200

- object
  - `data` object[] — The balance of the TRC-20 holder.
  - `success` boolean — Whether the request was successful.
  - `meta` object
    - `at` integer — The timestamp for when the API response was generated. (Unit: millisecond)
    - `page_size` integer — The number of items returned on the current page.
    - `fingerprint` string — A fingerprint of the last transaction on this page, used to fetch the next page of results.
    - `links` object
      - `next` string — The complete URL to request the next page of results. `null` if this is the last page.

## Other responses

- `400` — 400

---

[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)