Skip to main content

Get all token transfers of a wallet address

Overview​

This API allows users to track every token transaction associated with a specific wallet address. It is highly useful for individuals, investors, and platforms that want to monitor the flow of assets in and out of a particular wallet. For DeFi users and traders, it helps provide a clear record of all token movements, whether for personal tracking, tax reporting, or performance analysis. NFT collectors and creators can use this API to see how their tokens are being transferred between wallets. It’s also valuable for auditing purposes, allowing users to trace all token interactions with a wallet, offering full transparency and accountability. By giving access to detailed transfer data, this API simplifies wallet management and provides a comprehensive view of on-chain token movements, making it an essential tool for both individuals and platforms involved in crypto and NFT ecosystems

Get all token transfers of a wallet address​

To get all token transfers list, use this get token transfers of an address API

It requires one parameter (in path):

  • address: wallet address

Optional parameters (in query):

  • limit: how many items can be return in a single response, maximum 200
  • cursor: the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results
  • order: specify the order of result set. For most APIs, order might not be supported but the default value desc, otherwise you can choose between desc and asc. Desc ordering usually refers to show latest elements over older elements

Example of 0xc591125e9770d0fc908c2ff1939b1ca2e27b9022 wallet address:

curl --location 'https://api-gateway.skymavis.com/skynet/ronin/web3/v2/accounts/0xc591125e9770d0fc908c2ff1939b1ca2e27b9022/tokens/transfers?limit=2' \
--header 'Accept: application/json' \
--header 'X-API-KEY: <YOUR_API_KEY>'

Response:

{
    "result": {
        "items": [
            {
                "blockNumber": 38483462,
                "logIndex": 59,
                "tokenId": "201763",
                "contractAddress": "0x029bb759353f6547fbe387e97869057849ab4d23",
                "tokenStandard": "ERC721",
                "decimals": 0,
                "from": "0x0000000000000000000000000000000000000000",
                "to": "0xc591125e9770d0fc908c2ff1939b1ca2e27b9022",
                "value": "1",
                "blockHash": "0xb972bad1d526952432bcb7a9d6943aba0944a952e94b38975614ca970ecc490a",
                "transactionHash": "0x222c3e1dd18d333710c19d76e73b9be656b52ab604a9999ed3e316b4b7b64026",
                "blockTime": 1727289926
            },
            {
                "blockNumber": 38483462,
                "logIndex": 57,
                "tokenId": "1",
                "contractAddress": "0x59cfa86b6820901ebeddd60f131c473c15eae130",
                "tokenStandard": "ERC1155",
                "decimals": 0,
                "from": "0xc591125e9770d0fc908c2ff1939b1ca2e27b9022",
                "to": "0x0000000000000000000000000000000000000000",
                "value": "35",
                "blockHash": "0xb972bad1d526952432bcb7a9d6943aba0944a952e94b38975614ca970ecc490a",
                "transactionHash": "0x222c3e1dd18d333710c19d76e73b9be656b52ab604a9999ed3e316b4b7b64026",
                "blockTime": 1727289926
            }
        ],
        "paging": {
            "nextCursor": "Mzg0ODM0NjI6NTc6MQ=="
        }
    }
}

The response returned from the API may vary in the future as the state of NFTs/Ownership/Collections can change.