Parameters
- objectobjectREQUIRED
A custom object with the following fields:
- addressstringREQUIRED
The wallet address or ENS name we want to check for transfers
- contractstring
The ERC-20 contract we want to check for transfers
- fromBlockstring
The first block number to check for transfers (inclusive). If omitted, will default to the genesis block for the provided token contract address
- toBlockstring
The last block number to check for transfers (inclusive). If omitted, will default to the latest block
- pageinteger
The page number you would like returned. The page numbers start at 1 and end at totalPages. If omitted, defaults to the first page (page 1). If the page number requested is higher than totalPages, an empty assets array will be returned. If the page number requested is less than 1, an invalid params response will be returned
- perPageinteger
The maximum amount of transfers to return on each page. You can request up to 100 transfers per page. If omitted, defaults to 40 transfers per page
Returns
- objectobject
The custom response object containing token details and array of transfers, or an empty array if no transfers are found:
- addressstring
The address we checked for transfers
- ensNamestring
The ENS name associated with the address we checked
- tokenobject
An object containing information about the token with the following shape:
- addressstring
The address associated with the token
- genesisBlocknumber
The genesis block for the token
- genesisTransactionstring
The genesis transaction for the token
- namestring
The name of the token
- symbolstring
The symbol of the token
- decimalsstring
The number of decimals the token uses
- contractAddressstring
The contract address of the token
- paginatedItemsarray
An array of objects representing token transfers with the following shape:
- timestampstring
The timestamp of the transaction
- blockNumberstring
The block number within which this transfer occurred
- transactionHashstring
The token transfer transaction hash
- sentTokenContractAddressstring
The contract address of the sent token
- toAddressstring
The address for the receiver of this transfer
- receivedTokenContractAddressstring
The contract address of the received token
- fromAddressstring
The address of the sender of this transfer
- logIndexnumber
The log index for this transfer
- typestring
The type of event, i.e., 'MINT', 'SALE', 'TRANSFER'
- sentAmountstring
The sent token amount
- decimalSentAmountstring
The sent amount in decimals
- receivedAmountstring
The received token amount
- decimalReceivedAmountstring
The received amount in decimals
- pageNumberinteger
The page number of results that was returned with this response
- totalItemsinteger
The total number of results
- totalPagesinteger
The total number of results pages available
1{2"jsonrpc": "2.0",3"id": 67,4"result": {5"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",6"ensName": "vitalik.eth",7"paginatedItems": [8{9"timestamp": "2024-11-24T16:42:59.000Z",10"blockNumber": "21258873",11"transactionHash": "0xca57c78b32f9512bde35dfd1621ccd7e758b679ce0264e4d9f5494d1b09d8bce",12"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",13"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",14"receivedTokenContractAddress": null,15"fromAddress": "0xdd4c573e3b8f0b7db5a88b9b49a40105e10120e6",16"logIndex": 68,17"type": "TRANSFER",18"sentAmount": "1111000000000000000000",19"decimalSentAmount": "1111",20"receivedAmount": "0",21"decimalReceivedAmount": "0"22},23{24"timestamp": "2024-11-17T11:17:59.000Z",25"blockNumber": "21207077",26"transactionHash": "0x520bc0cecd9f028428967e39349c16a7e7ba3768517042926c26672224ee3d5f",27"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",28"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",29"receivedTokenContractAddress": null,30"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",31"logIndex": 157,32"type": "TRANSFER",33"sentAmount": "355586633038473906",34"decimalSentAmount": "0.355586633038473906",35"receivedAmount": "0",36"decimalReceivedAmount": "0"37},38{39"timestamp": "2024-11-17T11:08:23.000Z",40"blockNumber": "21207029",41"transactionHash": "0xf1d53afb9e4c3570468e72cfab93c90cd675bbe1c2a30e7c8539fd3289f3b2f9",42"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",43"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",44"receivedTokenContractAddress": null,45"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",46"logIndex": 164,47"type": "TRANSFER",48"sentAmount": "59301010914155328",49"decimalSentAmount": "0.059301010914155328",50"receivedAmount": "0",51"decimalReceivedAmount": "0"52},53{54"timestamp": "2024-11-17T11:00:11.000Z",55"blockNumber": "21206988",56"transactionHash": "0x7a9b44d0e9da74fc638c5a364801a854093b9bf6765e0e6d69b4eb062868e176",57"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",58"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",59"receivedTokenContractAddress": null,60"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",61"logIndex": 411,62"type": "TRANSFER",63"sentAmount": "1233878940411409023",64"decimalSentAmount": "1.233878940411409023",65"receivedAmount": "0",66"decimalReceivedAmount": "0"67},68{69"timestamp": "2024-11-17T10:54:23.000Z",70"blockNumber": "21206959",71"transactionHash": "0x1107bec3c2db1f2135a73ef644e770227a7da4a0792832b52d1e97fabf705238",72"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",73"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",74"receivedTokenContractAddress": null,75"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",76"logIndex": 313,77"type": "TRANSFER",78"sentAmount": "299099136108710103",79"decimalSentAmount": "0.299099136108710103",80"receivedAmount": "0",81"decimalReceivedAmount": "0"82},83{84"timestamp": "2024-11-17T03:42:59.000Z",85"blockNumber": "21204813",86"transactionHash": "0x06313ccaf1928b4aaff4cde80d154d0ea1a296fb9d102fec329bda5d23389b49",87"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",88"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",89"receivedTokenContractAddress": null,90"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",91"logIndex": 225,92"type": "TRANSFER",93"sentAmount": "2990999973161757",94"decimalSentAmount": "0.002990999973161757",95"receivedAmount": "0",96"decimalReceivedAmount": "0"97},98{99"timestamp": "2024-03-18T21:07:47.000Z",100"blockNumber": "19464244",101"transactionHash": "0x42476f2d6e533200e24c2b3a7a3baec149d2147e03e9be45b4ce03159bf7e919",102"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",103"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",104"receivedTokenContractAddress": null,105"fromAddress": "0xbc3ce21e97c337c007766088465e8b6ba203d550",106"logIndex": 200,107"type": "TRANSFER",108"sentAmount": "5289872835320060000000000",109"decimalSentAmount": "5289872.83532006",110"receivedAmount": "0",111"decimalReceivedAmount": "0"112},113{114"timestamp": "2024-01-16T21:07:11.000Z",115"blockNumber": "19022031",116"transactionHash": "0x7ff66afcb0ad08cd4b5d52142ba82bafa776d911b50b3ec5dffbd5f3de422992",117"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",118"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",119"receivedTokenContractAddress": null,120"fromAddress": "0x4293e4e33767c7cca80b7557c71e0420b8a197ec",121"logIndex": 168,122"type": "TRANSFER",123"sentAmount": "100000000000000000000000",124"decimalSentAmount": "100000",125"receivedAmount": "0",126"decimalReceivedAmount": "0"127},128{129"timestamp": "2022-11-30T04:47:47.000Z",130"blockNumber": "16080515",131"transactionHash": "0xe3a7b7b1169a1193400b1afb17b45e9f85679c0fdb2ad7c8b55918167aaabd1c",132"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",133"toAddress": "0x2234b808ec694608470259f72b5e32104a77078d",134"receivedTokenContractAddress": null,135"fromAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",136"logIndex": 228,137"type": "TRANSFER",138"sentAmount": "0",139"decimalSentAmount": "0",140"receivedAmount": "0",141"decimalReceivedAmount": "0"142},143{144"timestamp": "2021-12-11T12:15:03.000Z",145"blockNumber": "13783791",146"transactionHash": "0x5e0e2f294a3fb39bfc392417acaf0de7729bd7825f6b048ef6cef9006d59e49c",147"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",148"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",149"receivedTokenContractAddress": null,150"fromAddress": "0x36c1625e5ee6fbfa9fadd4f75790275e5eab7107",151"logIndex": 310,152"type": "TRANSFER",153"sentAmount": "15418468200123",154"decimalSentAmount": "0.000015418468200123",155"receivedAmount": "0",156"decimalReceivedAmount": "0"157}158],159"token": {160"address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",161"genesisBlock": "10569013",162"genesisTransaction": "0x0a4022e61c49c59b2538b78a6c7c9a0e4bb8c8fce2d1b4a725baef3c55fb7363",163"name": "SHIBA INU",164"symbol": "SHIB",165"decimals": "18",166"contractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce"167},168"totalPages": 2,169"totalItems": 11,170"pageNumber": 1171}172}
1{2"jsonrpc": "2.0",3"id": 67,4"result": {5"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",6"ensName": "vitalik.eth",7"paginatedItems": [8{9"timestamp": "2024-11-24T16:42:59.000Z",10"blockNumber": "21258873",11"transactionHash": "0xca57c78b32f9512bde35dfd1621ccd7e758b679ce0264e4d9f5494d1b09d8bce",12"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",13"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",14"receivedTokenContractAddress": null,15"fromAddress": "0xdd4c573e3b8f0b7db5a88b9b49a40105e10120e6",16"logIndex": 68,17"type": "TRANSFER",18"sentAmount": "1111000000000000000000",19"decimalSentAmount": "1111",20"receivedAmount": "0",21"decimalReceivedAmount": "0"22},23{24"timestamp": "2024-11-17T11:17:59.000Z",25"blockNumber": "21207077",26"transactionHash": "0x520bc0cecd9f028428967e39349c16a7e7ba3768517042926c26672224ee3d5f",27"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",28"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",29"receivedTokenContractAddress": null,30"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",31"logIndex": 157,32"type": "TRANSFER",33"sentAmount": "355586633038473906",34"decimalSentAmount": "0.355586633038473906",35"receivedAmount": "0",36"decimalReceivedAmount": "0"37},38{39"timestamp": "2024-11-17T11:08:23.000Z",40"blockNumber": "21207029",41"transactionHash": "0xf1d53afb9e4c3570468e72cfab93c90cd675bbe1c2a30e7c8539fd3289f3b2f9",42"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",43"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",44"receivedTokenContractAddress": null,45"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",46"logIndex": 164,47"type": "TRANSFER",48"sentAmount": "59301010914155328",49"decimalSentAmount": "0.059301010914155328",50"receivedAmount": "0",51"decimalReceivedAmount": "0"52},53{54"timestamp": "2024-11-17T11:00:11.000Z",55"blockNumber": "21206988",56"transactionHash": "0x7a9b44d0e9da74fc638c5a364801a854093b9bf6765e0e6d69b4eb062868e176",57"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",58"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",59"receivedTokenContractAddress": null,60"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",61"logIndex": 411,62"type": "TRANSFER",63"sentAmount": "1233878940411409023",64"decimalSentAmount": "1.233878940411409023",65"receivedAmount": "0",66"decimalReceivedAmount": "0"67},68{69"timestamp": "2024-11-17T10:54:23.000Z",70"blockNumber": "21206959",71"transactionHash": "0x1107bec3c2db1f2135a73ef644e770227a7da4a0792832b52d1e97fabf705238",72"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",73"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",74"receivedTokenContractAddress": null,75"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",76"logIndex": 313,77"type": "TRANSFER",78"sentAmount": "299099136108710103",79"decimalSentAmount": "0.299099136108710103",80"receivedAmount": "0",81"decimalReceivedAmount": "0"82},83{84"timestamp": "2024-11-17T03:42:59.000Z",85"blockNumber": "21204813",86"transactionHash": "0x06313ccaf1928b4aaff4cde80d154d0ea1a296fb9d102fec329bda5d23389b49",87"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",88"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",89"receivedTokenContractAddress": null,90"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",91"logIndex": 225,92"type": "TRANSFER",93"sentAmount": "2990999973161757",94"decimalSentAmount": "0.002990999973161757",95"receivedAmount": "0",96"decimalReceivedAmount": "0"97},98{99"timestamp": "2024-03-18T21:07:47.000Z",100"blockNumber": "19464244",101"transactionHash": "0x42476f2d6e533200e24c2b3a7a3baec149d2147e03e9be45b4ce03159bf7e919",102"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",103"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",104"receivedTokenContractAddress": null,105"fromAddress": "0xbc3ce21e97c337c007766088465e8b6ba203d550",106"logIndex": 200,107"type": "TRANSFER",108"sentAmount": "5289872835320060000000000",109"decimalSentAmount": "5289872.83532006",110"receivedAmount": "0",111"decimalReceivedAmount": "0"112},113{114"timestamp": "2024-01-16T21:07:11.000Z",115"blockNumber": "19022031",116"transactionHash": "0x7ff66afcb0ad08cd4b5d52142ba82bafa776d911b50b3ec5dffbd5f3de422992",117"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",118"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",119"receivedTokenContractAddress": null,120"fromAddress": "0x4293e4e33767c7cca80b7557c71e0420b8a197ec",121"logIndex": 168,122"type": "TRANSFER",123"sentAmount": "100000000000000000000000",124"decimalSentAmount": "100000",125"receivedAmount": "0",126"decimalReceivedAmount": "0"127},128{129"timestamp": "2022-11-30T04:47:47.000Z",130"blockNumber": "16080515",131"transactionHash": "0xe3a7b7b1169a1193400b1afb17b45e9f85679c0fdb2ad7c8b55918167aaabd1c",132"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",133"toAddress": "0x2234b808ec694608470259f72b5e32104a77078d",134"receivedTokenContractAddress": null,135"fromAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",136"logIndex": 228,137"type": "TRANSFER",138"sentAmount": "0",139"decimalSentAmount": "0",140"receivedAmount": "0",141"decimalReceivedAmount": "0"142},143{144"timestamp": "2021-12-11T12:15:03.000Z",145"blockNumber": "13783791",146"transactionHash": "0x5e0e2f294a3fb39bfc392417acaf0de7729bd7825f6b048ef6cef9006d59e49c",147"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",148"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",149"receivedTokenContractAddress": null,150"fromAddress": "0x36c1625e5ee6fbfa9fadd4f75790275e5eab7107",151"logIndex": 310,152"type": "TRANSFER",153"sentAmount": "15418468200123",154"decimalSentAmount": "0.000015418468200123",155"receivedAmount": "0",156"decimalReceivedAmount": "0"157}158],159"token": {160"address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",161"genesisBlock": "10569013",162"genesisTransaction": "0x0a4022e61c49c59b2538b78a6c7c9a0e4bb8c8fce2d1b4a725baef3c55fb7363",163"name": "SHIBA INU",164"symbol": "SHIB",165"decimals": "18",166"contractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce"167},168"totalPages": 2,169"totalItems": 11,170"pageNumber": 1171}172}