Path Parameters

chainName

string

REQUIRED

The chain name eg: base-mainnet

walletAddress

string

REQUIRED

The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically

Query Parameters

quote-currency

string

The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP

days

integer

The number of days to return data for. Defaults to 30 days

Returns

data

object

The response data containing following fields:

address

string

The blockchain address for which data is retrieved

updated_at

string

The timestamp when the data was last updated

quote_currency

string

The currency used for quote values

chain_id

integer

The ID of the blockchain network

chain_name

string

The name of the blockchain network

items

array

An array of token balances and their historical holdings

contract_address

string

The address of the token contract

contract_decimals

integer

The number of decimals used by the token contract

contract_name

string

The name of the token contract

contract_ticker_symbol

string

The ticker symbol of the token contract

logo_url

string

The URL of the token's logo

holdings

array

An array of historical holdings data

quote_rate

integer

The current quote rate for the token in the specified currency

timestamp

string

The timestamp of the holding record

close

object

The closing balance and quote value for the token

balance

string

The closing balance of the token

quote

integer

The quote value of the token at close

pretty_quote

string

A formatted string of the quote value at close

high

object

The highest balance and quote value during the period (empty for this dataset)

low

object

The lowest balance and quote value during the period (empty for this dataset)

open

object

The opening balance and quote value during the period (empty for this dataset)

pagination

object

Pagination metadata for navigating through the data

has_more

boolean

Indicates if more pages are available

page_number

integer

The current page number

page_size

integer

The number of items per page

total_count

integer

The total number of items available

error

boolean

Indicates whether an error occurred

error_message

string

The error message if an error occurred, or null otherwise

error_code

string

The error code if an error occurred, or null otherwise

Request

1
curl --location 'https://api.covalenthq.com/v1/base-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/base-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/base-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/base-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/base-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/base-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/base-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/base-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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free