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 now

Example Variables

{
  "address": "0xf3f92a60e6004f3982f0fde0d43602fc0a30a0db",
  "chainId": 480,
  "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 data for charts
      priceTicks(currency: $currency, timeFrame: $timeFrame) {
        open
        median
        close
        timestamp
      }
    }
  }
}

Example Response

{
  "data": {
    "fungibleTokenV2": {
      "address": "0xf3f92a60e6004f3982f0fde0d43602fc0a30a0db",
      "symbol": "ORB",
      "name": "Orb",
      "decimals": 18,
      "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/worldchain/0xf3f92a60e6004f3982f0fde0d43602fc0a30a0db.png",
      "priceData": {
        "marketCap": 334470.7897902368,
        "price": 0.00023383417352516877,
        "priceChange5m": -0.0199982305272961,
        "priceChange1h": -0.2097692977861887,
        "priceChange24h": 5.773325856543643,
        "volume24h": 7466.82861328125,
        "totalGasTokenLiquidity": 4.779354739755427,
        "totalLiquidity": 11721.561173042304,
        "priceTicks": [
          {
            "open": 0.0002140876677549433,
            "median": 0.00022124794010452628,
            "close": 0.00022118157877651454,
            "timestamp": 1747677600000
          },
          {
            "open": 0.00022096051014730816,
            "median": 0.00022096051014730816,
            "close": 0.00022100471223336377,
            "timestamp": 1747677900000
          },
          {
            "open": 0.00022096051014730816,
            "median": 0.00022096051014730816,
            "close": 0.00022100471223336377,
            "timestamp": 1747678200000
          },
          {
            "open": 0.00022100471223336377,
            "median": 0.00022100471223336377,
            "close": 0.00022100471223336377,
            "timestamp": 1747678500000
          },
          {
            "open": 0.00023383417352516877,
            "median": 0.00023383417352516877,
            "close": 0.00023383417352516877,
            "timestamp": 1747767600000
          }
        ]
      }
    }
  }
}

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).

note

This field requires heavy computation and costs an additional 8 credits.

Try it now

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 now

Example 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"
                  }
                }
              }
            }
          }
        ]
      }
    }
  }
}

Example Use Case: Historical Price

Returns the price of a token at a specific timestamp.

Try it now

Example Variables

{
  "address": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
  "chainId": 8453,
}

Example Query

query TokenPriceData($address: Address!, $chainId: Int!) {
  fungibleTokenV2(address: $address, chainId: $chainId) {
    # Basic token information
    address
    symbol
    name
    decimals
    imageUrlV2

    # Historical price by timestamp
    priceData {
      historicalPrice(timestamp: 1742262500000) {
        timestamp
        price
      }
    }
  }
}

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": {
        "historicalPrice": {
          "timestamp": 1742227200000,
          "price": 0.00000626961364413425
        }
      }
    }
  }
}

`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.

Try it now

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
}

fungibleTokenV2​

Example Use Case: Token Details with Charts​

Example Variables​

Example Query​

Example Response​

Example Use Case: Latest Swaps​

Example Variables​

Example Query​

Response​

Example Use Case: Token Holders​

Example Variables​

Example Query​

Response​

Example Use Case: Historical Price​

Example Variables​

Example Query​

Response​

fungibleTokenBatchV2​

Example Variables​

Example Query​

Arguments​

Fields​

priceData Fields​

Enums​

`fungibleTokenV2`

Example Use Case: Token Details with Charts

Example Variables

Example Query

Example Response

Example Use Case: Latest Swaps

Example Variables

Example Query

Response

Example Use Case: Token Holders

Example Variables

Example Query

Response

Example Use Case: Historical Price

Example Variables

Example Query

Response

`fungibleTokenBatchV2`

Example Variables

Example Query

Arguments

Fields

priceData Fields

Enums