Token Prices & Charts
Get comprehensive onchain prices, current and historical, for any token that has an onchain market across supported networks. Price ticks are also provided for price charts with open, median, and close data.
fungibleTokenV2
Takes an address
and chainId
as input. Returns detailed token information including:
- Real-time onchain sourced price data
- Price history with customizable timeframes
- Holders, percentage owned, and value
- Liquidity and market cap data
- Latest swaps
- Support for multiple price currencies (default: USD)
Example Use Case: Token Details with Charts
Let's say you want to create a token page providing the price, market data, historical graphs in USD as well as metadata including the token's image, name, and symbol.
Try it nowExample Variables
{
"address": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"chainId": 8453,
"currency": "USD",
"timeFrame": "DAY"
}
Example Query
query TokenPriceData(
$address: Address!
$chainId: Int!
$currency: Currency!
$timeFrame: TimeFrame!
) {
fungibleTokenV2(address: $address, chainId: $chainId) {
# Basic token information
address
symbol
name
decimals
imageUrlV2
# Market data and pricing information
priceData {
marketCap
price
priceChange5m
priceChange1h
priceChange24h
volume24h
totalGasTokenLiquidity
totalLiquidity
# Historical price by timestamp
historicalPrice(timestamp: 1742262500000) {
price
timestamp
}
# Historical price data for charts
priceTicks(currency: $currency, timeFrame: $timeFrame) {
open
median
close
timestamp
}
}
}
}
Example Response
{
"data": {
"fungibleTokenV2": {
"address": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"symbol": "27 mgas/s",
"name": "27 mgas/s",
"decimals": 18,
"imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd.png",
"priceData": {
"marketCap": 6431.575021058252,
"price": 0.000006431575021058252,
"priceChange5m": 0,
"priceChange1h": 0.49381554275405026,
"priceChange24h": 0.24525187837818319,
"volume24h": 20.59552001953125,
"totalGasTokenLiquidity": 0.4681539122704667,
"totalLiquidity": 917.7032008057402,
"historicalPrice": {
"price": 0.00000625519110006274,
"timestamp": 1742261400000
},
"priceTicks": [
{
"open": 0.000006456779400726827,
"median": 0.000006456779400726827,
"close": 0.000006456779400726827,
"timestamp": 1742486400000
},
{
"open": 0.000006467061318532762,
"median": 0.000006467061318532762,
"close": 0.000006467061318532762,
"timestamp": 1742486700000
},
{...}
{
"open": 0.000006431575021058252,
"median": 0.000006431575021058252,
"close": 0.000006431575021058252,
"timestamp": 1742575500000
}
]
},
}
}
}
Example Use Case: Latest Swaps
Get a paginated list of the latest swaps for a given token address. Also surfaces identity information such as displayName or farcasterProfile (if any).
This field requires heavy computation and costs an additional 8 credits.
Example Variables
{
"address": "0x0578d8a44db98b23bf096a382e016e29a5ce0ffe",
"chainId": 8453
}
Example Query
query fungibleTokenV2(
$address: Address!
$chainId: Int!
) {
fungibleTokenV2(address: $address, chainId: $chainId) {
# Latest Swaps
priceData {
latestSwaps(first: 3) {
edges {
node {
boughtTokenAddress
boughtAmount
soldTokenAddress
soldAmount
gasTokenVolume
volumeUsd
timestamp
transactionHash
from {
address
displayName {
value
source
}
farcasterProfile {
fid
username
metadata {
displayName
imageUrl
}
}
}
}
}
}
}
}
}
Response
{
"data": {
"fungibleTokenV2": {
"address": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"symbol": "27 mgas/s",
"name": "27 mgas/s",
"decimals": 18,
"imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd.png",
"priceData": {
"latestSwaps": {
"edges": [
{
"node": {
"timestamp": 1744839371000,
"transactionHash": "0xdef9ae17c8e9ffdbae9ab726c184aac0f218ce3148f92cfa87c5d09ccb3c47d4",
"boughtTokenAddress": "0x4200000000000000000000000000000000000006",
"boughtAmount": 0.000096904283015405,
"soldTokenAddress": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"soldAmount": 32084.056006244813,
"volumeUsd": 0.15412087987907147,
"gasTokenVolume": 0.000096904283015405
}
},
{
"node": {
"timestamp": 1744823943000,
"transactionHash": "0x5da3a1869ef809ab14b7fca7acddf440d6fbffa57fe8bac659cbcecff0c11e70",
"boughtTokenAddress": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"boughtAmount": 629.0869634078529,
"soldTokenAddress": "0x4200000000000000000000000000000000000006",
"soldAmount": 0.000001938697097137,
"volumeUsd": 0.0030833900538973754,
"gasTokenVolume": 0.000001938697097137
}
},
{
"node": {
"timestamp": 1744815531000,
"transactionHash": "0x8dbbc401b87924929afe7ef0731f499d70a5c9c74555c4a3bb0e27390f16fbf0",
"boughtTokenAddress": "0x4200000000000000000000000000000000000006",
"boughtAmount": 0.000063636068597575,
"soldTokenAddress": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"soldAmount": 21068,
"volumeUsd": 0.10120963263041816,
"gasTokenVolume": 0.000063636068597575
}
},
{
"node": {
"timestamp": 1744767561000,
"transactionHash": "0xd981578ed22f3d2c629e784f2cd9c3dd7a1f9bc6f396665bf8714f6fb079abcd",
"boughtTokenAddress": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"boughtAmount": 32.12290981256175,
"soldTokenAddress": "0x4200000000000000000000000000000000000006",
"soldAmount": 9.9e-8,
"volumeUsd": 0.00015745400134277343,
"gasTokenVolume": 9.9e-8
}
},
{
"node": {
"timestamp": 1744767095000,
"transactionHash": "0xe409b34e748ca2c2a6c78afe293d813badc96379d7fd3f1093a008833d5858ec",
"boughtTokenAddress": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"boughtAmount": 32.12291224817941,
"soldTokenAddress": "0x4200000000000000000000000000000000000006",
"soldAmount": 9.9e-8,
"volumeUsd": 0.00015745400134277343,
"gasTokenVolume": 9.9e-8
}
},
{
"node": {
"timestamp": 1744766441000,
"transactionHash": "0xd7a9079cf4cbf867c730305c2b61b8b48dd30cba3ce15f5b8feacc89402bd618",
"boughtTokenAddress": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"boughtAmount": 32.12291468379734,
"soldTokenAddress": "0x4200000000000000000000000000000000000006",
"soldAmount": 9.9e-8,
"volumeUsd": 0.00015745400134277343,
"gasTokenVolume": 9.9e-8
}
},
{
"node": {
"timestamp": 1744766105000,
"transactionHash": "0x942f7bda52e857d6044fe86e84169f726481283824134ae192aaf9efaee16bac",
"boughtTokenAddress": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"boughtAmount": 32.122917119415554,
"soldTokenAddress": "0x4200000000000000000000000000000000000006",
"soldAmount": 9.9e-8,
"volumeUsd": 0.00015745400134277343,
"gasTokenVolume": 9.9e-8
}
},
{
"node": {
"timestamp": 1744765615000,
"transactionHash": "0xbe6a25f995905df2c8ce067166c39dd7524e526f129357055987076462b44fa0",
"boughtTokenAddress": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"boughtAmount": 32.12291955503404,
"soldTokenAddress": "0x4200000000000000000000000000000000000006",
"soldAmount": 9.9e-8,
"volumeUsd": 0.00015745400134277343,
"gasTokenVolume": 9.9e-8
}
},
{
"node": {
"timestamp": 1744765179000,
"transactionHash": "0xb2d5c24bd30549dfcfa7b6a6a61127c6b22a17c0a5287ea0ba2bfedf59021d85",
"boughtTokenAddress": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"boughtAmount": 32.1229219906528,
"soldTokenAddress": "0x4200000000000000000000000000000000000006",
"soldAmount": 9.9e-8,
"volumeUsd": 0.00015745400134277343,
"gasTokenVolume": 9.9e-8
}
},
{
"node": {
"timestamp": 1744764705000,
"transactionHash": "0x181d84ecd3cbbecc4add95461a0efaa470c830197b1aca68c2659f1fad5bf22a",
"boughtTokenAddress": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"boughtAmount": 32.12292442627184,
"soldTokenAddress": "0x4200000000000000000000000000000000000006",
"soldAmount": 9.9e-8,
"volumeUsd": 0.00015745400134277343,
"gasTokenVolume": 9.9e-8
}
}
]
}
}
}
}
}
Example Use Case: Token Holders
Get a paginated list of token holders with their quanity held, percentage of total supply, as well as identity information such as displayName or farcasterProfile (if any).
Try it nowExample Variables
{
"address": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"chainId": 8453,
"first": 5
}
Example Query
query TokenHolders(
$address: Address!
$chainId: Int!
$first: Float!
) {
fungibleTokenV2(address: $address, chainId: $chainId) {
# Basic token information
address
symbol
name
decimals
imageUrlV2
# Token holders information
holders(first: $first) {
edges {
node {
holderAddress
percentileShare
value
account {
displayName {
value
source
}
# Social identity data when available
farcasterProfile {
username
fid
metadata {
imageUrl
warpcast
}
}
}
}
}
}
}
}
Response
{
"data": {
"fungibleTokenV2": {
"address": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
"symbol": "27 mgas/s",
"name": "27 mgas/s",
"decimals": 18,
"imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd.png",
"holders": {
"edges": [
{
"node": {
"holderAddress": "0x3adb6190e0dc8d60e162878704783def2f898d26",
"percentileShare": 84.73782306624328,
"value": "847378230662432766735763531",
"account": {
"displayName": {
"value": "0x3adb...8d26",
"source": "ADDRESS"
},
"farcasterProfile": null
}
}
},
{
"node": {
"holderAddress": "0x849151d7d0bf1f34b70d5cad5149d28cc2308bf1",
"percentileShare": 2.5262672668761947,
"value": "25262672668761945941188720",
"account": {
"displayName": {
"value": "jesse.xyz",
"source": "ENS"
},
"farcasterProfile": {
"username": "jessepollak",
"fid": 99,
"metadata": {
"imageUrl": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/1013b0f6-1bf4-4f4e-15fb-34be06fede00/original",
"warpcast": "https://warpcast.com/jessepollak"
}
}
}
}
},
{
"node": {
"holderAddress": "0x90360a22946d40196383b4832d366fb3c2fad596",
"percentileShare": 2.1290545421559686,
"value": "21290545421559686643069389",
"account": {
"displayName": {
"value": "0x9036...d596",
"source": "ADDRESS"
},
"farcasterProfile": null
}
}
},
{
"node": {
"holderAddress": "0x7bf90111ad7c22bec9e9dff8a01a44713cc1b1b6",
"percentileShare": 1.5262672668761945,
"value": "15262672668761945941188961",
"account": {
"displayName": {
"value": "0x7bf9...b1b6",
"source": "ADDRESS"
},
"farcasterProfile": null
}
}
},
{
"node": {
"holderAddress": "0x4d9ee121638b6fe72907bc1872d5f20eb4e33596",
"percentileShare": 0.6881155320900804,
"value": "6881155320900803544851892",
"account": {
"displayName": {
"value": "0x4d9e...3596",
"source": "ADDRESS"
},
"farcasterProfile": {
"username": "starit",
"fid": 10692,
"metadata": {
"imageUrl": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/a27eb6ca-68ce-4073-19a5-d4cb370d4d00/original",
"warpcast": "https://warpcast.com/starit"
}
}
}
}
}
]
}
}
}
}
fungibleTokenBatchV2
Takes an array of token inputs (address
and chainId
pairs) and returns detailed information for multiple tokens in a single request. Returns the same data structure as fungibleToken
but for multiple tokens at once.
Example Variables
{
"tokens": [
{
"address": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
"chainId": 8453
},
{
"address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
"chainId": 1
},
{
"address": "0x00ef6220b7e28e890a5a265d82589e072564cc57",
"chainId": 8453
}
]
}
Example Query
query FungibleTokenBatchV2($tokens: [FungibleTokenInputV2!]!) {
fungibleTokenBatchV2(tokens: $tokens) {
address
symbol
name
decimals
imageUrlV2
priceData {
price
priceChange5m
priceChange1h
priceChange24h
volume24h
totalGasTokenLiquidity
totalLiquidity
}
}
}
Arguments
Argument | Description | Type | Required |
---|---|---|---|
address | Token contract address | Address! | Yes |
chainId | Chain ID where the token exists | Int! | Yes |
currency | Price currency (USD/ETH/BTC) | Currency! | Yes |
timeFrame | Time interval for price data | TimeFrame! | Yes |
first | Number of holders to fetch | Float! | Yes |
Fields
Field | Description | Type |
---|---|---|
id | Unique identifier for the token | ID! |
address | Contract address | Address! |
name | Token name | String! |
symbol | Token symbol | String! |
decimals | Number of decimals | Int! |
totalSupply | Total supply of the token | String |
credibility | Token credibility score | Float |
rank | Token rank | Int |
securityRisk | Security risk assessment | FungibleTokenSecurityRisk |
isHoldersSupported | Whether holder data is available | Boolean! |
imageUrl | Token logo URL | String! |
priceData | Detailed onchain market data | PriceData |
isVerified | Token verification status | Boolean! |
priceData Fields
Field | Description | Type |
---|---|---|
price | Current token price | Float! |
marketCap | Market capitalization | Float |
totalLiquidity | Total liquidity across all pairs | Float! |
totalGasTokenLiquidity | Native token liquidity | Float! |
priceChange5m | 5-minute price change percentage | Float |
priceChange1h | 1-hour price change percentage | Float |
priceChange24h | 24-hour price change percentage | Float |
priceTicks | Historical price data points | [PriceTick!]! |
historicalPrice | Price at a given timestamp | [HistoricalPrice!]! |
Enums
enum TimeFrame {
HOUR
DAY
WEEK
MONTH
YEAR
}
enum Currency {
USD
EUR
GBP
CAD
CNY
KRW
JPY
RUB
AUD
NZD
CHF
SGD
INR
BRL
ETH
BTC
HKD
SEK
NOK
MXN
TRY
}