HomeDocumentationAPI Reference
Log In
API Reference

Get Erc20 Transfer History

Method Name

private/get_erc20_transfer_history

Get erc20 transfer history for a subaccount or wallet.

Position transfers (e.g. options or perps) are treated as trades. Use private/get_trade_history for position transfer history.
Required minimum session key permission level is read_only

Parameters

end_timestamp  integer
End timestamp of the event history in ms since Unix epoch (default current time)
start_timestamp  integer
Start timestamp of the event history in ms since Unix epoch (default 0)
subaccount_id  integer
Subaccount id (must be set if wallet is blank)
wallet  string
Wallet address (if set, subaccount_id ignored)

Response

id  string or integer required
result  object required
result. events  array of objects required
List of erc20 transfers
result.events[]. amount  string required
Amount withdrawn by the subaccount
result.events[]. asset  string required
Asset withdrawn
result.events[]. counterparty_subaccount_id  integer required
Recipient or sender subaccount_id of transfer
result.events[]. is_outgoing  boolean required
True if the transfer was initiated by the subaccount, False otherwise
result.events[]. subaccount_id  integer required
Subaccount ID of the subaccount involved in the transfer
result.events[]. timestamp  integer required
Timestamp of the transfer (in ms since UNIX epoch)
result.events[]. tx_hash  string required
Hash of the transaction that withdrew the funds

Example

{request_example_shell}
{request_example_javascript}
{request_example_python}

The above command returns JSON structured like this:

{response_example_json}