Skip to main content

qn_fetchAddressesByTag RPC Method

Returns all addresses with a specificed wallet tag

Updated on
Nov 2, 2023

qn_fetchAddressesByTag 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
array
The custom object with the following fields:
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
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
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

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
Request
1
curl https://docs-demo.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  -H "x-qn-api-version: 1" \
5
  --data '{
6
    "method":"qn_fetchAddressesByTag",
7
    "params":{
8
      "tag": "zombie_wallet",
9
      "page": 1,
10
      "perPage": 10
11
    }
12
  }'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free