Skip to main content

Get all token transfers of a wallet address and a contract

Overview​

This API offers a more targeted way to track token movements between a specific wallet and a particular smart contract. It is ideal for platforms, traders, and developers who need detailed insights into how tokens are being transferred between a wallet and a specific contract, such as in staking, liquidity pools, or token sale contracts. For NFT and token holders, it allows precise tracking of interactions with a contract, ensuring transparency and control over assets. DeFi projects and investors can use this API to analyze contract-specific transactions like token swaps, staking, or rewards distributed from the contract to the wallet. By narrowing the focus to a single wallet-contract relationship, this API simplifies auditing and enhances security checks, helping users spot patterns or irregularities in token flows. I t’s an essential tool for those who need contract-specific token transfer data without wading through the noise of all wallet transactions

Get all token transfers of a wallet address and a contract​

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

It requires two parameters (in path):

  • address: wallet address
  • contractAddress: contract 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 and the contract 0x029bb759353f6547fbe387e97869057849ab4d23:

curl --location 'https://api-gateway.skymavis.com/skynet/ronin/web3/v2/accounts/0xc591125e9770d0fc908c2ff1939b1ca2e27b9022/tokens/0x029bb759353f6547fbe387e97869057849ab4d23/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": 56,
                "tokenId": "201762",
                "contractAddress": "0x029bb759353f6547fbe387e97869057849ab4d23",
                "tokenStandard": "ERC721",
                "decimals": 0,
                "from": "0x0000000000000000000000000000000000000000",
                "to": "0xc591125e9770d0fc908c2ff1939b1ca2e27b9022",
                "value": "1",
                "blockHash": "0xb972bad1d526952432bcb7a9d6943aba0944a952e94b38975614ca970ecc490a",
                "transactionHash": "0x222c3e1dd18d333710c19d76e73b9be656b52ab604a9999ed3e316b4b7b64026",
                "blockTime": 1727289926
            }
        ],
        "paging": {
            "nextCursor": "Mzg0ODM0NjI6NTY6MjAxNzYy"
        }
    }
}

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