v1/{chainName}/address/{walletAddress}/transfers_v2/ REST API Endpoint - GoldRush Wallet API

Path Parameters

chainName

string

REQUIRED

walletAddress

string

REQUIRED

Query Parameters

quote-currency

string

contract-address

string

starting-block

integer

ending-block

integer

page-size

integer

page-number

integer

Returns

data

object

address

string

updated_at

string

quote_currency

string

chain_id

integer

chain_name

string

items

array

block_signed_at

string

block_height

integer

block_hash

string

tx_hash

string

tx_offset

integer

successful

boolean

miner_address

string

from_address

string

from_address_label

string

to_address

string

to_address_label

string

value

string

value_quote

integer

pretty_value_quote

string

gas_metadata

object

contract_decimals

integer

contract_name

string

contract_ticker_symbol

string

contract_address

string

supports_erc

array

logo_url

string

gas_offered

integer

gas_spent

integer

gas_price

integer

fees_paid

string

gas_quote

integer

pretty_gas_quote

string

gas_quote_rate

integer

transfers

array

block_signed_at

string

tx_hash

string

from_address

string

to_address

string

delta

string

pagination

object

has_more

boolean

page_number

integer

page_size

integer

total_count

integer

error

boolean

error_message

string

error_code

string

Request

1
curl --location 'https://api.covalenthq.com/v1/eth-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/transfers_v2/?contract-address=0xdAC17F958D2ee523a2206206994597C13D831ec7' \
2
--header 'Content-Type: application/json' \
3
--header 'Authorization: Bearer YOUR_API_KEY'

1
const myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
4

5
const requestOptions = {
6
  method: "GET",
7
  headers: myHeaders,
8
  redirect: "follow"
9
};
10

11
fetch("https://api.covalenthq.com/v1/eth-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/transfers_v2/?contract-address=0xdAC17F958D2ee523a2206206994597C13D831ec7", requestOptions)
12
  .then((response) => response.text())
13
  .then((result) => console.log(result))
14
  .catch((error) => console.error(error));

1
import requests
2
import json
3

4
url = "https://api.covalenthq.com/v1/eth-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/transfers_v2/?contract-address=0xdAC17F958D2ee523a2206206994597C13D831ec7"
5

6
payload = {}
7
headers = {
8
  'Content-Type': 'application/json',
9
  'Authorization': 'Bearer YOUR_API_KEY'
10
}
11

12
response = requests.request("GET", url, headers=headers, data=payload)
13

14
print(response.text)
15

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://api.covalenthq.com/v1/eth-mainnet/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/transfers_v2/?contract-address=0xdAC17F958D2ee523a2206206994597C13D831ec7")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Get.new(url)
11
request["Content-Type"] = "application/json"
12
request["Authorization"] = "Bearer YOUR_API_KEY"
13

14
response = https.request(request)
15
puts response.read_body
16

Response

