Usage Guidelines
- Maximum datapoints: 1500 per request
- Use
countback: 1500withfrom: 0for maximum results - Add
removeEmptyBars: trueto 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
circulatingSupplyfromEnhancedToken - For volume, be sure to use
volumeinstead ofv. Due to large volume numbers exceeding max integer lengths, we needed to deprecatevin place ofvolume.
Troubleshooting Tips
When should I use getBars vs getTokenBars?
When should I use getBars vs getTokenBars?
Use
getBars when you want price data for a specific trading pair. Use getTokenBars when you want aggregate price data for a token across all its trading pairs — it uses weighted average pricing based on liquidity.Wrong or inconsistent base token in pair (Token0 vs Token1)
Wrong or inconsistent base token in pair (Token0 vs Token1)
Omit
quoteToken parameter to auto-detect the correct base token of the pair automatically.Null or empty values returned
Null or empty values returned
-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
-Ensure the token has started trading (we do not index tokens until trades occur)
-Use
removeLeadingNullValues: trueSome BSC tokens return stale or incorrect data, such as '0' Volume
Some BSC tokens return stale or incorrect data, such as '0' Volume
Add
symbolType: Token to your query. This is a common issue with four.meme tokens as their pair and token address is the same.Integrating data with TradingView
Integrating data with TradingView
Our API fits right into TradingView’s library. You can find docs for integrating with TradingView at https://www.tradingview.com/free-charting-libraries/.
Updating charts in real-time
Updating charts in real-time
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.Incorrect values or errors returned with resolutions under 1m
Incorrect values or errors returned with resolutions under 1m
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.