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
Example Use Case: NFT Collection Search
Search specifically for NFT collections across all networks:
Try it nowExample 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"
}
}
}
}
]
}
}
}
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.
Example Use Case: Chain Specific Token Search
Search for tokens across one or multiple specified networks:
Try it nowExample 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"
}
}
}
]
}
}
}
Example Use Case: Global Search
Let's create a global search component that returns relevant results across multiple entity types:
Try it nowExample 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
Argument | Description | Type | Required |
---|---|---|---|
search | Search query string | String! | Yes |
chainIds | Chains to search on | [Int!] | No |
categories | Entity types to search for | [OnchainSearchCategory!] | No |
maxResultsPerCategory | Maximum results per category | Float | No (Default: 3) |
Response Fields
Field | Description | Type |
---|---|---|
results | Array of search results | [OnchainSearchResultObject!]! |
Each result object includes these common fields:
Field | Description | Type |
---|---|---|
id | Unique identifier for the result | String! |
category | Entity type of the result | SearchResultCategory! |
title | Display title for the result | String! |
imageUrl | URL for result image/icon | String |
score | Relevance score | String |
Category-Specific Fields
Each result type has additional fields relevant to its category:
App Results
appId
: App identifiername
: App namenetworks
: Networks the app is available onapp
: Detailed app information
Token Results (ERC20_TOKEN)
address
: Token contract addresssymbol
: Token symbolname
: Token namedecimals
: Token decimalsnetwork
: Network where token existserc20
: Detailed token information
Unified Token Results (UNIFIED_ERC20_TOKEN)
symbol
: Token symbolname
: Token namegroupId
: Token group identifierperNetworkInfo
: Network-specific informationgroupedFungibleTokens
: Associated tokens
NFT Collection Results
address
: Collection contract addressname
: Collection namenetwork
: Network where collection existsnftStandard
: NFT standard (ERC721, ERC1155)collection
: Detailed collection information
User Results
address
: User addressens
: ENS domain (if available)lens
: Lens handle (if available)farcaster
: Farcaster username (if available)account
: Detailed account information
Transaction Results
hash
: Transaction hashnetwork
: Network of transaction
Enums
enum OnchainSearchCategory {
APP
FARCASTER_PROFILE
GAS_TOKEN
UNIFIED_GAS_TOKEN
ERC20_TOKEN
NFT_COLLECTION
UNIFIED_ERC20_TOKEN
USER
TRANSACTION
}