Skip to main content

​
Example

​
Usage Guidelines

  • Maximum datapoints: 1500 per request
  • Use countback: 1500 with from: 0 for maximum results
  • Add removeEmptyBars: true to eliminate gaps in low-activity tokens
  • Use currencyCode: "TOKEN" for native token pricing instead of USD
  • For charting by Market cap: multiply price data by circulatingSupply from EnhancedToken
  • For volume, be sure to use volume instead of v. Due to large volume numbers exceeding max integer lengths, we needed to deprecate v in place of volume.

​
Troubleshooting Tips

Omit quoteToken parameter to auto-detect the correct base token of the pair automatically.
-Check that your timestamp window is accurate and long enough for the resolution requested.
-Ensure the token has started trading (we do not index tokens until trades occur)
-Use removeLeadingNullValues: true
Add symbolType: Token to your query. This is a common issue with four.meme tokens as their pair and token address is the same.
Our API fits right into TradingView’s library. You can find docs for integrating with TradingView at https://www.tradingview.com/free-charting-libraries/.
You can use getBars to do an initial fetch of bars and then subscribe to onBarsUpdated to keep it updated in real-time. More info on creating real-time charts is available here.
Our chart data for under 1m (1S, 5S, 15S, 30S) only goes back 24 hours due to the volume of data required at those resolutions.
Returns: BarsResponse

​
Arguments

​
symbol
String!
required
The ID of the pair or token (pairAddress:networkId or tokenAddress:networkId). If a token contract address is provided, the token’s top pair is used. For example, 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1 returns WETH’s top pair on Ethereum.
​
from
Int!
required
The unix timestamp for the start of the requested range.
​
to
Int!
required
The unix timestamp for the end of the requested range.
​
resolution
String!
required
The time frame for each candle. Available options are 1S, 5S, 15S, 30S, 1, 5, 15, 30, 60, 240, 720, 1D, 7D. Resolutions lower than 1 minute are only updated for the last 24 hours due to the volume of data produced.
​
currencyCode
String
The currency to use for the response. Can be USD or TOKEN. Default is USD. Use currencyCode: TOKEN for native token pricing.
​
removeLeadingNullValues
Boolean
Whether to remove leading null values from the response. Default is false. To fetch a token’s entire history, set resolution to 1D, from value to 0 and removeLeadingNullValues to true.
​
removeEmptyBars
Boolean
Whether to remove empty bars from the response. This is useful for eliminating gaps in low-activity tokens. Default is false.
​
quoteToken
QuoteToken
The token of interest within the token’s top pair. Can be token0 or token1. If omitted, the base token is inferred automatically. You can invert the pair by quoting the other token.
​
statsType
TokenPairStatisticsType
The type of statistics returned. Can be FILTERED or UNFILTERED. Default is UNFILTERED.
​
countback
Int
Guarantees number of bars returned is at most this number. Use countback: 1500 with from: 0 for maximum results.
​
symbolType
SymbolType
Specify the type of symbol you want to fetch values for. Can be TOKEN or POOL.

​
Schema

"""Returns bar chart data to track price changes over time."""
getBars(symbol: String!, from: Int!, to: Int!, resolution: String!, currencyCode: String, removeLeadingNullValues: Boolean, removeEmptyBars: Boolean, quoteToken: QuoteToken, statsType: TokenPairStatisticsType, countback: Int, symbolType: SymbolType): BarsResponse