---
title: "Get TRC-20 transaction info by account address"
method: GET
path: "/v1/accounts/{address}/transactions/trc20"
---

# Get TRC-20 transaction info by account address

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

## Request

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

Get the historical TRC-20, TRC-721 transfer records and authorization records of an account

## Path parameters

- `address` string, required

## Query parameters

- `only_confirmed` boolean
- `only_unconfirmed` boolean
- `limit` integer
- `fingerprint` string
- `order_by` string
- `min_timestamp` integer
- `max_timestamp` integer
- `contract_address` string
- `only_to` boolean
- `only_from` boolean
- `min_block_timestamp` integer
- `max_block_timestamp` integer

## Response `200`

200

- object
  - `data` object[]
    - `transaction_id` string: Transaction hash.
    - `token_info` object
      - `symbol` string: TRC-20 token symbol.
      - `address` string: TRC-20 contract address. (Encoding: Base58.)
      - `decimals` integer: TRC-20 token decimals.
      - `name` string: TRC-20 token name.
    - `block_timestamp` integer: The block timestamp. (Unit: millisecond)
    - `from` string: The `from` address of the transaction. (Encoding: Base58, starts with `T`.)
    - `to` string: The `to` address of the transaction. (Encoding: Base58, starts with `T`.)
    - `type` string: The TRC-20 event type, typically `Transfer` (capitalized event name, not a lowercase function name).
    - `value` string: The raw transferred amount (smallest unit, integer string). Divide by 10^`token_info.decimals` to get the human-readable amount. This value is NOT denominated in sun.
  - `success` boolean: Whether the request was successful.
  - `meta` object
    - `at` integer: The response timestamp. (Unit: millisecond)
    - `page_size` integer: The number of items returned on the current page.
    - `fingerprint` string: The fingerprint for paginating to the next page.
    - `links` object
      - `next` string: The URL for the next page of results.

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