Skip to main content

Onchain Search

Get comprehensive search results across multiple chains and entity types with a single query. The search endpoint allows you to find tokens, NFT collections, apps, users, transactions, and more.

searchV2

Takes a search input and optional filters. Returns search results across multiple entity types and networks simultaneously.

  • Cross-chain search across all supported networks
  • Multi-entity results (tokens, NFTs, apps, users, transactions)
  • Category filtering for targeted searches
  • Configurable results limit per category

Search specifically for NFT collections across all networks:

Try it nowArrow pointing right

Example Variables

{
"input": {
"search": "azuki",
"categories": ["NFT_COLLECTION"],
"maxResultsPerCategory": 3
}
}

Example Query

query NFTCollectionSearch ($input: SearchInputV2!) {
searchV2(input: $input) {
results {
# NFT Collection-specific fields
... on NftCollectionResult {
category
address
network
collection {
displayName
symbol
description
nftStandard
deployedAt

floorPrice {
valueUsd
}
topOfferPrice {
valueUsd
}
medias {
logo {
fileSize
height
width
mimeType
predominantColor
blurhash
thumbnail
medium
large
original
}
}

}
}
}
}
}

Example Response

{
"data": {
"searchV2": {
"results": [
{
"category": "NFT_COLLECTION",
"address": "0xed5af388653567af2f388e6224dc7c4b3241c544",
"network": "ETHEREUM_MAINNET",
"collection": {
"displayName": "Azuki",
"symbol": "AZUKI",
"description": "Take the red bean to join the garden. View the collection at [azuki.com/gallery](https://azuki.com/gallery).\r\n\r\nAzuki starts with a collection of 10,000 avatars that give you membership access to The Garden: a corner of the internet where artists, builders, and web3 enthusiasts meet to create a decentralized future. Azuki holders receive access to exclusive drops, experiences, and more. Visit [azuki.com](https://azuki.com) for more details.\r\n\r\nWe rise together. We build together. We grow together.",
"nftStandard": "ERC_721",
"deployedAt": 1641791997000,
"floorPrice": {
"valueUsd": 4789.95808
},
"topOfferPrice": {
"valueUsd": 4715.92
},
"medias": {
"logo": {
"fileSize": 1215,
"height": 250,
"width": 250,
"mimeType": "image/png",
"predominantColor": "#c15661",
"blurhash": "U6MDKU].8w]:].jZayj[00ae.mWB[roLofjZ",
"thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0xed5af388653567af2f388e6224dc7c4b3241c544/logo.png&width=100&checksum=cBSZEKQIYuy0ex7WgWdMOLWJ-bhqjlDcBOE1xflhvhY",
"medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0xed5af388653567af2f388e6224dc7c4b3241c544/logo.png&width=250&checksum=e_-iM7ncKUMRoQQsLmFywfy3iI5r98RJb7wHS4BK-Og",
"large": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0xed5af388653567af2f388e6224dc7c4b3241c544/logo.png&width=500&checksum=bENXiuKRHZes9h3plIcoUXPxepYNIZWbpU85cGZ0dzE",
"original": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0xed5af388653567af2f388e6224dc7c4b3241c544/logo.png&checksum=bMDAYGhTW0diO5PJms4btjuRrC1-hM4jUiFTJneHGcE"
}
}
}
},
{
"category": "NFT_COLLECTION",
"address": "0xb6a37b5d14d502c3ab0ae6f3a0e058bc9517786e",
"network": "ETHEREUM_MAINNET",
"collection": {
"displayName": "Azuki Elementals",
"symbol": "ELEM",
"description": "Azuki Elementals are a collection of 20,000 characters within the four domains of the Garden.\r\n\r\nTake the red bean. azuki.com/elementals/reveal",
"nftStandard": "ERC_721",
"deployedAt": 1687207415000,
"floorPrice": {
"valueUsd": 479.7936
},
"topOfferPrice": {
"valueUsd": 473.456
},
"medias": {
"logo": {
"fileSize": 1766,
"height": 250,
"width": 250,
"mimeType": "image/png",
"predominantColor": "#454545",
"blurhash": "U67^}Wof00of-;fQM{j[00WB~qWB00j[-;WB",
"thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0xb6a37b5d14d502c3ab0ae6f3a0e058bc9517786e/logo.png&width=100&checksum=pmka6FfaI2NOuFl7UVXKWYYayeD1FzRaGHr3PZXLH7c",
"medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0xb6a37b5d14d502c3ab0ae6f3a0e058bc9517786e/logo.png&width=250&checksum=L-Yo8wLc1c8zOXb7AWna-B8WPqg8pzTBUFkLz2kyHg0",
"large": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0xb6a37b5d14d502c3ab0ae6f3a0e058bc9517786e/logo.png&width=500&checksum=IgImYERSvlY1AQPnlIw38Nhhh7_9GS7DE-GM-82WX7M",
"original": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0xb6a37b5d14d502c3ab0ae6f3a0e058bc9517786e/logo.png&checksum=byT-_1EESd57mCPMl0PNDte0AUmA_R0XEFMus_4H-Yo"
}
}
}
},
{
"category": "NFT_COLLECTION",
"address": "0x3af2a97414d1101e2107a70e7f33955da1346305",
"network": "ETHEREUM_MAINNET",
"collection": {
"displayName": "Azuki Elemental Beans",
"symbol": "MBEAN",
"description": "Azuki Elemental Beans can be consumed to take you into the Garden, revealing your Azuki Elemental. Reveal available immediately after the sale closes. \r\n\r\nFind your domain. Be in your element.\r\n\r\nazuki.com/elementals",
"nftStandard": "ERC_721",
"deployedAt": 1686804431000,
"floorPrice": {
"valueUsd": 1584.4
},
"topOfferPrice": {
"valueUsd": 1211.6
},
"medias": {
"logo": {
"fileSize": 1239176,
"height": 250,
"width": 250,
"mimeType": "image/gif",
"predominantColor": "#ae2954",
"blurhash": "U5J{-G]oIj]n]qjuS0jsEGfP-aa},Bjs$moM",
"thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0x3af2a97414d1101e2107a70e7f33955da1346305/logo.gif&width=100&checksum=3fSz7lIT51vXGUgEllcucXIt35uMZHw2Ly_MjthLr-A",
"medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0x3af2a97414d1101e2107a70e7f33955da1346305/logo.gif&width=250&checksum=BBPQY7ufTyaTb2OgkazwaKLv2Ld7F6esuFDUSHyGj7U",
"large": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0x3af2a97414d1101e2107a70e7f33955da1346305/logo.gif&width=500&checksum=PYYUEbSDsI-NamSabTMVxE6xU7gk1Ow4n_D9UslATU8",
"original": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/ethereum/0x3af2a97414d1101e2107a70e7f33955da1346305/logo.gif&checksum=PWHDqGjsMzofdrW8iQnaeY9uICrRmFFwsrQbV1SeZpY"
}
}
}
}
]
}
}
}
note

