🆎 Get all transactions for an address

Code samples

GET /api/v1/trx/address/{address}/transactions

curl 'https://settla.net/api/v1/trx/address/TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9/transactions?currency=usdt' \
  -H 'X-API-Key: $SETTLA_API_KEY' \
  -H 'Accept: application/json'

Returns the address's transaction history from the platform's TRX index, newest first, wrapped in {transactions, pagination} — the list is not the top-level value. Entries here are the short form: identifiers, counterparties, amount, fee and result. raw_data, token_decimals and @timestamp are only returned by GET /api/v1/trx/transactions/{hash}. Two fields deserve care. result is the on-chain outcome, so a FAILED TRC20 transfer is a transaction that was mined and paid for but reverted — most often out of energy — and must not be treated as an incoming payment. And fee here is the fee actually charged, which can differ from the fee reported by the by-hash endpoint; see that endpoint for why. The example below is abridged to two of the 979 transactions this address has. Paging caveat. per_page is honoured for currency=trx and currency=usdt, but the default currency=all feed ignores it and returns up to 50 items per page; pagination.per_page still echoes back whatever you asked for, while pagination.total_pages is computed for pages of 50. If you need a page size you control, request a single currency.

🛠️ Parameters

Name	In	Type	Required	Description
address	path	string	true	Base58 Tron address.
currency	query	string	false	Which feed to read. Any other value is rejected with `400`.
page	query	integer	false	1-based page number; values below 1 are clamped to 1.
per_page	query	integer	false	Items per page, clamped to 1–50. Ignored by the `all` feed — see the paging caveat above.

Example responses

200 Response

{
  "transactions": [
    {
      "tx_id": "8b5e5f9a99d65c0b3aac7f3cbc2ee3029a0d4225054fd99830236d96d853c503",
      "block_number": 77951958,
      "block_timestamp": 1764517689000,
      "contract_type": "TriggerSmartContract",
      "from": "TEPSrSYPDSQ7yXpMFPq91Fb1QEWpMkRGfn",
      "to": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
      "token_symbol": "USDT",
      "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "amount": "2000000",
      "fee": 0,
      "result": "SUCCESS"
    },
    {
      "tx_id": "3296e063030ea7f84bb4cbea4911a54911805c958637564a84d4adcc02e39d49",
      "block_number": 78365095,
      "block_timestamp": 1765757448000,
      "contract_type": "TriggerSmartContract",
      "from": "TPrkFhZ8LH8Mruco8vXyA496TaeFBrbmeU",
      "to": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
      "token_symbol": "USDT",
      "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "amount": "1000000",
      "fee": 0,
      "result": "FAILED"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 20,
    "total_transactions": 979,
    "per_page": 20,
    "has_more": true
  }
}

400 Response

{
  "error": "Invalid currency parameter."
}

🔁 Responses

Status	Meaning	Description	Schema
200	OK	List of transactions	Inline
400	Bad Request	Unsupported `currency` value	Inline

🔄 Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» transactions	[object]	false	none	none
»» tx_id	string	false	none	none
»» block_number	integer¦null	false	none	none
»» block_timestamp	integer(int64)¦null	false	none	Milliseconds since the Unix epoch.
»» contract_type	string	false	none	`TransferContract` for TRX, `TriggerSmartContract` for TRC20.
»» from	string¦null	false	none	none
»» to	string¦null	false	none	none
»» token_symbol	string	false	none	`TRX` for native transfers.
»» contract_address	string¦null	false	none	`null` for native TRX transfers.
»» amount	string	false	none	Smallest unit, as a decimal string.
»» fee	integer	false	none	Fee actually charged, in SUN.
»» result	string	false	none	none
» pagination	object	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	Echoes the requested value. Not necessarily the number of items actually returned — see the endpoint description.
»» has_more	boolean	false	none	none

Status Code 400

Name	Type	Required	Restrictions	Description
» error	string	false	none	none
» details	object	false	none	Present only on a few validation errors.

Enumerated Values

Property	Value
result	SUCCESS
result	FAILED