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.
Copy link