Path Parameters

walletAddress

string

REQUIRED

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

Query Parameters

testnets

boolean

When set to true, the API includes data from testnet networks in the response. If omitted or set to false, only data from mainnet networks will be included

Returns

data

object

The data object which contains the following fields:

updated_at

string

A timestamp indicating when the data was last updated

address

string

The wallet address queried

items

array

An array of items representing activity on different chains

name

string

The short name of the chain

chain_id

string

The unique identifier for the chain

is_testnet

boolean

Indicates whether the chain is a testnet

db_schema_name

string

The database schema name corresponding to the chain

label

string

The display name of the chain

category_label

string

The category or ecosystem the chain belongs to

priority_label

string

The priority level of the chain

logo_url

string

URL pointing to the chain's default logo

black_logo_url

string

URL pointing to the chain's black-themed logo

white_logo_url

string

URL pointing to the chain's white-themed logo

color_theme

object

The color_theme object which contains the following fields:

red

integer

The red component of the color

green

integer

The green component of the color

blue

integer

The blue component of the color

alpha

integer

The alpha (opacity) value

hex

string

The hexadecimal representation of the color

css_rgb

string

The CSS rgb() representation of the color

is_appchain

boolean

Indicates whether the chain is an app-specific chain

appchain_of

string

Specifies which chain the appchain belongs to, or null if not an appchain

last_seen_at

string

A timestamp indicating the last time the chain's data was updated or accessed

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 -X GET "https://api.covalenthq.com/v1/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/activity/?testnets=false" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json" \
4
  -H "Authorization: Bearer YOUR_API_KEY"

1
curl -X GET "https://api.covalenthq.com/v1/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/activity/?testnets=false" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json" \
4
  -H "Authorization: Bearer YOUR_API_KEY"

1
async function main() {
2
    const response = await fetch('https://api.covalenthq.com/v1/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/activity/?testnets=false', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json', "Authorization": "Bearer YOUR_API_KEY"}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
async function main() {
2
    const response = await fetch('https://api.covalenthq.com/v1/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/activity/?testnets=false', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json', "Authorization": "Bearer YOUR_API_KEY"}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
import requests
2
import json
3

4
url = "https://api.covalenthq.com/v1/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/activity/?testnets=False"
5

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

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

14
print(response.text)

1
import requests
2
import json
3

4
url = "https://api.covalenthq.com/v1/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/activity/?testnets=False"
5

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

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

14
print(response.text)

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

5
uri = URI("https://api.covalenthq.com/v1/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/activity/?testnets=false")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10
request["Authorization"] = "Bearer YOUR_API_KEY"
11

12
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
13
  http.request(request)
14
end
15

16
puts response.body

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

5
uri = URI("https://api.covalenthq.com/v1/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/activity/?testnets=false")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10
request["Authorization"] = "Bearer YOUR_API_KEY"
11

12
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
13
  http.request(request)
14
end
15

16
puts response.body

Response

1
{
2
  "data": {
3
    "updated_at": "2025-04-29T21:01:39.175128580Z",
4
    "address": "0x9690c8c169dd8fc15d75593048e4c453b7cc451c",
5
    "items": [
6
      {
7
        "name": "eth-mainnet",
8
        "chain_id": "1",
9
        "is_testnet": false,
10
        "db_schema_name": "chain_eth_mainnet",
11
        "label": "Ethereum Mainnet",
12
        "category_label": "Ethereum",
13
        "priority_label": "Foundational",
14
        "logo_url": "https://www.datocms-assets.com/86369/1669653891-eth.svg",
15
        "black_logo_url": "https://www.datocms-assets.com/86369/1669619544-ethereum.png",
16
        "white_logo_url": "https://www.datocms-assets.com/86369/1669619533-ethereum.png",
17
        "color_theme": {
18
          "red": 94,
19
          "green": 121,
20
          "blue": 138,
21
          "alpha": 255,
22
          "hex": "#5E798A",
23
          "css_rgb": "rgb(94 121 138)"
24
        },
25
        "is_appchain": false,
26
        "appchain_of": null,
27
        "last_seen_at": "2024-11-14T13:02:11Z"
28
      },
29
      {
30
        "name": "base-mainnet",
31
        "chain_id": "8453",
32
        "is_testnet": false,
33
        "db_schema_name": "chain_base_mainnet",
34
        "label": "Base Mainnet",
35
        "category_label": "Coinbase",
36
        "priority_label": "Foundational",
37
        "logo_url": "https://www.datocms-assets.com/86369/1677538323-property-1-base-icon-white.svg",
38
        "black_logo_url": "https://www.datocms-assets.com/86369/1677538328-property-1-base-white.png",
39
        "white_logo_url": "https://www.datocms-assets.com/86369/1677538326-base-colour.png",
40
        "color_theme": {
41
          "red": 15,
42
          "green": 91,
43
          "blue": 228,
44
          "alpha": 255,
45
          "hex": "#0F5BE4",
46
          "css_rgb": "rgb(15 91 228)"
47
        },
48
        "is_appchain": false,
49
        "appchain_of": null,
50
        "last_seen_at": "2024-11-14T13:02:49Z"
51
      }
52
    ]
53
  },
54
  "error": false,
55
  "error_message": null,
56
  "error_code": null
57
}

1
{
2
  "data": {
3
    "updated_at": "2025-04-29T21:01:39.175128580Z",
4
    "address": "0x9690c8c169dd8fc15d75593048e4c453b7cc451c",
5
    "items": [
6
      {
7
        "name": "eth-mainnet",
8
        "chain_id": "1",
9
        "is_testnet": false,
10
        "db_schema_name": "chain_eth_mainnet",
11
        "label": "Ethereum Mainnet",
12
        "category_label": "Ethereum",
13
        "priority_label": "Foundational",
14
        "logo_url": "https://www.datocms-assets.com/86369/1669653891-eth.svg",
15
        "black_logo_url": "https://www.datocms-assets.com/86369/1669619544-ethereum.png",
16
        "white_logo_url": "https://www.datocms-assets.com/86369/1669619533-ethereum.png",
17
        "color_theme": {
18
          "red": 94,
19
          "green": 121,
20
          "blue": 138,
21
          "alpha": 255,
22
          "hex": "#5E798A",
23
          "css_rgb": "rgb(94 121 138)"
24
        },
25
        "is_appchain": false,
26
        "appchain_of": null,
27
        "last_seen_at": "2024-11-14T13:02:11Z"
28
      },
29
      {
30
        "name": "base-mainnet",
31
        "chain_id": "8453",
32
        "is_testnet": false,
33
        "db_schema_name": "chain_base_mainnet",
34
        "label": "Base Mainnet",
35
        "category_label": "Coinbase",
36
        "priority_label": "Foundational",
37
        "logo_url": "https://www.datocms-assets.com/86369/1677538323-property-1-base-icon-white.svg",
38
        "black_logo_url": "https://www.datocms-assets.com/86369/1677538328-property-1-base-white.png",
39
        "white_logo_url": "https://www.datocms-assets.com/86369/1677538326-base-colour.png",
40
        "color_theme": {
41
          "red": 15,
42
          "green": 91,
43
          "blue": 228,
44
          "alpha": 255,
45
          "hex": "#0F5BE4",
46
          "css_rgb": "rgb(15 91 228)"
47
        },
48
        "is_appchain": false,
49
        "appchain_of": null,
50
        "last_seen_at": "2024-11-14T13:02:49Z"
51
      }
52
    ]
53
  },
54
  "error": false,
55
  "error_message": null,
56
  "error_code": null
57
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free