Path Parameters

chainName

string

REQUIRED

The chain name eg: eth-mainnet

walletAddress

string

REQUIRED

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

Returns

data

object

The data object which contains the following fields:

updated_at

string

The timestamp of the last update

chain_id

integer

The ID of the blockchain

chain_name

string

The name of the blockchain

address

string

The address for which data is retrieved

items

array

An array of items containing contract and spender details

contract_address

string

The contract address associated with the item

contract_address_label

string

The label for the contract address

contract_ticker_symbol

string

The ticker symbol of the contract

supports_erc

array

An array of supported ERC tokens

token_balances

array

An array of token balances

token_id

string

The ID of the token

token_balance

string

The balance of the token

spenders

array

An array of spender details

block_height

integer

The block height at which the spender event occurred

tx_offset

integer

The transaction offset within the block

log_offset

integer

The log offset within the transaction

block_signed_at

string

The timestamp when the block was signed

tx_hash

string

The transaction hash associated with the spender

spender_address

string

The address of the spender

spender_address_label

string

The label for the spender address

token_ids_approved

string

The IDs of tokens approved for the spender

allowance

string

The allowance granted to the spender

Request

1
curl -X GET "https://api.covalenthq.com/v1/eth-mainnet/nft/approvals/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/" \
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/eth-mainnet/nft/approvals/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/" \
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/eth-mainnet/nft/approvals/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/', {
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/eth-mainnet/nft/approvals/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/', {
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/eth-mainnet/nft/approvals/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/"
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/eth-mainnet/nft/approvals/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/"
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/eth-mainnet/nft/approvals/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/")
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/eth-mainnet/nft/approvals/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/")
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-30T12:45:23Z",
4
    "chain_id": 1,
5
    "chain_name": "eth-mainnet",
6
    "address": "0x8526E4F21d060Ef0EF2e69D2a00392e82eeFa63D",
7
    "items": [
8
      {
9
        "contract_address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
10
        "contract_address_label": "Bored Ape Yacht Club",
11
        "contract_ticker_symbol": "BAYC",
12
        "supports_erc": [
13
          "ERC721"
14
        ],
15
        "token_balances": [
16
          {
17
            "token_id": "8765",
18
            "token_balance": "1"
19
          },
20
          {
21
            "token_id": "5432",
22
            "token_balance": "1"
23
          }
24
        ],
25
        "spenders": [
26
          {
27
            "block_height": 18598765,
28
            "tx_offset": 87,
29
            "log_offset": 103,
30
            "block_signed_at": "2025-04-01T10:23:45Z",
31
            "tx_hash": "0x9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b",
32
            "spender_address": "0x00000000006c3852cbEf3e08E8dF289169EdE581",
33
            "spender_address_label": "OpenSea: Seaport 1.1",
34
            "token_ids_approved": "*",
35
            "allowance": "true"
36
          }
37
        ]
38
      },
39
      {
40
        "contract_address": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
41
        "contract_address_label": "Mutant Ape Yacht Club",
42
        "contract_ticker_symbol": "MAYC",
43
        "supports_erc": [
44
          "ERC721"
45
        ],
46
        "token_balances": [
47
          {
48
            "token_id": "12345",
49
            "token_balance": "1"
50
          }
51
        ],
52
        "spenders": [
53
          {
54
            "block_height": 18612345,
55
            "tx_offset": 34,
56
            "log_offset": 56,
57
            "block_signed_at": "2025-04-05T15:34:21Z",
58
            "tx_hash": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b",
59
            "spender_address": "0x74b3bC5665ED03D0298c3D8Df63D0ed8A3D091F0",
60
            "spender_address_label": "LooksRare: Transfer Manager",
61
            "token_ids_approved": "12345",
62
            "allowance": "true"
63
          }
64
        ]
65
      }
66
    ]
67
  },
68
  "error": false,
69
  "error_message": null,
70
  "error_code": null
71
}

1
{
2
  "data": {
3
    "updated_at": "2025-04-30T12:45:23Z",
4
    "chain_id": 1,
5
    "chain_name": "eth-mainnet",
6
    "address": "0x8526E4F21d060Ef0EF2e69D2a00392e82eeFa63D",
7
    "items": [
8
      {
9
        "contract_address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
10
        "contract_address_label": "Bored Ape Yacht Club",
11
        "contract_ticker_symbol": "BAYC",
12
        "supports_erc": [
13
          "ERC721"
14
        ],
15
        "token_balances": [
16
          {
17
            "token_id": "8765",
18
            "token_balance": "1"
19
          },
20
          {
21
            "token_id": "5432",
22
            "token_balance": "1"
23
          }
24
        ],
25
        "spenders": [
26
          {
27
            "block_height": 18598765,
28
            "tx_offset": 87,
29
            "log_offset": 103,
30
            "block_signed_at": "2025-04-01T10:23:45Z",
31
            "tx_hash": "0x9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b",
32
            "spender_address": "0x00000000006c3852cbEf3e08E8dF289169EdE581",
33
            "spender_address_label": "OpenSea: Seaport 1.1",
34
            "token_ids_approved": "*",
35
            "allowance": "true"
36
          }
37
        ]
38
      },
39
      {
40
        "contract_address": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
41
        "contract_address_label": "Mutant Ape Yacht Club",
42
        "contract_ticker_symbol": "MAYC",
43
        "supports_erc": [
44
          "ERC721"
45
        ],
46
        "token_balances": [
47
          {
48
            "token_id": "12345",
49
            "token_balance": "1"
50
          }
51
        ],
52
        "spenders": [
53
          {
54
            "block_height": 18612345,
55
            "tx_offset": 34,
56
            "log_offset": 56,
57
            "block_signed_at": "2025-04-05T15:34:21Z",
58
            "tx_hash": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b",
59
            "spender_address": "0x74b3bC5665ED03D0298c3D8Df63D0ed8A3D091F0",
60
            "spender_address_label": "LooksRare: Transfer Manager",
61
            "token_ids_approved": "12345",
62
            "allowance": "true"
63
          }
64
        ]
65
      }
66
    ]
67
  },
68
  "error": false,
69
  "error_message": null,
70
  "error_code": null
71
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free