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_timestampinteger
End timestamp of the event history in ms since Unix epoch (default current time)
start_timestampinteger
Start timestamp of the event history in ms since Unix epoch (default 0)
subaccount_idinteger
Subaccount id (must be set if wallet is blank)
walletstring
Wallet address (if set, subaccount_id ignored)

Response

idstring or integerrequired
resultobjectrequired
result.eventsarray of objectsrequired
List of erc20 transfers
result.events[].amountstringrequired
Amount withdrawn by the subaccount
result.events[].assetstringrequired
Asset withdrawn
result.events[].counterparty_subaccount_idintegerrequired
Recipient or sender subaccount_id of transfer
result.events[].is_outgoingbooleanrequired
True if the transfer was initiated by the subaccount, False otherwise
result.events[].subaccount_idintegerrequired
Subaccount ID of the subaccount involved in the transfer
result.events[].timestampintegerrequired
Timestamp of the transfer (in ms since UNIX epoch)
result.events[].tx_hashstringrequired
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}