How can i get transfers using watch_getTransfersByAddress?

We at WatchData πŸ‘€ can give you the ability to simplify this approach and get this data in 1 API call you only need to know the address you want to track. With our data you can create many different services, such as your monitoring service (pictured below):

Let’s now look at an example of how it all works.

Open the API client, we processed the request through Postman. If you’re having trouble, check out our Quick start guide on how to get started with our API.

Request:

{
    "id": 1,
    "method": "watch_getTransfersByAddress",
    "jsonrpc": "2.0",
    "params": [
        {
            "addresses": "0xc7d15E3aE9442baD3E0B3689b835fDd035479B52",
            "transferDirection": "to",
            "fromBlock": 1,
            "offset": 0,
            "limit": 100
        }
    ]
}
  • For example you want to monitor your address for sending transactions . Suppose it is 0xc7d15E3aE9442baD3E0B3689b835fDd035479B52.

  • To get the transfers that were received at the specified address, add the parameter: β€œtransferDirection": "to", and to get the transfers that were sent from this address, add the parameter "transferDirection": "from".

By the way, in the β€œaddresses" parameter you can use several address values to get more information in one query, for example "addresses": ["0xc7d15E3aE9442baD3E0B3689b835fDd035479B52","0x6aE6d807E57964D5DaC79CF07D43AA0B458CB0dB"],

Now we make 1 request to the API and get information on all transfers of a given address.

Let’s find out what we get in response.

