docs: document the historical add-ons per chain, and what realtime actually holds - #253
Merged
Conversation
The pages a blocked user lands on did not answer the question they were blocked by. archive.md never mentioned that querying it needs anything, and realtime.md claimed a flat "past 8 hours approximately", which contradicts the per-cube retention matrix. The add-on list is taken from the products table rather than written from memory, so it is the real catalogue: - Ethereum, BSC, Base, Arbitrum, Optimism, Polygon, Tron and Robinhood each have Historical Trading Data and Historical Transfers + Balances + Holders. - Solana has Historical OHLCV & Token Price, and Historical Token Transfers & Balances. - Bitcoin, Bitcoin Cash, Litecoin, Dogecoin, Dash and Zcash each ship as Chain Data with history included. - Polymarket has Historical Data. Bundles cover all EVM chains, and all six UTXO chains. Cardano, Ripple, Stellar, Algorand, Filecoin, Avalanche, Celo, Cronos and Klaytn have no self-serve add-on at all -- historical access there is Enterprise. That distinction was not written down anywhere. archive.md now also quotes the exact rejection message, since it names the entitlement you are missing and therefore tells you which add-on to buy, and warns that archive is not deployed for every cube on every chain. realtime.md replaces the flat 8 hours with the real shape -- about 12 hours on Solana DEXTrades, 7 days on DEXTradeByTokens, a few days on the EVM cubes, 30 days on Trading -- and states the behaviour that generates most "the data is wrong" reports: realtime does not error past its window, it silently returns fewer rows. paid.md gains the same table, which closes the gap left when its add-on section listed only points, stream-minutes and stream data. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Left behind by #252 — pushed a few minutes after that merge landed. Cherry-picked onto the updated
main. Docs only, 3 files, no query or panel changes.Why
The pages a blocked user lands on did not answer the question they were blocked by.
archive.mdnever mentioned that querying the archive dataset needs anything at all.realtime.mdclaimed a flat "past 8 hours approximately", which contradicts the per-cube retention matrix.paid.md's add-on section listed only API points, stream-minutes and stream data.Meanwhile the support channel is full of
access restricted: your plan only allows "realtime"with no page to point at.The add-on catalogue, taken from the products table
Not written from memory — read out of
bitquery.products, so it is the real catalogue:Bundles cover every EVM chain in one purchase and all six UTXO chains in another.
Cardano, Ripple, Stellar, Algorand, Filecoin, Avalanche, Celo, Cronos and Klaytn have no self-serve add-on — historical access there is Enterprise. Verified with a direct query for those chains, which returns nothing, rather than by inferring from a list. That distinction was not written down anywhere.
Also
archive.mdquotes the exact rejection message, because it names the entitlement you are missing and therefore tells you which add-on to buy. It also warns that archive is not deployed for every cube on every chain, sono table can query <Cube>is not a problem with your query.realtime.mdreplaces the flat 8 hours with the real shape — roughly 12 hours on SolanaDEXTrades, 7 days onDEXTradeByTokens, a few days on the EVM cubes, about 30 days onTrading— and states the behaviour behind most "the data is wrong" reports: realtime does not error past its window, it silently returns fewer rows.Production build passes with no warnings.
🤖 Generated with Claude Code