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

Path Parameters

chainName

string

REQUIRED

Loading...

walletAddress

string

REQUIRED

Loading...

Query Parameters

quote-currency

string

Loading...

days

integer

Loading...

Returns

data

object

Loading...

address

string

Loading...

updated_at

string

Loading...

quote_currency

string

Loading...

chain_id

integer

Loading...

chain_name

string

Loading...

items

array

Loading...

contract_address

string

Loading...

contract_decimals

integer

Loading...

contract_name

string

Loading...

contract_ticker_symbol

string

Loading...

logo_url

string

Loading...

holdings

array

Loading...

quote_rate

integer

Loading...

timestamp

string

Loading...

close

object

Loading...

balance

string

Loading...

quote

integer

Loading...

pretty_quote

string

Loading...

high

object

Loading...

low

object

Loading...

open

object

Loading...

pagination

object

Loading...

has_more

boolean

Loading...

page_number

integer

Loading...

page_size

integer

Loading...

total_count

integer

Loading...

error

boolean

Loading...

error_message

string

Loading...

error_code

string

Loading...

Request

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

1
curl --location 'https://api.covalenthq.com/v1/eth-mainnet/address/0x00000000219ab540356cbb839cbe05303d7705fa/portfolio_v2/' \
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/0x00000000219ab540356cbb839cbe05303d7705fa/portfolio_v2/", requestOptions)
12
  .then((response) => response.text())
13
  .then((result) => console.log(result))
14
  .catch((error) => console.error(error));

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/0x00000000219ab540356cbb839cbe05303d7705fa/portfolio_v2/", 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/0x00000000219ab540356cbb839cbe05303d7705fa/portfolio_v2/"
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
import requests
2
import json
3

4
url = "https://api.covalenthq.com/v1/eth-mainnet/address/0x00000000219ab540356cbb839cbe05303d7705fa/portfolio_v2/"
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/0x00000000219ab540356cbb839cbe05303d7705fa/portfolio_v2/")
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

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

5
url = URI("https://api.covalenthq.com/v1/eth-mainnet/address/0x00000000219ab540356cbb839cbe05303d7705fa/portfolio_v2/")
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": "0x00000000219ab540356cbb839cbe05303d7705fa",
4
    "updated_at": "2025-04-29T10:15:30Z",
5
    "quote_currency": "USD",
6
    "chain_id": 1,
7
    "chain_name": "eth-mainnet",
8
    "items": [
9
      {
10
        "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
11
        "contract_decimals": 18,
12
        "contract_name": "Wrapped Ether",
13
        "contract_ticker_symbol": "WETH",
14
        "logo_url": "https://www.covalenthq.com/static/images/icons/weth.png",
15
        "holdings": [
16
          {
17
            "quote_rate": 3500,
18
            "timestamp": "2025-04-29T00:00:00Z",
19
            "close": {
20
              "balance": "2.5",
21
              "quote": 8750,
22
              "pretty_quote": "$8,750.00"
23
            },
24
            "high": {},
25
            "low": {},
26
            "open": {}
27
          },
28
          {
29
            "quote_rate": 3450,
30
            "timestamp": "2025-04-28T00:00:00Z",
31
            "close": {
32
              "balance": "2.5",
33
              "quote": 8625,
34
              "pretty_quote": "$8,625.00"
35
            },
36
            "high": {},
37
            "low": {},
38
            "open": {}
39
          }
40
        ]
41
      },
42
      {
43
        "contract_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
44
        "contract_decimals": 6,
45
        "contract_name": "Tether USD",
46
        "contract_ticker_symbol": "USDT",
47
        "logo_url": "https://www.covalenthq.com/static/images/icons/usdt.png",
48
        "holdings": [
49
          {
50
            "quote_rate": 1,
51
            "timestamp": "2025-04-29T00:00:00Z",
52
            "close": {
53
              "balance": "5000",
54
              "quote": 5000,
55
              "pretty_quote": "$5,000.00"
56
            },
57
            "high": {},
58
            "low": {},
59
            "open": {}
60
          },
61
          {
62
            "quote_rate": 1,
63
            "timestamp": "2025-04-28T00:00:00Z",
64
            "close": {
65
              "balance": "5000",
66
              "quote": 5000,
67
              "pretty_quote": "$5,000.00"
68
            },
69
            "high": {},
70
            "low": {},
71
            "open": {}
72
          }
73
        ]
74
      }
75
    ],
76
    "pagination": {
77
      "has_more": false,
78
      "page_number": 1,
79
      "page_size": 100,
80
      "total_count": 2
81
    }
82
  },
83
  "error": false,
84
  "error_message": null,
85
  "error_code": null
86
}

1
{
2
  "data": {
3
    "address": "0x00000000219ab540356cbb839cbe05303d7705fa",
4
    "updated_at": "2025-04-29T10:15:30Z",
5
    "quote_currency": "USD",
6
    "chain_id": 1,
7
    "chain_name": "eth-mainnet",
8
    "items": [
9
      {
10
        "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
11
        "contract_decimals": 18,
12
        "contract_name": "Wrapped Ether",
13
        "contract_ticker_symbol": "WETH",
14
        "logo_url": "https://www.covalenthq.com/static/images/icons/weth.png",
15
        "holdings": [
16
          {
17
            "quote_rate": 3500,
18
            "timestamp": "2025-04-29T00:00:00Z",
19
            "close": {
20
              "balance": "2.5",
21
              "quote": 8750,
22
              "pretty_quote": "$8,750.00"
23
            },
24
            "high": {},
25
            "low": {},
26
            "open": {}
27
          },
28
          {
29
            "quote_rate": 3450,
30
            "timestamp": "2025-04-28T00:00:00Z",
31
            "close": {
32
              "balance": "2.5",
33
              "quote": 8625,
34
              "pretty_quote": "$8,625.00"
35
            },
36
            "high": {},
37
            "low": {},
38
            "open": {}
39
          }
40
        ]
41
      },
42
      {
43
        "contract_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
44
        "contract_decimals": 6,
45
        "contract_name": "Tether USD",
46
        "contract_ticker_symbol": "USDT",
47
        "logo_url": "https://www.covalenthq.com/static/images/icons/usdt.png",
48
        "holdings": [
49
          {
50
            "quote_rate": 1,
51
            "timestamp": "2025-04-29T00:00:00Z",
52
            "close": {
53
              "balance": "5000",
54
              "quote": 5000,
55
              "pretty_quote": "$5,000.00"
56
            },
57
            "high": {},
58
            "low": {},
59
            "open": {}
60
          },
61
          {
62
            "quote_rate": 1,
63
            "timestamp": "2025-04-28T00:00:00Z",
64
            "close": {
65
              "balance": "5000",
66
              "quote": 5000,
67
              "pretty_quote": "$5,000.00"
68
            },
69
            "high": {},
70
            "low": {},
71
            "open": {}
72
          }
73
        ]
74
      }
75
    ],
76
    "pagination": {
77
      "has_more": false,
78
      "page_number": 1,
79
      "page_size": 100,
80
      "total_count": 2
81
    }
82
  },
83
  "error": false,
84
  "error_message": null,
85
  "error_code": null
86
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free