Response:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": [
        {
            "blockNumber": 12591647,
            "blockTimestamp": "2021-06-08T04:07:30",
            "transactionHash": "0x00ad22de60c19215fdb5f789d8848ac2ded1901c53993aa6f5499b2fcb5bbdd0",
            "transactionIndex": 25,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 100055406833350373,
            "fee": 21000000000000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 12664741,
            "blockTimestamp": "2021-06-19T12:13:15",
            "transactionHash": "0x1edae51265579268cb7ecedfdb554035d2111a5ce0e649783c7b1bacac0b493e",
            "transactionIndex": 19,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 100050819506085117,
            "fee": 21000000000000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 12731449,
            "blockTimestamp": "2021-06-29T21:56:32",
            "transactionHash": "0x474688e3368506c1ad881925b5ae4d9037df04f617a72a4ee75aecb84c58e8c2",
            "transactionIndex": 115,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 100022202551483258,
            "fee": 21000000000000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 12787576,
            "blockTimestamp": "2021-07-08T15:46:11",
            "transactionHash": "0xca1f7dd68737465c2308ea67f0c412927aa1ab429e245a3c4a08c47d35a40261",
            "transactionIndex": 111,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 100064203282927934,
            "fee": 21000000000000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 12852233,
            "blockTimestamp": "2021-07-18T18:35:14",
            "transactionHash": "0xd879dffe40a6ceb36e647058a1278b81f4a9ca739f368b33591770088150091b",
            "transactionIndex": 137,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 100040965764744213,
            "fee": 21000000000000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 12934040,
            "blockTimestamp": "2021-07-31T15:09:28",
            "transactionHash": "0xd32e4a3460b3e1b2eaf21589e42410cb9ec3c7aabc3a137be864019a5e31318c",
            "transactionIndex": 150,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 100052699164834856,
            "fee": 21000000000000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13032339,
            "blockTimestamp": "2021-08-15T21:56:25",
            "transactionHash": "0xd2d650b368dfdf96365b3f9efaca167e05410f81e26be72599f331aae4fefdd8",
            "transactionIndex": 98,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 99527456709614532,
            "fee": 867817198164000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13174050,
            "blockTimestamp": "2021-09-06T19:22:09",
            "transactionHash": "0x114bd7003fda3b8d833fdffbc055e5ca3c00f875a4819846bb9ddfa835b54142",
            "transactionIndex": 42,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 145864161609975783,
            "fee": 2214117747702000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13219941,
            "blockTimestamp": "2021-09-13T21:57:15",
            "transactionHash": "0x0ebddecba880d82061bf2ced42b1f4c61d65c50c740adb923b5b2c1bff91ea30",
            "transactionIndex": 2,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 49050023759201803,
            "fee": 889011460554000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13279919,
            "blockTimestamp": "2021-09-23T04:47:37",
            "transactionHash": "0xe3812e59f2d7d37ec293a45b112812c23d57e96643c0947cb292551c42500a97",
            "transactionIndex": 61,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 48783631668947601,
            "fee": 1426795435821000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13334797,
            "blockTimestamp": "2021-10-01T17:22:43",
            "transactionHash": "0x0bc231023afa5d8bd9a39f537978948efa879c33039bb8e903f48d0a0fd4f6d3",
            "transactionIndex": 32,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 48086604947893201,
            "fee": 2267402002131000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13397112,
            "blockTimestamp": "2021-10-11T11:49:11",
            "transactionHash": "0xeec4a3b9f81d29d8bc92cbd1cdc6f59199c59b37215d16c5fdb0e2fa7394c31c",
            "transactionIndex": 33,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 48122650617617135,
            "fee": 1577784126975000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13447735,
            "blockTimestamp": "2021-10-19T10:42:09",
            "transactionHash": "0x1e74549d45697d90214853c4f71d9680cb78d0e2c274bdbcb8a2b86601df336d",
            "transactionIndex": 33,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 48906535879973071,
            "fee": 969342959592000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13513768,
            "blockTimestamp": "2021-10-29T18:54:52",
            "transactionHash": "0x1ef83e2aa8ac65af7f57f606be4b211da1814f25939745345a1f0c0b17a174a2",
            "transactionIndex": 27,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 46915559589268410,
            "fee": 3192511164801000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13571787,
            "blockTimestamp": "2021-11-07T21:18:22",
            "transactionHash": "0x97395d427651f3bdbf36924b636c0e004ce69a77cae6ce591ca71c2784707941",
            "transactionIndex": 18,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 47332341526035279,
            "fee": 2436568481403000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13668140,
            "blockTimestamp": "2021-11-23T02:08:45",
            "transactionHash": "0xf263641c4a1d5b2e66b759a7ebb323d03e82b1a3a6d3bdb0487fc1b33f3ac500",
            "transactionIndex": 6,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 47048587626919036,
            "fee": 3144959835906000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13762081,
            "blockTimestamp": "2021-12-08T01:59:57",
            "transactionHash": "0xb5a308b5e45ad03dac847bd6463302a1b20a1df3b9d44c8cb724551ce1e28973",
            "transactionIndex": 79,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 48449200355182063,
            "fee": 1758319003665000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13828638,
            "blockTimestamp": "2021-12-18T10:37:35",
            "transactionHash": "0xf9e21d4573922f487c67bf78d2aa29a1b019965c37392c188f074f3f8c8ab8b4",
            "transactionIndex": 14,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 49182814205428422,
            "fee": 917314911219000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 13905165,
            "blockTimestamp": "2021-12-30T06:43:50",
            "transactionHash": "0xf721782ef5ef25d6d41464b82e4def2db6526db05f87cd825b195d4f6e87eab6",
            "transactionIndex": 260,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 47689737215736311,
            "fee": 2311304183496000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 14005398,
            "blockTimestamp": "2022-01-14T19:05:07",
            "transactionHash": "0xa4454c91319d0997fcb434405c92f264ead967d955a80005f607b8c810984c11",
            "transactionIndex": 6,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 46390728299654410,
            "fee": 3585806828163000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 14089525,
            "blockTimestamp": "2022-01-27T19:13:55",
            "transactionHash": "0xb13279284c30d8b87b590a22398021a893785f061ee90f39eea4e26b7fb884ec",
            "transactionIndex": 32,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 46988581114812943,
            "fee": 3405636426696000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 14279332,
            "blockTimestamp": "2022-02-26T03:40:15",
            "transactionHash": "0xcfe91240bc1cb6769a5ce33ede3abd7d58484fe723a56a7137b2462ee9928eb4",
            "transactionIndex": 6,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 98831624961049017,
            "fee": 1149781134999000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 14358742,
            "blockTimestamp": "2022-03-10T11:12:40",
            "transactionHash": "0x1008c9f15715ec06d4c7c3e3dcecbd434d858e6107c2b117ab24d9e88d7282e8",
            "transactionIndex": 59,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 35032399349924011,
            "fee": 549650733261000,
            "asset": "ETH",
            "decimals": 18
        },
        {
            "blockNumber": 14557431,
            "blockTimestamp": "2022-04-10T10:28:39",
            "transactionHash": "0x72aef05a416cd49c42f948d72af1297178e943bcd88339c3110dbef3d6152d4c",
            "transactionIndex": 96,
            "logIndex": null,
            "contractAddress": null,
            "transferType": "trx",
            "from": "0x00192fb10df37c9fb26829eb2cc623cd1bf599e8",
            "to": "0xc7d15e3ae9442bad3e0b3689b835fdd035479b52",
            "value": 95616800000000000,
            "fee": 435049309065000,
            "asset": "ETH",
            "decimals": 18
        }
    ]
}

We obtained a dataset that transmits information on transfers.

From these values, we can determine that the:

  • transferType "trx" - is the native ETH token transfer.

  • Value - parameter gives the value with the uint256 format.

To convert this value into a usable format, we need to divide it by 10¹⁸, because the decimals parameter at ETH = 18.

For different tokens there is a different decimals parameter be careful!

After processing the entire data set, we were able to get transfers that came and went from the address we specified. We have shown you just one example of how you can interact with a watch_getTransfersByAddress endpoint, try it yourself.

Last updated