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.

Try it now

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

---

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": 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
          }
        ]
      },
      "holders": {
        "edges": [
          {...}
          {
            "node": {
              "holderAddress": "0x849151d7d0bf1f34b70d5cad5149d28cc2308bf1",
              "percentileShare": 2.50266192783304,
              "value": "25026619278330401676995906",
              "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"
                  }
                }
              }
            }
          }
        ]
      },
      "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
                }
              }
            }
          }
        }
      }
    }
  }
}

Try it now

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

fungibleTokenBatch

Takes an array of token inputs (address and network 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",
      "network": "BASE_MAINNET"
    },
    {
      "address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
      "network": "ETHEREUM_MAINNET"
    },
    {
      "address": "0x00ef6220b7e28e890a5a265d82589e072564cc57",
      "network": "BASE_MAINNET"
    }
  ]
}

---

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
}