π Get all transactions for an address
Code samples
GET /api/v1/trx/address/{address}/transactions
Returns paginated list of transactions for the specified address
π οΈ Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| address | path | string | true | Tron address in base58 format |
| page | query | integer | false | Page number (default is 1) |
| per_page | query | integer | false | Items per page (default is 20, max is 50) |
| currency | query | string | false | Currency to filter by trx, usdt (default is all) |
Example responses
200 Response
{
"transactions": [
{
"@timestamp": "2025-09-16T12:30:42Z",
"amount": "3",
"block_hash": "000000000484715dffef1b99e837b860411174ae940c73ede754fe5dbb48b00d",
"block_number": 75788637,
"block_timestamp": 1758025842000,
"contract_type": "TransferContract",
"fee": 0,
"from": "TTkFbvEFZVU6wxjEgMo3Tueiisphi6cJzh",
"result": "SUCCESS",
"to": "TLWKepDBC8RZjAhtWyNqASyzgyVyHUuS7o",
"token_decimals": 6,
"token_symbol": "TRX",
"tx_id": "3ce2e9f522baf0e4dc28e0f2604c1ad2216482e535b1c60d65ea7cca1de40f70"
},
{
"@timestamp": "2025-09-16T12:30:30Z",
"amount": "3724000000",
"block_hash": "00000000048471591924378d405ab66bb72d6775e5032f36fa1f5be58efa0646",
"block_number": 75788633,
"block_timestamp": 1758025830000,
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"contract_type": "TriggerSmartContract",
"fee": 345000,
"from": "TLWKepDBC8RZjAhtWyNqASyzgyVyHUuS7o",
"result": "SUCCESS",
"to": "TNoSrqU8rxb1y2mcn1kvFmXRGVXyPiKJzh",
"token_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_decimals": 6,
"token_symbol": "USDT",
"tx_id": "d358ffa7390a1981c2b656efe89d1d04137570442ea2638a6920335f3c7f84fe"
}
],
"pagination": {
"current_page": 1,
"total_pages": 1,
"total_transactions": 20,
"per_page": 20,
"has_more": false
}
}
π Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Successful response | Inline |
| 400 | Bad Request | Bad request (invalid parameters) | None |
| 500 | Internal Server Error | Internal server error | None |
π Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| Β» transactions | [Transaction] | false | none | none |
| »» tx_id | string | false | none | Transaction ID (hash) |
| »» block_number | integer | false | none | Block number containing the transaction |
| »» block_timestamp | integer | false | none | Block timestamp in milliseconds |
| »» block_hash | string | false | none | Block hash containing the transaction |
| »» from | string | false | none | Sender address |
| »» to | string | false | none | Receiver address |
| »» amount | string | false | none | Transaction amount |
| »» token_symbol | string | false | none | Token symbol (TRX, USDT, etc.) |
| »» token_decimals | integer | false | none | Number of decimal places for the token |
| »» contract_type | string | false | none | Type of contract executed |
| »» fee | integer | false | none | Transaction fee in SUN |
| »» result | string | false | none | Transaction result status |
| »» contract_address | string¦null | false | none | Contract address (for TRC20 tokens) |
| »» token_address | string¦null | false | none | Token (TRC20) contract address (alias of contract_address) |
| »» raw_data | object | false | none | Raw transaction payload from blockchain/indexer |
| »» @timestamp | string | false | none | Indexing timestamp (ISO 8601) |
| Β» pagination | Pagination | false | none | none |
| »» current_page | integer | false | none | none |
| »» total_pages | integer | false | none | none |
| »» total_transactions | integer | false | none | none |
| »» per_page | integer | false | none | none |
| »» has_more | boolean | false | none | none |
Webhooks
Webhook management operations