Resolving accounts, NFT collections, ERC20 tokens, and app metadata on top of search results adds the cost of those queries. Pricing for those queries are available in the pricing section.

Search for tokens across one or multiple specified networks:

Try it nowArrow pointing right

Example Variables

{
"input": {
"search": "dog",
"chainIds": [8453],
"categories": ["ERC20_TOKEN"],
"maxResultsPerCategory": 5
}
}

Example Query

query ChainSpecificTokenSearch ($input: SearchInputV2!) {
searchV2(input: $input) {
results {
# Token-specific fields
... on Erc20TokenResult {
category
address
symbol
name
erc20 {
priceData {
price
priceChange24h
}
imageUrlV2
networkV2 {
name
}
}
}
}
}
}

Example Response

{
"data": {
"searchV2": {
"results": [
{
"category": "ERC20_TOKEN",
"address": "0x6921b130d297cc43754afba22e5eac0fbf8db75b",
"symbol": "doginme",
"name": "doginme",
"erc20": {
"priceData": {
"price": 0.0005325247661081628,
"priceChange24h": 7.776699759535033
},
"imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x6921b130d297cc43754afba22e5eac0fbf8db75b.png",
"networkV2": {
"name": "Base"
}
}
},
{
"category": "ERC20_TOKEN",
"address": "0x3b916b8f6a710e9240ff08c1dd646dd8e8ed9e1e",
"symbol": "DOG",
"name": "Base Dog",
"erc20": {
"priceData": {
"price": 173.85062074661255,
"priceChange24h": 5.350710049675955
},
"imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x3b916b8f6a710e9240ff08c1dd646dd8e8ed9e1e.png",
"networkV2": {
"name": "Base"
}
}
},
{
"category": "ERC20_TOKEN",
"address": "0xafb89a09d82fbde58f18ac6437b3fc81724e4df6",
"symbol": "DOG",
"name": "The Doge NFT",
"erc20": {
"priceData": {
"price": 0.0009226905858667997,
"priceChange24h": 3.741367863337075
},
"imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0xafb89a09d82fbde58f18ac6437b3fc81724e4df6.png",
"networkV2": {
"name": "Base"
}
}
},
{
"category": "ERC20_TOKEN",
"address": "0x488542c2320f20d65405a1c03da769bc124f9a28",
"symbol": "DOGA",
"name": "DOGITA",
"erc20": {
"priceData": {
"price": 4.0422153413544e-7,
"priceChange24h": 5.350710049675955
},
"imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x488542c2320f20d65405a1c03da769bc124f9a28.png",
"networkV2": {
"name": "Base"
}
}
},
{
"category": "ERC20_TOKEN",
"address": "0x80e3ee7bab68feaea6e01c44df9daa5de53e4818",
"symbol": "DOGE",
"name": "DOGECOIN",
"erc20": {
"priceData": {
"price": 0.00022064535539812505,
"priceChange24h": 13.532117306667168
},
"imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x80e3ee7bab68feaea6e01c44df9daa5de53e4818.png",
"networkV2": {
"name": "Base"
}
}
}
]
}
}
}

