← Documentation
/ qn_fetchAddressesByTag
AptosAptos Network's breakthrough technology and seamless user experience are now available on QuickNode.
Start building today!
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:
tag - string - The tag to return all addresses for.
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
perPage - integer/null - The maximum amount of addresses to return on each page. You can request up to 100 items per page. Must be null if not used, this will default to 50 items per page
page - integer/null - The page number you would like to get returned. The page numbers start at 1 and end at totalPages. Must be null if not used, default page number will be 1. If the page number requested is less than 1 or higher than totalPages, an empty assets array will be returned
Returns:
status - The status of the response
data - The custom object containing the following fields:
tags - An array of tag objects, each representing a specific tag. Each tag object has two fields:
address - The wallet address with the specified tag
ensDomainName - The wallet address with the specified tag
pageNumber - The page number of results that was returned with this response
totalItems - The total number of results
totalPages - The total number of results pages available
Code Examples:
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_fetchAddressesByTag', [ "Zombie Wallet", 10, 1 ])
print(resp)
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_fetchAddressesByTag",
"params": [ "Zombie Wallet", 10, 1 ]
}'
var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("x-qn-api-version", "1");
var raw = JSON.stringify({
"method": "qn_fetchAddressesByTag",
"params": [ "Zombie Wallet", 10, 1 ]
});
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));
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_fetchAddressesByTag", [
"Zombie Wallet",
10,
1,
]);
console.log(heads);
})();
# 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_fetchAddressesByTag",
"params": [
"Zombie Wallet", 10, 1
]
}
response = client.send(payload.to_json)
puts response
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_fetchAddressesByTag",
"params": [ "Zombie Wallet", 10, 1 ]
})
response = https.request(request)
puts response.read_body
import requests
import json
url = "http://sample-endpoint-name.network.quiknode.pro/token-goes-here/"
payload = json.dumps({
"method": "qn_fetchAddressesByTag",
"params": [ "Zombie Wallet", 10, 1 ]
})
headers = {
'Content-Type': 'application/json',
'x-qn-api-version': '1'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)