qn_fetchTagsByAddress - Ethereum RPC method documentation

Chain

qn_fetchTagsByAddress RPC Method

Tags are currently updated every 24 hours. Users can also submit requests for new labels here. We encourage existing web3 projects to contribute their own labels, enhancing our collective knowledge. Please note that this RPC method requires the EVM Labels marketplace add-on enabled on your QuickNode endpoint.

Parameters:

params - The custom array with the following fields:

address - string - The wallet address to return tags for

Returns:

status - The status of the response

data - An array of data objects, each representing a specific piece of data. In this case, each data object has two fields:

value - The tag attached to the wallet. It can be one of the following mentioned below:

Freshling - Freshling is a wallet with less than 25 transactions

Contract - A Smart Contract

ICED - Wallet has not executed a transaction in 6 months

Zombie Wallet - Wallets that have not executed a transaction in at least 1 year

Active Wallet - Performed a transaction in the past 3 months

ICED - No transactions in at least 6 months

BAYC Holder - Holds a Bored Ape Yacht Club Token in the wallet

Punks Holder - Holds a CryptoPunk Token in the wallet

MAYC Holder - Holds a Mutant Ape Yacht Club Token in the wallet

Doodles Holder - Holds a Doodles Token in the wallet

Azuki Holder - Holds a Azuki Token in the wallet

Moonbird Holder - Holds a Moonbird Token in the wallet

CloneX Holder - Holds a CloneX Token in the wallet

PROOF Holder - Holds a PROOF Token in the wallet

Autoglyphs Holder - Holds a Autoglyphs Token in the wallet

Nouns Holder - Holds a Nouns Token in the wallet

DAI/USDC - Uni V3 - A stablecoin pair on Uniswap v3

USDC/USDT - Uni V3 - A stablecoin pair on Uniswap v3

Curve 3p - A stablecoin pairing on Curve

Lido - stETH - Lido's staked ETH contract

Lido - wstETH - Lido's wrapped stake ETH contract

RPL - staked eth - RocketPool's staked ETH contract

Coinbase - wrapped staked eth - Coinbase wrapped stake ETH contract

USDC - A stablecoin token address

USDT - A stablecoin token address

DAI - A stablecoin token address

TrueUSD - A stablecoin token address

Pax Dollar - A stablecoin token address

USDD - A stablecoin token address

GUSD - A stablecoin token address

Frax - A stablecoin token address

LUSD - A stablecoin token address

sUSD - A stablecoin token address

3Pool - One of Curve's swapping pools

AAVE - One of Curve's swapping pools

ankrETH - One of Curve's swapping pools

BUSD - One of Curve's swapping pools

Compound - One of Curve's swapping pools

EURS - One of Curve's swapping pools

hBTC - One of Curve's swapping pools

IronBank - One of Curve's swapping pools

Link - One of Curve's swapping pools

PAX - One of Curve's swapping pools

renBTC - One of Curve's swapping pools

rETH - One of Curve's swapping pools

sAAVE - One of Curve's swapping pools

sBTC - One of Curve's swapping pools

sETH - One of Curve's swapping pools

stETH - One of Curve's swapping pools

TriCrypto - One of Curve's swapping pools

Y - One of Curve's swapping pools

Yv2 - One of Curve's swapping pools

Uni v3 Factory - UniSwap v3 pair creation factory. All v3 pairs are created through this

OpenSea (Legacy) - OpenSea's legacy contract. NFT Marketplace

OpenSea (Seaport 1.1) - OpenSea's legacy contract. NFT Marketplace

OpenSea (Seaport 1.4) - OpenSea's legacy contract. NFT Marketplace

Blur Contract - Blur's NFT Marketplace

USDC Blacklister - Address initiating & blacklisting wallets that are found on the USDC Blacklist

Tornado Cash 0.1E - Tornado Cash Address. Blacklisted by OFAC; caution advised

Tornado Cash 0.1WBTC - Tornado Cash Address. Blacklisted by OFAC; caution advised

Tornado Cash 1E - Tornado Cash Address. Blacklisted by OFAC; caution advised

Tornado Cash 1WBTC - Tornado Cash Address. Blacklisted by OFAC; caution advised

