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.

`fungibleToken`

Takes an address and network 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
Support for multiple price currencies (default: USD)

Example Use Case: Detailed Token Page

Let's say you want to create a token page providing the price, historical graphs and relevant token information like holders, supply and the token's image:

Example Variables

{
  "address": "0xbe19c96f5deec29a91ca84e0d038d4bb01d098cd",
  "network": "BASE_MAINNET",
  "first": 3,
  "currency": "USD",
  "timeFrame": "DAY",
  "timestamp": 1742262500000
}

Example Query

query fungibleToken(
  $address: Address!
  $network: Network!
  $first: Float!
  $currency: Currency!
  $timeFrame: TimeFrame!
) {
  fungibleToken(address: $address, network: $network) {
    # 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: $timestamp) {
        price
        timestamp
      

      # Historical price data for charts
      priceTicks(currency: $currency, timeFrame: $timeFrame) {
        open
        median
        close
        timestamp
      }
    }

      # 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
                }
              }
            }
          }
        }
      }

    # Supply and security information
    totalSupply
    securityRisk {
      reason
    }
  }
}

Try in sandbox

Example Response

{
    "data": {
      "fungibleToken": {
        "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": 5496.302834251137,
          "price": 0.000005496302834251137,
          "priceChange5m": 0.1585327087627153,
          "priceChange1h": -0.5293226618769853,
          "priceChange24h": 3.7477470190199647,
          "volume24h": 229.4892578125,
          "totalGasTokenLiquidity": 0.27751946195368976,
          "totalLiquidity": 538.7850808038372,
          "historicalPrice": {
            "price": 0.00000622139916071825,
            "timestamp": 1742262300000
          }
          "priceTicks": [
            {
              "open": 0.000005294925110822725,
              "median": 0.000005294925110822725,
              "close": 0.000005294925110822725,
              "timestamp": 1741636800000
            },
            {
              "open": 0.000005317601901037492,
              "median": 0.000005317601901037492,
              "close": 0.000005317601901037492,
              "timestamp": 1741637100000
            },
            {
              "open": 0.000005496302834251137,
              "median": 0.000005496302834251137,
              "close": 0.000005496302834251137,
              "timestamp": 1741725300000
            }
          ]
        },
        "holders": {
          "edges": [
            {
              "node": {
                "holderAddress": "0x3adb6190e0dc8d60e162878704783def2f898d26",
                "percentileShare": 87.96704595269054,
                "value": "879670459526905395667173537",
                "account": {
                  "displayName": {
                    "value": "0x3adb...8d26",
                    "source": "ADDRESS"
                  },
                  "farcasterProfile": null
                }
              }
            },
            {
              "node": {
                "holderAddress": "0x849151d7d0bf1f34b70d5cad5149d28cc2308bf1",
                "percentileShare": 2.4354700234160593,
                "value": "24354700234160593151051034",
                "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": "0x7bf90111ad7c22bec9e9dff8a01a44713cc1b1b6",
                "percentileShare": 1.4354700234160593,
                "value": "14354700234160593151051187",
                "account": {
                  "displayName": {
                    "value": "0x7bf9...b1b6",
                    "source": "ADDRESS"
                  },
                  "farcasterProfile": null
                }
              }
            }
          ]
        },
        "totalSupply": "1000000000",
        "securityRisk": null
      }
    }
  }

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 additional 8 credits.

query fungibleToken(
  $address: Address!
  $network: Network!
) {
  fungibleToken(address: $address, network: $network) {
    # 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": {
    "fungibleToken": {
      "priceData": {
        "latestSwaps": {
          "edges": [
            {
              "node": {
                "boughtTokenAddress": "0x4200000000000000000000000000000000000006",
                "boughtAmount": 0.2455538814280863,
                "soldTokenAddress": "0xd54400a07c33cb219bd6046bdca696217c691d1c",
                "soldAmount": 212765633.92132998,
                "gasTokenVolume": 0.2455538814280863,
                "volumeUsd": 485.4511510309703,
                "timestamp": 1742502815000,
                "transactionHash": "0x1176815721d443c17fe9aeca06f70902bfa59e9dfa80d0ea9ed8f2ef2c74110b",
                "from": {
                  "address": "0x05da01afcc4c89e564ca3f1513a384ec992cda94",
                  "displayName": {
                    "value": "0x05da...da94",
                    "source": "ADDRESS"
                  },
                  "farcasterProfile": null
                }
              }
            },
            {
              "node": {
                "boughtTokenAddress": "0xd54400a07c33cb219bd6046bdca696217c691d1c",
                "boughtAmount": 212765633.92132998,
                "soldTokenAddress": "0x4200000000000000000000000000000000000006",
                "soldAmount": 0.25,
                "gasTokenVolume": 0.25,
                "volumeUsd": 494.240966796875,
                "timestamp": 1742502515000,
                "transactionHash": "0xcfea85b31dcbb7439e21eeb98928686ba3e041ccb80ca193a5696f7c4aaa177b",
                "from": {
                  "address": "0x80e3a02384c52e30fd9edad317ee150e3464a585",
                  "displayName": {
                    "value": "0x80e3...a585",
                    "source": "ADDRESS"
                  },
                  "farcasterProfile": null
                }
              }
            },
            {
              "node": {
                "boughtTokenAddress": "0xd54400a07c33cb219bd6046bdca696217c691d1c",
                "boughtAmount": 1075007.1065161992,
                "soldTokenAddress": "0x4200000000000000000000000000000000000006",
                "soldAmount": 0.00099,
                "gasTokenVolume": 0.00099,
                "volumeUsd": 1.957194228515625,
                "timestamp": 1742502511000,
                "transactionHash": "0xa6ddd4f47ee8d6b2074a5bde3475235fcb8e7bf0d20b5e1679ce474fc20b6e7b",
                "from": {
                  "address": "0x849151d7d0bf1f34b70d5cad5149d28cc2308bf1",
                  "displayName": {
                    "value": "jesse.xyz",
                    "source": "ENS"
                  },
                  "farcasterProfile": {
                    "fid": 99,
                    "username": "jessepollak",
                    "metadata": {
                      "displayName": "jesse.base.eth 🔵",
                      "imageUrl": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/1013b0f6-1bf4-4f4e-15fb-34be06fede00/original"
                    }
                  }
                }
              }
            }
          ]
        }
      }
    }
  }
}

Arguments

Argument	Description	Type	Required
`address`	Token contract address	`Address!`	Yes
`network`	Network where the token exists	`Network!`	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
}

fungibleToken​

Example Use Case: Detailed Token Page​

Example Variables​

Example Query​

Example Response​

Example Use Case: Latest Swaps​

Response​

Arguments​

Fields​

priceData Fields​

Enums​