AptosAptos Network's breakthrough technology and seamless user experience are now available on QuickNode.

Start building today!     

Contents

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:

  1. params - The custom array 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

    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:

  1. 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)
Ready to get started? Create a free account