Skip to main content

API-Based Transactions Collection for a Specific Period

E
Written by Eilon Nisim Lotem
Updated this week

In this article, we will outline the process to run data collection (=commit), for the following parameters:

  • Specific internal accounts

  • Period (from and to date)

  • Specific Assets

The links to the postman contain the GraphQL query you should initiate and example responses.

Specific cases:

Steps to Fetch Historical Transactions:

1. Register the internal accounts in TRES [Link to Postman]

identifier: the address of the wallet

parentPlatform: the blockchain family (for any EVM-based - use ETHEREUM)

name: a friendly name for the wallet

2. Trigger commit [Link to Postman]

internalAccountIds: the internal account IDs you got as a response from step #1

internalAccountIdentifiers: the internal account addresses you want to run data collection (the reqeust should include internalAccountIds or internalAccountIdentifiers, but not both of them)

fromDate: the start time of the data collection period, should be ISO with UTC timezone (i.e. 2025-06-14T00:00:00+00:00)

toDate: end time of the data collection period, should be ISO with UTC timezone

commitId: valid and unique UUID4 generated by the user (i.e. 80a2268a-2006-4ef2-b056-0ce134febe8f)

assetsToCollect: list of assets keys to collect, each key should be at the following format β€œ{platform}_{identifier}”, (i.e. avax_0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7 or avax_native)

3. Check Commit Status [Link to Postman]

commitId: Use the commitId you generated in step #2

  • The data will be completed only when the commit status is COMPLETED

4. Query Sub Transactions = Balance changing events [Link to Postman]

limit: the number of results in each page

page: the page number

timestamp_Gt: the start time of the data collection period. Same as step #2

timestamp_Lt: end time of the data collection period. Same as step #2

belongsTo_In: the internal account IDs you want to query data

asset_In: a list of asset keys to query. Same as step #2

5. Check Parallel Commit Reconciliation Status - returns metrics about the data collection.

Request:

{
"commitId": "6a16a104-422a-4f68-bafd-b4634eafc801"
}

Response:

[
{
"fromDate": "2025-06-01T00:00:00+00:00",
"toDate": "2025-07-09T00:00:00+00:00",
"inflowAmount": 0.0032838007,
"outflowAmount": -5000000.0,
"feeAmount": -0.049850441,
"totalAmount": -5000000.04656664,
"openingBalance": 97111595.10644071,
"closingBalance": 92111595.05987407,
"balanceDiff": -5000000.046566635,
"reconciliationDiff": -4.6566128730773926e-09,
"isReconciled": true
}
]

Did this answer your question?