Let's create a global search component that returns relevant results across multiple entity types:

Try it nowArrow pointing right

Example Variables

{
"input": {
"search": "dog",
"categories": ["APP", "UNIFIED_ERC20_TOKEN", "UNIFIED_GAS_TOKEN", "NFT_COLLECTION", "USER"],
"maxResultsPerCategory": 2
}
}

Example Query

query GlobalSearchExample ($input: SearchInputV2!) {
searchV2(input: $input) {
results {
# App-specific fields
... on AppResult {
category
appId
app {
displayName
description
url
imgUrl
}
}

# NFT Collection-specific fields
... on NftCollectionResult {
category
address
network
collection {
displayName
description
floorPrice {
valueUsd
}
medias {
logo {
thumbnail
medium
blurhash
}
}
}
}

# User-specific fields
... on UserResult {
category
address
account {
displayName {
value
}
farcasterProfile {
username
fid
metadata {
imageUrl
displayName
}
}
}
}
# Single result for tokens that are deployed on multiple chains
... on UnifiedErc20TokenResult {
category
name
symbol
imageUrl
groupedFungibleTokens {
address
networkV2 {
chainId
name
}
priceData {
price
priceChange24h
}
}
}
# Single result for gas tokens that are deployed on multiple chains
... on UnifiedGasTokenResult {
category
name
symbol
imageUrl
groupedGasTokens {
address
networkV2 {
chainId
name
}
priceData {
price
priceChange24h
}
}
}
}
}
}

Example Response

