Api transfer history request
The request to get the historical transfers of an account
The history is returned in reverse chronological order
Pagination works as follows:
- We perform a reverse chronological lookup, starting from
end_time. Ifend_timeis not set, we start from the most recent data. - The lookup is limited to
limitrecords. If more data is requested, the response will contain anextcursor for you to query the next page. - If a
cursoris provided, it will be used to fetch results from that point onwards. - Pagination will continue until the
start_timeis reached. Ifstart_timeis not set, pagination will continue as far back as our data retention policy allows.
NameLite |
Type | RequiredDefault |
Description |
|---|---|---|---|
currencyc |
[string] | True | The token currency to query for, if nil or empty, return all transfers. Otherwise, only entries matching the filter will be returned |
start_timest |
string | False0 |
The start time to query for in unix nanoseconds |
end_timeet |
string | Falsenow() |
The end time to query for in unix nanoseconds |
limitl |
integer | False500 |
The limit to query for. Defaults to 500; Max 1000 |
cursorc1 |
string | False'' |
The cursor to indicate when to start the next query from |
tx_idti |
string | False0 |
The transaction ID to query for |
main_account_idma |
string | False `` |
Main account ID being queried. By default, applies the requestor's main account ID. |
transfer_typestt |
[TransferType] | False[] |
The transfer type to filters for. If the list is empty, return all transfer types. |
TransferType
| Value | Description |
|---|---|
UNSPECIFIED = 0 |
Deprecated: use standard instead. Legacy value for transfers created before transfer types were introduced. |
STANDARD = 1 |
Standard transfer that has nothing to do with bridging |
FAST_ARB_DEPOSIT = 2 |
Fast Arb Deposit Metadata type |
FAST_ARB_WITHDRAWAL = 3 |
Fast Arb Withdrawal Metadata type |
NON_NATIVE_BRIDGE_DEPOSIT = 4 |
Transfer type for non native bridging deposit |
NON_NATIVE_BRIDGE_WITHDRAWAL = 5 |
Transfer type for non native bridging withdrawal |
ADHOC_INCENTIVE = 6 |
Transfer type for adhoc incentive |
REFERRAL_INCENTIVE = 7 |
Transfer type for referral incentive |
TRADING_DEPOSIT_YIELD_INCENTIVE = 8 |
Transfer type for trading deposit yield incentive |