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

Use cases

  • Get transactions for a TON address
  • Monitor recent account activity
  • Audit transaction history
Constraints

Constraints

  • Needs a valid TON address
  • Only finds existing transactions
Get started
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'
Copy
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"
        }
    ]
}
Copy

Request params

Parametersobject
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.