getTransactions - Ton
getTransactions. Retrieves a list of transactions associated with a specified address or block, providing details about each transaction's status and content.
getTransactions - ton [Value: 100CU]
Retrieves a list of transactions associated with a specified address or block, providing details about each transaction's status and content.
Use cases
- Get transactions for a TON address
- Monitor recent account activity
- Audit transaction history
Constraints
- Needs a valid TON address
- Only finds existing transactions
Unlock Access to 50+ chains
Boost your app's speed and reliability with dRPC - get your access API key
Language
Request
Examples
curl --request GET \
--url '${DRPC_ENDPOINT_URL_TON}getTransactions?address=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2&limit=10&to_lt=0&archival=false' \
--header 'accept: application/json'
Response
200
{
"ok": true,
"result": [
{
"transaction_id": "0:abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
"from": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
"to": "EQBkQP48aUEDg5Y5RRc8SxFHm_C5tNcJDlh3e9pYHC-ZmG2M",
"amount": "5000000000",
"lt": 47597573000002,
"fee": "100000",
"timestamp": 1693527600,
"status": "completed",
"message": "Payment for services"
},
{
"transaction_id": "0:1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"from": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
"to": "EQC7VpEHw2DA9hxkdx_WXv9NSkb_v_KVQMY2Le4a4Fk9DUqQ",
"amount": "2000000000",
"lt": 47597573000001,
"fee": "50000",
"timestamp": 1693527500,
"status": "completed",
"message": "Subscription renewal"
}
]
}
Request params
object
addressstring
Required. The address for which to retrieve transactions.
limitinteger
Optional. The maximum number of transactions to return. Default is 10.
to_ltinteger
Optional. The logical time to start the search from, with 0 indicating the latest. Default is 0.
archivalboolean
Optional. Indicates whether to use an archival node for the query. Default is false.
Response
200
Response params
object
okboolean
Indicates if the request was successful.
resultarray
List of transaction details.
object
transaction_idstring
Unique identifier of the transaction.
fromstring
Address of the sender.
tostring
Address of the recipient.
amountstring
Amount transferred in the transaction, in the smallest units.
ltinteger
Logical time associated with the transaction.
feestring
Fee paid for the transaction.
timestampinteger
Unix timestamp when the transaction occurred.
statusstring
Current status of the transaction (e.g., completed).
messagestring
Additional message associated with the transaction.