Tornado Cash 1WBTC - Tornado Cash Address. Blacklisted by OFAC; caution advised

Tornado Cash 1000 DAI - Tornado Cash Address. Blacklisted by OFAC; caution advised

Tornado Cash 1000 USDC - Tornado Cash Address. Blacklisted by OFAC; caution advised

Tornado Cash 10E - Tornado Cash Address. Blacklisted by OFAC; caution advised

Tornado Cash 100E - Tornado Cash Address. Blacklisted by OFAC; caution advised

Tornado Cash Proxy - Tornado Cash Address. Blacklisted by OFAC; caution advised

Tornado Cash Router - Tornado Cash Address. Blacklisted by OFAC; caution advised

MIXED - OFAC Blocklist - An address blacklisted by OFAC. Caution advised. This list can be checked at https://www.treasury.gov/ofac/downloads/sdn.csv

Binance - Binance Exchange wallets

Kraken - Kraken Exchange wallets

Kraken Hot wallet - Kraken Exchange wallets

Coinbase - Coinbase Exchange wallets

Coinbase Commerce - Coinbase Exchange wallets

USDT Blacklist - A wallet address that is on the $USDT blacklist

description - The description of the tag

Code Examples:

curl
ruby
ethers
javascript
python
web3py
eth.rb

curl http://sample-endpoint-name.network.quiknode.pro/token-goes-here/ \
  -X POST \
  -H "Content-Type: application/json" \
  -H "x-qn-api-version: 1" \
  --data '{
    "method":"qn_fetchTagsByAddress",
    "params":[
      "0x91b51c173a4bdaa1a60e234fc3f705a16d228740",
    ]
  }'

require "uri"
require "json"
require "net/http"

url = URI("http://sample-endpoint-name.network.quiknode.pro/token-goes-here/")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["x-qn-api-version"] = "1"
request.body = JSON.dump({
  "method": "qn_fetchTagsByAddress",
  "params": [
    "0x91b51c173a4bdaa1a60e234fc3f705a16d228740"
  ]
})

response = https.request(request)
puts response.read_body

const ethers = require("ethers");
(async () => {
  const provider = new ethers.providers.JsonRpcProvider("http://sample-endpoint-name.network.quiknode.pro/token-goes-here/");
  provider.connection.headers = { "x-qn-api-version": 1 };
  const heads = await provider.send("qn_fetchTagsByAddress", [
    "0x91b51c173a4bdaa1a60e234fc3f705a16d228740",
  ]);
  console.log(heads);
})();

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("x-qn-api-version", "1");

var raw = JSON.stringify({
  "method": "qn_fetchTagsByAddress",
  "params": [
    "0x91b51c173a4bdaa1a60e234fc3f705a16d228740"
  ]
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("http://sample-endpoint-name.network.quiknode.pro/token-goes-here/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests
import json

url = "http://sample-endpoint-name.network.quiknode.pro/token-goes-here/"

payload = json.dumps({
  "method": "qn_fetchTagsByAddress",
  "params": [
    "0x91b51c173a4bdaa1a60e234fc3f705a16d228740"
  ]
})
headers = {
  'Content-Type': 'application/json',
  'x-qn-api-version': '1'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

from web3 import Web3, HTTPProvider
OPTIONS = {
  'headers':
    {
      'x-qn-api-version': '1'
    }
}
w3 = Web3(HTTPProvider('http://sample-endpoint-name.network.quiknode.pro/token-goes-here/', request_kwargs=OPTIONS))
resp = w3.provider.make_request('qn_fetchTagsByAddress', [
  "0x91b51c173a4bdaa1a60e234fc3f705a16d228740"
])
print(resp)

# The eth.rb library does not support including additional request headers, so you won't be able to add the x-qn-api-version header.
require 'eth'

client = Eth::Client.create 'http://sample-endpoint-name.network.quiknode.pro/token-goes-here/'
payload = {
    "method": "qn_fetchTagsByAddress",
    "params": [
      "0x91b51c173a4bdaa1a60e234fc3f705a16d228740"
    ]
}

response = client.send(payload.to_json)
puts response

Ready to get started? Create a free account

Qn Fetch Tags By Address

Contents

qn_fetchTagsByAddress RPC Method