{
"data": {
"searchV2": {
"results": [
{
"category": "UNIFIED_ERC20_TOKEN",
"name": "Dogecoin",
"symbol": "DOGE",
"imageUrl": "https://storage.googleapis.com/zapper-fi-assets/tokens/ethereum/0x4206931337dc273a630d328da6441786bfad668f.png",
"groupedFungibleTokens": [
{
"address": "0x4206931337dc273a630d328da6441786bfad668f",
"networkV2": {
"chainId": 1,
"name": "Ethereum"
},
"priceData": {
"price": 0.18202949560613735,
"priceChange24h": 6.749571606475713
}
}
]
},
{
"category": "UNIFIED_ERC20_TOKEN",
"name": "Dogecoin",
"symbol": "DOGE",
"imageUrl": "https://storage.googleapis.com/zapper-fi-assets/tokens/binance-smart-chain/0x4206931337dc273a630d328da6441786bfad668f.png",
"groupedFungibleTokens": [
{
"address": "0x4206931337dc273a630d328da6441786bfad668f",
"networkV2": {
"chainId": 56,
"name": "BNB Chain"
},
"priceData": {
"price": 0.18182203041459943,
"priceChange24h": 6.417745944107001
}
}
]
},
{
"category": "USER",
"address": "0x640ac467fd8d1b1a9dfb37bcc1722e4fbd6aae5d",
"account": {
"displayName": {
"value": "dog.eth"
},
"farcasterProfile": null
}
},
{
"category": "USER",
"address": "0x438a5728fc3ff225a22b48fbaeeb3b55897900d0",
"account": {
"displayName": {
"value": "mrmiggles.base.eth"
},
"farcasterProfile": null
}
},
{
"category": "NFT_COLLECTION",
"address": "0xc8b9b85ab5f88525d3e2fcf27a9aaa0103a52211",
"network": "APECHAIN_MAINNET",
"collection": {
"displayName": null,
"description": "",
"floorPrice": {
"valueUsd": 0.06522
},
"medias": {
"logo": {
"thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/2bf0a6b9244a7bb551d2c23e3c709e92830d7e52a64403a0ce527d62de82a55d.webp&width=100&checksum=mynrjV0L5WoXypwrAW6RIG8NI24k9DoOAWKHnVYcjMM",
"medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/2bf0a6b9244a7bb551d2c23e3c709e92830d7e52a64403a0ce527d62de82a55d.webp&width=250&checksum=yp0PIeQK-9qe1h5BOTlisLRnpBdyezGOZH88F92_5As",
"blurhash": "UFF6LP-S1BA2JqR.$xxC5tWB=qt6o~W=axsk"
}
}
}
},
{
"category": "APP",
"appId": "dogliens",
"app": {
"displayName": "Dogliens",
"description": "Join Ralph's mission to evolve Paw Planet through storytelling and emotional intelligence.",
"url": "https://www.dogliens.com/",
"imgUrl": "https://storage.googleapis.com/zapper-fi-assets/apps%2Fdogliens.png"
}
},
{
"category": "NFT_COLLECTION",
"address": "0x62b81affe23f9855478607eba53c4bdffd6b8383",
"network": "ETHEREUM_MAINNET",
"collection": {
"displayName": null,
"description": "",
"floorPrice": null,
"medias": {
"logo": {
"thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/6bce5726a4e49f942be9601e5aa2b4162b629645ca067426c2b3ec35f67bec62.png&width=100&checksum=5kqVWnqBVe7_iTXkF37G9oZE1FzU_c0g-ip5i-1XZtc",
"medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/6bce5726a4e49f942be9601e5aa2b4162b629645ca067426c2b3ec35f67bec62.png&width=250&checksum=98TQu7E84pZW6mQWDVwZrXH2Jg2b7FYvI5sQpf1DqmY",
"blurhash": null
}
}
}
}
]
}
}
}

Arguments

ArgumentDescriptionTypeRequired
searchSearch query stringString!Yes
chainIdsChains to search on[Int!]No
categoriesEntity types to search for[OnchainSearchCategory!]No
maxResultsPerCategoryMaximum results per categoryFloatNo (Default: 3)

Response Fields

FieldDescriptionType
resultsArray of search results[OnchainSearchResultObject!]!

Each result object includes these common fields:

FieldDescriptionType
idUnique identifier for the resultString!
categoryEntity type of the resultSearchResultCategory!
titleDisplay title for the resultString!
imageUrlURL for result image/iconString
scoreRelevance scoreString

Category-Specific Fields

Each result type has additional fields relevant to its category:

App Results

  • appId: App identifier
  • name: App name
  • networks: Networks the app is available on
  • app: Detailed app information

Token Results (ERC20_TOKEN)

  • address: Token contract address
  • symbol: Token symbol
  • name: Token name
  • decimals: Token decimals
  • network: Network where token exists
  • erc20: Detailed token information

Unified Token Results (UNIFIED_ERC20_TOKEN)

  • symbol: Token symbol
  • name: Token name
  • groupId: Token group identifier
  • perNetworkInfo: Network-specific information
  • groupedFungibleTokens: Associated tokens

NFT Collection Results

  • address: Collection contract address
  • name: Collection name
  • network: Network where collection exists
  • nftStandard: NFT standard (ERC721, ERC1155)
  • collection: Detailed collection information

User Results

  • address: User address
  • ens: ENS domain (if available)
  • lens: Lens handle (if available)
  • farcaster: Farcaster username (if available)
  • account: Detailed account information

Transaction Results

  • hash: Transaction hash
  • network: Network of transaction

Enums

enum OnchainSearchCategory {
APP
FARCASTER_PROFILE
GAS_TOKEN
UNIFIED_GAS_TOKEN
ERC20_TOKEN
NFT_COLLECTION
UNIFIED_ERC20_TOKEN
USER
TRANSACTION
}