TRC-20 transaction history

📘
Prerequisites

TRC-20

The TronGrid v1 API exposes per-account TRC-20 transfer history. The endpoint returns all TRC-20 transfers — incoming and outgoing — for the requested account, optionally filtered by contract address.

Endpoint

GET /v1/accounts/{address}/transactions/trc20

Parameter	Description
`address`	The account address, in Base58 or hex.
`only_confirmed`	`true` or `false`. When `false`, both confirmed and unconfirmed transactions are returned. Cannot be combined with `only_unconfirmed`.
`only_unconfirmed`	`true` or `false`. When `false`, both confirmed and unconfirmed transactions are returned. Cannot be combined with `only_confirmed`.
`limit`	Transactions per page. Default `20`, maximum `200`.
`fingerprint`	The fingerprint of the last transaction returned on the previous page. Use it to paginate; keep other filters unchanged when paginating.
`contract_address`	TRC-20 contract address, in Base58 or hex. Filters results to a single token.

Example

Fetch the most recent USDT (TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t) transfers for TJmmqjb1DK9TTZbQXzRQ2AuA94z4gKAPFh:

BASE_URL=https://api.trongrid.io   # example — replace with any TRON node (TronGrid, third-party, or self-hosted)
curl --request GET \
  --url "${BASE_URL}/v1/accounts/TJmmqjb1DK9TTZbQXzRQ2AuA94z4gKAPFh/transactions/trc20?limit=20&contract_address=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"

For the full API reference, see Get TRC-20 transaction info by account address.

Related resources

TRC-20 — standard overview
TRC-20 contract interaction — read state and call methods directly
TRC-20 protocol interface — function and event reference