1
{
2
  "data": {
3
    "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
4
    "updated_at": "2025-04-29T15:30:45Z",
5
    "quote_currency": "USD",
6
    "chain_id": 1,
7
    "chain_name": "eth-mainnet",
8
    "items": [
9
      {
10
        "block_signed_at": "2025-04-29T15:25:12Z",
11
        "block_height": 19875510,
12
        "block_hash": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b",
13
        "tx_hash": "0x7c21e95d4a498a168bb7f3c8b13bfa2cbc7056c17e48a1a3c7c55301bb87ba5d",
14
        "tx_offset": 7,
15
        "successful": true,
16
        "miner_address": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
17
        "from_address": "0x6cc5f688a315f3dc28a7781717a9a798a59fda7b",
18
        "from_address_label": null,
19
        "to_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
20
        "to_address_label": "Tether USD",
21
        "value": "0",
22
        "value_quote": 0,
23
        "pretty_value_quote": "$0.00",
24
        "gas_metadata": {
25
          "contract_decimals": 18,
26
          "contract_name": "Ethereum",
27
          "contract_ticker_symbol": "ETH",
28
          "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
29
          "supports_erc": [
30
            "ERC20"
31
          ],
32
          "logo_url": "https://assets.coingecko.com/coins/images/279/small/ethereum.png"
33
        },
34
        "gas_offered": 65000,
35
        "gas_spent": 42563,
36
        "gas_price": 25000000000,
37
        "fees_paid": "1064075000000000",
38
        "gas_quote": 3.72,
39
        "pretty_gas_quote": "$3.72",
40
        "gas_quote_rate": 3500,
41
        "transfers": [
42
          {
43
            "block_signed_at": "2025-04-29T15:25:12Z",
44
            "tx_hash": "0x7c21e95d4a498a168bb7f3c8b13bfa2cbc7056c17e48a1a3c7c55301bb87ba5d",
45
            "from_address": "0x6cc5f688a315f3dc28a7781717a9a798a59fda7b",
46
            "to_address": "0x8b6c8fd93d6f4cea42bbb345dbc6f0dfdb5bec73",
47
            "contract_decimals": 6,
48
            "contract_name": "Tether USD",
49
            "contract_ticker_symbol": "USDT",
50
            "contract_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
51
            "logo_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png",
52
            "transfer_type": "OUT",
53
            "delta": "-10000000000",
54
            "balance": "240000000000",
55
            "quote_rate": 1,
56
            "delta_quote": -10000,
57
            "balance_quote": 240000,
58
            "pretty_delta_quote": "-$10,000.00",
59
            "pretty_balance_quote": "$240,000.00"
60
          }
61
        ]
62
      },
63
      {
64
        "block_signed_at": "2025-04-29T14:50:23Z",
65
        "block_height": 19875490,
66
        "block_hash": "0x2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c",
67
        "tx_hash": "0x8d32f96a4c5b6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e",
68
        "tx_offset": 12,
69
        "successful": true,
70
        "miner_address": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
71
        "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
72
        "from_address_label": "Binance: Hot Wallet",
73
        "to_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
74
        "to_address_label": "Tether USD",
75
        "value": "0",
76
        "value_quote": 0,
77
        "pretty_value_quote": "$0.00",
78
        "gas_metadata": {
79
          "contract_decimals": 18,
80
          "contract_name": "Ethereum",
81
          "contract_ticker_symbol": "ETH",
82
          "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
83
          "supports_erc": [
84
            "ERC20"
85
          ],
86
          "logo_url": "https://assets.coingecko.com/coins/images/279/small/ethereum.png"
87
        },
88
        "gas_offered": 75000,
89
        "gas_spent": 52341,
90
        "gas_price": 24000000000,
91
        "fees_paid": "1256184000000000",
92
        "gas_quote": 4.4,
93
        "pretty_gas_quote": "$4.40",
94
        "gas_quote_rate": 3500,
95
        "transfers": [
96
          {
97
            "block_signed_at": "2025-04-29T14:50:23Z",
98
            "tx_hash": "0x8d32f96a4c5b6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e",
99
            "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
100
            "to_address": "0x6cc5f688a315f3dc28a7781717a9a798a59fda7b",
101
            "contract_decimals": 6,
102
            "contract_name": "Tether USD",
103
            "contract_ticker_symbol": "USDT",
104
            "contract_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
105
            "logo_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png",
106
            "transfer_type": "IN",
107
            "delta": "250000000000",
108
            "balance": "250000000000",
109
            "quote_rate": 1,
110
            "delta_quote": 250000,
111
            "balance_quote": 250000,
112
            "pretty_delta_quote": "$250,000.00",
113
            "pretty_balance_quote": "$250,000.00"
114
          }
115
        ]
116
      }
117
    ],
118
    "pagination": {
119
      "has_more": true,
120
      "page_number": 0,
121
      "page_size": 100,
122
      "total_count": 12845
123
    }
124
  },
125
  "error": false,
126
  "error_message": null,
127
  "error_code": null
128
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free

v1/{chainName}/address/{walletAddress}/transfers_v2/ REST API Endpoint - GoldRush Wallet API

Loading...

Path Parameters

Query Parameters

Returns