diff --git a/README.md b/README.md index 3612ca57..e768c77b 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Bitquery Data Platform Documentation -This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator. +This website is built using [Docusaurus 3](https://docusaurus.io/), a modern static website generator. ### Installation @@ -54,4 +54,4 @@ npx docusaurus-prince-pdf -u http://localhost:3000/docs/intro ### Contributing to Docs -Read contribution guidlines [here](https://docs.bitquery.io/docs/contribution_guidelines) \ No newline at end of file +Read contribution guidlines [here](https://docs.bitquery.io/docs/contribution-guidelines) \ No newline at end of file diff --git a/blog/2024-02-17-schema-changes copy.md b/blog/2024-02-17-schema-changes copy.md deleted file mode 100644 index 6151f73c..00000000 --- a/blog/2024-02-17-schema-changes copy.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -slug: schema-changes -title: Schema changed for Transaction_Time mempool and default settings to query blocks and trigger_on -authors: [astudnev] -tags: [new capability] ---- - - - -# Changes in API Schema - -The following changes applied to the schema: - -1. ```trigger_on``` attribute for subscription default value set now to ```all```. -2```Transaction_Time``` field for mempool ```Transaction``` now returns the transaction time not in numeric, but in ISO8601 format up to 1 nanosecond ( 9 digits after the seconds ), - -```"2006-01-02T15:04:05.999999999Z"``` diff --git a/docs/API-Blog/migrate-v1-v2.md b/docs/API-Blog/migrate-v1-v2.md index 153897b4..9de6204a 100644 --- a/docs/API-Blog/migrate-v1-v2.md +++ b/docs/API-Blog/migrate-v1-v2.md @@ -1,7 +1,8 @@ --- sidebar_position: 3 +title: "Migrate from Bitquery API v1 to v2" +description: "Migrate Bitquery GraphQL apps from API v1 to v2 covering schema changes, streaming datasets, authentication updates, and code examples." --- - # Migrating from API v1 to v2 ## Overview @@ -13,7 +14,7 @@ Below, you'll find key changes and instructions on how to adapt your existing v1 One of the major differences between v1 and v2 is the way API is authenticated. In v1, you use a API-KEY to authenticate your requests to `graphql.bitquery.io`. -And in v2, you use OAuth token mentioned as `Bearer ory_...yourtoken` and authenticate your requests to `streaming.bitquery.io/graphql`. Read more on how to generate token [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/). +And in v2, you use OAuth token mentioned as `Bearer ory_...yourtoken` and authenticate your requests to `streaming.bitquery.io/graphql`. Read more on how to generate token [here](/docs/authorization/how-to-generate/). ## Changes in Network Specification @@ -51,9 +52,9 @@ The v2 API maintains a similar schema structure but integrates new data cubes su If you're new to v2, check more examples on: -[TokenHolder APIs](https://docs.bitquery.io/docs/examples/token-holders/token-holder-api/) -[balanceUpdates](https://docs.bitquery.io/docs/examples/balances/balance-api/) -[DexTradeByTokens](https://docs.bitquery.io/docs/examples/dextrades/token-trades-apis/) +[TokenHolder APIs](/docs/blockchain/Ethereum/token-holders/token-holder-api/) +[balanceUpdates](/docs/blockchain/Ethereum/balances/balance-api/) +[DexTradeByTokens](/docs/blockchain/Ethereum/dextrades/token-trades-apis/) ## Smart Contract Interactions @@ -253,4 +254,4 @@ To find your Bitquery API v1 key, log in to your [Bitquery account](https://acco ## V1 vs V2 : Data Points -![](/img/v1v2.png) \ No newline at end of file +![](/img/v1v2.png) diff --git a/docs/API-Blog/polymarket-api-vs-bitquery-polymarket-api.md b/docs/API-Blog/polymarket-api-vs-bitquery-polymarket-api.md index 048b92aa..f3cbd17c 100644 --- a/docs/API-Blog/polymarket-api-vs-bitquery-polymarket-api.md +++ b/docs/API-Blog/polymarket-api-vs-bitquery-polymarket-api.md @@ -1,7 +1,6 @@ --- -title: "Polymarket API vs Bitquery Polymarket API: Which One Should You Use?" -description: - "A side-by-side comparison of Polymarket's official APIs (CLOB, Gamma, Data, Real-Time Data Socket) and Bitquery's on-chain Polymarket API (GraphQL queries, subscriptions, and Kafka streams on Polygon)." +title: "Polymarket API Vs Bitquery Polymarket" +description: "Polymarket API Vs Bitquery Polymarket: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." keywords: - Polymarket API - Bitquery Polymarket API @@ -13,7 +12,6 @@ keywords: - Polymarket websocket - on-chain prediction markets --- - # Polymarket API vs Bitquery Polymarket API If you are building on Polymarket—whether a dashboard, a trading bot, a research tool, or a wallet leaderboard—you have two very different data stacks to choose from. Polymarket publishes a set of **official REST and WebSocket APIs** that serve the [polymarket.com](https://polymarket.com) application itself. Bitquery offers an **on-chain-derived GraphQL API** for the same Polymarket markets on Polygon, plus subscriptions and Kafka streams. @@ -48,20 +46,20 @@ Bitquery takes a different approach. It indexes the Polymarket contracts on Poly The pages under **`docs/examples/polymarket-api/`** in this repo correspond to these guides: -- [Polymarket API overview](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-api/): the entry point, covering the core PredictionTrades query, live subscriptions, whale trades, and top buyers and sellers. -- [Polymarket Markets API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-markets-api/): filter markets by market_slug, condition_id, or token_id through PredictionManagements. -- [Polymarket Wallet & User Activity API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-wallet-api/): recent trade counts, collateral totals, and distinct-market counts for any wallet, plus guidance on which fields belong to Polymarket's Profile, Gamma, or Bridge APIs. -- [Polymarket Advanced Analytics API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-advanced-analytics-api/): USDC TVL in core contracts, daily volume, maker/taker splits, order flow by market, whale subscriptions, settlement flows, and top markets by volume. -- [Polymarket Sports API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-sports-api/): cricket, sports, and esports markets filtered by ResolutionSource, description, or outcome label. -- [Polymarket Commodity API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-commodity-api/): oil, gold, and commodity-linked prediction markets. -- [Bitcoin Up or Down Polymarket API](https://docs.bitquery.io/docs/examples/polymarket-api/bitcoin-polymarket-api/): BTC direction markets, live odds, and top winners from settlements. -- [Polymarket Wallet Realized PnL](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-wallet-realized-pnl/): PnL derived from on-chain fills. +- [Polymarket API overview](/docs/examples/polymarket-api/polymarket-api/): the entry point, covering the core PredictionTrades query, live subscriptions, whale trades, and top buyers and sellers. +- [Polymarket Markets API](/docs/examples/polymarket-api/polymarket-markets-api/): filter markets by market_slug, condition_id, or token_id through PredictionManagements. +- [Polymarket Wallet & User Activity API](/docs/examples/polymarket-api/polymarket-wallet-api/): recent trade counts, collateral totals, and distinct-market counts for any wallet, plus guidance on which fields belong to Polymarket's Profile, Gamma, or Bridge APIs. +- [Polymarket Advanced Analytics API](/docs/examples/polymarket-api/polymarket-advanced-analytics-api/): USDC TVL in core contracts, daily volume, maker/taker splits, order flow by market, whale subscriptions, settlement flows, and top markets by volume. +- [Polymarket Sports API](/docs/examples/polymarket-api/polymarket-sports-api/): cricket, sports, and esports markets filtered by ResolutionSource, description, or outcome label. +- [Polymarket Commodity API](/docs/examples/polymarket-api/polymarket-commodity-api/): oil, gold, and commodity-linked prediction markets. +- [Bitcoin Up or Down Polymarket API](/docs/examples/polymarket-api/bitcoin-polymarket-api/): BTC direction markets, live odds, and top winners from settlements. +- [Polymarket Wallet Realized PnL](/docs/examples/polymarket-api/polymarket-wallet-realized-pnl/): PnL derived from on-chain fills. Underneath, Bitquery's primary operations are PredictionTrades (buys and sells with buyer, seller, amount, price, USD-denominated collateral, and full market metadata), PredictionManagements (creation, resolution, and other lifecycle events), and PredictionSettlements (splits, merges, redemptions). Each can be run as a query for history or as a subscription for live streaming; swapping the single keyword is the only change required. For low-latency pipelines, Bitquery also publishes Kafka topics matic.predictions.proto and matic.broadcasted.predictions.proto (mempool), which require separate credentials. Because everything is GraphQL, aggregations, limitBy, orderBy: descendingByField, and computed expressions (e.g. `calculate(expression: "$buyUSD + $sellUSD")`) are first-class. That is what makes queries like "top 100 Polymarket markets by volume over a window" or "all whale trades above $10k across Polymarket in real time" one query instead of a client-side batch job over the CLOB. -The one caveat is retention on the live endpoint: dataset: realtime holds roughly the **last 7 days**. For longer windows, a **full historical dataset is available via [Bitquery Cloud](https://docs.bitquery.io/docs/cloud/) on request**, with no need to self-persist the stream. +The one caveat is retention on the live endpoint: dataset: realtime holds roughly the **last 7 days**. For longer windows, a **full historical dataset is available via [Bitquery Cloud](/docs/cloud/) on request**, with no need to self-persist the stream. ## Side-by-side comparison @@ -70,17 +68,17 @@ The one caveat is retention on the live endpoint: dataset: realtime holds roughl | **Place orders** | Yes, via CLOB /order with signed requests | No (read-only) | | **Live order book (bids/asks/depth)** | Yes, via CLOB REST + WS market channel | No; trades and settlements, not the L2 book | | **Event, market, tag, series metadata** | Yes, via Gamma API, canonical | Partial: market ID, question, outcomes, condition ID, resolution source (on-chain derived) | -| **User positions / PnL** | Yes, via Data API /positions | Derivable from trades + settlements; [realized PnL example](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-wallet-realized-pnl/) | -| **User activity feed** | Yes, via Data API /activity | Yes, via [Wallet API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-wallet-api/) | +| **User positions / PnL** | Yes, via Data API /positions | Derivable from trades + settlements; [realized PnL example](/docs/examples/polymarket-api/polymarket-wallet-realized-pnl/) | +| **User activity feed** | Yes, via Data API /activity | Yes, via [Wallet API](/docs/examples/polymarket-api/polymarket-wallet-api/) | | **Price history per token** | Yes, via CLOB /prices-history | Yes, via PredictionTrades with time filter | | **On-chain fields** (tx hash, block time, log signatures, condition ID events) | Limited | Yes, native on every row | | **Aggregations** (top N markets by volume, top wallets, maker/taker split) | Client-side | Native GraphQL: sum, count(distinct:), limitBy, orderBy: descendingByField | -| **Whale trade filtering across all markets** | Manual | One subscription; see the [whale trades example](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-api/) | +| **Whale trade filtering across all markets** | Manual | One subscription; see the [whale trades example](/docs/examples/polymarket-api/polymarket-api/) | | **Real-time streaming** | WebSocket (ws-subscriptions-clob, ws-live-data), cannot unsubscribe, some filter gaps | GraphQL subscriptions plus Kafka matic.predictions.proto | -| **Settlement (split / merge / redeem) analytics** | Indirect | Native; see [Advanced Analytics](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-advanced-analytics-api/) | -| **Cross-market vertical APIs** (sports, commodity, BTC up/down) | Filter manually on Gamma | Purpose-built: [Sports](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-sports-api/), [Commodity](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-commodity-api/), [Bitcoin Up or Down](https://docs.bitquery.io/docs/examples/polymarket-api/bitcoin-polymarket-api/) | +| **Settlement (split / merge / redeem) analytics** | Indirect | Native; see [Advanced Analytics](/docs/examples/polymarket-api/polymarket-advanced-analytics-api/) | +| **Cross-market vertical APIs** (sports, commodity, BTC up/down) | Filter manually on Gamma | Purpose-built: [Sports](/docs/examples/polymarket-api/polymarket-sports-api/), [Commodity](/docs/examples/polymarket-api/polymarket-commodity-api/), [Bitcoin Up or Down](/docs/examples/polymarket-api/bitcoin-polymarket-api/) | | **TVL / USDC custody balances** | Not exposed | Yes, via TransactionBalances on Conditional Tokens + neg-risk collateral | -| **Historical depth** | Full CLOB history | realtime dataset ~last 7 days; full historical dataset available via [Bitquery Cloud](https://docs.bitquery.io/docs/cloud/) on request | +| **Historical depth** | Full CLOB history | realtime dataset ~last 7 days; full historical dataset available via [Bitquery Cloud](/docs/cloud/) on request | | **Auth** | API-key + HMAC-SHA256 (CLOB); none (Gamma) | Bitquery API token; Kafka requires separate creds | | **Rate limits** | 4,000/10s (Gamma), ~10 orders/sec (CLOB) | No data or rate limits on streams; Kafka for enterprise streaming and scaling to 1,000+ simultaneous users | @@ -125,10 +123,10 @@ A reasonable production architecture looks like this: If you are new to Bitquery's Polymarket coverage, four queries exercise most of the surface area: -1. The basic recent-trades query from the [Polymarket API overview](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-api/), which confirms your API token and shows the shape of a PredictionTrade. +1. The basic recent-trades query from the [Polymarket API overview](/docs/examples/polymarket-api/polymarket-api/), which confirms your API token and shows the shape of a PredictionTrade. 2. The volume-ranking query from the same doc, which demonstrates limitBy, orderBy: descendingByField, and the computed sumBuyAndSell expression. 3. A live whale-trade subscription: swap the query keyword for subscription and filter on `CollateralAmountInUSD: { gt: "10000" }` to push events as they happen. -4. The daily volume and maker/taker split from the [Advanced Analytics page](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-advanced-analytics-api/), which shows how far GraphQL takes you before any client-side aggregation is required. +4. The daily volume and maker/taker split from the [Advanced Analytics page](/docs/examples/polymarket-api/polymarket-advanced-analytics-api/), which shows how far GraphQL takes you before any client-side aggregation is required. All of these are runnable from the Bitquery IDE (linked inline from each docs page) before you ever issue an API token. @@ -144,19 +142,19 @@ The two APIs are not rivals; they answer different questions. The official Polym Canonical Bitquery Polymarket references: -- [Polymarket API, Trade, Prices & Market Data](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-api/) -- [Polymarket Markets API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-markets-api/) for CTF Exchange, condition_id, and token_id lookups -- [Polymarket Wallet & User Activity API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-wallet-api/) -- [Polymarket Advanced Analytics API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-advanced-analytics-api/) +- [Polymarket API, Trade, Prices & Market Data](/docs/examples/polymarket-api/polymarket-api/) +- [Polymarket Markets API](/docs/examples/polymarket-api/polymarket-markets-api/) for CTF Exchange, condition_id, and token_id lookups +- [Polymarket Wallet & User Activity API](/docs/examples/polymarket-api/polymarket-wallet-api/) +- [Polymarket Advanced Analytics API](/docs/examples/polymarket-api/polymarket-advanced-analytics-api/) Vertical guides: -- [Polymarket Sports API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-sports-api/) -- [Polymarket Commodity API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-commodity-api/) -- [Bitcoin Up or Down Polymarket API](https://docs.bitquery.io/docs/examples/polymarket-api/bitcoin-polymarket-api/) -- [Polymarket Wallet Realized PnL](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-wallet-realized-pnl/) +- [Polymarket Sports API](/docs/examples/polymarket-api/polymarket-sports-api/) +- [Polymarket Commodity API](/docs/examples/polymarket-api/polymarket-commodity-api/) +- [Bitcoin Up or Down Polymarket API](/docs/examples/polymarket-api/bitcoin-polymarket-api/) +- [Polymarket Wallet Realized PnL](/docs/examples/polymarket-api/polymarket-wallet-realized-pnl/) Infrastructure and live reference: -- [Kafka Streaming Concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) +- [Kafka Streaming Concepts](/docs/streams/kafka-streaming-concepts/) - [DexRabbit Polymarket Predictions dashboard](https://dexrabbit.bitquery.io/polymarket-predictions) diff --git a/docs/API-Blog/slippage-faq-using-dexpool-stream.md b/docs/API-Blog/slippage-faq-using-dexpool-stream.md index 4516885c..0327f06b 100644 --- a/docs/API-Blog/slippage-faq-using-dexpool-stream.md +++ b/docs/API-Blog/slippage-faq-using-dexpool-stream.md @@ -1,6 +1,6 @@ --- -title: "Slippage FAQ: Calculating Necessary Slippage for DEX Swaps Using Bitquery DEXPool Stream" -description: "FAQ answering developer questions about calculating necessary slippage before executing DEX swaps from smart contracts. Learn how to use Bitquery DEXPool stream data to programmatically determine slippage tolerance instead of guessing or trial-and-error." +title: "Slippage Faq Using Dexpool Stream" +description: "Slippage Faq Using Dexpool Stream: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." keywords: - slippage calculation - DEX slippage @@ -13,7 +13,6 @@ keywords: - swapExactTokensForTokens - removeLiquidity --- - # Slippage FAQ: Calculating Necessary Slippage for DEX Swaps Using Bitquery DEXPool Stream This FAQ addresses common developer questions about calculating necessary slippage before executing swaps or withdrawing liquidity on DEXs from smart contracts. Instead of guessing or using trial-and-error, you can use Bitquery's DEXPool stream data to programmatically determine the appropriate slippage tolerance. @@ -544,7 +543,7 @@ Subscribe to DEXPool stream updates for your target pool. When you see `Liquidit ## Additional Resources -- [DEXPools Cube Documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/) - Complete guide to DEXPool data structure and concepts +- [DEXPools Cube Documentation](/docs/cubes/evm-dexpool/) - Complete guide to DEXPool data structure and concepts - [Bitquery IDE](https://ide.bitquery.io/) - Query DEXPool data in real-time - [Kafka Data Samples](https://github.com/bitquery/kafka-data-sample/blob/main/evm/eth_dexpools.json) - Sample DEXPool stream data structure -- [EVM DEXPool Stream Documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/) - Understanding when DEXPool records are emitted +- [EVM DEXPool Stream Documentation](/docs/cubes/evm-dexpool/) - Understanding when DEXPool records are emitted diff --git a/docs/API-Blog/track-token-lock-unlock.md b/docs/API-Blog/track-token-lock-unlock.md index 987b915e..fa98c075 100644 --- a/docs/API-Blog/track-token-lock-unlock.md +++ b/docs/API-Blog/track-token-lock-unlock.md @@ -1,7 +1,8 @@ --- sidebar_position: 2 +title: "Track Token Lock Unlock" +description: "Track Token Lock Unlock: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance. Keep queries fast with indexed filters." --- - # How to Easily Track Token Lock and Unlock Events Using Bitquery APIs In this article, we are going to understand why tracking token lock and unlock events is necessary for investors and project teams in the quickly changing crypto space. @@ -228,8 +229,7 @@ subscription { This subscription query tracks transactions that signal token unlocks, providing details about the dates, transaction hash, gas price, and gas used. It helps in predicting when tokens will become available for trading. 4. Set Up Notifications -[Create notifications to alert](https://docs.bitquery.io/docs/usecases/monitoring-solana-blockchain-real-time-tutorial/) you when tokens are about to be unlocked. You can use email alerts, websockets, or messaging platforms like Slack. Setting up notifications ensures you stay informed about important events and can react promptly to market changes. - +[Create notifications to alert](/docs/usecases/monitoring-solana-blockchain-real-time-tutorial/) you when tokens are about to be unlocked. You can use email alerts, websockets, or messaging platforms like Slack. Setting up notifications ensures you stay informed about important events and can react promptly to market changes. ### Tracking Token Lock/ Unlock Without Knowing Log Signatures @@ -305,8 +305,6 @@ query ($network: evm_network, $limit: Int, $method: String) { } ``` - - ### Solana Token Unlock Schedule Solana, known for its fast and cheap transactions, has important token unlock events. Tracking these can help understand its market dynamics and potential price movements. You can run the query [here](https://ide.bitquery.io/Solana-Token) diff --git a/docs/API-Blog/use-regular-expressions-to-search-solana-logs.md b/docs/API-Blog/use-regular-expressions-to-search-solana-logs.md index 9d113167..3ab82178 100644 --- a/docs/API-Blog/use-regular-expressions-to-search-solana-logs.md +++ b/docs/API-Blog/use-regular-expressions-to-search-solana-logs.md @@ -1,7 +1,8 @@ --- sidebar_position: 1 +title: "Use Regular Expressions To Search Solana Logs" +description: "Use Regular Expressions To Search Solana Logs: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." --- - # How to Filter Events from Solana Logs Using Bitquery APIs and Regular Expressions In this article, we are going to understand how we can track events like token lock and burn, which are necessary for investors and project teams in the quickly changing crypto space. @@ -180,4 +181,3 @@ query { This query will return the Solana Instructions Logs and transaction signature to double check the results and get more info. - diff --git a/docs/API-Blog/what-are-internal-transactions-how-to-get-them.md b/docs/API-Blog/what-are-internal-transactions-how-to-get-them.md index 05da0e41..7c58ba81 100644 --- a/docs/API-Blog/what-are-internal-transactions-how-to-get-them.md +++ b/docs/API-Blog/what-are-internal-transactions-how-to-get-them.md @@ -1,3 +1,7 @@ +--- +title: "What are Internal Transactions & How to Get Them?" +description: "What are Internal Transactions & How to Get Them?: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." +--- import FAQ from "@site/src/components/FAQ"; # What are Internal Transactions & How to Get Them? diff --git a/docs/api-comparison.md b/docs/api-comparison.md index 132fe827..8ffb7288 100644 --- a/docs/api-comparison.md +++ b/docs/api-comparison.md @@ -1,11 +1,12 @@ --- sidebar_position: 1 +title: "Bitquery API Product Comparison" +description: "API Comparison: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance. Great for bots, dashboards, and alerts." --- - # API Comparison :::tip Looking specifically for trading / DEX data? -This page compares **delivery methods** (GraphQL Query vs Subscription vs Kafka). For the **trading-data product choice** (chain-level `DEXTrades` / `DEXTradeByTokens` vs the curated `Trading` cube), see the dedicated [**Trading Data Overview**](https://docs.bitquery.io/docs/trading/trading-data-overview). +This page compares **delivery methods** (GraphQL Query vs Subscription vs Kafka). For the **trading-data product choice** (chain-level `DEXTrades` / `DEXTradeByTokens` vs the curated `Trading` cube), see the dedicated [**Trading Data Overview**](/docs/trading/trading-data-overview). ::: To choose the right Bitquery API offering, it helps to understand their differences. The table below summarizes key features and capabilities of GraphQL Query vs GraphQL Subscription vs Kafka Streams: @@ -54,4 +55,4 @@ Pick Queries for flexibility and history, Subscriptions for easy real-time UI fe ## How do I specify dataset: realtime vs archive in an API v1 query? -This site documents **API V2** GraphQL, where you set **`dataset`** on the root field (for example **`EVM(dataset: archive)`** or **`Solana(dataset: combined)`**)—see [Dataset options](https://docs.bitquery.io/docs/graphql/dataset/options). **API V1** uses a **different endpoint and schema**; realtime/archive semantics are **not** expressed the same way. For V1 query shapes and examples, use **[Bitquery V1 documentation](https://docs.bitquery.io/v1/)** and the [V1 examples catalog](https://docs.bitquery.io/v1/docs/category/examples). +This site documents **API V2** GraphQL, where you set **`dataset`** on the root field (for example **`EVM(dataset: archive)`** or **`Solana(dataset: combined)`**)—see [Dataset options](/docs/graphql/dataset/options). **API V1** uses a **different endpoint and schema**; realtime/archive semantics are **not** expressed the same way. For V1 query shapes and examples, use **[Bitquery V1 documentation](https://docs.bitquery.io/v1/)** and the [V1 examples catalog](https://docs.bitquery.io/v1/docs/category/examples). diff --git a/docs/authorisation/_category_.json b/docs/authorisation/_category_.json deleted file mode 100644 index 7e4cfb1a..00000000 --- a/docs/authorisation/_category_.json +++ /dev/null @@ -1,8 +0,0 @@ -{ - "label": "Authorization", - "position": 2, - "link": { - "type": "generated-index", - "description": "Using the APIs in Application" - } -} diff --git a/docs/authorization/_category_.json b/docs/authorization/_category_.json new file mode 100644 index 00000000..91fcdd61 --- /dev/null +++ b/docs/authorization/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Authorization", + "position": 2, + "link": { + "type": "doc", + "id": "authorization/how-to-generate" + } +} diff --git a/docs/authorisation/how-to-generate.md b/docs/authorization/how-to-generate.md similarity index 97% rename from docs/authorisation/how-to-generate.md rename to docs/authorization/how-to-generate.md index 2bf5985f..a8c55a79 100644 --- a/docs/authorisation/how-to-generate.md +++ b/docs/authorization/how-to-generate.md @@ -1,7 +1,8 @@ --- sidebar_position: 1 +title: "Generate a Bitquery API Token" +description: "Generate a Bitquery API Token in Bitquery docs with practical setup steps, examples, and guidance for secure API access." --- - # How to Generate a Token In this section, we will see how OAuth is used to generate a token. @@ -108,7 +109,6 @@ Ensure that `scope=api` is mentioned in the payload, import requests import json - def oAuth_example(): url = "https://oauth2.bitquery.io/oauth2/token" @@ -130,7 +130,6 @@ def oAuth_example(): //use the token to send a request - oAuth_example() ``` diff --git a/docs/authorisation/how-to-use.md b/docs/authorization/how-to-use.md similarity index 69% rename from docs/authorisation/how-to-use.md rename to docs/authorization/how-to-use.md index e8c7b064..4ce2e063 100644 --- a/docs/authorisation/how-to-use.md +++ b/docs/authorization/how-to-use.md @@ -1,20 +1,9 @@ --- title: "How to Use Bitquery API Token - Authorization Examples" -description: "Use your Bitquery OAuth token in API requests: header Bearer token or URL token parameter. Python, JavaScript, and cURL examples for streaming.bitquery.io." +description: "How to Use Bitquery API Token - Authorization Examples in Bitquery docs with practical setup steps, examples, and guidance for secure API access." sidebar_position: 2 keywords: ["Bitquery API token", "Bitquery authorization", "OAuth token usage", "Bearer token", "API authentication"] --- - - - - - - - - - - - # How to Use a Token Regardless of how you obtain your token, whether generated directly in the IDE or using a client ID-secret combination, the process for using the token remains consistent. @@ -24,7 +13,7 @@ Regardless of how you obtain your token, whether generated directly in the IDE o - You attach the token in the URL `https://streaming.bitquery.io/graphql?token=ory_at_...` -For the `wss` endpoint, the 2nd method is the only way, read more [here](https://docs.bitquery.io/docs/authorisation/websocket/) +For the `wss` endpoint, the 2nd method is the only way, read more [here](/docs/authorization/websocket/) Below is an example in Python that mentions the token in the header. @@ -32,12 +21,10 @@ Below is an example in Python that mentions the token in the header. import requests import json - def oAuth_example(): //access_token generated using either of the two approaches - # Step 2: Make Streaming API query url_graphql = "https://streaming.bitquery.io/graphql" headers_graphql = { @@ -81,7 +68,6 @@ def oAuth_example(): # Print the response print(response_graphql.text) - oAuth_example() ``` diff --git a/docs/authorisation/usage-api.md b/docs/authorization/usage-api.md similarity index 86% rename from docs/authorisation/usage-api.md rename to docs/authorization/usage-api.md index 875bfe14..da445636 100644 --- a/docs/authorisation/usage-api.md +++ b/docs/authorization/usage-api.md @@ -1,25 +1,14 @@ --- title: "Usage API - Track Billing and Quota Programmatically" -description: "OAuth2-authenticated Usage API on account.bitquery.io. Check billing period, plan limits, and current usage with GET /api/usage." +description: "Usage API - Track Billing and Quota Programmatically in Bitquery docs with practical setup steps, examples, and guidance for secure API access." sidebar_position: 4 keywords: ["Bitquery Usage API", "Bitquery billing API", "API quota", "OAuth2", "account.bitquery.io", "usage tracking"] --- - - - - - - - - - - - # Usage API The **Usage API** exposes OAuth2-authenticated endpoints on [account.bitquery.io](https://account.bitquery.io/) so you can **programmatically track billing period status, plan limits, and consumption** for your Bitquery account. -Open the interactive reference and copy a bearer token from **[Authorization → Usage API](https://account.bitquery.io/user/api)**. To create or manage tokens, see [How to Generate a Token](/docs/authorisation/how-to-generate/). +Open the interactive reference and copy a bearer token from **[Authorization → Usage API](https://account.bitquery.io/user/api)**. To create or manage tokens, see [How to Generate a Token](/docs/authorization/how-to-generate/). :::caution Keep your token secret Authenticate every request with your account bearer token in the `Authorization` header. The token identifies your account — do not expose it in client-side code, public repos, or logs. diff --git a/docs/authorisation/websocket.md b/docs/authorization/websocket.md similarity index 71% rename from docs/authorisation/websocket.md rename to docs/authorization/websocket.md index dce41aba..b8ec488d 100644 --- a/docs/authorisation/websocket.md +++ b/docs/authorization/websocket.md @@ -1,7 +1,8 @@ --- sidebar_position: 3 +title: "Authenticate Bitquery WebSockets" +description: "Authenticate Bitquery WebSockets in Bitquery docs with practical setup steps, examples, and guidance for secure API access." --- - # Authenticating Websockets When it comes to authenticating websockets the token can be included only in the following manner: @@ -14,4 +15,4 @@ Content-Type: application/json ``` -Refer this [this](https://www.postman.com/interstellar-eclipse-270749/workspace/bitquery/ws-raw-request/659811c95188ca95c7b9e569?action=share&creator=27392958&ctx=documentation) link for postman example of how to use OAuth with websockets. \ No newline at end of file +Refer this [this](https://www.postman.com/interstellar-eclipse-270749/workspace/bitquery/ws-raw-request/659811c95188ca95c7b9e569?action=share&creator=27392958&ctx=documentation) link for postman example of how to use OAuth with websockets. diff --git a/docs/blockchain/Algorand/algorand-address-api.md b/docs/blockchain/Algorand/algorand-address-api.md index 0650ec0f..ff316648 100644 --- a/docs/blockchain/Algorand/algorand-address-api.md +++ b/docs/blockchain/Algorand/algorand-address-api.md @@ -1,7 +1,7 @@ --- -title: Algorand Address API - Get ALGO Balances & Smart Contract Bytecode +title: "Algorand Address API" sidebar_label: Algorand Address API -description: Query Algorand address balances for ALGO, look up multiple addresses in one request, and retrieve smart contract bytecode and source via Bitquery GraphQL. +description: "Algorand Address API: query and stream Algorand on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." keywords: - Algorand address API - Algorand balance API @@ -10,7 +10,6 @@ keywords: - Algorand GraphQL - Bitquery Algorand --- - # Algorand Address API The Address API gives you native ALGO balances for one or many accounts, plus smart contract details — bytecode and source — for application addresses. Use it for wallet dashboards, treasury monitoring, and inspecting on-chain program code without running your own indexer. @@ -79,5 +78,5 @@ Returns the bytecode and source of an Algorand application address. Add the `bal ## Related resources -- [Algorand Transfers API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-transfers-api) — ALGO and ASA transfer history per address -- [Algorand Coinpath API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-coinpath-api) — multi-hop fund flow tracing +- [Algorand Transfers API](/docs/blockchain/Algorand/algorand-transfers-api) — ALGO and ASA transfer history per address +- [Algorand Coinpath API](/docs/blockchain/Algorand/algorand-coinpath-api) — multi-hop fund flow tracing diff --git a/docs/blockchain/Algorand/algorand-arguments-api.md b/docs/blockchain/Algorand/algorand-arguments-api.md index a0a6873a..70ae6448 100644 --- a/docs/blockchain/Algorand/algorand-arguments-api.md +++ b/docs/blockchain/Algorand/algorand-arguments-api.md @@ -1,7 +1,7 @@ --- -title: Algorand Arguments API - Parsed Smart Contract Call & Event Arguments +title: "Algorand Arguments API" sidebar_label: Algorand Arguments API -description: Query parsed argument names, types, and values from Algorand smart contract calls and events. Filter by contract address, transaction type, or argument value via Bitquery GraphQL. +description: "Algorand Arguments API: query and stream Algorand on-chain data with Bitquery GraphQL examples for developers. Covers archive history and realtime data." keywords: - Algorand arguments API - Algorand smart contract arguments @@ -10,7 +10,6 @@ keywords: - Algorand event arguments - Bitquery Algorand --- - # Algorand Arguments API When Bitquery parses an Algorand smart contract call or event, the Arguments API exposes each argument's index, type, and value alongside transaction and block context. Use it to inspect app call payloads, filter calls by specific argument values, or build dashboards around on-chain program activity. @@ -83,5 +82,5 @@ Narrow results to a specific application. You can also filter by `txType`, `txHa ## Related resources -- [Algorand Smart Contract Calls API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-smart-contract-calls-api) — call counts and transaction-type filters -- [Algorand Transactions API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-transactions-api) — full transaction details and hash lookups +- [Algorand Smart Contract Calls API](/docs/blockchain/Algorand/algorand-smart-contract-calls-api) — call counts and transaction-type filters +- [Algorand Transactions API](/docs/blockchain/Algorand/algorand-transactions-api) — full transaction details and hash lookups diff --git a/docs/blockchain/Algorand/algorand-blocks-api.md b/docs/blockchain/Algorand/algorand-blocks-api.md index 888622f8..e5385117 100644 --- a/docs/blockchain/Algorand/algorand-blocks-api.md +++ b/docs/blockchain/Algorand/algorand-blocks-api.md @@ -1,7 +1,7 @@ --- -title: Algorand Blocks API - Query Blocks by Proposer, Height & Rewards +title: "Algorand Blocks API - Query Blocks by Proposer" sidebar_label: Algorand Blocks API -description: Pull Algorand blocks with proposer, height, protocol version, rewards, and timestamps via Bitquery's GraphQL Blocks API. Build explorer features and staking analytics. +description: "Algorand Blocks API - Query Blocks by Proposer: query and stream Algorand on-chain data with Bitquery GraphQL examples for developers." keywords: - Algorand blocks API - Algorand block explorer API @@ -11,7 +11,6 @@ keywords: - Algorand block height query - Bitquery Algorand --- - # Algorand Blocks API The Blocks API returns block-level data on Algorand: height, hash, protocol version, proposer, seed, reward, and timestamp. Use it to drive explorer front-ends, monitor chain progression, track validator participation, or aggregate block rewards over time. @@ -68,5 +67,5 @@ Aggregates total block rewards for a proposer address. Add a `date` filter to li ## Related resources -- [Algorand Transactions API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-transactions-api) — per-block transaction details and daily counts -- [Algorand Address API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-address-api) — proposer and wallet balances +- [Algorand Transactions API](/docs/blockchain/Algorand/algorand-transactions-api) — per-block transaction details and daily counts +- [Algorand Address API](/docs/blockchain/Algorand/algorand-address-api) — proposer and wallet balances diff --git a/docs/blockchain/Algorand/algorand-coinpath-api.md b/docs/blockchain/Algorand/algorand-coinpath-api.md index 12b53c72..728ea016 100644 --- a/docs/blockchain/Algorand/algorand-coinpath-api.md +++ b/docs/blockchain/Algorand/algorand-coinpath-api.md @@ -1,7 +1,7 @@ --- -title: Algorand Coinpath API - Trace ALGO & ASA Flows Across Addresses +title: "Algorand Coinpath API" sidebar_label: Algorand Coinpath API -description: Trace Algorand fund flows between addresses with Bitquery Coinpath. Track outbound and inbound paths, hop depth, amounts, and transaction counts for AML and forensics. +description: "Algorand Coinpath API: query and stream Algorand on-chain data with Bitquery GraphQL examples for developers. Built for traders and analytics teams." keywords: - Algorand coinpath API - Algorand fund tracing @@ -12,7 +12,6 @@ keywords: - Algorand GraphQL - Bitquery Algorand --- - # Algorand Coinpath API Coinpath walks ALGO and ASA flows between Algorand addresses — forward to see where funds went, backward to see where they came from. The API returns senders, receivers, hop depth, amounts, currency metadata, and transaction details at each level. Common use cases: AML screening, treasury audits, exchange deposit tracing, and source-of-funds verification. @@ -75,5 +74,5 @@ Counts total coinpath entries received by an address after a given date. Add a ` ## Related resources -- [Algorand Transfers API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-transfers-api) — raw ALGO and ASA transfer history -- [Algorand Address API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-address-api) — wallet balances and contract bytecode +- [Algorand Transfers API](/docs/blockchain/Algorand/algorand-transfers-api) — raw ALGO and ASA transfer history +- [Algorand Address API](/docs/blockchain/Algorand/algorand-address-api) — wallet balances and contract bytecode diff --git a/docs/blockchain/Algorand/algorand-smart-contract-calls-api.mdx b/docs/blockchain/Algorand/algorand-smart-contract-calls-api.mdx index 2a6239a9..c1c4ec2d 100644 --- a/docs/blockchain/Algorand/algorand-smart-contract-calls-api.mdx +++ b/docs/blockchain/Algorand/algorand-smart-contract-calls-api.mdx @@ -1,7 +1,7 @@ --- -title: Algorand Smart Contract Calls API - Track App Calls & Asset Creation +title: "Algorand Smart Contract Calls API" sidebar_label: Algorand Smart Contract Calls API -description: Query Algorand smart contract calls with Bitquery GraphQL. Count calls per block, filter by transaction type (pay, acfg), and track newly created ASAs. +description: "Algorand Smart Contract Calls API: query and stream Algorand on-chain data with Bitquery GraphQL examples for developers." keywords: - Algorand smart contract calls API - Algorand app calls API @@ -11,7 +11,6 @@ keywords: - Algorand GraphQL - Bitquery Algorand --- - # Algorand Smart Contract Calls API The Smart Contract Calls API returns parsed application call data on Algorand: transaction type, sender, smart contract address, block context, and call counts. Filter by `txType` to isolate payments (`pay`), asset configuration (`acfg`), or any other Algorand transaction type. @@ -132,5 +131,5 @@ Returns the 10 most recent `pay` (payment) transactions with smart contract addr ## Related resources -- [Algorand Arguments API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-arguments-api) — parsed argument names, types, and values -- [Algorand Transactions API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-transactions-api) — full transaction details and daily counts +- [Algorand Arguments API](/docs/blockchain/Algorand/algorand-arguments-api) — parsed argument names, types, and values +- [Algorand Transactions API](/docs/blockchain/Algorand/algorand-transactions-api) — full transaction details and daily counts diff --git a/docs/blockchain/Algorand/algorand-transactions-api.mdx b/docs/blockchain/Algorand/algorand-transactions-api.mdx index 327ff474..de9b4a34 100644 --- a/docs/blockchain/Algorand/algorand-transactions-api.mdx +++ b/docs/blockchain/Algorand/algorand-transactions-api.mdx @@ -1,7 +1,7 @@ --- -title: Algorand Transactions API - Get Latest Txs, Daily Counts & Hash Lookups +title: "Algorand Transactions API" sidebar_label: Algorand Transactions API -description: Query Algorand transactions with fees, types, senders, and block context. Get daily counts, unique senders, per-address totals, and hash lookups via Bitquery GraphQL. +description: "Algorand Transactions API: query and stream Algorand on-chain data with Bitquery GraphQL examples for developers. Run it in the IDE, then ship in your app." keywords: - Algorand transactions API - Algorand transaction history @@ -11,7 +11,6 @@ keywords: - ALGO transaction list - Bitquery Algorand --- - # Algorand Transactions API The Transactions API returns transaction-level data on Algorand: block context, fees, types, senders, groups, and currency metadata. Use it for paginated transaction feeds, daily activity dashboards, sender analytics, and hash-based lookups. @@ -186,5 +185,5 @@ Returns block context, currency, sender, subtype, and type for a single transact ## Related resources -- [Algorand Transfers API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-transfers-api) — ALGO and ASA transfer history -- [Algorand Blocks API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-blocks-api) — block-level context for each transaction +- [Algorand Transfers API](/docs/blockchain/Algorand/algorand-transfers-api) — ALGO and ASA transfer history +- [Algorand Blocks API](/docs/blockchain/Algorand/algorand-blocks-api) — block-level context for each transaction diff --git a/docs/blockchain/Algorand/algorand-transfers-api.mdx b/docs/blockchain/Algorand/algorand-transfers-api.mdx index f694c032..8c5d9d83 100644 --- a/docs/blockchain/Algorand/algorand-transfers-api.mdx +++ b/docs/blockchain/Algorand/algorand-transfers-api.mdx @@ -1,7 +1,7 @@ --- title: Algorand Transfers API - Track ALGO & ASA Token Transfers sidebar_label: Algorand Transfers API -description: Query Algorand ALGO and ASA transfers filtered by asset ID, date range, sender, or receiver. Get amounts in native units and USD via Bitquery GraphQL. +description: "Algorand Transfers API - Track ALGO & ASA Token Transfers: monitor Algorand native and token transfers in real time with Bitquery GraphQL APIs." keywords: - Algorand transfers API - Algorand token transfers @@ -11,7 +11,6 @@ keywords: - Algorand GraphQL - Bitquery Algorand --- - # Algorand Transfers API The Transfers API returns ALGO and ASA (Algorand Standard Asset) movements with amounts in native units and USD, sender and receiver addresses, block context, and transaction hashes. Filter by asset ID, date range, or address to build wallet history feeds, treasury monitors, and token analytics dashboards. @@ -116,5 +115,5 @@ query MyQuery { ## Related resources -- [Algorand Address API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-address-api) — wallet balances and contract bytecode -- [Algorand Coinpath API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-coinpath-api) — multi-hop fund flow tracing +- [Algorand Address API](/docs/blockchain/Algorand/algorand-address-api) — wallet balances and contract bytecode +- [Algorand Coinpath API](/docs/blockchain/Algorand/algorand-coinpath-api) — multi-hop fund flow tracing diff --git a/docs/blockchain/Algorand/index.mdx b/docs/blockchain/Algorand/index.mdx index 7f84b84b..13c0107d 100644 --- a/docs/blockchain/Algorand/index.mdx +++ b/docs/blockchain/Algorand/index.mdx @@ -1,6 +1,6 @@ --- title: Algorand API Documentation -description: Query Algorand blocks, transactions, ALGO and ASA transfers, addresses, smart contract calls, arguments, and fund flows with Bitquery's GraphQL API. +description: "Algorand API Documentation: query and stream Algorand on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." slug: /blockchain/Algorand/ keywords: - Algorand API @@ -14,7 +14,6 @@ keywords: - Algorand coinpath API - Algorand transactions API --- - # Algorand API Documentation ## Overview @@ -72,16 +71,16 @@ This query returns the 5 most recent Algorand blocks with height, hash, reward, ### Core data -- [Algorand Blocks API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-blocks-api) — block lookups by proposer, height, or time, plus reward aggregates. -- [Algorand Transactions API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-transactions-api) — transaction details, daily counts, unique senders, and hash lookups. -- [Algorand Transfers API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-transfers-api) — ALGO and ASA transfer history with USD amounts. +- [Algorand Blocks API](/docs/blockchain/Algorand/algorand-blocks-api) — block lookups by proposer, height, or time, plus reward aggregates. +- [Algorand Transactions API](/docs/blockchain/Algorand/algorand-transactions-api) — transaction details, daily counts, unique senders, and hash lookups. +- [Algorand Transfers API](/docs/blockchain/Algorand/algorand-transfers-api) — ALGO and ASA transfer history with USD amounts. ### Addresses and contracts -- [Algorand Address API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-address-api) — ALGO balances, multi-address lookups, and smart contract bytecode. -- [Algorand Smart Contract Calls API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-smart-contract-calls-api) — app call counts, transaction-type filters, and new asset creation tracking. -- [Algorand Arguments API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-arguments-api) — parsed argument names, types, and values from calls and events. +- [Algorand Address API](/docs/blockchain/Algorand/algorand-address-api) — ALGO balances, multi-address lookups, and smart contract bytecode. +- [Algorand Smart Contract Calls API](/docs/blockchain/Algorand/algorand-smart-contract-calls-api) — app call counts, transaction-type filters, and new asset creation tracking. +- [Algorand Arguments API](/docs/blockchain/Algorand/algorand-arguments-api) — parsed argument names, types, and values from calls and events. ### Fund tracing -- [Algorand Coinpath API](https://docs.bitquery.io/docs/blockchain/Algorand/algorand-coinpath-api) — multi-hop ALGO and ASA flow tracing for compliance and treasury work. +- [Algorand Coinpath API](/docs/blockchain/Algorand/algorand-coinpath-api) — multi-hop ALGO and ASA flow tracing for compliance and treasury work. diff --git a/docs/blockchain/Arbitrum/Blocks_Transactions.md b/docs/blockchain/Arbitrum/Blocks_Transactions.md index 572ed782..29905a39 100644 --- a/docs/blockchain/Arbitrum/Blocks_Transactions.md +++ b/docs/blockchain/Arbitrum/Blocks_Transactions.md @@ -1,30 +1,12 @@ --- sidebar_position: 6 +title: "Arbitrum Transactions API" +description: "Arbitrum Transactions API: query and stream Arbitrum on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." --- - # Arbitrum Transactions API In this section we'll have a look at some examples using the Arbitrum Transactions API. - - - - - - - - - - - - - - - - - - - ## Latest Transactions The query below retrieves the latest 10 transactions on the Arbitrum network. @@ -95,7 +77,6 @@ To retrieve the latest transactions from or to a specific wallet address we will } } - ``` ## Latest Blocks @@ -118,5 +99,4 @@ query MyQuery { } } - ``` diff --git a/docs/blockchain/Arbitrum/DexTrades.mdx b/docs/blockchain/Arbitrum/DexTrades.mdx index 6e4657a6..00e28ff2 100644 --- a/docs/blockchain/Arbitrum/DexTrades.mdx +++ b/docs/blockchain/Arbitrum/DexTrades.mdx @@ -1,43 +1,16 @@ --- sidebar_position: 2 +title: "Arbitrum DEX Trades API" +description: "Arbitrum DEX Trades API: get Arbitrum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Scale further with Kafka or gRPC streams." --- - # Arbitrum DEX Trades API :::tip Need real-time Arbitrum DEX data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API** (filter with `Pair.Market.Network: Arbitrum`). Use this page when you need **historical Arbitrum data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API** (filter with `Pair.Market.Network: Arbitrum`). Use this page when you need **historical Arbitrum data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. ::: - In this section we will see how to get Arbitrum DEX trades information using our API. - - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Live DEX swap stream (Arbitrum) {#crypto-trades-live-stream} @@ -126,7 +99,7 @@ subscription { [This](https://ide.bitquery.io/trending-token-pairs-on-Arbitrum) query returns the top trending pairs traded on Arbitrum Chain based on the trade volume for the last 24 hours, and returns info such as latest price, number of buyers and sellers, number of trades in a day and much more. -Read [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. +Read [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. ```graphql query pairs( @@ -222,7 +195,7 @@ query pairs( Implementation of this data in a full scale project could be seen on [DEXRabbit](https://dexrabbit.com/arbitrum/pair). -![Trending Pairs on Arbitrum](../../../static/img/dexrabbit/arbitrum/arbitrum_trending_pairs.png) +![Trending Pairs on Arbitrum](/img/dexrabbit/arbitrum/arbitrum_trending_pairs.png) ## Latest Trades for a Token Pair on Arbitrum @@ -328,7 +301,7 @@ query tradingViewPairs( An example for the data visualisation of the data obtained could be seen on the [DEXRabbit](https://dexrabbit.com/arbitrum/pair/0x912ce59144191c1204e64559fe8253a0e49e6548/0xff970a61a04b1ca14834a43f5de4533ebddb5cc8). -![OHLC/ K Line for a Pair on Arbitrum](../../../static/img/dexrabbit/arbitrum/arbitrum_ohlc_pair.png) +![OHLC/ K Line for a Pair on Arbitrum](/img/dexrabbit/arbitrum/arbitrum_ohlc_pair.png) ## Latest Trades in Realtime with Subscription @@ -584,7 +557,7 @@ query topTraders($network: evm_network, $time_ago: DateTime, $token: String) { The implementation of this data could also be seen on the [DEXRabbit](https://dexrabbit.com/arbitrum/token/0x912ce59144191c1204e64559fe8253a0e49e6548#top_traders). -![Top Traders for a token on Arbitrum](../../../static/img/dexrabbit/arbitrum/arbitrum_top_traders_token.png) +![Top Traders for a token on Arbitrum](/img/dexrabbit/arbitrum/arbitrum_top_traders_token.png) The `DEXTrades` API contains the following information about each trade: diff --git a/docs/blockchain/Arbitrum/Overview.md b/docs/blockchain/Arbitrum/Overview.md deleted file mode 100644 index a7575547..00000000 --- a/docs/blockchain/Arbitrum/Overview.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Arbitrum API Documentation - -Bitquery API offers access to indexed data from the Arbitrum blockchain via GraphQL API and GraphQl Subscriptions for developers. - -The Arbitrum Explorer [explorer](https://explorer.bitquery.io/arbitrum) is a visual way to view Arbitrum data easily. - -![chains](/img/ide/arbitrum.png) - -This is the basic structure of a query: - -``` -query { - EVM(network: arbitrum){ - __typename - } -} -``` - -Let's dive in and explore the Arbitrum data available through Bitquery API. diff --git a/docs/blockchain/Arbitrum/Smart_Contract_Calls.md b/docs/blockchain/Arbitrum/Smart_Contract_Calls.md index be0d2d67..61d584ec 100644 --- a/docs/blockchain/Arbitrum/Smart_Contract_Calls.md +++ b/docs/blockchain/Arbitrum/Smart_Contract_Calls.md @@ -1,38 +1,12 @@ --- sidebar_position: 3 +title: "Arbitrum Smart Contract Calls API" +description: "Arbitrum Smart Contract Calls API: query and stream Arbitrum on-chain data with Bitquery GraphQL examples for developers." --- - # Arbitrum Smart Contract Calls API In this section we will see how to get Arbitrum Smart contract calls information using our API. - - - - - - - - - - - - - - - - - - - - - - - - - - - ## Transaction Call Trace for a Arbitrum Transaction This query gets the transaction call trace for an Arbitrum transaction. The `Calls` API in the query returns a list of all calls made by the transaction. diff --git a/docs/blockchain/Arbitrum/Smart_Contract_Events.md b/docs/blockchain/Arbitrum/Smart_Contract_Events.md index dd55c73e..6accf402 100644 --- a/docs/blockchain/Arbitrum/Smart_Contract_Events.md +++ b/docs/blockchain/Arbitrum/Smart_Contract_Events.md @@ -1,39 +1,12 @@ --- sidebar_position: 4 +title: "Arbitrum Smart Contract Events API" +description: "Arbitrum Smart Contract Events API: query and stream Arbitrum on-chain data with Bitquery GraphQL examples for developers." --- - # Arbitrum Smart Contract Events API In this section we will see how to get Arbitrum Smart Contract Events information using our API. - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## Tracking Swap Events on Arbitrum The query returns the 10 most recent `swap` events on the Arbitrum network. We get this by using the signature hash `c42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67` for the swap event. diff --git a/docs/blockchain/Arbitrum/arbitrum-balance-api.md b/docs/blockchain/Arbitrum/arbitrum-balance-api.md index bfc569d8..eda60118 100644 --- a/docs/blockchain/Arbitrum/arbitrum-balance-api.md +++ b/docs/blockchain/Arbitrum/arbitrum-balance-api.md @@ -1,11 +1,12 @@ --- sidebar_position: 5 +title: "Arbitrum Address Balance API" +description: "Arbitrum Address Balance API: fetch current and historical Arbitrum balances with Bitquery GraphQL balance queries. Keep queries fast with indexed filters." --- - # Arbitrum Address Balance API :::caution Deprecated APIs -On EVM, **`BalanceUpdates`** and **`TokenHolders`** are deprecated as of **20 May 2026** and will be removed on **15 June 2026**. Use **`EVM.Balances`** (this page) and **[Token Holders API](/docs/blockchain/Ethereum/token-holders/token-holder-api)** (`EVM.Holders`) instead. +On EVM, **`BalanceUpdates`** and **`TokenHolders`** were deprecated as of **20 May 2026** and removed on **15 June 2026**. Use **`EVM.Balances`** (this page) and **[Token Holders API](/docs/blockchain/Ethereum/token-holders/token-holder-api)** (`EVM.Holders`) instead. ::: The **Balances** API returns current and historical token balances for an address on Arbitrum. To return only non-zero balances, add `Amount(selectWhere: { gt: "0" })` on the `Balance` field (not in `where`). Use `dataset: combined` or `dataset: archive` as follows: diff --git a/docs/blockchain/Arbitrum/arbitrum-cross-chain.md b/docs/blockchain/Arbitrum/arbitrum-cross-chain.md index 4b17b595..42cec1fe 100644 --- a/docs/blockchain/Arbitrum/arbitrum-cross-chain.md +++ b/docs/blockchain/Arbitrum/arbitrum-cross-chain.md @@ -1,7 +1,8 @@ --- sidebar_position: 7 +title: "Arbitrum Cross Chain API" +description: "Arbitrum Cross Chain API: query and stream Arbitrum on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." --- - # Arbitrum Cross Chain API import VideoPlayer from "../../../src/components/videoplayer.js"; diff --git a/docs/blockchain/Arbitrum/arbitrum-liquidity-api.md b/docs/blockchain/Arbitrum/arbitrum-liquidity-api.md index 25912f1e..d4015948 100644 --- a/docs/blockchain/Arbitrum/arbitrum-liquidity-api.md +++ b/docs/blockchain/Arbitrum/arbitrum-liquidity-api.md @@ -1,38 +1,12 @@ --- sidebar_position: 4 +title: "Arbitrum Liquidity API" +description: "Arbitrum Liquidity API: read Arbitrum pool reserves and liquidity updates via Bitquery GraphQL DEX APIs. Built for traders and analytics teams." --- - # Arbitrum Liquidity API In this section we will see how to get Arbitrum DEX pool liquidity information using Bitquery API. The liquidity API helps you monitor real-time liquidity changes, track pool reserves, and analyze liquidity depth for token pairs on Arbitrum DEX pools. - - - - - - - - - - - - - - - - - - - - - ## Understanding Liquidity and Pool Reserves Liquidity in DEX pools refers to the amount of tokens available for trading. Pool reserves (the balance of each token in the pool) determine the pool's ability to handle trades without significant price impact. Monitoring liquidity changes helps you: @@ -49,7 +23,7 @@ The DEXPoolEvents API provides real-time information about: - Pool and token pair information - Transaction details for liquidity-changing events -For a comprehensive explanation of how DEX pools work, liquidity calculations, and when pool events are emitted, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/). +For a comprehensive explanation of how DEX pools work, liquidity calculations, and when pool events are emitted, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/). ## Realtime Liquidity Stream @@ -284,7 +258,7 @@ Kafka streams provide the same liquidity data as GraphQL subscriptions but with - Ability to read from latest offset without gaps - Better scalability with multiple consumers -For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](/docs/streams/kafka-streaming-concepts/). > **Note:** IDE credentials will not work with Kafka Streams. You need separate Kafka credentials. Please contact sales on our official telegram channel or fill out the [form on our website](https://bitquery.io/forms/api). @@ -317,7 +291,7 @@ The `DEXPoolEvents` API response contains the following information: - `Hash`: Transaction hash - `Gas`: Gas used for the transaction -For more details on when new pool events are emitted and how liquidity is calculated, see the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). +For more details on when new pool events are emitted and how liquidity is calculated, see the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). ## Use Cases @@ -355,4 +329,4 @@ Track liquidity events that may create trading opportunities: - Monitor liquidity removals that may signal pool abandonment - Identify pools experiencing rapid liquidity growth -For more advanced use cases, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). +For more advanced use cases, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). diff --git a/docs/blockchain/Arbitrum/arbitrum-slippage-api.md b/docs/blockchain/Arbitrum/arbitrum-slippage-api.md index 63a79edd..55aa3b03 100644 --- a/docs/blockchain/Arbitrum/arbitrum-slippage-api.md +++ b/docs/blockchain/Arbitrum/arbitrum-slippage-api.md @@ -1,38 +1,12 @@ --- sidebar_position: 3 +title: "Arbitrum Slippage API" +description: "Arbitrum Slippage API: measure Arbitrum DEX price impact and slippage with Bitquery GraphQL pool metrics. Built for traders and analytics teams." --- - # Arbitrum Slippage API In this section we will see how to get Arbitrum DEX pool slippage information using our API. The slippage API helps you understand price impact and liquidity depth for token swaps on Arbitrum DEX pools. - - - - - - - - - - - - - - - - - - - - - ## Understanding Slippage and Price Impact Slippage refers to the difference between the expected price of a trade and the actual execution price. When swapping tokens in a DEX pool, larger trades can move the price due to limited liquidity, resulting in slippage. @@ -43,7 +17,7 @@ The DEXPoolSlippages API provides detailed information about: - Average execution prices for different trade sizes - Price impact calculations for both swap directions (A to B and B to A) -For a comprehensive explanation of how DEX pools work, liquidity calculations, and price tables, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/). +For a comprehensive explanation of how DEX pools work, liquidity calculations, and price tables, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/). ## Realtime Slippage Monitoring @@ -181,7 +155,7 @@ Kafka streams provide the same slippage data as GraphQL subscriptions but with s - Ability to read from latest offset without gaps - Better scalability with multiple consumers -For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](/docs/streams/kafka-streaming-concepts/). > **Note:** IDE credentials will not work with Kafka Streams. You need separate Kafka credentials. Please contact sales on our official telegram channel or fill out the [form on our website](https://bitquery.io/forms/api). @@ -203,7 +177,7 @@ The `DEXPoolSlippages` API response contains the following information: - `Time`: Timestamp of the block - `Number`: Block number -For more details on how slippage is calculated and when new pool records are emitted, see the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). +For more details on how slippage is calculated and when new pool records are emitted, see the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). ## Use Cases @@ -250,4 +224,4 @@ For a practical implementation example of using slippage data for automated trad - Execute fade trades against temporary price impacts - Manage positions with dynamic stop losses and take profits based on slippage data -For more advanced use cases, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). +For more advanced use cases, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). diff --git a/docs/blockchain/Arbitrum/arbitrum-timeboost-api.md b/docs/blockchain/Arbitrum/arbitrum-timeboost-api.md index bbeba4bb..b3dfb1ee 100644 --- a/docs/blockchain/Arbitrum/arbitrum-timeboost-api.md +++ b/docs/blockchain/Arbitrum/arbitrum-timeboost-api.md @@ -1,11 +1,11 @@ --- sidebar_position: 11 +title: "Arbitrum TimeBoost API & Streams" +description: "Arbitrum TimeBoost API & Streams: query and stream Arbitrum on-chain data with Bitquery GraphQL examples for developers." --- - # Arbitrum TimeBoost API & Streams -Arbitrum sequencers traditionally ordered transactions on a first-come-first-serve (FCFS) basis. **TimeBoost** introduced an auction-driven priority lane that lets searchers bid for earlier inclusion. With Bitquery’s Stream you can subscribe to every call that interacts with the TimeBoost auction contract and correlate it with other Arbitrum insights described in our [Arbitrum Overview](./Overview.md). - +Arbitrum sequencers traditionally ordered transactions on a first-come-first-serve (FCFS) basis. **TimeBoost** introduced an auction-driven priority lane that lets searchers bid for earlier inclusion. With Bitquery’s Stream you can subscribe to every call that interacts with the TimeBoost auction contract and correlate it with other Arbitrum insights described in our [Arbitrum Overview](./). ## Real-time subscription diff --git a/docs/blockchain/Arbitrum/arbitrum-token-marketcap-api.md b/docs/blockchain/Arbitrum/arbitrum-token-marketcap-api.md index 724763a3..a12508c6 100644 --- a/docs/blockchain/Arbitrum/arbitrum-token-marketcap-api.md +++ b/docs/blockchain/Arbitrum/arbitrum-token-marketcap-api.md @@ -1,28 +1,14 @@ --- sidebar_position: 9 +title: "Arbitrum Token Market Cap API" +description: "Arbitrum Token Market Cap API: stream Arbitrum market cap, FDV, supply, and price using Bitquery Trading GraphQL APIs. See examples in the Bitquery IDE." --- - # Arbitrum Token Market Cap API Use Bitquery’s **Trading** API **`Tokens`** cube to stream or query **market cap**, **fully diluted valuation (USD)**, **total supply**, **price** (OHLC and averages), and **volume** for tokens traded on **Arbitrum One**. Filter with token/currency **`Id`** values such as **`arbitrum:`** plus a **lowercase** contract address. For schema details and field meanings, see the **[Tokens cube](/docs/trading/crypto-price-api/tokens)** and **[Supply fields](/docs/trading/crypto-price-api/supply-fields)**. - - - - - - - - - - - - - - - :::note Trading API and EVM addresses On **Arbitrum** (EVM), the **Trading** API expects **lowercase** hex in **`Id`** values (e.g. `arbitrum:0x97e6…`, not mixed-case checksum addresses). ::: diff --git a/docs/blockchain/Arbitrum/esgmx-api.md b/docs/blockchain/Arbitrum/esgmx-api.md index ad0e915d..d349bf3e 100644 --- a/docs/blockchain/Arbitrum/esgmx-api.md +++ b/docs/blockchain/Arbitrum/esgmx-api.md @@ -1,3 +1,7 @@ +--- +title: "esGMX (Escrowed) and vGLP (Vested) API" +description: "esGMX (Escrowed) and vGLP (Vested) API: query and stream Arbitrum on-chain data with Bitquery GraphQL examples for developers." +--- # esGMX (Escrowed) and vGLP (Vested) API When a wallet stakes GMX tokens in the GMX protocol, they are escrowed and earn Escrowed GMX (esGMX) tokens as rewards. diff --git a/docs/blockchain/Arbitrum/gmx-api.mdx b/docs/blockchain/Arbitrum/gmx-api.mdx index 3694b3e5..7df4fd5d 100644 --- a/docs/blockchain/Arbitrum/gmx-api.mdx +++ b/docs/blockchain/Arbitrum/gmx-api.mdx @@ -1,3 +1,7 @@ +--- +title: "GMX Staking API on Arbitrum" +description: "Query GMX staking positions, esGMX rewards, and related on-chain activity on Arbitrum with Bitquery GraphQL APIs. Works with WebSocket live subscriptions." +--- import FAQ from "@site/src/components/FAQ"; # GMX API @@ -6,7 +10,6 @@ This section covers how to retrieve staking information on GMX. You can read more about the [GMX ecosystem in this blog](https://bitquery.io/blog/gmx). - ## Video Tutorial on GMX and esGMX import VideoPlayer from "../../../src/components/videoplayer.js"; @@ -138,8 +141,6 @@ The following query retrieves the latest liquidated positions on the GMX DEX, pr } ``` - - ## Latest GMX Events You can run the query [here](https://ide.bitquery.io/latest-GMX-Events). diff --git a/docs/blockchain/Arbitrum/index.mdx b/docs/blockchain/Arbitrum/index.mdx index 9594f62a..b610876f 100644 --- a/docs/blockchain/Arbitrum/index.mdx +++ b/docs/blockchain/Arbitrum/index.mdx @@ -1,6 +1,6 @@ --- title: Arbitrum API Documentation -description: Collection of Arbitrum APIs organized by topic including DEX trades, liquidity pools, slippage data, and more. +description: "Arbitrum API Documentation: query and stream Arbitrum on-chain data with Bitquery GraphQL examples for developers. Keep queries fast with indexed filters." slug: /blockchain/Arbitrum/ keywords: - Arbitrum API @@ -17,7 +17,6 @@ keywords: - GMX API - Arbitrum DEX API --- - import VideoPlayer from "../../../src/components/videoplayer.js"; Unlock the full potential of Arbitrum with comprehensive blockchain data—from GMX perpetual trading analytics and DEX swaps to liquidity monitoring, slippage analysis, cross-chain bridge monitoring, and smart contract interactions. This complete guide delivers production-ready GraphQL APIs, real-time streaming data, and practical examples for tracking trades, balances, liquidity pools, slippage, events, and more across the Arbitrum ecosystem. Whether you're building DeFi dashboards, trading algorithms, or cross-chain applications, discover all the Arbitrum data solutions you need here. @@ -27,10 +26,9 @@ Need help crafting a query or subscription? Message us on [support](https://t.me ## What is the Bitquery Arbitrum API? :::tip Building a trading app or DEX UI on Arbitrum? -For **real-time trades and prices on Arbitrum** (and the last ~30 days), use the curated [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. For **historical Arbitrum data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. +For **real-time trades and prices on Arbitrum** (and the last ~30 days), use the curated [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. For **historical Arbitrum data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. ::: - It's a GraphQL interface over curated, indexed Arbitrum data. Write powerful queries instead of building and maintaining your own indexer for the fastest L2 solution. ## What can you build with it? @@ -50,7 +48,7 @@ Track GMX perpetual positions, monitor DEX liquidity, pool reserves, slippage, a ## WebSockets and Webhooks -Most queries can be turned into live streams by switching `query` to `subscription`, and consumed over WebSocket. See examples and code snippets [here](https://docs.bitquery.io/docs/subscriptions/websockets/). +Most queries can be turned into live streams by switching `query` to `subscription`, and consumed over WebSocket. See examples and code snippets [here](/docs/subscriptions/websockets/). ## DEX and Perp APIs @@ -74,7 +72,6 @@ Monitor real-time liquidity changes, track pool reserves, and analyze liquidity ## Core Arbitrum APIs -- [Overview](./Overview) - [Blocks & Transactions](./Blocks_Transactions) - [Smart Contract Calls](./Smart_Contract_Calls) - [Smart Contract Events](./Smart_Contract_Events) diff --git a/docs/blockchain/Arbitrum/uniswap-v4-api.md b/docs/blockchain/Arbitrum/uniswap-v4-api.md index 9bb1802f..2883e8b8 100644 --- a/docs/blockchain/Arbitrum/uniswap-v4-api.md +++ b/docs/blockchain/Arbitrum/uniswap-v4-api.md @@ -1,9 +1,8 @@ --- -title: "Uniswap V4 API - Track Trader Activities, Token Trades and Market Behaviour" -description: "Track Uniswap V4 trades, trader activities, token trades, and market behaviour in real time using Bitquery's DEX Trades API on Arbitrum." +title: "Arbitrum Uniswap V4 API" +description: "Arbitrum Uniswap V4 API: query Arbitrum Uniswap trades, pools, and prices with Bitquery GraphQL DEX APIs. Keep queries fast with indexed filters." --- - -# Uniswap V4 API - Track Trader Activities, Token Trades and Market Behaviour +# Uniswap V4 API - Track Trader Activities, Token Trades and Market Behavior Uniswap v4 introduces a major shift in protocol architecture. Instead of deploying a separate smart contract for each liquidity pool, Uniswap v4 uses a singleton PoolManager contract that manages all pools internally as structured state. diff --git a/docs/blockchain/BSC/binance-memerush-api.md b/docs/blockchain/BSC/binance-memerush-api.md index e39c1342..0fb273a7 100644 --- a/docs/blockchain/BSC/binance-memerush-api.md +++ b/docs/blockchain/BSC/binance-memerush-api.md @@ -1,3 +1,7 @@ +--- +title: "Binance Meme Rush API" +description: "Binance Meme Rush API: query and stream BNB Chain on-chain data with Bitquery GraphQL examples for developers. Great for bots, dashboards, and alerts." +--- import VideoPlayer from "../../../src/components/videoplayer.js"; # Binance Meme Rush API @@ -8,63 +12,19 @@ Get ultra low latency Binance Meme Rush memecoin data on BNB Chain: live trades, The below GraphQL APIs and Streams are examples of data points you can get with Bitquery. If you have questions on other data points, reach out to [support](https://t.me/Bloxy_info). -Need zero-latency BSC data via Kafka? Read about our [Kafka Streams](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) and contact us for a trial. +Need zero-latency BSC data via Kafka? Read about our [Kafka Streams](/docs/streams/kafka-streaming-concepts/) and contact us for a trial. You may also be interested in: -- [Crypto Price API ➤](https://docs.bitquery.io/docs/trading/crypto-price-api/) -- [BSC Pancake Swap APIs ➤](https://docs.bitquery.io/docs/blockchain/BSC/pancake-swap-api/) -- [BSC DEX Trades ➤](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades/) -- [PumpFun API ➤](https://docs.bitquery.io/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) - - -Binance Meme Rush API - Live Trades, Bonding Curve, Prices, Liquidity on BSC - - - - - - - - - - - - - - - - - - - - - - - - - - +- [Crypto Price API ➤](/docs/trading/crypto-price-api/introduction/) +- [BSC Pancake Swap APIs ➤](/docs/blockchain/BSC/pancake-swap-api/) +- [BSC DEX Trades ➤](/docs/blockchain/BSC/bsc-dextrades/) +- [PumpFun API ➤](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) ::::note To query or stream data via GraphQL outside the Bitquery IDE, you need to generate an API access token. -Follow the steps here to create one: https://docs.bitquery.io/docs/authorisation/how-to-generate/ +Follow the steps here to create one: /docs/authorization/how-to-generate/ :::: --- @@ -119,11 +79,11 @@ Follow the steps here to create one: https://docs.bitquery.io/docs/authorisation ## Getting Started with Bitquery: -- [Learning Track](https://docs.bitquery.io/docs/start/learning-path/): Learning track to get started with Bitquery GraphQL APIs and streams. -- [BSC DEX Trades](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades/): Real time DEX Trading data via examples. -- [BSC Uniswap APIs](https://docs.bitquery.io/docs/blockchain/BSC/bsc-uniswap-api/): Uniswap Trades on BSC network with the help of examples. -- [BSC Pancake Swap APIs](https://docs.bitquery.io/docs/blockchain/BSC/pancake-swap-api/): Pancake swap Trades on BSC network with the help of examples. -- [Trade APIs](https://docs.bitquery.io/docs/trading/crypto-price-api/examples/): Multi-chain Trade API Examples. +- [Learning Track](/docs/start/learning-path/): Learning track to get started with Bitquery GraphQL APIs and streams. +- [BSC DEX Trades](/docs/blockchain/BSC/bsc-dextrades/): Real time DEX Trading data via examples. +- [BSC Uniswap APIs](/docs/blockchain/BSC/bsc-uniswap-api/): Uniswap Trades on BSC network with the help of examples. +- [BSC Pancake Swap APIs](/docs/blockchain/BSC/pancake-swap-api/): Pancake swap Trades on BSC network with the help of examples. +- [Trade APIs](/docs/trading/crypto-price-api/examples/): Multi-chain Trade API Examples. ## Track All Binance Meme Rush Tokens That Have Migrated to Pancakeswap @@ -608,7 +568,7 @@ query MyQuery($currency: String) { -You can also check if the token is listed on other DEX using this [example](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades/#get-all-dexs-where-a-specific-token-is-listed). +You can also check if the token is listed on other DEX using this [example](/docs/blockchain/BSC/bsc-dextrades/#get-all-dexs-where-a-specific-token-is-listed). ## Get Trade Metrics of a Meme Rush Token @@ -664,7 +624,7 @@ query MyQuery($currency: String) { ## Get latest price of a Meme Rush token -We launched the [Price Index](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) in August 2025, allowing you to track price of any token trading onchain. +We launched the [Price Index](/docs/trading/crypto-price-api/introduction/) in August 2025, allowing you to track price of any token trading onchain. Here's an example of [tracking Meme Rush token prices](https://ide.bitquery.io/latest-meme-rush-token-price-on-four-meme-dex#).
@@ -928,7 +888,7 @@ subscription {
-You can also get the trade activities of a user on Pancake Swap using our [Pancake Swap](./pancake-swap-api.md) APIs. +You can also get the trade activities of a user on Pancake Swap using our [Pancake Swap](/docs/blockchain/BSC/pancake-swap-api/) APIs. ## Track Meme Rush Tokens in 14k to 18k Marketcap diff --git a/docs/blockchain/BSC/bsc-balance-updates.md b/docs/blockchain/BSC/bsc-balance-updates.md index beb550df..ed315597 100644 --- a/docs/blockchain/BSC/bsc-balance-updates.md +++ b/docs/blockchain/BSC/bsc-balance-updates.md @@ -1,38 +1,12 @@ --- sidebar_position: 1 +title: "BSC Balance Updates API" +description: "BSC Balance Updates API: fetch current and historical BNB Chain balances with Bitquery GraphQL balance queries. Scale further with Kafka or gRPC streams." --- - # BSC Balance Updates API In thise section we will see how to monitor real-time balance changes across the BSC blockchain. - - - - - - - - - - - - - - - - - - - - - :::warning Important: Rebasing Token Limitations **Rebasing tokens are not supported for accurate balance calculations.** diff --git a/docs/blockchain/BSC/bsc-calls-api.mdx b/docs/blockchain/BSC/bsc-calls-api.mdx index 583dea75..b8389b58 100644 --- a/docs/blockchain/BSC/bsc-calls-api.mdx +++ b/docs/blockchain/BSC/bsc-calls-api.mdx @@ -1,50 +1,14 @@ --- sidebar_position: 3 +title: "BSC Smart Contract Calls API" +description: "BSC Smart Contract Calls API: query and stream BNB Chain on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." --- - # BSC Smart Contract Calls API In this section we will see how to get BSC Smart contract calls information using our API. import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## Track Latest Calls on BNB The below query retrieves the latest successful smart contract calls on the BNB Smart Chain (BSC). It fetches details about contract interactions, transaction metadata, and associated block information. diff --git a/docs/blockchain/BSC/bsc-dextrades.mdx b/docs/blockchain/BSC/bsc-dextrades.mdx index d080c922..780038a5 100644 --- a/docs/blockchain/BSC/bsc-dextrades.mdx +++ b/docs/blockchain/BSC/bsc-dextrades.mdx @@ -1,63 +1,36 @@ --- sidebar_position: 2 +title: "BNB Chain DEXtrades API" +description: "BNB Chain DEXtrades API: get BNB Chain DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Built for traders and analytics teams." --- - # BNB DEX Trades API :::tip Need real-time BNB / BSC DEX data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API** (filter with `Pair.Market.Network: Binance Smart Chain`). Use this page when you need **historical BNB / BSC data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API** (filter with `Pair.Market.Network: Binance Smart Chain`). Use this page when you need **historical BNB / BSC data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. ::: - Bitquery provides BSC DEX trade data through APIs, Streams, and Data Dumps. The examples below show how to access real-time and historical trade data across BSC-based DEXs using GraphQL APIs and subscriptions. -Read [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. +Read [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. If you're looking for other data points or have integration questions, reach out to [support](https://t.me/Bloxy_info). Need zero-latency BSC trade data? -[Explore our Kafka Streams and request a trial ➤](https://docs.bitquery.io/docs/streams/protobuf/chains/EVM-protobuf/) +[Explore our Kafka Streams and request a trial ➤](/docs/streams/protobuf/chains/EVM-protobuf/) You may also be interested in: -- [FourMeme APIs ➤](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/) -- [BNB Uniswap API ➤](https://docs.bitquery.io/docs/blockchain/BSC/bsc-uniswap-api/) -- [BNB DEX Trades API ➤](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades/) +- [FourMeme APIs ➤](/docs/blockchain/BSC/four-meme-api/) +- [BNB Uniswap API ➤](/docs/blockchain/BSC/bsc-uniswap-api/) +- [BNB DEX Trades API ➤](/docs/blockchain/BSC/bsc-dextrades/) :::note To query or stream data via GraphQL **outside the Bitquery IDE**, you must generate an API access token. -Follow these steps: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow these steps: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Live DEX swap stream (BNB Chain) {#crypto-trades-live-stream} @@ -194,7 +167,6 @@ subscription { } } - ``` ## Latest Trades of a Token @@ -1540,7 +1512,7 @@ query { ## Trader-Focused Trade APIs (with USD Price, Market Cap & Supply) -The queries below use the **[Trades cube](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. +The queries below use the **[Trades cube](/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. ### Get All DEX Trades on BSC With Price, Market Cap, and Supply diff --git a/docs/blockchain/BSC/bsc-events-api.mdx b/docs/blockchain/BSC/bsc-events-api.mdx index ece17c5b..5f79d10f 100644 --- a/docs/blockchain/BSC/bsc-events-api.mdx +++ b/docs/blockchain/BSC/bsc-events-api.mdx @@ -1,39 +1,14 @@ --- sidebar_position: 4 +title: "BSC Smart Contract Events API" +description: "BSC Smart Contract Events API: query and stream BNB Chain on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." --- - # BSC Smart Contract Events API In this section we will see how to get BSC Smart Contract Events information using our API. import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - - - - - - - - - - - - - ## Track Newly Created Pools on BSC This subscription websocket lets you track the newly created pools on Uniswap V3 `0xdB1d10011AD0Ff90774D0C6Bb92e5C5c8b4461F7`. And we are listening for a particular event here named as `PoolCreated` because whenever a new pool is created on Uniswap V3 this event is fired. You can get the newly created pool address in the response in `arguments`. diff --git a/docs/blockchain/BSC/bsc-liquidity-api.md b/docs/blockchain/BSC/bsc-liquidity-api.md index b6ce8d06..9112fcc3 100644 --- a/docs/blockchain/BSC/bsc-liquidity-api.md +++ b/docs/blockchain/BSC/bsc-liquidity-api.md @@ -1,38 +1,12 @@ --- sidebar_position: 11 +title: "BNB Chain Liquidity API" +description: "BNB Chain Liquidity API: read BNB Chain pool reserves and liquidity updates via Bitquery GraphQL DEX APIs. Built for traders and analytics teams." --- - # BSC Liquidity API In this section we will see how to get BSC DEX pool liquidity information using Bitquery API. The liquidity API helps you monitor real-time liquidity changes, track pool reserves, and analyze liquidity depth for token pairs on BSC DEX pools. - - - - - - - - - - - - - - - - - - - - - ## Understanding Liquidity and Pool Reserves Liquidity in DEX pools refers to the amount of tokens available for trading. Pool reserves (the balance of each token in the pool) determine the pool's ability to handle trades without significant price impact. Monitoring liquidity changes helps you: @@ -49,7 +23,7 @@ The DEXPoolEvents API provides real-time information about: - Pool and token pair information - Transaction details for liquidity-changing events -For a comprehensive explanation of how DEX pools work, liquidity calculations, and when pool events are emitted, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/). +For a comprehensive explanation of how DEX pools work, liquidity calculations, and when pool events are emitted, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/). ## Realtime Liquidity Stream @@ -282,7 +256,7 @@ Kafka streams provide the same liquidity data as GraphQL subscriptions but with - Ability to read from latest offset without gaps - Better scalability with multiple consumers -For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](/docs/streams/kafka-streaming-concepts/). > **Note:** IDE credentials will not work with Kafka Streams. You need separate Kafka credentials. Please contact sales on our official telegram channel or fill out the [form on our website](https://bitquery.io/forms/api). @@ -315,7 +289,7 @@ The `DEXPoolEvents` API response contains the following information: - `Hash`: Transaction hash - `Gas`: Gas used for the transaction -For more details on when new pool events are emitted and how liquidity is calculated, see the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). +For more details on when new pool events are emitted and how liquidity is calculated, see the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). ## Use Cases @@ -353,4 +327,4 @@ Track liquidity events that may create trading opportunities: - Monitor liquidity removals that may signal pool abandonment - Identify pools experiencing rapid liquidity growth -For more advanced use cases, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). +For more advanced use cases, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). diff --git a/docs/blockchain/BSC/bsc-mempool-stream.md b/docs/blockchain/BSC/bsc-mempool-stream.md index d36f48a3..cdeb3763 100644 --- a/docs/blockchain/BSC/bsc-mempool-stream.md +++ b/docs/blockchain/BSC/bsc-mempool-stream.md @@ -1,8 +1,7 @@ --- title: "BSC Mempool Stream - Real-Time Transaction Monitoring" -description: "Monitor BSC mempool in real-time. Track pending transactions, DEX trades, token creations, and more with ultra-low latency using Bitquery Mempool APIs and Kafka Streams." +description: "BSC Mempool Stream - Real-Time Transaction Monitoring: watch BNB Chain pending transactions before confirmation with Bitquery GraphQL subscriptions." --- - # BSC Mempool Stream - Real-Time Transaction Monitoring Monitor BSC (BNB Smart Chain) mempool transactions in real-time before they are confirmed on-chain. Track pending DEX trades, token creations, transfers, and detect opportunities early with Bitquery's Mempool APIs and Streams. @@ -10,52 +9,19 @@ Monitor BSC (BNB Smart Chain) mempool transactions in real-time before they are Any Bitquery GraphQL stream can be converted to a mempool monitoring stream by setting `mempool: true`. We also provide low-latency Kafka streams to monitor broadcasted data, which are much faster than GraphQL mempool streams. -Read more about Kafka streams [here](https://docs.bitquery.io/docs/streams/protobuf/chains/EVM-protobuf/). +Read more about Kafka streams [here](/docs/streams/protobuf/chains/EVM-protobuf/). :::note To query or stream data via GraphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - -BSC Mempool Stream - Real-Time Transaction Monitoring | Bitquery - - - - - - - - - - - - - - - - --- ## How do I stream BSC pending transactions (mempool) using Bitquery? {#how-do-i-stream-bsc-pending-transactions-mempool-using-bitquery} -Use a **GraphQL `subscription`** on the Bitquery streaming **WebSocket** [`wss://streaming.bitquery.io/graphql`](https://docs.bitquery.io/docs/subscriptions/websockets/) with root **`EVM(network: bsc, mempool: true)`**. The **`mempool: true`** flag switches the stream to **broadcast / simulated pending** traffic instead of only confirmed blocks. Under that root, subscribe to the same APIs you use on-chain—**`Transactions`**, **`Transfers`**, **`DEXTrades`**, **`Events`**, and others—with `where` filters as needed. Authenticate the socket per [WebSocket authorisation](https://docs.bitquery.io/docs/authorisation/websocket/). For mempool semantics (ordering, time window, vs confirmed subscriptions), read [Subscribing to mempool updates](https://docs.bitquery.io/docs/subscriptions/mempool-subscriptions/). For lower latency at scale, consider **Kafka** [EVM protobuf streams](https://docs.bitquery.io/docs/streams/protobuf/chains/EVM-protobuf/). +Use a **GraphQL `subscription`** on the Bitquery streaming **WebSocket** [`wss://streaming.bitquery.io/graphql`](/docs/subscriptions/websockets/) with root **`EVM(network: bsc, mempool: true)`**. The **`mempool: true`** flag switches the stream to **broadcast / simulated pending** traffic instead of only confirmed blocks. Under that root, subscribe to the same APIs you use on-chain—**`Transactions`**, **`Transfers`**, **`DEXTrades`**, **`Events`**, and others—with `where` filters as needed. Authenticate the socket per [WebSocket authorization](/docs/authorization/websocket/). For mempool semantics (ordering, time window, vs confirmed subscriptions), read [Subscribing to mempool updates](/docs/subscriptions/mempool-subscriptions/). For lower latency at scale, consider **Kafka** [EVM protobuf streams](/docs/streams/protobuf/chains/EVM-protobuf/). Minimal example—pending transaction headers on BSC: @@ -159,7 +125,6 @@ subscription { - ### Stream Four Meme Token Creation in Mempool - Detect Them First Track new Four Meme token creations in the mempool instantly. Be the first to know when a new token is being created, before it's confirmed on-chain. @@ -323,10 +288,10 @@ subscription { You may also be interested in: -- [Four Meme API Documentation ➤](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/) -- [BSC DEX Trades API ➤](https://docs.bitquery.io/docs/evm/dextrades/) -- [Kafka Protobuf Streams for EVM ➤](https://docs.bitquery.io/docs/streams/protobuf/chains/EVM-protobuf/) -- [WebSocket Subscriptions ➤](https://docs.bitquery.io/docs/authorisation/websocket/) +- [Four Meme API Documentation ➤](/docs/blockchain/BSC/four-meme-api/) +- [BSC DEX Trades API ➤](/docs/schema/evm/dextrades/) +- [Kafka Protobuf Streams for EVM ➤](/docs/streams/protobuf/chains/EVM-protobuf/) +- [WebSocket Subscriptions ➤](/docs/authorization/websocket/) ## Need Help? diff --git a/docs/blockchain/BSC/bsc-nft.md b/docs/blockchain/BSC/bsc-nft.md index 4b92b5b1..576bf281 100644 --- a/docs/blockchain/BSC/bsc-nft.md +++ b/docs/blockchain/BSC/bsc-nft.md @@ -1,34 +1,11 @@ +--- +title: "BNB Chain NFT API" +description: "Track BNB Chain NFT trades, ownership, and metadata with Bitquery GraphQL queries, filters, and real-time streaming options." +--- # BSC NFT API In this section we'll have a look at some examples using the BSC NFT API. - - - - - - - - - - - - - - - - - - - - - ## Track Transfers of a specific NFT on BSC in Realtime This query subscribes you to the real time non-fungible token (NFT) transfers of a specific nft contract on the BSC network. diff --git a/docs/blockchain/BSC/bsc-pancakeswap-infinity-api.md b/docs/blockchain/BSC/bsc-pancakeswap-infinity-api.md index 9101b18a..2796c0be 100644 --- a/docs/blockchain/BSC/bsc-pancakeswap-infinity-api.md +++ b/docs/blockchain/BSC/bsc-pancakeswap-infinity-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 7 +title: "BSC PancakeSwap Infinity API" +description: "BSC PancakeSwap Infinity API: query and stream BNB Chain on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." --- - import VideoPlayer from "../../../src/components/videoplayer.js"; # BSC PancakeSwap Infinity API @@ -10,42 +11,19 @@ Bitquery provides PancakeSwap Infinity (BSC) data through APIs, Streams and Data The below graphQL APIs and Streams are examples of data points you can get with Bitquery for PancakeSwap Infinity on Binance Smart Chain (BSC). If you have any question on other data points reach out to [support](https://t.me/Bloxy_info) -Need zero-latency Binance Smart Chain (BSC) data? [Read about our Kafka Streams and Contact us for a Trial](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +Need zero-latency Binance Smart Chain (BSC) data? [Read about our Kafka Streams and Contact us for a Trial](/docs/streams/kafka-streaming-concepts/). You may also be interested in: -- [Four.meme APIs ➤](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/) -- [BSC PancakeSwap APIs ➤](https://docs.bitquery.io/docs/blockchain/BSC/pancake-swap-api/) +- [Four.meme APIs ➤](/docs/blockchain/BSC/four-meme-api/) +- [BSC PancakeSwap APIs ➤](/docs/blockchain/BSC/pancake-swap-api/) :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - - - - - - - - - - - - - - - - - ## Get Latest Trades on PancakeSwap Infinity diff --git a/docs/blockchain/BSC/bsc-slippage-api.md b/docs/blockchain/BSC/bsc-slippage-api.md index 582496eb..d555d823 100644 --- a/docs/blockchain/BSC/bsc-slippage-api.md +++ b/docs/blockchain/BSC/bsc-slippage-api.md @@ -1,38 +1,12 @@ --- sidebar_position: 3 +title: "BNB Chain Slippage API" +description: "BNB Chain Slippage API: measure BNB Chain DEX price impact and slippage with Bitquery GraphQL pool metrics. Covers archive history and realtime data." --- - # BSC Slippage API In this section we will see how to get BSC DEX pool slippage information using our API. The slippage API helps you understand price impact and liquidity depth for token swaps on BSC DEX pools. - - - - - - - - - - - - - - - - - - - - - ## Understanding Slippage and Price Impact Slippage refers to the difference between the expected price of a trade and the actual execution price. When swapping tokens in a DEX pool, larger trades can move the price due to limited liquidity, resulting in slippage. @@ -43,7 +17,7 @@ The DEXPoolSlippages API provides detailed information about: - Average execution prices for different trade sizes - Price impact calculations for both swap directions (A to B and B to A) -For a comprehensive explanation of how DEX pools work, liquidity calculations, and price tables, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/). +For a comprehensive explanation of how DEX pools work, liquidity calculations, and price tables, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/). ## Realtime Slippage Monitoring @@ -181,7 +155,7 @@ Kafka streams provide the same slippage data as GraphQL subscriptions but with s - Ability to read from latest offset without gaps - Better scalability with multiple consumers -For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](/docs/streams/kafka-streaming-concepts/). > **Note:** IDE credentials will not work with Kafka Streams. You need separate Kafka credentials. Please contact sales on our official telegram channel or fill out the [form on our website](https://bitquery.io/forms/api). @@ -203,7 +177,7 @@ The `DEXPoolSlippages` API response contains the following information: - `Time`: Timestamp of the block - `Number`: Block number -For more details on how slippage is calculated and when new pool records are emitted, see the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). +For more details on how slippage is calculated and when new pool records are emitted, see the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). ## Use Cases @@ -250,4 +224,4 @@ For a practical implementation example of using slippage data for automated trad - Execute fade trades against temporary price impacts - Manage positions with dynamic stop losses and take profits based on slippage data -For more advanced use cases, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). +For more advanced use cases, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). diff --git a/docs/blockchain/BSC/bsc-token-marketcap-api.md b/docs/blockchain/BSC/bsc-token-marketcap-api.md index 5628d3b3..a4bf4a24 100644 --- a/docs/blockchain/BSC/bsc-token-marketcap-api.md +++ b/docs/blockchain/BSC/bsc-token-marketcap-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 8 +title: "BNB Smart Chain (BSC) Token Market Cap API" +description: "BNB Smart Chain (BSC) Token Market Cap API: stream BNB Chain market cap, FDV, supply, and price using Bitquery Trading GraphQL APIs." --- - # BNB Smart Chain (BSC) Token Market Cap API This page explains how to **query or stream** BSC token metrics including **market cap**, **FDV**, **supply**, **price**, and **volume** with Bitquery **`Trading.Tokens`** (GraphQL). @@ -10,21 +11,6 @@ Use **`bsc:`** plus a **lowercase** contract address in token ids, or filter **` For field definitions, see **[Tokens cube](/docs/trading/crypto-price-api/tokens)** and **[Supply fields](/docs/trading/crypto-price-api/supply-fields)**. - - - - - - - - - - - - - - - :::note Trading API and EVM addresses On **BSC** (EVM), use **lowercase** hex in **`Id`** values (e.g. `bsc:0x2eb0…`, not mixed-case checksum addresses). ::: diff --git a/docs/blockchain/BSC/bsc-transfers.md b/docs/blockchain/BSC/bsc-transfers.md index 713572ef..c86526be 100644 --- a/docs/blockchain/BSC/bsc-transfers.md +++ b/docs/blockchain/BSC/bsc-transfers.md @@ -1,34 +1,11 @@ +--- +title: "BNB Chain Transfers API" +description: "BNB Chain Transfers API: monitor BNB Chain native and token transfers in real time with Bitquery GraphQL APIs. Includes filters and field selection tips." +--- # BSC Transfers API In this section we'll have a look at some examples using the BSC Transfers API. - - - - - - - - - - - - - - - - - - - - - ## Subscribe to Recent Whale Transactions of a particular currency The subscription query below fetches the whale transactions on the BSC network. We have used WBNB address `0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c`. You can find the query [here](https://ide.bitquery.io/Whale-transfers-of-USDC-on-BSC) @@ -60,7 +37,6 @@ subscription{ } } - ``` ## Sender is a particular address @@ -166,7 +142,6 @@ subscription { } } - ``` ## Check if an address ever interacted with predict.fun (USDT → protocol receivers) @@ -291,4 +266,4 @@ The composite `orderBy` across `Block_Number`, `Transaction_Index`, `Call_Index` ## Why does my wallet inflow/outflow query miss some transactions on BSC? {#why-does-my-wallet-inflowoutflow-query-miss-some-transactions-on-bsc} -Bitquery indexes all transactions from the blockchain. If you're missing inflow/outflow records in your query, first verify you're using the correct dataset—either `realtime` or `combined`—based on your needs. If your query still appears to miss transactions, please report the issue to the Bitquery team via [Telegram](https://t.me/bloxy_info). \ No newline at end of file +Bitquery indexes all transactions from the blockchain. If you're missing inflow/outflow records in your query, first verify you're using the correct dataset—either `realtime` or `combined`—based on your needs. If your query still appears to miss transactions, please report the issue to the Bitquery team via [Telegram](https://t.me/bloxy_info). diff --git a/docs/blockchain/BSC/bsc-uniswap-api.md b/docs/blockchain/BSC/bsc-uniswap-api.md index 71944195..6b7ff0d7 100644 --- a/docs/blockchain/BSC/bsc-uniswap-api.md +++ b/docs/blockchain/BSC/bsc-uniswap-api.md @@ -1,5 +1,7 @@ --- sidebar_position: 7 +title: "BNB Chain Uniswap API" +description: "BNB Chain Uniswap API: query BNB Chain Uniswap trades, pools, and prices with Bitquery GraphQL DEX APIs. Copy GraphQL snippets for production apps." --- import FAQ from "@site/src/components/FAQ"; @@ -9,29 +11,6 @@ import VideoPlayer from "../../../src/components/videoplayer.js"; This section provides you with a set of queries that provides an insight about the Uniswap DEX on BSC. - - - - - - - - - - - - - - - - - ## Get Latest Trades on Uniswap v3 Below query will subscribe you to the latest DEX Trades on BSC Uniswap v3. Try out the API [here](https://ide.bitquery.io/uniswap-v3-trades-bsc) diff --git a/docs/blockchain/BSC/flap-sh.md b/docs/blockchain/BSC/flap-sh.md index bc830d9f..37744661 100644 --- a/docs/blockchain/BSC/flap-sh.md +++ b/docs/blockchain/BSC/flap-sh.md @@ -1,6 +1,6 @@ --- title: Flap.sh API - BSC Launchpad Token Analytics and Trading Data -description: Comprehensive guide to Flap.sh launchpad API on BNB Smart Chain. Track token creation, monitor trades, analyze OHLCV data, and stream real-time prices for Flap.sh tokens using Bitquery GraphQL APIs. +description: "Flap.sh API - BSC Launchpad Token Analytics and Trading Data: query and stream BNB Chain on-chain data with Bitquery GraphQL examples for developers." keywords: - Flap.sh API - Flap.sh launchpad @@ -23,7 +23,6 @@ keywords: - Launchpad monitoring sidebar_position: 1 --- - # Flap.sh API Flap.sh is a token launchpad platform on BNB Smart Chain (BSC) that enables users to create and launch new tokens with unique features including tax tokens and vanity addresses. This comprehensive guide covers how to track, analyze, and monitor Flap.sh tokens using Bitquery's GraphQL APIs. @@ -804,16 +803,16 @@ You can identify Flap.sh tokens by checking the last 4 characters of their contr ## Related Documentation -- [BSC Blockchain API](https://docs.bitquery.io/docs/blockchain/BSC/index) – BNB Smart Chain documentation -- [DEX Trades API](https://docs.bitquery.io/docs/evm/dextrades) – DEX trading data documentation -- [Events API](https://docs.bitquery.io/docs/evm/events) – Smart contract events documentation -- [Transfers API](https://docs.bitquery.io/docs/evm/transfers) – Token transfer tracking -- [Trading APIs](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction) – Price and OHLCV data -- [GraphQL Subscriptions](https://docs.bitquery.io/docs/subscriptions/subscription) – Real-time data streaming +- [BSC Blockchain API](/docs/blockchain/BSC/) – BNB Smart Chain documentation +- [DEX Trades API](/docs/schema/evm/dextrades) – DEX trading data documentation +- [Events API](/docs/schema/evm/events) – Smart contract events documentation +- [Transfers API](/docs/schema/evm/transfers) – Token transfer tracking +- [Trading APIs](/docs/trading/crypto-price-api/introduction) – Price and OHLCV data +- [GraphQL Subscriptions](/docs/subscriptions/subscription) – Real-time data streaming ## Support For questions or issues: - [Bitquery Documentation](https://docs.bitquery.io) - [Flap.sh Official Documentation](https://docs.flap.sh/flap/) -- [Bitquery IDE](https://ide.bitquery.io) \ No newline at end of file +- [Bitquery IDE](https://ide.bitquery.io) diff --git a/docs/blockchain/BSC/four-meme-api.mdx b/docs/blockchain/BSC/four-meme-api.mdx index 966404d9..9695242d 100644 --- a/docs/blockchain/BSC/four-meme-api.mdx +++ b/docs/blockchain/BSC/four-meme-api.mdx @@ -1,6 +1,6 @@ --- -title: "Four Meme API" -description: "How to query four.meme on BNB Chain with Bitquery: live trades, bonding curve, new tokens, OHLCV, liquidity, PancakeSwap migrations, top tokens by volume, and trader stats via GraphQL and WebSocket." +title: "BNB Chain Four Meme API" +description: "BNB Chain Four Meme API: query and stream BNB Chain on-chain data with Bitquery GraphQL examples for developers. Keep queries fast with indexed filters." keywords: - Four Meme API - four.meme BSC API @@ -16,72 +16,28 @@ import VideoPlayer from "../../../src/components/videoplayer.js"; # Four Meme API :::tip Need real-time Four.meme data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Four.meme examples using `Trading.Trades` are also shown in the **"Trader-Focused Trade APIs"** section below. Use the raw chain-level queries on this page when you need **historical Four.meme data older than ~30 days** or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Four.meme examples using `Trading.Trades` are also shown in the **"Trader-Focused Trade APIs"** section below. Use the raw chain-level queries on this page when you need **historical Four.meme data older than ~30 days** or call / event context. ::: Bitquery exposes **four.meme (Four Meme)** on **BNB Chain** through GraphQL: **live trades** (`fourmeme_v1`), **TokenCreate** events on the exchange proxy, **bonding curve** math from proxy balances, **migrations** to PancakeSwap, **OHLCV**, **liquidity** events, and **leaderboards**. Use **subscriptions** for real-time streams and **`dataset: combined`** for history. The Four Meme exchange proxy used in examples is **`0x5c952063c7fc8610ffdb798152d69f0b9550762b`** (see below). The sections below are example queries and streams. For other fields, contact [support](https://t.me/Bloxy_info). -Need low-latency BSC data? See [Streams](https://docs.bitquery.io/docs/streams/) and contact us for a trial. For **mempool (pre-confirmation)** Four Meme data, see the dedicated [Four Meme Mempool API](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-mempool-API/) page. +Need low-latency BSC data? See [Streams](/docs/streams/) and contact us for a trial. For **mempool (pre-confirmation)** Four Meme data, see the dedicated [Four Meme Mempool API](/docs/blockchain/BSC/four-meme-mempool-API/) page. For live DEX prices and 24h volume across Four.meme tokens, see [DEXrabbit's Four.meme category](https://dexrabbit.bitquery.io/categories/four-meme-ecosystem). You may also be interested in: -- [Crypto Price API ➤](https://docs.bitquery.io/docs/trading/crypto-price-api/) -- [BSC Pancake Swap APIs ➤](https://docs.bitquery.io/docs/blockchain/BSC/pancake-swap-api/) -- [BSC DEX Trades ➤](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades/) -- [PumpFun API ➤](https://docs.bitquery.io/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) - - -Four Meme API - - - - - - - - - - - - - - - - - - - - - - - - - - +- [Crypto Price API ➤](/docs/trading/crypto-price-api/introduction/) +- [BSC Pancake Swap APIs ➤](/docs/blockchain/BSC/pancake-swap-api/) +- [BSC DEX Trades ➤](/docs/blockchain/BSC/bsc-dextrades/) +- [PumpFun API ➤](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) :::note To query or stream data via GraphQL outside the Bitquery IDE, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token](/docs/authorization/how-to-generate/) ::: ## What is the Four Meme exchange contract address on BSC? {#what-is-the-four-meme-exchange-contract-address-on-bsc} @@ -168,11 +124,11 @@ Use it in **`Transaction.To`**, **`LogHeader.Address`**, or **`BalanceUpdate.Add ## Getting Started with Bitquery: -- [Learning Track](https://docs.bitquery.io/docs/start/learning-path/): Learning track to get started with Bitquery GraphQL APIs and streams. -- [BSC DEX Trades](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades/): Real time DEX Trading data via examples. -- [BSC Uniswap APIs](https://docs.bitquery.io/docs/blockchain/BSC/bsc-uniswap-api/): Uniswap Trades on BSC network with the help of examples. -- [BSC Pancake Swap APIs](https://docs.bitquery.io/docs/blockchain/BSC/pancake-swap-api/): Pancake swap Trades on BSC network with the help of examples. -- [Trade APIs](https://docs.bitquery.io/docs/trading/crypto-price-api/examples/): Multi-chain Trade API Examples. +- [Learning Track](/docs/start/learning-path/): Learning track to get started with Bitquery GraphQL APIs and streams. +- [BSC DEX Trades](/docs/blockchain/BSC/bsc-dextrades/): Real time DEX Trading data via examples. +- [BSC Uniswap APIs](/docs/blockchain/BSC/bsc-uniswap-api/): Uniswap Trades on BSC network with the help of examples. +- [BSC Pancake Swap APIs](/docs/blockchain/BSC/pancake-swap-api/): Pancake swap Trades on BSC network with the help of examples. +- [Trade APIs](/docs/trading/crypto-price-api/examples/): Multi-chain Trade API Examples. ## How do I detect Four Meme token migrations to PancakeSwap? {#track-all-four-meme-tokens-that-have-migrated-to-pancakeswap} @@ -477,7 +433,7 @@ subscription { -You can refer to this [example](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/#subscribe-the-latest-trades-on-four-meme) to track latest trades of a token on other particular DEX's such as Pancake Swap. +You can refer to this [example](/docs/blockchain/BSC/four-meme-api/#subscribe-the-latest-trades-on-four-meme) to track latest trades of a token on other particular DEX's such as Pancake Swap. ## Get Four.Meme Tokens created by a specific Dev @@ -784,7 +740,7 @@ query MyQuery($currency: String) { -You can also check if the token is listed on other DEX using this [example](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades/#get-all-dexs-where-a-specific-token-is-listed). +You can also check if the token is listed on other DEX using this [example](/docs/blockchain/BSC/bsc-dextrades/#get-all-dexs-where-a-specific-token-is-listed). ## Get Trade Metrics of a Four Meme Token @@ -840,7 +796,7 @@ query MyQuery($currency: String) { ## Get latest price of a Four.meme token -We launched the [Price Index](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) in August 2025, allowing you to track price of any token trading onchain. +We launched the [Price Index](/docs/trading/crypto-price-api/introduction/) in August 2025, allowing you to track price of any token trading onchain. Here's an example of [tracking Four.meme token prices](https://ide.bitquery.io/latest-token-price-on-four-meme-dex).
@@ -1093,7 +1049,7 @@ subscription {
-You can also get the trade activities of a user on Pancake Swap using our [Pancake Swap](https://docs.bitquery.io/docs/blockchain/BSC/pancake-swap-api/) APIs. +You can also get the trade activities of a user on Pancake Swap using our [Pancake Swap](/docs/blockchain/BSC/pancake-swap-api/) APIs. ## Track Four Meme Tokens in 14k to 18k Marketcap @@ -2142,7 +2098,7 @@ query MyQuery { ## Trader-Focused Trade APIs (with USD Price, Market Cap & Supply) -The queries below use the **[Trades cube](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. +The queries below use the **[Trades cube](/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. ### Get All DEX Trades on FourMeme With Price, Market Cap, and Supply @@ -2294,7 +2250,7 @@ These mirror common “answer engine” questions. Each item points to the secti | How do I get newly created tokens on Four Meme? | [TokenCreate query](#get-newly-created-tokens-on-four-meme) | | How do I stream Four Meme token creation events in real time? | [TokenCreate subscription](#how-do-i-stream-four-meme-token-creation-events-in-real-time) | | How do I get top tokens by volume on Four Meme? | [Top tokens by volume / activity](#top-tokens-by-buys-sells-volume-price-change-buyers-sellers) and [realtime market cap leaderboard](#top-four-meme-tokens-by-realtime-marketcap) | -| Can I monitor Four Meme transactions in the BSC mempool before confirmation? | **Separate guide:** [Four Meme Mempool API](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-mempool-API/) (not duplicated on this page) | +| Can I monitor Four Meme transactions in the BSC mempool before confirmation? | **Separate guide:** [Four Meme Mempool API](/docs/blockchain/BSC/four-meme-mempool-API/) (not duplicated on this page) | | How do I get Four Meme OHLCV data for a token? | [OHLCV query](#get-ohlcv-data-of-a-four-meme-token) | | Can the API return four.meme token volume changes every second? | **Not documented on this page yet** — add minimum interval, aggregation options, and any rate or streaming limits you want to communicate publicly. | @@ -2328,7 +2284,7 @@ These mirror common “answer engine” questions. Each item points to the secti ### Four Meme Sniper Bot -- [Tutorial](https://docs.bitquery.io/docs/streams/sniper-trade-using-bitquery-kafka-stream/) +- [Tutorial](/docs/streams/sniper-trade-using-bitquery-kafka-stream/) - [Source Code](https://github.com/Kshitij0O7/evm-sniper) - [Video](https://youtu.be/vgOHgqTJmj0?si=yfUguMWdMtxRJMvg) diff --git a/docs/blockchain/BSC/four-meme-mempool-API.md b/docs/blockchain/BSC/four-meme-mempool-API.md index c18e7ffb..43c498d8 100644 --- a/docs/blockchain/BSC/four-meme-mempool-API.md +++ b/docs/blockchain/BSC/four-meme-mempool-API.md @@ -1,16 +1,15 @@ --- -title: "Four Meme Mempool API - Real-Time Pre-Confirmation Monitoring" -description: "Monitor Four Meme memecoin transactions in real-time before confirmation. Track pending trades, token creations, and detect opportunities early with ultra-low latency mempool streams on BSC." +title: "Four Meme Mempool API" +description: "Four Meme Mempool API: watch BNB Chain pending transactions before confirmation with Bitquery GraphQL subscriptions. Built for traders and analytics teams." --- import FAQ from "@site/src/components/FAQ"; # Four Meme Mempool API - Real-Time Pre-Confirmation Monitoring :::tip Need real-time Four.meme data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Four.meme swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Four.meme data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Four.meme swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Four.meme data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Monitor Four Meme memecoin activity in the BSC mempool before transactions are confirmed on-chain. Track pending trades, new token launches, bonding curve progress, and detect MEV opportunities with Bitquery's ultra-low latency Mempool APIs and Kafka Streams. Get ahead of the market by monitoring mempool activity for Four Meme tokens before they hit the blockchain. Perfect for MEV bots, sniper bots, and advanced trading strategies. @@ -20,42 +19,9 @@ For live DEX prices and volume after tokens trade on-chain, browse [DEXrabbit's :::note To query or stream data via GraphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - -Four Meme Mempool API - Real-Time Pre-Confirmation Monitoring | Bitquery - - - - - - - - - - - - - - - - --- ## Table of Contents @@ -112,7 +78,7 @@ When a transaction is broadcasted to the BSC network but not yet included in a b :::tip We provide both GraphQL streams (easy to use) and Kafka streams (ultra-low latency) for mempool monitoring. For production MEV and sniper bots, we recommend Kafka streams. -Read more: [Kafka Protobuf Streams for EVM ➤](https://docs.bitquery.io/docs/streams/protobuf/chains/EVM-protobuf/) +Read more: [Kafka Protobuf Streams for EVM ➤](/docs/streams/protobuf/chains/EVM-protobuf/) ::: --- @@ -828,8 +794,8 @@ message BroadcastedTransactionsMessage { **Learn More:** -- [Kafka Protobuf Streams Documentation ➤](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) -- [Building a Sniper Bot with Kafka ➤](https://docs.bitquery.io/docs/streams/sniper-trade-using-bitquery-kafka-stream/) +- [Kafka Protobuf Streams Documentation ➤](/docs/streams/kafka-streaming-concepts/) +- [Building a Sniper Bot with Kafka ➤](/docs/streams/sniper-trade-using-bitquery-kafka-stream/) - [Contact Us for Kafka Stream Access ➤](https://t.me/Bloxy_info) --- @@ -877,12 +843,12 @@ message BroadcastedTransactionsMessage { You may also be interested in: -- [Four Meme API Documentation ➤](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/) -- [BSC Mempool Stream ➤](https://docs.bitquery.io/docs/blockchain/BSC/bsc-mempool-stream/) -- [BSC DEX Trades API ➤](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades/) -- [Kafka Protobuf Streams ➤](https://docs.bitquery.io/docs/streams/protobuf/chains/EVM-protobuf/) -- [WebSocket Subscriptions ➤](https://docs.bitquery.io/docs/authorisation/websocket/) -- [Building a Sniper Bot Tutorial ➤](https://docs.bitquery.io/docs/streams/sniper-trade-using-bitquery-kafka-stream/) +- [Four Meme API Documentation ➤](/docs/blockchain/BSC/four-meme-api/) +- [BSC Mempool Stream ➤](/docs/blockchain/BSC/bsc-mempool-stream/) +- [BSC DEX Trades API ➤](/docs/blockchain/BSC/bsc-dextrades/) +- [Kafka Protobuf Streams ➤](/docs/streams/protobuf/chains/EVM-protobuf/) +- [WebSocket Subscriptions ➤](/docs/authorization/websocket/) +- [Building a Sniper Bot Tutorial ➤](/docs/streams/sniper-trade-using-bitquery-kafka-stream/) ## Need Help? diff --git a/docs/blockchain/BSC/gra-fun-api.md b/docs/blockchain/BSC/gra-fun-api.md index 47c9e9d1..08688f27 100644 --- a/docs/blockchain/BSC/gra-fun-api.md +++ b/docs/blockchain/BSC/gra-fun-api.md @@ -1,44 +1,19 @@ +--- +title: "BNB Chain Gra Fun API" +description: "BNB Chain Gra Fun API: query and stream BNB Chain on-chain data with Bitquery GraphQL examples for developers. Keep queries fast with indexed filters." +--- # GRA.fun API :::tip Need real-time GRA.fun data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered GRA.fun swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical GRA.fun data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered GRA.fun swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical GRA.fun data older than ~30 days**, raw per-swap detail, or call / event context. ::: - In this section we'll have a look at some examples using the BSC Transfers API. - - - - - - - - - - - - - - - - - - - - - ## New Token Created Retrieve newly created tokens on the gra.fun platform using [query below](https://ide.bitquery.io/grafun-new-token-created-api). - ```graphql { EVM(network: bsc) { @@ -143,12 +118,10 @@ Retrieve all transfer and trade events related to the GRA fun using [this query] ``` - ## GRA fun Redeem Transactions Retrieve all redeemed transactions using [this query](https://ide.bitquery.io/Gra-fun-redeem-transactions). - ```graphql { EVM(network: bsc) { @@ -301,7 +274,6 @@ Retrieve all buy transactions from GRA.fun using [this query](https://ide.bitque Retrieve all sell transactions on GRA fun using [this query](https://ide.bitquery.io/Gra-fun-sell-transactions). - ```graphql { EVM(network: bsc) { @@ -375,7 +347,6 @@ Retrieve all sell transactions on GRA fun using [this query](https://ide.bitquer ``` - ## GRA fun Transaction Details Retrieve detailed information about a specific transaction using [this query](https://ide.bitquery.io/gra-fun-detailed-transfer-of-a-transaction). You can check Sender and Receiver of Transfers to understand what bought and sold. @@ -419,12 +390,10 @@ Retrieve detailed information about a specific transaction using [this query](ht To get all transfers of on GRA.fun, please check [this query](https://ide.bitquery.io/gra-fun-all-transfers). - ## Trades of a token on pancake v3 Use this API to get Pancake V3 APIs using [this api](https://ide.bitquery.io/Trades-of-token-on-pancake-v3) - ``` { EVM(dataset: archive, network: bsc) { @@ -520,4 +489,4 @@ Get 1st trade of token on Pancake v3 using [this api](https://ide.bitquery.io/Tr } } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/BSC/index.mdx b/docs/blockchain/BSC/index.mdx index f4d2221c..d6c28e94 100644 --- a/docs/blockchain/BSC/index.mdx +++ b/docs/blockchain/BSC/index.mdx @@ -1,6 +1,6 @@ --- title: BSC API Documentation -description: Collection of BSC APIs organized by project including DEX trades, liquidity pools, slippage data, and more. +description: "BSC API Documentation: query and stream BNB Chain on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." slug: /blockchain/BSC/ keywords: - BSC API @@ -20,10 +20,9 @@ import FAQ from "@site/src/components/FAQ"; # BSC API Documentation :::tip Building a trading app or DEX UI on BNB Chain (BSC)? -For **real-time trades and prices on BNB Chain (BSC)** (and the last ~30 days), use the curated [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. For **historical BNB Chain (BSC) data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. +For **real-time trades and prices on BNB Chain (BSC)** (and the last ~30 days), use the curated [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. For **historical BNB Chain (BSC) data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. ::: - In this section we will see how to fetch data on different tokens, transactions, DEXs like Uniswap, Pancakeswap, Four Meme, liquidity pools, and slippage data etc via APIs and Streams. If you need help getting data on Binance Smart Chain,reach out to [support](https://t.me/Bloxy_info) @@ -44,16 +43,15 @@ Bitquery BSC APIs are very flexible, you can fetch trade, transaction, balance, | No built-in history or analytics—any indexing/aggregation you build or outsource | Historical data, joins, aggregations & real-time subscriptions | Delivers pre-parsed, enriched Protocol-Buffers events (DEX trades, token transfers and transactions) | | Ideal for submitting transactions | Great for real-time data and historical backtesting without running your own indexer | Great for Enterprise usage with built-in replication/failover and no node ops or custom parsing needed | -Read more about Kafka streams [here](https://docs.bitquery.io/docs/streams/protobuf/chains/EVM-protobuf/) and contact sales via [Telegram](https://t.me/Bloxy_info) or [form](https://bitquery.io/forms/api) for a **Trial**. +Read more about Kafka streams [here](/docs/streams/protobuf/chains/EVM-protobuf/) and contact sales via [Telegram](https://t.me/Bloxy_info) or [form](https://bitquery.io/forms/api) for a **Trial**. ### Does Bitquery support BSC Websocket and BSC Webhooks? -Bitquery supports websocket and webhooks, you can convert most of the graphQL APIs into graphQL streams by changing the word `query` to `subscription`. You can monitor this data via a websocket. More [code samples available here](https://docs.bitquery.io/docs/subscriptions/websockets/) +Bitquery supports websocket and webhooks, you can convert most of the graphQL APIs into graphQL streams by changing the word `query` to `subscription`. You can monitor this data via a websocket. More [code samples available here](/docs/subscriptions/websockets/) ## Can I monitor BSC pending transactions using Bitquery? {#can-i-monitor-bsc-pending-transactions-using-bitquery} -**Yes.** Use **GraphQL subscriptions** with **`EVM(network: bsc, mempool: true)`** on the shapes documented for mempool (see [mempool subscriptions](/docs/subscriptions/mempool-subscriptions/) and the [Ethereum mempool API](/docs/blockchain/Ethereum/mempool/mempool-api/)—the same patterns apply to **BSC**). For **lower-latency** broadcast data, use **Kafka** streams as described on the **[BSC mempool stream](/docs/blockchain/BSC/bsc-mempool-stream/)** page. You need a valid **V2 OAuth token** for requests outside the IDE ([authorisation](/docs/authorisation/how-to-generate/)). - +**Yes.** Use **GraphQL subscriptions** with **`EVM(network: bsc, mempool: true)`** on the shapes documented for mempool (see [mempool subscriptions](/docs/subscriptions/mempool-subscriptions/) and the [Ethereum mempool API](/docs/blockchain/Ethereum/mempool/mempool-api/)—the same patterns apply to **BSC**). For **lower-latency** broadcast data, use **Kafka** streams as described on the **[BSC mempool stream](/docs/blockchain/BSC/bsc-mempool-stream/)** page. You need a valid **V2 OAuth token** for requests outside the IDE ([authorization](/docs/authorization/how-to-generate/)). ## BSC DEX APIs diff --git a/docs/blockchain/BSC/pancake-swap-api.md b/docs/blockchain/BSC/pancake-swap-api.md index 7d83541d..1c50b2f9 100644 --- a/docs/blockchain/BSC/pancake-swap-api.md +++ b/docs/blockchain/BSC/pancake-swap-api.md @@ -1,3 +1,7 @@ +--- +title: "BNB Chain Pancake Swap API" +description: "BNB Chain Pancake Swap API: query and stream BNB Chain on-chain data with Bitquery GraphQL examples for developers. Keep queries fast with indexed filters." +--- import FAQ from "@site/src/components/FAQ"; import VideoPlayer from "../../../src/components/videoplayer.js"; @@ -5,12 +9,11 @@ import VideoPlayer from "../../../src/components/videoplayer.js"; # Pancake Swap API :::tip Need real-time PancakeSwap data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered PancakeSwap swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical PancakeSwap data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered PancakeSwap swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical PancakeSwap data older than ~30 days**, raw per-swap detail, or call / event context. ::: - In this section we will use APIs from Bitquery to get the on-chain trade related data, trade metrics, trades for a token or a trader on the Pancake Swap DEX. -To get the trade activities of the Pancake Swap exclusively we have added a filter out trades based on `Factory Contract` address, `0x0bfbcf9fa4f9c56b0f40a671ad40e0805a091865` for the case of Pancake Swap V3. To get the trades and trade related data for Pancake Swap V1 or V2 you would need their respective addresses. Create your account and get started by following the [Quickstart instructions](https://docs.bitquery.io/docs/start/first-query/). +To get the trade activities of the Pancake Swap exclusively we have added a filter out trades based on `Factory Contract` address, `0x0bfbcf9fa4f9c56b0f40a671ad40e0805a091865` for the case of Pancake Swap V3. To get the trades and trade related data for Pancake Swap V1 or V2 you would need their respective addresses. Create your account and get started by following the [Quickstart instructions](/docs/start/first-query/). ## Bitquery DEX Data Access Options @@ -21,33 +24,10 @@ To get the trade activities of the Pancake Swap exclusively we have added a filt ## Getting Started with Bitquery: -- [BSC DEX Trades](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades/): Real time DEX Trading data via examples. -- [BSC Uniswap APIs](https://docs.bitquery.io/docs/blockchain/BSC/bsc-uniswap-api/): Uniswap Trades on BSC network with the help of examples. -- [BSC Four Meme APIs](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/): Four Meme Trades on BSC network with the help of examples. -- [Trade APIs](https://docs.bitquery.io/docs/trading/crypto-price-api/examples/): Multi-chain Trade API Examples. - - - - - - - - - - - - - - - - - +- [BSC DEX Trades](/docs/blockchain/BSC/bsc-dextrades/): Real time DEX Trading data via examples. +- [BSC Uniswap APIs](/docs/blockchain/BSC/bsc-uniswap-api/): Uniswap Trades on BSC network with the help of examples. +- [BSC Four Meme APIs](/docs/blockchain/BSC/four-meme-api/): Four Meme Trades on BSC network with the help of examples. +- [Trade APIs](/docs/trading/crypto-price-api/examples/): Multi-chain Trade API Examples. ## Get Latest Trades on Pancake Swap @@ -451,7 +431,7 @@ subscription { -Also, checkout the [Four Meme](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/) documentation for APIs related to Four Meme tokens and Four Meme Exchange. +Also, checkout the [Four Meme](/docs/blockchain/BSC/four-meme-api/) documentation for APIs related to Four Meme tokens and Four Meme Exchange. ## Get Top Traders of a Token on Pancake Swap @@ -598,7 +578,7 @@ query MyQuery { [This](https://ide.bitquery.io/bsc-pancakeswap-ohlc-using-trading-api) API endpoint provides the OHLC/ K-Line data for a given token against other specified token. -This query uses the `Trading` cube from the [Crypto Price APIs](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) +This query uses the `Trading` cube from the [Crypto Price APIs](/docs/trading/crypto-price-api/introduction/)
Click to expand GraphQL query @@ -669,7 +649,7 @@ This query uses the `Trading` cube from the [Crypto Price APIs](https://docs.bit ## Price Change Percentage for a Token on Pancake Swap -[This](https://ide.bitquery.io/Percentage-price-change-for-a-pancake-swap-token) query returns the price change percentage for a token traded on Pancake Swap in the time periods of `24hr`, `1hr` and `5 min` using [calculate expression](https://docs.bitquery.io/docs/graphql/capabilities/expression/) feature. +[This](https://ide.bitquery.io/Percentage-price-change-for-a-pancake-swap-token) query returns the price change percentage for a token traded on Pancake Swap in the time periods of `24hr`, `1hr` and `5 min` using [calculate expression](/docs/graphql/capabilities/expression/) feature.
Click to expand GraphQL query diff --git a/docs/blockchain/BSC/transaction-balance-tracker/bsc-gas-balance-tracker.md b/docs/blockchain/BSC/transaction-balance-tracker/bsc-gas-balance-tracker.md index f3c9c183..603d8b18 100644 --- a/docs/blockchain/BSC/transaction-balance-tracker/bsc-gas-balance-tracker.md +++ b/docs/blockchain/BSC/transaction-balance-tracker/bsc-gas-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 6 +title: "BSC Gas Balance Tracker" +description: "BSC Gas Balance Tracker: stream BNB Chain balance changes with reason codes using Bitquery GraphQL subscriptions. Works with WebSocket live subscriptions." --- - # BSC Gas Balance Tracker The BSC Gas Balance Tracker API provides real-time balance updates related to Gas Fee activities, including transaction fee rewards, monitoring gas fee spent, and other GAS-related balance changes. - - - - - - - - - - - - - - - - - - - ## Get Top Gas Fee Collectors [This](https://ide.bitquery.io/top-gas-fee-collectors-bsc) API endpoint returns the list of top gas fee collectors. We are tracking the Gas Collection Event causing Balance Update by appliying condition on `BalanceChangeReasonCode` to be equal to `5`. @@ -311,4 +287,4 @@ subscription { } } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/BSC/transaction-balance-tracker/bsc-mev-balance-tracker.md b/docs/blockchain/BSC/transaction-balance-tracker/bsc-mev-balance-tracker.md index d98ec003..01b8b759 100644 --- a/docs/blockchain/BSC/transaction-balance-tracker/bsc-mev-balance-tracker.md +++ b/docs/blockchain/BSC/transaction-balance-tracker/bsc-mev-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 4 +title: "BSC MEV Balance Tracker" +description: "BSC MEV Balance Tracker: stream BNB Chain balance changes with reason codes using Bitquery GraphQL subscriptions. Keep queries fast with indexed filters." --- - # BSC MEV Balance Tracker The BSC MEV (Maximal Extractable Value) Balance Tracker API provides real-time balance updates related to MEV activities, including transaction fee rewards, block builder rewards, and other MEV-related balance changes. - - - - - - - - - - - - - - - - - - - ## Track MEV-Related Balance Updates Monitor balance changes related to MEV activities, including transaction fee rewards and block builder rewards. Try the API [here](https://ide.bitquery.io/Track-MEV-Related-Balance-Updates-bsc). diff --git a/docs/blockchain/BSC/transaction-balance-tracker/bsc-miner-balance-tracker.md b/docs/blockchain/BSC/transaction-balance-tracker/bsc-miner-balance-tracker.md index 403671a7..980eff83 100644 --- a/docs/blockchain/BSC/transaction-balance-tracker/bsc-miner-balance-tracker.md +++ b/docs/blockchain/BSC/transaction-balance-tracker/bsc-miner-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 3 +title: "BSC Miner Balance Tracker" +description: "BSC Miner Balance Tracker: stream BNB Chain balance changes with reason codes using Bitquery GraphQL subscriptions. Built for traders and analytics teams." --- - # BSC Miner Balance Tracker The BSC Miner Balance Tracker API provides real-time balance updates for BSC miners, tracking their mining rewards, uncle block rewards, and transaction fee rewards. - - - - - - - - - - - - - - - - - - - ## Track Miner Balance Updates Monitor balance changes for BSC miners, including block rewards, uncle block rewards, and transaction fee rewards. Try the API [here](https://ide.bitquery.io/Track-Miner-Balance-Updates-bsc). diff --git a/docs/blockchain/BSC/transaction-balance-tracker/bsc-self-destruct-balance-api.md b/docs/blockchain/BSC/transaction-balance-tracker/bsc-self-destruct-balance-api.md index c23e6fda..3f26808b 100644 --- a/docs/blockchain/BSC/transaction-balance-tracker/bsc-self-destruct-balance-api.md +++ b/docs/blockchain/BSC/transaction-balance-tracker/bsc-self-destruct-balance-api.md @@ -1,36 +1,12 @@ --- sidebar_position: 5 +title: "BSC Self-Destruct Balance Tracker" +description: "BSC Self-Destruct Balance Tracker: stream BNB Chain balance changes with reason codes using Bitquery GraphQL subscriptions." --- - # BSC Self-Destruct Balance Tracker The BSC Self-Destruct Balance Tracker API provides real-time balance updates for contracts that self-destruct and addresses that receive funds from self-destructed contracts. This API helps you monitor contract destruction events, track ephemeral contracts (like MEV bots), and analyze security incidents. - - - - - - - - - - - - - - - - - - - ## What is Self-Destruct? The `selfdestruct` opcode allows a smart contract to permanently remove its bytecode from the blockchain and send its remaining ETH balance to a specified recipient address. Once a contract self-destructs, it can no longer execute code or receive transactions. diff --git a/docs/blockchain/BSC/transaction-balance-tracker/bsc-transaction-balance-tracker.md b/docs/blockchain/BSC/transaction-balance-tracker/bsc-transaction-balance-tracker.md index 5d539d3d..18b9684f 100644 --- a/docs/blockchain/BSC/transaction-balance-tracker/bsc-transaction-balance-tracker.md +++ b/docs/blockchain/BSC/transaction-balance-tracker/bsc-transaction-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 1 +title: "BSC Transaction Balance Tracker" +description: "BSC Transaction Balance Tracker: stream BNB Chain balance changes with reason codes using Bitquery GraphQL subscriptions." --- - # BSC Transaction Balance Tracker The BSC Transaction Balance Tracker API provides real-time balance updates for all addresses involved in transactions on the BSC blockchain, including detailed information about the reason for each balance change. - - - - - - - - - - - - - - - - - - - ## Subscribe to All Transaction Balances This subscription provides real-time balance updates for all addresses involved in transactions on the BSC network. @@ -268,4 +244,4 @@ This API gives you latest Supply and Marketcap of a token on BSC. Try it out [he } } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/BSC/transaction-balance-tracker/bsc-transfer-balance-tracker.md b/docs/blockchain/BSC/transaction-balance-tracker/bsc-transfer-balance-tracker.md index 1d66c3c6..18bf056e 100644 --- a/docs/blockchain/BSC/transaction-balance-tracker/bsc-transfer-balance-tracker.md +++ b/docs/blockchain/BSC/transaction-balance-tracker/bsc-transfer-balance-tracker.md @@ -1,7 +1,8 @@ --- sidebar_position: 7 +title: "BSC Transfer Balance Tracker" +description: "BSC Transfer Balance Tracker: monitor BNB Chain native and token transfers in real time with Bitquery GraphQL APIs. Keep queries fast with indexed filters." --- - # BSC Transfer Balance Tracker The BSC Transfer Balance Tracker API provides real-time balance updates for all addresses involved in Transfers on the BSC blockchain, and provides option to filter out based on the direction of transfer you want to target. The BSC Transfer Balance is tracked by marking the the `BalanceUpdateReason` equals `10`. @@ -10,31 +11,6 @@ The BSC Transfer Balance Tracker API provides real-time balance updates for all The queries covered this section are only valid for the Native Currency Transfer. ::: - - - - - - - - - - - - - - - - - - - ## Get Balance Info for an Address after Transfer [This](https://ide.bitquery.io/balance-update-from-transfer-for-an-address-bsc) query returns the Balance Info such as PreBalance, PostBalance, Balances in USD and transfer amount for a particular address after a transfer, irrespective of the direction of transfer. @@ -327,7 +303,6 @@ subscription { ```
- ## Get Balance Info for an Address after Transfer Recieved [This](https://ide.bitquery.io/Balance-update-after-transfer-received-bsc) query returns the Balance Info such as PreBalance, PostBalance, Balances in USD and transfer amount for a particular address after it recieves a transfer. diff --git a/docs/blockchain/BSC/transaction-balance-tracker/bsc-validator-balance-tracker.md b/docs/blockchain/BSC/transaction-balance-tracker/bsc-validator-balance-tracker.md index 97d391ba..9f52c334 100644 --- a/docs/blockchain/BSC/transaction-balance-tracker/bsc-validator-balance-tracker.md +++ b/docs/blockchain/BSC/transaction-balance-tracker/bsc-validator-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 2 +title: "BSC Validator Balance Tracker" +description: "BSC Validator Balance Tracker: stream BNB Chain balance changes with reason codes using Bitquery GraphQL subscriptions. See examples in the Bitquery IDE." --- - # BSC Validator Balance Tracker The BSC Validator Balance Tracker API provides real-time balance updates for BSC validators, tracking their staking rewards, withdrawals, and balance changes. - - - - - - - - - - - - - - - - - - - ## Track Validator Balance Updates Monitor balance changes for BSC validators, including staking rewards and withdrawals from the beacon chain. diff --git a/docs/blockchain/BSC/transaction-balance-tracker/index.md b/docs/blockchain/BSC/transaction-balance-tracker/index.md index 6a94405e..add9ffc7 100644 --- a/docs/blockchain/BSC/transaction-balance-tracker/index.md +++ b/docs/blockchain/BSC/transaction-balance-tracker/index.md @@ -1,6 +1,6 @@ --- title: BSC Transaction Balance Tracker API -description: Access comprehensive BSC Transaction Balance Tracker APIs for real-time balance updates, validator tracking, miner rewards, MEV analysis, and self-destruct monitoring. GraphQL API with subscriptions. +description: "BSC Transaction Balance Tracker API: stream BNB Chain balance changes with reason codes using Bitquery GraphQL subscriptions." slug: /blockchain/BSC/transaction-balance-tracker/ keywords: - BSC Transaction Balance Tracker @@ -14,7 +14,6 @@ keywords: - Balance Change Reason Codes - Real-time Balance Updates --- - # BSC Transaction Balance Tracker API - Complete Guide ## What is Transaction Balance Tracker? @@ -37,8 +36,8 @@ Our Transaction Balance Tracker APIs track balance changes across different scen New to Transaction Balance Tracker? Here's how to get started: 1. **[Create a free account](https://ide.bitquery.io/)** - Get instant access to our GraphQL IDE -2. **[Generate your API key](https://docs.bitquery.io/docs/authorisation/how-to-generate/)** - Required for API access -3. **[Run your first query](https://docs.bitquery.io/docs/start/first-query/)** - Learn the basics in 5 minutes +2. **[Generate your API key](/docs/authorization/how-to-generate/)** - Required for API access +3. **[Run your first query](/docs/start/first-query/)** - Learn the basics in 5 minutes 4. **[Explore examples](#bsc-transaction-balance-tracker-apis)** - Copy-paste ready queries below Need help crafting a query or subscription? Message us on [support](https://t.me/Bloxy_info). @@ -59,11 +58,11 @@ Get live BSC balance updates through our streaming solutions: - **GraphQL Subscriptions**: Convert any query to a live stream by changing `query` to `subscription` - **Kafka Streaming**: High-throughput streaming for enterprise applications -See examples and code snippets [here](https://docs.bitquery.io/docs/subscriptions/websockets/) for GraphQL subscription implementation, and learn about [Kafka streaming](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) for high-volume use cases. +See examples and code snippets [here](/docs/subscriptions/websockets/) for GraphQL subscription implementation, and learn about [Kafka streaming](/docs/streams/kafka-streaming-concepts/) for high-volume use cases. ## BSC Transaction Balance Tracker APIs -### [BSC Transaction Balance Tracker](https://docs.bitquery.io/docs/blockchain/BSC/transaction-balance-tracker/bsc-transaction-balance-tracker) +### [BSC Transaction Balance Tracker](/docs/blockchain/BSC/transaction-balance-tracker/bsc-transaction-balance-tracker) The core Transaction Balance Tracker API provides real-time balance updates for all addresses involved in transactions on the BSC network, including detailed information about the reason for each balance change. Track native ETH, ERC-20 tokens, and NFTs with pre/post balances, USD values, and balance change reason codes. @@ -74,7 +73,7 @@ The core Transaction Balance Tracker API provides real-time balance updates for - Track ERC-20, ERC-721, and ERC-1155 tokens - Access pre and post balance values -### [BSC Validator Balance Tracker](https://docs.bitquery.io/docs/blockchain/BSC/transaction-balance-tracker/bsc-validator-balance-tracker) +### [BSC Validator Balance Tracker](/docs/blockchain/BSC/transaction-balance-tracker/bsc-validator-balance-tracker) Track BSC validator balances, staking rewards, and withdrawals from the beacon chain. Monitor validator activity including block rewards, withdrawal events, and transaction fee rewards. @@ -85,7 +84,7 @@ Track BSC validator balances, staking rewards, and withdrawals from the beacon c - Filter by specific validator addresses - Real-time validator balance updates -### [BSC Miner Balance Tracker](https://docs.bitquery.io/docs/blockchain/BSC/transaction-balance-tracker/bsc-miner-balance-tracker) +### [BSC Miner Balance Tracker](/docs/blockchain/BSC/transaction-balance-tracker/bsc-miner-balance-tracker) Monitor BSC miner balances, mining rewards, uncle block rewards, and transaction fee rewards. Track historical and real-time mining activity across the BSC network. @@ -96,7 +95,7 @@ Monitor BSC miner balances, mining rewards, uncle block rewards, and transaction - Filter by specific miner addresses - Historical mining reward data -### [BSC MEV Balance Tracker](https://docs.bitquery.io/docs/blockchain/BSC/transaction-balance-tracker/bsc-mev-balance-tracker) +### [BSC MEV Balance Tracker](/docs/blockchain/BSC/transaction-balance-tracker/bsc-mev-balance-tracker) Track MEV (Maximal Extractable Value) related balance changes including transaction fee rewards, block builder rewards, and other MEV extraction activities. Monitor MEV bots and block builders in real-time. @@ -107,7 +106,7 @@ Track MEV (Maximal Extractable Value) related balance changes including transact - Track large MEV transactions - Aggregate MEV reward statistics -### [BSC Self-Destruct Balance Tracker](https://docs.bitquery.io/docs/blockchain/BSC/transaction-balance-tracker/bsc-self-destruct-balance-api) +### [BSC Self-Destruct Balance Tracker](/docs/blockchain/BSC/transaction-balance-tracker/bsc-self-destruct-balance-api) Monitor contract self-destruct events, ephemeral contracts (like MEV bots), and security incidents. Track contracts that self-destruct and addresses that receive funds from self-destructed contracts. diff --git a/docs/blockchain/BSC/uniswap-v4-api.md b/docs/blockchain/BSC/uniswap-v4-api.md index 22ae9a6e..ec4b0c1a 100644 --- a/docs/blockchain/BSC/uniswap-v4-api.md +++ b/docs/blockchain/BSC/uniswap-v4-api.md @@ -1,9 +1,8 @@ --- -title: "Uniswap V4 API - Track Trader Activities, Token Trades and Market Behaviour" -description: "Track Uniswap V4 trades, trader activities, token trades, and market behaviour in real time using Bitquery's DEX Trades API on BSC." +title: "BNB Chain Uniswap V4 API" +description: "BNB Chain Uniswap V4 API: query BNB Chain Uniswap trades, pools, and prices with Bitquery GraphQL DEX APIs. See examples in the Bitquery IDE." --- - -# Uniswap V4 API - Track Trader Activities, Token Trades and Market Behaviour +# Uniswap V4 API - Track Trader Activities, Token Trades and Market Behavior Uniswap v4 introduces a major shift in protocol architecture. Instead of deploying a separate smart contract for each liquidity pool, Uniswap v4 uses a singleton PoolManager contract that manages all pools internally as structured state. diff --git a/docs/blockchain/Base/aerodrome-base-api.mdx b/docs/blockchain/Base/aerodrome-base-api.mdx index ad517567..9d11ec64 100644 --- a/docs/blockchain/Base/aerodrome-base-api.mdx +++ b/docs/blockchain/Base/aerodrome-base-api.mdx @@ -1,6 +1,6 @@ --- -title: "Aerodrome Finance API - Base DEX Trades, Liquidity Pools, Token Analytics" -description: "Get real-time Aerodrome Finance DEX trades, liquidity pools, token prices, trading volume and analytics on Base network. Access comprehensive on-chain data via Aerodrome API, Streams and GraphQL." +title: "Base Aerodrome Base API" +description: "Base Aerodrome Base API: query and stream Base on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." sidebar_position: 7 --- import FAQ from "@site/src/components/FAQ"; @@ -14,49 +14,16 @@ If you have any questions on other data points, reach out to [support](https://t You may also be interested in: -- [Base Network DEX APIs ➤](https://docs.bitquery.io/docs/examples/dextrades/dex-api/) -- [Token Trades APIs ➤](https://docs.bitquery.io/docs/examples/dextrades/token-trades-apis/) -- [Liquidity Pool APIs ➤](https://docs.bitquery.io/docs/examples/dextrades/pools-api/) +- [Base Network DEX APIs ➤](/docs/blockchain/Ethereum/dextrades/dex-api/) +- [Token Trades APIs ➤](/docs/blockchain/Ethereum/dextrades/token-trades-apis/) +- [Liquidity Pool APIs ➤](/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api/) :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - -Aerodrome Finance API - Base DEX Trades, Liquidity Pools, Token Analytics - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; --- diff --git a/docs/blockchain/Base/aerodrome-gauge-vaults-api.md b/docs/blockchain/Base/aerodrome-gauge-vaults-api.md index c7888f47..43671b59 100644 --- a/docs/blockchain/Base/aerodrome-gauge-vaults-api.md +++ b/docs/blockchain/Base/aerodrome-gauge-vaults-api.md @@ -1,9 +1,8 @@ --- -title: "Aerodrome Gauge Vaults API — Base (Deposits, Withdraws, Rewards)" -description: "Track Aerodrome gauge vaults on Base: new gauges, deposits, withdraws, and reward claims. Query governance-directed emissions activity and LP staking flows via Bitquery GraphQL and Streams." +title: "Aerodrome Gauge Vaults API" +description: "Aerodrome Gauge Vaults API: query and stream Base on-chain data with Bitquery GraphQL examples for developers. Covers archive history and realtime data." sidebar_position: 7 --- - # Aerodrome Gauge Vaults API — Base (Deposits, Withdraws, Rewards) Aerodrome Finance gauge vaults are staking contracts for LP tokens that let liquidity providers earn AERO emissions. veAERO holders (who lock AERO for up to four years) vote every week to direct emissions across pool gauges. LPs staking in the most‑voted gauges earn more AERO, while veAERO voters receive trading fees from the pools they support and may be incentivized by external bribes. Users can also auto‑compound earned AERO into veAERO to build long‑term voting power. @@ -16,51 +15,18 @@ This page covers, on Base: You may also be interested in: -- [Base Network DEX APIs ➤](https://docs.bitquery.io/docs/examples/dextrades/dex-api/) -- [Token Trades APIs ➤](https://docs.bitquery.io/docs/examples/dextrades/token-trades-apis/) -- [Liquidity Pool APIs ➤](https://docs.bitquery.io/docs/examples/dextrades/pools-api/) +- [Base Network DEX APIs ➤](/docs/blockchain/Ethereum/dextrades/dex-api/) +- [Token Trades APIs ➤](/docs/blockchain/Ethereum/dextrades/token-trades-apis/) +- [Liquidity Pool APIs ➤](/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api/) Use the GraphQL queries below to monitor governance‑directed liquidity incentives across Aerodrome on Base. If you need other data points, reach out to [support](https://t.me/Bloxy_info). :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - -Aerodrome Gauge Vaults API — Base (Deposits, Withdraws, Rewards) - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; --- diff --git a/docs/blockchain/Base/ai-agent-base-data.mdx b/docs/blockchain/Base/ai-agent-base-data.mdx index 159010cc..d70c0298 100644 --- a/docs/blockchain/Base/ai-agent-base-data.mdx +++ b/docs/blockchain/Base/ai-agent-base-data.mdx @@ -1,3 +1,7 @@ +--- +title: "Build AI Trading Agents with Bitquery Base Chain Data" +description: "Build AI Trading Agents with Bitquery Base Chain Data: query and stream Base on-chain data with Bitquery GraphQL examples for developers." +--- # Build AI Trading Agents with Bitquery Base Chain Data In this section, we will explore how to use Bitquery APIs and real-time streams to build AI-enabled trading agents for the Base blockchain. diff --git a/docs/blockchain/Base/apestore-base-api.md b/docs/blockchain/Base/apestore-base-api.md index d5f5d7fb..7d334d39 100644 --- a/docs/blockchain/Base/apestore-base-api.md +++ b/docs/blockchain/Base/apestore-base-api.md @@ -1,24 +1,13 @@ --- title: "APE Store API - Base Chain Token Trades & Transaction Data" -description: "Query APE Store trades on Base using Bitquery Transaction and Calls APIs. Get token address, contract address, and trade events via GraphQL." +description: "APE Store API - Base Chain Token Trades & Transaction Data: query and stream Base on-chain data with Bitquery GraphQL examples for developers." sidebar_position: 7 keywords: ["APE Store API", "APE Store Base", "Base blockchain API", "Bitquery Base", "APE Store trades"] --- - - - - - - - - - - - # APE Store API -In this section we will see how we can use the [Transaction](https://docs.bitquery.io/docs/cubes/transaction-cube/) -and [Calls](https://docs.bitquery.io/docs/graphql-reference/enums/evm-call-compare-fields/) API from Bitquery to get info about trades on APE Store using one of the token address traded on the platform. For this section the token address is the following - `0xb2779752b8abe50e2a06bddd774bf0a40353f867`. +In this section we will see how we can use the [Transaction](/docs/cubes/transaction-cube/) +and [Calls](/docs/graphql-reference/enums/evm-call-compare-fields/) API from Bitquery to get info about trades on APE Store using one of the token address traded on the platform. For this section the token address is the following - `0xb2779752b8abe50e2a06bddd774bf0a40353f867`. ## Get APE Store Address @@ -92,7 +81,7 @@ query MyQuery { } } ``` -From the results we get a signature named `buy` that will be analysed to get the trades on APE Store. +From the results we get a signature named `buy` that will be analyzed to get the trades on APE Store. ## Get Trades for APE Store diff --git a/docs/blockchain/Base/base-balance-updates.mdx b/docs/blockchain/Base/base-balance-updates.mdx index bd1cdb4d..63c6eae4 100644 --- a/docs/blockchain/Base/base-balance-updates.mdx +++ b/docs/blockchain/Base/base-balance-updates.mdx @@ -1,11 +1,12 @@ --- sidebar_position: 1 +title: "Base Address Balance API" +description: "Base Address Balance API: fetch current and historical Base balances with Bitquery GraphQL balance queries. Great for bots, dashboards, and alerts." --- - # Base Address Balance API :::caution Deprecated APIs -On EVM, **`BalanceUpdates`** and **`TokenHolders`** are deprecated as of **20 May 2026** and will be removed on **15 June 2026**. Use **`EVM.Balances`** (this page) and **[Token Holders API](/docs/blockchain/Ethereum/token-holders/token-holder-api)** (`EVM.Holders`) instead. +On EVM, **`BalanceUpdates`** and **`TokenHolders`** were deprecated as of **20 May 2026** and removed on **15 June 2026**. Use **`EVM.Balances`** (this page) and **[Token Holders API](/docs/blockchain/Ethereum/token-holders/token-holder-api)** (`EVM.Holders`) instead. ::: The **Balances** API returns current and historical token balances for an address on Base. To return only non-zero balances, add `Amount(selectWhere: { gt: "0" })` on the `Balance` field (not in `where`). Use `dataset: combined` or `dataset: archive` as follows: diff --git a/docs/blockchain/Base/base-bankr-api.md b/docs/blockchain/Base/base-bankr-api.md index 40481c19..3e05bcd6 100644 --- a/docs/blockchain/Base/base-bankr-api.md +++ b/docs/blockchain/Base/base-bankr-api.md @@ -1,24 +1,10 @@ --- sidebar_position: 8 +title: "Base Bankr (Doppler) API" +description: "Base Bankr (Doppler) API: query and stream Base on-chain data with Bitquery GraphQL examples for developers. Built for traders and analytics teams." --- - # Base Bankr (Doppler) API - - - - - - - - - - - - - - - This page provides a set of queries to track tokens launched by **[Bankr](https://bankr.bot/)** on Base. Bankr deploys tokens using the **[Doppler Protocol](https://docs.doppler.lol/)** (canonical contracts maintained by Whetstone Research). Each token is minted into the Doppler **Airlock** orchestrator, seeded into a **Uniswap V4** multicurve pool via an initializer contract, and traded on V4 from the moment it launches. Bankr uses Doppler's `NoOpMigrator`, which means **liquidity never migrates** — the multicurve LP stays in the same V4 pool forever and fees stream out through `StreamableFeesLockerV2` to the creator and Doppler. Because of this, there is **no on-chain `Graduated` event** for Bankr tokens; "graduation" is inferred from curve exhaustion (initializer's token balance reaching zero, or the pool tick crossing the final curve segment). @@ -32,7 +18,7 @@ For the broader DEX schema, see: - [Base Token Market Cap API ➤](/docs/blockchain/Base/base-token-marketcap-api) :::note -To query or stream data via GraphQL **outside the Bitquery IDE**, you need to generate an API access token. Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorisation/how-to-generate/). +To query or stream data via GraphQL **outside the Bitquery IDE**, you need to generate an API access token. Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/). ::: ## Bankr / Doppler Contract Map (Base) diff --git a/docs/blockchain/Base/base-clanker-api.md b/docs/blockchain/Base/base-clanker-api.md index 4d80dcf6..346161bf 100644 --- a/docs/blockchain/Base/base-clanker-api.md +++ b/docs/blockchain/Base/base-clanker-api.md @@ -1,13 +1,14 @@ --- sidebar_position: 7 +title: "Base Clanker API" +description: "Base Clanker API: query and stream Base on-chain data with Bitquery GraphQL examples for developers. Great for bots, dashboards, and alerts." --- - # Base Clanker API This section provides you with a set of queries that provides an insight about the Clank fun. Clank.fun is a platform on the Base blockchain that allows users to launch and trade meme coins. Each coin is deployed as an ERC-20 token on Uniswap V3 with permanently locked single-sided liquidity of 1,000,000,000 coin. To launch a token, users must hold at least 1,000,000 $CLANKFUN tokens. Token creators earn 0.4% of the trading volume in liquidity provider (LP) fees, which can be claimed anytime on clanker.world. -You can see [Uniswap guide](https://docs.bitquery.io/docs/examples/Base/base-uniswap-api/) to get latest trades of these tokens, top traders, OHLCV, get token metadata, top bought tokens, top sold tokens, etc. For live DEX prices across Clanker-launched tokens, see [DEXrabbit's Clanker category](https://dexrabbit.bitquery.io/categories/clanker-ecosystem). +You can see [Uniswap guide](/docs/blockchain/Base/base-uniswap-api/) to get latest trades of these tokens, top traders, OHLCV, get token metadata, top bought tokens, top sold tokens, etc. For live DEX prices across Clanker-launched tokens, see [DEXrabbit's Clanker category](https://dexrabbit.bitquery.io/categories/clanker-ecosystem). ## Latest Tokens created using Clanker diff --git a/docs/blockchain/Base/base-coins-api.mdx b/docs/blockchain/Base/base-coins-api.mdx index 24b3e0e0..5cecbd94 100644 --- a/docs/blockchain/Base/base-coins-api.mdx +++ b/docs/blockchain/Base/base-coins-api.mdx @@ -1,7 +1,8 @@ --- sidebar_position: 7 +title: "Base Network Coins API" +description: "Base Network Coins API: query and stream Base on-chain data with Bitquery GraphQL examples for developers. Great for bots, dashboards, and alerts." --- - import VideoPlayer from "../../../src/components/videoplayer.js"; # Base Network Coins API @@ -233,7 +234,7 @@ query MyQuery { } ``` -You can checkout more queries related to tokens and token trades [here](https://docs.bitquery.io/docs/examples/dextrades/token-trades-apis/#ohlc-in-usd-of-a-token). +You can checkout more queries related to tokens and token trades [here](/docs/blockchain/Ethereum/dextrades/token-trades-apis/#ohlc-in-usd-of-a-token). ## Video Tutorial to Get Latest Memecoins on Base diff --git a/docs/blockchain/Base/base-dextrades.mdx b/docs/blockchain/Base/base-dextrades.mdx index ded1805f..eab6bc45 100644 --- a/docs/blockchain/Base/base-dextrades.mdx +++ b/docs/blockchain/Base/base-dextrades.mdx @@ -1,44 +1,18 @@ --- sidebar_position: 2 +title: "Base Chain DEX Trades API" +description: "Base Chain DEX Trades API: get Base DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Keep queries fast with indexed filters." --- import FAQ from "@site/src/components/FAQ"; # Base Chain DEX Trades API :::tip Need real-time Base DEX data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API** (filter with `Pair.Market.Network: Base`). Use this page when you need **historical Base data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API** (filter with `Pair.Market.Network: Base`). Use this page when you need **historical Base data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. ::: - In this section we will see how to get Base DEX trades information using our API. - - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Live DEX swap stream (Base) {#crypto-trades-live-stream} @@ -127,7 +101,7 @@ subscription { This example uses the chain-specific **DEXTrades** cube via `EVM(network: base) { DEXTrades }` (pool-side Buy/Sell; see [DEXTrades cube](/docs/cubes/dextrades)). USD can be weak on small tokens. For trader + USD swap rows, use the [stream at the top](#crypto-trades-live-stream). -Read [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. +Read [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. You can find the query [here](https://ide.bitquery.io/subscribe-to-dex-trades-on-base) ``` @@ -235,8 +209,6 @@ subscription { } } - - ``` ## Latest USD Price of a Token @@ -285,7 +257,6 @@ subscription { } } - ``` ## Get First 500 Buyers of a specific token @@ -502,7 +473,7 @@ Get up to 100 tokens with aggregated USD volume and average price over the last ## Trader-Focused Trade APIs (with USD Price, Market Cap & Supply) -The queries below use the **[Trades cube](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. +The queries below use the **[Trades cube](/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. ### Get All DEX Trades on Base With Price, Market Cap, and Supply diff --git a/docs/blockchain/Base/base-jump-base-api.md b/docs/blockchain/Base/base-jump-base-api.md index d5a6fd75..1c1b999f 100644 --- a/docs/blockchain/Base/base-jump-base-api.md +++ b/docs/blockchain/Base/base-jump-base-api.md @@ -1,11 +1,12 @@ --- sidebar_position: 7 +title: "Base Jump Base API" +description: "Base Jump Base API: query and stream Base on-chain data with Bitquery GraphQL examples for developers. Keep queries fast with indexed filters." --- - # Base Jump API -In this section we will see how we can use the [Transaction](https://docs.bitquery.io/docs/cubes/transaction-cube/) -and [Calls](https://docs.bitquery.io/docs/graphql-reference/enums/evm-call-compare-fields/) API from Bitquery to get info about trades on Base Jump using one of the token address traded on the platform. For this section the token address is the following - `0xEfC79f30b56f36bc49Bf47e8Dccf969fFF214EeD`. +In this section we will see how we can use the [Transaction](/docs/cubes/transaction-cube/) +and [Calls](/docs/graphql-reference/enums/evm-call-compare-fields/) API from Bitquery to get info about trades on Base Jump using one of the token address traded on the platform. For this section the token address is the following - `0xEfC79f30b56f36bc49Bf47e8Dccf969fFF214EeD`. ## Get Base Jump Address @@ -78,7 +79,7 @@ query MyQuery { } } ``` -From the results we get a signature named `swap` that will be analysed to get the trades on Base Jump. +From the results we get a signature named `swap` that will be analyzed to get the trades on Base Jump. ## Get Trades for Base Jump diff --git a/docs/blockchain/Base/base-liquidity-api.md b/docs/blockchain/Base/base-liquidity-api.md index e3f47c59..ae3a17dd 100644 --- a/docs/blockchain/Base/base-liquidity-api.md +++ b/docs/blockchain/Base/base-liquidity-api.md @@ -1,38 +1,12 @@ --- sidebar_position: 15 +title: "Base Liquidity API" +description: "Base Liquidity API: read Base pool reserves and liquidity updates via Bitquery GraphQL DEX APIs. Covers archive history and realtime data." --- - # Base Liquidity API In this section we will see how to get Base DEX pool liquidity information using Bitquery API. The liquidity API helps you monitor real-time liquidity changes, track pool reserves, and analyze liquidity depth for token pairs on Base DEX pools. - - - - - - - - - - - - - - - - - - - - - ## Understanding Liquidity and Pool Reserves Liquidity in DEX pools refers to the amount of tokens available for trading. Pool reserves (the balance of each token in the pool) determine the pool's ability to handle trades without significant price impact. Monitoring liquidity changes helps you: @@ -49,7 +23,7 @@ The DEXPoolEvents API provides real-time information about: - Pool and token pair information - Transaction details for liquidity-changing events -For a comprehensive explanation of how DEX pools work, liquidity calculations, and when pool events are emitted, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/). +For a comprehensive explanation of how DEX pools work, liquidity calculations, and when pool events are emitted, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/). ## Realtime Liquidity Stream @@ -380,7 +354,7 @@ Kafka streams provide the same liquidity data as GraphQL subscriptions but with - Ability to read from latest offset without gaps - Better scalability with multiple consumers -For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](/docs/streams/kafka-streaming-concepts/). > **Note:** IDE credentials will not work with Kafka Streams. You need separate Kafka credentials. Please contact sales on our official telegram channel or fill out the [form on our website](https://bitquery.io/forms/api). @@ -413,7 +387,7 @@ The `DEXPoolEvents` API response contains the following information: - `Hash`: Transaction hash - `Gas`: Gas used for the transaction -For more details on when new pool events are emitted and how liquidity is calculated, see the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). +For more details on when new pool events are emitted and how liquidity is calculated, see the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). ## Use Cases @@ -451,4 +425,4 @@ Track liquidity events that may create trading opportunities: - Monitor liquidity removals that may signal pool abandonment - Identify pools experiencing rapid liquidity growth -For more advanced use cases, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). +For more advanced use cases, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). diff --git a/docs/blockchain/Base/base-nft.md b/docs/blockchain/Base/base-nft.md index fca4560b..f8903dc8 100644 --- a/docs/blockchain/Base/base-nft.md +++ b/docs/blockchain/Base/base-nft.md @@ -1,36 +1,11 @@ +--- +title: "Base NFT Trades and Metadata API" +description: "Base NFT API: track Base NFT trades, ownership, and metadata with Bitquery GraphQL and streams. Includes filters and field selection tips." +--- # Base Chain NFT API In this section we'll have a look at some examples on how to get NFT information on Base using the NFT API. - - - - - - - - - - - - - - - - - - - - - - - ## Track transfers of an NFT This query subscribes you to the real time transfers of a specific non-fungible token (NFT) on the Base network. @@ -67,6 +42,4 @@ subscription { } } - - ``` diff --git a/docs/blockchain/Base/base-slippage-api.md b/docs/blockchain/Base/base-slippage-api.md index 1bcff008..2ab45869 100644 --- a/docs/blockchain/Base/base-slippage-api.md +++ b/docs/blockchain/Base/base-slippage-api.md @@ -1,38 +1,12 @@ --- sidebar_position: 3 +title: "Base Slippage API" +description: "Base Slippage API: measure Base DEX price impact and slippage with Bitquery GraphQL pool metrics. Scale further with Kafka or gRPC streams." --- - # Base Slippage API In this section we will see how to get Base DEX pool slippage information using our API. The slippage API helps you understand price impact and liquidity depth for token swaps on Base DEX pools. - - - - - - - - - - - - - - - - - - - - - ## Understanding Slippage and Price Impact Slippage refers to the difference between the expected price of a trade and the actual execution price. When swapping tokens in a DEX pool, larger trades can move the price due to limited liquidity, resulting in slippage. @@ -43,7 +17,7 @@ The DEXPoolSlippages API provides detailed information about: - Average execution prices for different trade sizes - Price impact calculations for both swap directions (A to B and B to A) -For a comprehensive explanation of how DEX pools work, liquidity calculations, and price tables, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/). +For a comprehensive explanation of how DEX pools work, liquidity calculations, and price tables, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/). ## Realtime Slippage Monitoring @@ -181,7 +155,7 @@ Kafka streams provide the same slippage data as GraphQL subscriptions but with s - Ability to read from latest offset without gaps - Better scalability with multiple consumers -For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](/docs/streams/kafka-streaming-concepts/). > **Note:** IDE credentials will not work with Kafka Streams. You need separate Kafka credentials. Please contact sales on our official telegram channel or fill out the [form on our website](https://bitquery.io/forms/api). @@ -203,7 +177,7 @@ The `DEXPoolSlippages` API response contains the following information: - `Time`: Timestamp of the block - `Number`: Block number -For more details on how slippage is calculated and when new pool records are emitted, see the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). +For more details on how slippage is calculated and when new pool records are emitted, see the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). ## Use Cases @@ -250,4 +224,4 @@ For a practical implementation example of using slippage data for automated trad - Execute fade trades against temporary price impacts - Manage positions with dynamic stop losses and take profits based on slippage data -For more advanced use cases, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). +For more advanced use cases, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). diff --git a/docs/blockchain/Base/base-token-marketcap-api.md b/docs/blockchain/Base/base-token-marketcap-api.md index 0a5f1fe2..476cff26 100644 --- a/docs/blockchain/Base/base-token-marketcap-api.md +++ b/docs/blockchain/Base/base-token-marketcap-api.md @@ -1,28 +1,14 @@ --- sidebar_position: 10 +title: "Base Token Market Cap API" +description: "Base Token Market Cap API: stream Base market cap, FDV, supply, and price using Bitquery Trading GraphQL APIs. Includes filters and field selection tips." --- - # Base Token Market Cap API Use Bitquery’s **Trading** API **`Tokens`** cube to stream or query **market cap**, **fully diluted valuation (USD)**, **total supply**, **price** (OHLC and averages), and **volume** for tokens traded on **Base**. Filter Base assets with token/currency **`Id`** values such as **`base:`** plus a **lowercase** contract address. For schema details and field meanings, see the **[Tokens cube](/docs/trading/crypto-price-api/tokens)** and **[Supply fields](/docs/trading/crypto-price-api/supply-fields)**. - - - - - - - - - - - - - - - :::note Trading API and EVM addresses On **Base** (EVM), the **Trading** API expects **lowercase** hex in **`Id`** values (e.g. `base:0x1f1c…`, not mixed-case checksum addresses). ::: diff --git a/docs/blockchain/Base/base-transfers.mdx b/docs/blockchain/Base/base-transfers.mdx index 0f6ae9f9..48509c41 100644 --- a/docs/blockchain/Base/base-transfers.mdx +++ b/docs/blockchain/Base/base-transfers.mdx @@ -1,31 +1,11 @@ +--- +title: "Base Chain Token Transfers API" +description: "Base Chain Token Transfers API: monitor Base native and token transfers in real time with Bitquery GraphQL APIs. Run it in the IDE, then ship in your app." +--- # Base Chain Token Transfers API In this section we'll have a look at some examples using the Base Transfers API. - - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Subscribe to Recent Whale Transactions of a particular currency @@ -59,8 +39,6 @@ subscription { } } - - ``` ## Sender is a particular address diff --git a/docs/blockchain/Base/base-uniswap-api.md b/docs/blockchain/Base/base-uniswap-api.md index f9234ec0..b562f0bb 100644 --- a/docs/blockchain/Base/base-uniswap-api.md +++ b/docs/blockchain/Base/base-uniswap-api.md @@ -1,5 +1,7 @@ --- sidebar_position: 7 +title: "Base Uniswap API" +description: "Base Uniswap API: query Base Uniswap trades, pools, and prices with Bitquery GraphQL DEX APIs. Built for traders and analytics teams." --- import FAQ from "@site/src/components/FAQ"; @@ -8,50 +10,26 @@ import VideoPlayer from "../../../src/components/videoplayer.js"; # Base Uniswap API :::tip Need real-time Base Uniswap data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Base Uniswap swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Base Uniswap data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Base Uniswap swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Base Uniswap data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Bitquery provides Uniswap data through APIs, Streams and Data Dumps. The below graphQL APIs and Streams are examples of data points you can get with Bitquery for Uniswap on Base. If you have any question on other data points reach out to [support](https://t.me/Bloxy_info) -Need zero-latency Base data? [Read about our Kafka Streams and Contact us for a Trial](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +Need zero-latency Base data? [Read about our Kafka Streams and Contact us for a Trial](/docs/streams/kafka-streaming-concepts/). You may also be interested in: -- [Clanker APIs ➤](https://docs.bitquery.io/docs/examples/Base/base-clanker-api/) -- [Base DEX Trade APIs ➤](https://docs.bitquery.io/docs/examples/Base/base-dextrades/) +- [Clanker APIs ➤](/docs/blockchain/Base/base-clanker-api/) +- [Base DEX Trade APIs ➤](/docs/blockchain/Base/base-dextrades/) :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - - - - - - - - - - - - - - - - - ## Get Latest Trades on Uniswap v3 Below query will subscribe you to the latest DEX Trades on Uniswap v3. Try out the API [here](https://ide.bitquery.io/uniswap-v3-trades_2) @@ -314,7 +292,7 @@ query MyQuery { ## Building with Bitquery and Uniswap API -Check [this](../../usecases/base-sniper-bot.mdx) guide to get started with building projects with real world value using Bitquery Uniswap APIs. +Check [this](/docs/usecases/base-sniper-bot/) guide to get started with building projects with real world value using Bitquery Uniswap APIs. - - - - - - - - - - - - - - - - ## Get Latest Trades on PancakeSwap Infinity Below query will subscribe you to the latest DEX Trades on PancakeSwap Infinity. Try out the API [here](https://ide.bitquery.io/pancakeswap-infinity-trades) diff --git a/docs/blockchain/Base/transaction-balance-tracker/base-gas-balance-tracker.md b/docs/blockchain/Base/transaction-balance-tracker/base-gas-balance-tracker.md index 25889090..685c80a8 100644 --- a/docs/blockchain/Base/transaction-balance-tracker/base-gas-balance-tracker.md +++ b/docs/blockchain/Base/transaction-balance-tracker/base-gas-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 6 +title: "Base Gas Balance Tracker" +description: "Base Gas Balance Tracker: stream Base balance changes with reason codes using Bitquery GraphQL subscriptions. See examples in the Bitquery IDE." --- - # Base Gas Balance Tracker The Base Gas Balance Tracker API provides real-time balance updates related to Gas Fee activities, including transaction fee rewards, monitoring gas fee spent, and other GAS-related balance changes. - - - - - - - - - - - - - - - - - - - ## Get Top Gas Fee Collectors [This](https://ide.bitquery.io/top-gas-fee-collectors-base) API endpoint returns the list of top gas fee collectors. We are tracking the Gas Collection Event causing Balance Update by appliying condition on `BalanceChangeReasonCode` to be equal to `5`. @@ -155,4 +131,3 @@ subscription { } ``` - diff --git a/docs/blockchain/Base/transaction-balance-tracker/base-mev-balance-tracker.md b/docs/blockchain/Base/transaction-balance-tracker/base-mev-balance-tracker.md index d3a3cdeb..76b1f2bd 100644 --- a/docs/blockchain/Base/transaction-balance-tracker/base-mev-balance-tracker.md +++ b/docs/blockchain/Base/transaction-balance-tracker/base-mev-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 4 +title: "Base MEV Balance Tracker" +description: "Base MEV Balance Tracker: stream Base balance changes with reason codes using Bitquery GraphQL subscriptions. Copy GraphQL snippets for production apps." --- - # Base MEV Balance Tracker The Base MEV (Maximal Extractable Value) Balance Tracker API provides real-time balance updates related to MEV activities, including transaction fee rewards, block builder rewards, and other MEV-related balance changes. - - - - - - - - - - - - - - - - - - - ## Track MEV-Related Balance Updates Monitor balance changes related to MEV activities, including transaction fee rewards and block builder rewards. Try the API [here](https://ide.bitquery.io/Track-MEV-Related-Balance-Updates-base). diff --git a/docs/blockchain/Base/transaction-balance-tracker/base-miner-balance-tracker.md b/docs/blockchain/Base/transaction-balance-tracker/base-miner-balance-tracker.md index e9ceab89..dd99c5a9 100644 --- a/docs/blockchain/Base/transaction-balance-tracker/base-miner-balance-tracker.md +++ b/docs/blockchain/Base/transaction-balance-tracker/base-miner-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 3 +title: "Base Miner Balance Tracker" +description: "Base Miner Balance Tracker: stream Base balance changes with reason codes using Bitquery GraphQL subscriptions. Copy GraphQL snippets for production apps." --- - # Base Miner Balance Tracker The Base Miner Balance Tracker API provides real-time balance updates for Base miners, tracking their mining rewards, uncle block rewards, and transaction fee rewards. - - - - - - - - - - - - - - - - - - - ## Track Miner Balance Updates Monitor balance changes for Base miners, including block rewards, uncle block rewards, and transaction fee rewards. Try the API [here](https://ide.bitquery.io/Track-Miner-Balance-Updates-base). diff --git a/docs/blockchain/Base/transaction-balance-tracker/base-self-destruct-balance-api.md b/docs/blockchain/Base/transaction-balance-tracker/base-self-destruct-balance-api.md index 7e828196..367c547f 100644 --- a/docs/blockchain/Base/transaction-balance-tracker/base-self-destruct-balance-api.md +++ b/docs/blockchain/Base/transaction-balance-tracker/base-self-destruct-balance-api.md @@ -1,36 +1,12 @@ --- sidebar_position: 5 +title: "Base Self-Destruct Balance Tracker" +description: "Base Self-Destruct Balance Tracker: stream Base balance changes with reason codes using Bitquery GraphQL subscriptions. See examples in the Bitquery IDE." --- - # Base Self-Destruct Balance Tracker The Base Self-Destruct Balance Tracker API provides real-time balance updates for contracts that self-destruct and addresses that receive funds from self-destructed contracts. This API helps you monitor contract destruction events, track ephemeral contracts (like MEV bots), and analyze security incidents. - - - - - - - - - - - - - - - - - - - ## What is Self-Destruct? The `selfdestruct` opcode allows a smart contract to permanently remove its bytecode from the blockchain and send its remaining ETH balance to a specified recipient address. Once a contract self-destructs, it can no longer execute code or receive transactions. diff --git a/docs/blockchain/Base/transaction-balance-tracker/base-transaction-balance-tracker.md b/docs/blockchain/Base/transaction-balance-tracker/base-transaction-balance-tracker.md index 626ad092..74dbec4c 100644 --- a/docs/blockchain/Base/transaction-balance-tracker/base-transaction-balance-tracker.md +++ b/docs/blockchain/Base/transaction-balance-tracker/base-transaction-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 1 +title: "Base Transaction Balance Tracker" +description: "Base Transaction Balance Tracker: stream Base balance changes with reason codes using Bitquery GraphQL subscriptions. See examples in the Bitquery IDE." --- - # Base Transaction Balance Tracker The Base Transaction Balance Tracker API provides real-time balance updates for all addresses involved in transactions on the Base blockchain, including detailed information about the reason for each balance change. - - - - - - - - - - - - - - - - - - - ## Subscribe to All Transaction Balances This subscription provides real-time balance updates for all addresses involved in transactions on the Base network. diff --git a/docs/blockchain/Base/transaction-balance-tracker/base-transfer-balance-tracker.md b/docs/blockchain/Base/transaction-balance-tracker/base-transfer-balance-tracker.md index 0e61bde5..03fcd6d6 100644 --- a/docs/blockchain/Base/transaction-balance-tracker/base-transfer-balance-tracker.md +++ b/docs/blockchain/Base/transaction-balance-tracker/base-transfer-balance-tracker.md @@ -1,7 +1,8 @@ --- sidebar_position: 7 +title: "Base Transfer Balance Tracker" +description: "Base Transfer Balance Tracker: monitor Base native and token transfers in real time with Bitquery GraphQL APIs. Copy GraphQL snippets for production apps." --- - # Base Transfer Balance Tracker The Base Transfer Balance Tracker API provides real-time balance updates for all addresses involved in Transfers on the Base blockchain, and provides option to filter out based on the direction of transfer you want to target. The Base Transfer Balance is tracked by marking the the `BalanceUpdateReason` equals `10`. @@ -10,31 +11,6 @@ The Base Transfer Balance Tracker API provides real-time balance updates for all The queries covered this section are only valid for the Native Currency Transfer. ::: - - - - - - - - - - - - - - - - - - - ## Get Balance Info for an Address after Transfer [This](https://ide.bitquery.io/balance-update-from-transfer-for-an-address-base) query returns the Balance Info such as PreBalance, PostBalance, Balances in USD and transfer amount for a particular address after a transfer, irrespective of the direction of transfer. diff --git a/docs/blockchain/Base/transaction-balance-tracker/index.md b/docs/blockchain/Base/transaction-balance-tracker/index.md index e8243cf4..9c614bc8 100644 --- a/docs/blockchain/Base/transaction-balance-tracker/index.md +++ b/docs/blockchain/Base/transaction-balance-tracker/index.md @@ -1,12 +1,11 @@ --- title: Base Transaction Balance Tracker API -description: Access comprehensive Base Transaction Balance Tracker APIs for real-time balance updates, validator tracking, miner rewards, MEV analysis, and self-destruct monitoring. GraphQL API with subscriptions. +description: "Base Transaction Balance Tracker API: stream Base balance changes with reason codes using Bitquery GraphQL subscriptions." slug: /blockchain/Base/transaction-balance-tracker/ keywords: - Base Transaction Balance Tracker - Base Balance API - Transaction Balance API - - Validator Balance Tracker - Miner Balance Tracker - MEV Balance Tracker - Self-Destruct Balance API @@ -14,14 +13,13 @@ keywords: - Balance Change Reason Codes - Real-time Balance Updates --- - # Base Transaction Balance Tracker API - Complete Guide ## What is Transaction Balance Tracker? The **Base Transaction Balance Tracker API** provides real-time balance updates for all addresses involved in transactions on the Base blockchain. Unlike traditional balance APIs that only show current balances, our Transaction Balance Tracker captures every balance change with detailed information about the reason for each change, making it perfect for building comprehensive transaction monitoring, portfolio tracking, and blockchain analytics applications. -Our Transaction Balance Tracker APIs track balance changes across different scenarios including regular transactions, validator rewards, miner rewards, MEV activities, and contract self-destruct events. Each balance change is enriched with reason codes, pre/post balances, USD values, and transaction context. +Our Transaction Balance Tracker APIs track balance changes across different scenarios including regular transactions, miner rewards, MEV activities, and contract self-destruct events. Each balance change is enriched with reason codes, pre/post balances, USD values, and transaction context. ## Key Features @@ -30,15 +28,15 @@ Our Transaction Balance Tracker APIs track balance changes across different scen - **Comprehensive Coverage**: Track native ETH, ERC-20 tokens, ERC-721, and ERC-1155 NFTs - **Historical Data**: Access complete historical balance change data since Base genesis - **USD Values**: Get balance values in USD for portfolio tracking and analytics -- **Multiple Use Cases**: Monitor validators, miners, MEV bots, self-destruct events, and more +- **Multiple Use Cases**: Monitor miners, MEV bots, self-destruct events, and more ## Getting Started New to Transaction Balance Tracker? Here's how to get started: 1. **[Create a free account](https://ide.bitquery.io/)** - Get instant access to our GraphQL IDE -2. **[Generate your API key](https://docs.bitquery.io/docs/authorisation/how-to-generate/)** - Required for API access -3. **[Run your first query](https://docs.bitquery.io/docs/start/first-query/)** - Learn the basics in 5 minutes +2. **[Generate your API key](/docs/authorization/how-to-generate/)** - Required for API access +3. **[Run your first query](/docs/start/first-query/)** - Learn the basics in 5 minutes 4. **[Explore examples](#base-transaction-balance-tracker-apis)** - Copy-paste ready queries below Need help crafting a query or subscription? Message us on [support](https://t.me/Bloxy_info). @@ -59,11 +57,11 @@ Get live Base balance updates through our streaming solutions: - **GraphQL Subscriptions**: Convert any query to a live stream by changing `query` to `subscription` - **Kafka Streaming**: High-throughput streaming for enterprise applications -See examples and code snippets [here](https://docs.bitquery.io/docs/subscriptions/websockets/) for GraphQL subscription implementation, and learn about [Kafka streaming](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) for high-volume use cases. +See examples and code snippets [here](/docs/subscriptions/websockets/) for GraphQL subscription implementation, and learn about [Kafka streaming](/docs/streams/kafka-streaming-concepts/) for high-volume use cases. ## Base Transaction Balance Tracker APIs -### [Base Transaction Balance Tracker](https://docs.bitquery.io/docs/blockchain/Base/transaction-balance-tracker/base-transaction-balance-tracker) +### [Base Transaction Balance Tracker](/docs/blockchain/Base/transaction-balance-tracker/base-transaction-balance-tracker) The core Transaction Balance Tracker API provides real-time balance updates for all addresses involved in transactions on the Base network, including detailed information about the reason for each balance change. Track native ETH, ERC-20 tokens, and NFTs with pre/post balances, USD values, and balance change reason codes. @@ -74,18 +72,7 @@ The core Transaction Balance Tracker API provides real-time balance updates for - Track ERC-20, ERC-721, and ERC-1155 tokens - Access pre and post balance values -### [Base Validator Balance Tracker](https://docs.bitquery.io/docs/blockchain/Base/transaction-balance-tracker/base-validator-balance-tracker) - -Track Base validator balances, staking rewards, and withdrawals from the beacon chain. Monitor validator activity including block rewards, withdrawal events, and transaction fee rewards. - -**Key Features:** -- Track validator staking rewards (Code 2) -- Monitor beacon chain withdrawals (Code 3) -- Track transaction fee rewards (Code 5) -- Filter by specific validator addresses -- Real-time validator balance updates - -### [Base Miner Balance Tracker](https://docs.bitquery.io/docs/blockchain/Base/transaction-balance-tracker/base-miner-balance-tracker) +### [Base Miner Balance Tracker](/docs/blockchain/Base/transaction-balance-tracker/base-miner-balance-tracker) Monitor Base miner balances, mining rewards, uncle block rewards, and transaction fee rewards. Track historical and real-time mining activity across the Base network. @@ -96,7 +83,7 @@ Monitor Base miner balances, mining rewards, uncle block rewards, and transactio - Filter by specific miner addresses - Historical mining reward data -### [Base MEV Balance Tracker](https://docs.bitquery.io/docs/blockchain/Base/transaction-balance-tracker/base-mev-balance-tracker) +### [Base MEV Balance Tracker](/docs/blockchain/Base/transaction-balance-tracker/base-mev-balance-tracker) Track MEV (Maximal Extractable Value) related balance changes including transaction fee rewards, block builder rewards, and other MEV extraction activities. Monitor MEV bots and block builders in real-time. @@ -107,7 +94,7 @@ Track MEV (Maximal Extractable Value) related balance changes including transact - Track large MEV transactions - Aggregate MEV reward statistics -### [Base Self-Destruct Balance Tracker](https://docs.bitquery.io/docs/blockchain/Base/transaction-balance-tracker/base-self-destruct-balance-api) +### [Base Self-Destruct Balance Tracker](/docs/blockchain/Base/transaction-balance-tracker/base-self-destruct-balance-api) Monitor contract self-destruct events, ephemeral contracts (like MEV bots), and security incidents. Track contracts that self-destruct and addresses that receive funds from self-destructed contracts. diff --git a/docs/blockchain/Base/uniswap-v4-api.md b/docs/blockchain/Base/uniswap-v4-api.md index 2e7f8f23..7c1ec3d7 100644 --- a/docs/blockchain/Base/uniswap-v4-api.md +++ b/docs/blockchain/Base/uniswap-v4-api.md @@ -1,9 +1,8 @@ --- -title: "Uniswap V4 API - Track Trader Activities, Token Trades and Market Behaviour" -description: "Track Uniswap V4 trades, trader activities, token trades, and market behaviour in real time using Bitquery's DEX Trades API on Base." +title: "Base Uniswap V4 API" +description: "Base Uniswap V4 API: query Base Uniswap trades, pools, and prices with Bitquery GraphQL DEX APIs. Scale further with Kafka or gRPC streams." --- - -# Uniswap V4 API - Track Trader Activities, Token Trades and Market Behaviour +# Uniswap V4 API - Track Trader Activities, Token Trades and Market Behavior Uniswap v4 introduces a major shift in protocol architecture. Instead of deploying a separate smart contract for each liquidity pool, Uniswap v4 uses a singleton PoolManager contract that manages all pools internally as structured state. diff --git a/docs/blockchain/Bitcoin/bitcoin-address-api.md b/docs/blockchain/Bitcoin/bitcoin-address-api.md index be4d5af4..8f7b7d8c 100644 --- a/docs/blockchain/Bitcoin/bitcoin-address-api.md +++ b/docs/blockchain/Bitcoin/bitcoin-address-api.md @@ -1,7 +1,7 @@ --- -title: Bitcoin Address API - Get BTC Balance, UTXO Activity & USD Values +title: "Bitcoin Address API - Get BTC Balance" sidebar_label: Bitcoin Address API -description: Query Bitcoin address balances from raw UTXOs, balance at a historical block height, multi-address aggregates, first/last active timestamps, and per-period activity. +description: "Bitcoin Address API - Get BTC Balance: query and stream Bitcoin on-chain data with Bitquery GraphQL examples for developers." keywords: - Bitcoin address API - Bitcoin balance API @@ -13,7 +13,6 @@ keywords: - addressStats Bitcoin - Bitquery Bitcoin --- - # Bitcoin Address API Bitcoin doesn't store account balances on-chain — there is no `getBalance` call. The reliable way to get an address balance is to sum every UTXO the address received (outputs) and subtract every UTXO it has spent (inputs). Bitquery indexes that UTXO data and pairs every value with the BTC/USD price at the time of the transaction, so you can pull current balances, historical balances at a specific block, or full activity timelines in a single request. @@ -235,6 +234,6 @@ Returns every UTXO an address spent or received inside a time window, with block ## Related resources -- [Bitcoin Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — more UTXO patterns, miner rewards, and historical BTC price -- [Bitcoin Transactions API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-transactions-api) — per-tx detail and pagination -- [Bitcoin Coinpath API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-coinpath-api) — multi-hop fund tracing +- [Bitcoin Inputs and Outputs API](/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — more UTXO patterns, miner rewards, and historical BTC price +- [Bitcoin Transactions API](/docs/blockchain/Bitcoin/bitcoin-transactions-api) — per-tx detail and pagination +- [Bitcoin Coinpath API](/docs/blockchain/Bitcoin/bitcoin-coinpath-api) — multi-hop fund tracing diff --git a/docs/blockchain/Bitcoin/bitcoin-blocks-api.md b/docs/blockchain/Bitcoin/bitcoin-blocks-api.md index f62490c9..17e42860 100644 --- a/docs/blockchain/Bitcoin/bitcoin-blocks-api.md +++ b/docs/blockchain/Bitcoin/bitcoin-blocks-api.md @@ -1,7 +1,7 @@ --- -title: Bitcoin Blocks API - Query Blocks by Height, Difficulty & Transaction Count +title: "Bitcoin Blocks API" sidebar_label: Bitcoin Blocks API -description: Pull Bitcoin blocks with height, difficulty, size, transaction counts, and timestamps via Bitquery's GraphQL Blocks API. Build explorer features and mining analytics. +description: "Bitcoin Blocks API: query and stream Bitcoin on-chain data with Bitquery GraphQL examples for developers. Run it in the IDE, then ship in your app." keywords: - Bitcoin blocks API - Bitcoin block explorer API @@ -12,7 +12,6 @@ keywords: - BTC block size - Bitquery Bitcoin --- - # Bitcoin Blocks API The Blocks API returns block-level data on Bitcoin: height, difficulty, size, transaction count, and timestamp. Use it to drive explorer front-ends, monitor chain progression, or pull historical block context for mining and network analytics. @@ -66,6 +65,6 @@ Swap the sort to `desc: "difficulty"` or `desc: "blockSizeBigInt"` for different ## Related resources -- [Bitcoin Transactions API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-transactions-api) — per-block transaction details and fees -- [Bitcoin Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — UTXO data and miner rewards -- [Bitcoin Kafka stream](https://docs.bitquery.io/docs/streams/protobuf/chains/Bitcoin-protobuf) — real-time block and transaction delivery +- [Bitcoin Transactions API](/docs/blockchain/Bitcoin/bitcoin-transactions-api) — per-block transaction details and fees +- [Bitcoin Inputs and Outputs API](/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — UTXO data and miner rewards +- [Bitcoin Kafka stream](/docs/streams/protobuf/chains/Bitcoin-protobuf) — real-time block and transaction delivery diff --git a/docs/blockchain/Bitcoin/bitcoin-coinpath-api.md b/docs/blockchain/Bitcoin/bitcoin-coinpath-api.md index d07dbc79..4271f3fa 100644 --- a/docs/blockchain/Bitcoin/bitcoin-coinpath-api.md +++ b/docs/blockchain/Bitcoin/bitcoin-coinpath-api.md @@ -1,7 +1,7 @@ --- title: Bitcoin Coinpath API - Trace BTC Fund Flows Across Addresses sidebar_label: Bitcoin Coinpath API -description: Trace Bitcoin fund flows between addresses with Bitquery Coinpath. Track inbound and outbound paths, multi-hop tracing, and address-to-address verification for AML and forensics. +description: "Bitcoin Coinpath API - Trace BTC Fund Flows Across Addresses: query and stream Bitcoin on-chain data with Bitquery GraphQL examples for developers." keywords: - Bitcoin coinpath API - Bitcoin fund tracing @@ -12,7 +12,6 @@ keywords: - Bitcoin GraphQL - Bitquery Bitcoin --- - # Bitcoin Coinpath API Coinpath walks Bitcoin fund flows between addresses — forward to see where funds went, backward to see where they came from. Use it for AML investigations, source-of-funds verification, exchange deposit tracing, and mapping transaction paths across wallets. @@ -130,6 +129,6 @@ import VideoPlayer from "../../../src/components/videoplayer.js"; ## Related resources -- [Bitcoin Address API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-address-api) — balances and activity stats -- [Bitcoin Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — UTXO-level inflows and outflows -- [Bitcoin Transactions API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-transactions-api) — per-tx detail +- [Bitcoin Address API](/docs/blockchain/Bitcoin/bitcoin-address-api) — balances and activity stats +- [Bitcoin Inputs and Outputs API](/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — UTXO-level inflows and outflows +- [Bitcoin Transactions API](/docs/blockchain/Bitcoin/bitcoin-transactions-api) — per-tx detail diff --git a/docs/blockchain/Bitcoin/bitcoin-fee-api.md b/docs/blockchain/Bitcoin/bitcoin-fee-api.md index 16a5f5e4..b97bca1d 100644 --- a/docs/blockchain/Bitcoin/bitcoin-fee-api.md +++ b/docs/blockchain/Bitcoin/bitcoin-fee-api.md @@ -1,7 +1,7 @@ --- -title: Bitcoin Fee API - Get Per-Tx Fees, USD Fees, and Address Aggregates +title: "Bitcoin Fee API" sidebar_label: Bitcoin Fee API -description: Query Bitcoin transaction fees with per-tx breakdowns and aggregate totals in BTC and USD. Useful for fee estimation, wallet expense tracking, and cost analysis. +description: "Bitcoin Fee API: analyze Bitcoin transaction fees and costs with Bitquery GraphQL queries and streams. Great for bots, dashboards, and alerts." keywords: - Bitcoin fee API - Bitcoin transaction fees @@ -12,7 +12,6 @@ keywords: - Bitcoin fee aggregates - Bitquery Bitcoin --- - # Bitcoin Fee API Query Bitcoin transaction fees at the per-transaction level or aggregated across an address or time window — in BTC and USD. Use it for fee estimation, wallet expense tracking, and historical fee trend analysis. @@ -87,6 +86,6 @@ Change `date` to a range for multi-day totals, drop `inputAddress` for a network ## Related resources -- [Bitcoin Transactions API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-transactions-api) — full transaction query patterns -- [Bitcoin Address API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-address-api) — address balances and activity -- [Bitcoin Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — UTXO-level detail +- [Bitcoin Transactions API](/docs/blockchain/Bitcoin/bitcoin-transactions-api) — full transaction query patterns +- [Bitcoin Address API](/docs/blockchain/Bitcoin/bitcoin-address-api) — address balances and activity +- [Bitcoin Inputs and Outputs API](/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — UTXO-level detail diff --git a/docs/blockchain/Bitcoin/bitcoin-inputs-outputs.md b/docs/blockchain/Bitcoin/bitcoin-inputs-outputs.md index 9c989081..f1227f21 100644 --- a/docs/blockchain/Bitcoin/bitcoin-inputs-outputs.md +++ b/docs/blockchain/Bitcoin/bitcoin-inputs-outputs.md @@ -1,7 +1,7 @@ --- -title: Bitcoin Inputs and Outputs API - UTXO Data, Miner Rewards & BTC Price +title: "Bitcoin Inputs Outputs" sidebar_label: Bitcoin Inputs & Outputs API -description: Query Bitcoin UTXO inputs and outputs with Bitquery GraphQL. Get historical BTC price, address balance at a block height, miner block rewards, and per-address activity. +description: "Bitcoin Inputs Outputs: query and stream Bitcoin on-chain data with Bitquery GraphQL examples for developers. Run it in the IDE, then ship in your app." keywords: - Bitcoin inputs outputs API - Bitcoin UTXO API @@ -12,7 +12,6 @@ keywords: - BTC UTXO - Bitquery Bitcoin --- - # Bitcoin Inputs and Outputs API Bitcoin runs on an unspent-transaction-output (UTXO) model — every transaction consumes previous outputs (inputs) and creates new ones (outputs). These APIs give you direct access to that UTXO data with BTC and USD values, block context, transaction hashes, and per-address filtering. They're the foundation for balance reconstruction, miner reward tracking, historical price lookups, and detailed wallet activity feeds. @@ -204,7 +203,7 @@ query MyQuery { ## Related resources -- [Bitcoin Address API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-address-api) — balances and activity stats per address -- [Bitcoin Coinpath API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-coinpath-api) — multi-hop fund flow tracing -- [Bitcoin Transactions API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-transactions-api) — transaction-level totals and fees -- [Bitcoin Kafka stream](https://docs.bitquery.io/docs/streams/protobuf/chains/Bitcoin-protobuf) — real-time UTXO delivery +- [Bitcoin Address API](/docs/blockchain/Bitcoin/bitcoin-address-api) — balances and activity stats per address +- [Bitcoin Coinpath API](/docs/blockchain/Bitcoin/bitcoin-coinpath-api) — multi-hop fund flow tracing +- [Bitcoin Transactions API](/docs/blockchain/Bitcoin/bitcoin-transactions-api) — transaction-level totals and fees +- [Bitcoin Kafka stream](/docs/streams/protobuf/chains/Bitcoin-protobuf) — real-time UTXO delivery diff --git a/docs/blockchain/Bitcoin/bitcoin-omni-transactions.md b/docs/blockchain/Bitcoin/bitcoin-omni-transactions.md index 147607e0..0032417e 100644 --- a/docs/blockchain/Bitcoin/bitcoin-omni-transactions.md +++ b/docs/blockchain/Bitcoin/bitcoin-omni-transactions.md @@ -1,7 +1,7 @@ --- -title: Bitcoin Omni Layer API - Track USDT on Bitcoin and Other Omni Tokens +title: "Bitcoin Omni Transactions" sidebar_label: Bitcoin Omni Layer API -description: Query Omni Layer transactions and transfers on Bitcoin with Bitquery GraphQL. Track USDT-on-Bitcoin and other Omni-issued assets with senders, receivers, and fees. +description: "Bitcoin Omni Transactions: query and stream Bitcoin on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." keywords: - Bitcoin Omni Layer API - Omni Layer GraphQL @@ -12,7 +12,6 @@ keywords: - Bitcoin GraphQL - Bitquery Omni --- - # Bitcoin Omni Layer API The Omni Layer is a protocol built on top of Bitcoin for issuing and trading custom tokens — most famously the original Bitcoin-issued USDT. These APIs return Omni-specific transaction and transfer data so you can track issuance, redemptions, and per-address Omni token activity directly on the Bitcoin chain. @@ -73,6 +72,6 @@ Filter incoming transfers with `transferTo: {is: "..."}` instead, add a `date` w ## Related resources -- [Bitcoin Transactions API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-transactions-api) — base-layer Bitcoin transactions -- [Bitcoin Address API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-address-api) — address balances and activity -- [Bitcoin Coinpath API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-coinpath-api) — multi-hop BTC fund tracing +- [Bitcoin Transactions API](/docs/blockchain/Bitcoin/bitcoin-transactions-api) — base-layer Bitcoin transactions +- [Bitcoin Address API](/docs/blockchain/Bitcoin/bitcoin-address-api) — address balances and activity +- [Bitcoin Coinpath API](/docs/blockchain/Bitcoin/bitcoin-coinpath-api) — multi-hop BTC fund tracing diff --git a/docs/blockchain/Bitcoin/bitcoin-transactions-api.md b/docs/blockchain/Bitcoin/bitcoin-transactions-api.md index d64a8307..c5d259f8 100644 --- a/docs/blockchain/Bitcoin/bitcoin-transactions-api.md +++ b/docs/blockchain/Bitcoin/bitcoin-transactions-api.md @@ -1,7 +1,7 @@ --- -title: Bitcoin Transactions API - Get Latest Txs, Fees, and Daily Aggregates +title: "Bitcoin Transactions API" sidebar_label: Bitcoin Transactions API -description: Query Bitcoin transactions with input/output totals, fees in BTC and USD, daily counts, average fees, and per-address transaction history via Bitquery GraphQL. +description: "Bitcoin Transactions API: query and stream Bitcoin on-chain data with Bitquery GraphQL examples for developers. Run it in the IDE, then ship in your app." keywords: - Bitcoin transactions API - Bitcoin transaction history @@ -12,7 +12,6 @@ keywords: - Bitcoin address transactions - Bitquery Bitcoin --- - # Bitcoin Transactions API The Transactions API returns transaction-level data on Bitcoin: input and output totals in BTC and USD, fees, input/output counts, block context, and per-address transaction history. Use it for paginated transaction feeds, daily activity dashboards, fee trend analysis, and wallet history widgets. @@ -104,7 +103,7 @@ Swap `inputAddress` for `outputAddress` to see received transactions instead. Ad ## Related resources -- [Bitcoin Blocks API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-blocks-api) — block-level lookups and stats -- [Bitcoin Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — UTXO-level transaction detail -- [Bitcoin Fee API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-fee-api) — focused fee queries and aggregates -- [Bitcoin Address API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-address-api) — wallet balances and activity stats +- [Bitcoin Blocks API](/docs/blockchain/Bitcoin/bitcoin-blocks-api) — block-level lookups and stats +- [Bitcoin Inputs and Outputs API](/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — UTXO-level transaction detail +- [Bitcoin Fee API](/docs/blockchain/Bitcoin/bitcoin-fee-api) — focused fee queries and aggregates +- [Bitcoin Address API](/docs/blockchain/Bitcoin/bitcoin-address-api) — wallet balances and activity stats diff --git a/docs/blockchain/Bitcoin/index.mdx b/docs/blockchain/Bitcoin/index.mdx index 42c7276e..aecb2a3f 100644 --- a/docs/blockchain/Bitcoin/index.mdx +++ b/docs/blockchain/Bitcoin/index.mdx @@ -1,6 +1,6 @@ --- title: Bitcoin API Documentation -description: Query Bitcoin blocks, transactions, addresses, UTXO inputs and outputs, fees, miner rewards, Omni Layer, and fund flows with Bitquery's GraphQL and Kafka APIs. +description: "Bitcoin API Documentation: query and stream Bitcoin on-chain data with Bitquery GraphQL examples for developers. Copy GraphQL snippets for production apps." slug: /blockchain/Bitcoin/ keywords: - Bitcoin API @@ -15,7 +15,6 @@ keywords: - Bitcoin Omni Layer API - Bitcoin Kafka stream --- - # Bitcoin API Documentation ## Overview @@ -25,7 +24,7 @@ Bitquery's Bitcoin APIs cover the chain end-to-end through GraphQL — blocks, t If you need a data point that isn't covered here, reach out on [Telegram](https://t.me/Bloxy_info). :::info Endpoint -Bitcoin GraphQL queries are served at `https://graphql.bitquery.io`. For real-time data, see the [Bitcoin Kafka stream](https://docs.bitquery.io/docs/streams/protobuf/chains/Bitcoin-protobuf). +Bitcoin GraphQL queries are served at `https://graphql.bitquery.io`. For real-time data, see the [Bitcoin Kafka stream](/docs/streams/protobuf/chains/Bitcoin-protobuf). ::: ### What you can do with the Bitcoin API @@ -50,7 +49,7 @@ Bitcoin GraphQL queries are served at `https://graphql.bitquery.io`. For real-ti ### Real-time Bitcoin data -For live, low-latency Bitcoin data, use Bitquery's **[Bitcoin Kafka stream](https://docs.bitquery.io/docs/streams/protobuf/chains/Bitcoin-protobuf)** (`btc.transactions.proto`). It delivers every block and transaction as soon as it lands on-chain, with full input/output detail, script and address parsing, and miner data. GraphQL subscriptions are not available for Bitcoin — Kafka is the real-time path. +For live, low-latency Bitcoin data, use Bitquery's **[Bitcoin Kafka stream](/docs/streams/protobuf/chains/Bitcoin-protobuf)** (`btc.transactions.proto`). It delivers every block and transaction as soon as it lands on-chain, with full input/output detail, script and address parsing, and miner data. GraphQL subscriptions are not available for Bitcoin — Kafka is the real-time path. For polling or historical pulls, the GraphQL queries below work the same way you'd expect on any other Bitquery chain. @@ -78,26 +77,26 @@ This query returns the 5 most recent Bitcoin blocks with height, difficulty, tra ### Core data -- [Bitcoin Blocks API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-blocks-api) — block lookups by height or time, difficulty, size, and transaction counts. -- [Bitcoin Transactions API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-transactions-api) — transaction-level data with fees, inputs/outputs totals, and pagination patterns. -- [Bitcoin Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — UTXO-level data, historical BTC price, balance at a block height, and miner rewards. +- [Bitcoin Blocks API](/docs/blockchain/Bitcoin/bitcoin-blocks-api) — block lookups by height or time, difficulty, size, and transaction counts. +- [Bitcoin Transactions API](/docs/blockchain/Bitcoin/bitcoin-transactions-api) — transaction-level data with fees, inputs/outputs totals, and pagination patterns. +- [Bitcoin Inputs and Outputs API](/docs/blockchain/Bitcoin/bitcoin-inputs-outputs) — UTXO-level data, historical BTC price, balance at a block height, and miner rewards. ### Addresses and balances -- [Bitcoin Address API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-address-api) — balances from UTXOs (current and at a height), `addressStats` aggregates, first/last-active. +- [Bitcoin Address API](/docs/blockchain/Bitcoin/bitcoin-address-api) — balances from UTXOs (current and at a height), `addressStats` aggregates, first/last-active. ### Fees -- [Bitcoin Fee API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-fee-api) — per-transaction and aggregate fee queries in BTC and USD. +- [Bitcoin Fee API](/docs/blockchain/Bitcoin/bitcoin-fee-api) — per-transaction and aggregate fee queries in BTC and USD. ### Omni Layer (USDT on Bitcoin) -- [Bitcoin Omni Transactions & Transfers API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-omni-transactions) — Omni transactions and per-address transfers for tokens like USDT-on-Bitcoin. +- [Bitcoin Omni Transactions & Transfers API](/docs/blockchain/Bitcoin/bitcoin-omni-transactions) — Omni transactions and per-address transfers for tokens like USDT-on-Bitcoin. ### Fund tracing -- [Bitcoin Coinpath API](https://docs.bitquery.io/docs/blockchain/Bitcoin/bitcoin-coinpath-api) — multi-hop fund flow tracing between Bitcoin addresses. +- [Bitcoin Coinpath API](/docs/blockchain/Bitcoin/bitcoin-coinpath-api) — multi-hop fund flow tracing between Bitcoin addresses. ### Real-time -- [Bitcoin Kafka stream](https://docs.bitquery.io/docs/streams/protobuf/chains/Bitcoin-protobuf) — `btc.transactions.proto` topic for sub-block-time delivery. +- [Bitcoin Kafka stream](/docs/streams/protobuf/chains/Bitcoin-protobuf) — `btc.transactions.proto` topic for sub-block-time delivery. diff --git a/docs/blockchain/Cardano/address.md b/docs/blockchain/Cardano/address.md index 56b32ba5..0874fdb7 100644 --- a/docs/blockchain/Cardano/address.md +++ b/docs/blockchain/Cardano/address.md @@ -1,7 +1,7 @@ --- -title: Cardano Address API - Get Wallet Balances, Native Tokens & Staking +title: "Cardano Address API" sidebar_label: Cardano Address API -description: Query Cardano wallet balances across ADA and native tokens, plus staking and rewards data, using Bitquery's GraphQL Address API. +description: "Cardano Address: query and stream Cardano on-chain data with Bitquery GraphQL examples for developers. Scale further with Kafka or gRPC streams." keywords: - Cardano address API - Cardano wallet balance API @@ -12,7 +12,6 @@ keywords: - Cardano native token balance - Bitquery Cardano --- - # Cardano Address API The Address API gives you everything tied to a Cardano wallet: ADA balance, balances for every native token the wallet holds, and the staking snapshot (controlled stake, rewards available, rewards withdrawn). For quick activity profiling you can also use the `addressStats` cube, which returns pre-aggregated inflow, outflow, counterparty, and first/last-active metrics. @@ -72,7 +71,7 @@ If you only want the ADA balance, filter the response client-side where `currenc `addressStats` is a pre-aggregated view of a wallet's lifetime activity — total inflows and outflows, inbound and outbound transaction counts, unique senders and receivers, unique active days, current balance, and the first / last active timestamps. It's the fastest way to profile an address for compliance checks, exchange screening, or analytics dashboards. :::caution -`addressStats` is pre-aggregated and can lag the chain slightly. For exact, up-to-the-block balance math, sum `outputs` and subtract `inputs` from the [Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Cardano/inputs-outputs). +`addressStats` is pre-aggregated and can lag the chain slightly. For exact, up-to-the-block balance math, sum `outputs` and subtract `inputs` from the [Inputs and Outputs API](/docs/blockchain/Cardano/inputs-outputs). ::: ```graphql @@ -108,6 +107,6 @@ Pair this with the `address(...)` query above when you want fast aggregate metri ## Related resources -- [Cardano Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Cardano/inputs-outputs) — UTXO-level balance reconstruction -- [Cardano Transactions API](https://docs.bitquery.io/docs/blockchain/Cardano/transactions) — transaction-level data with fees -- [Cardano Coinpath API](https://docs.bitquery.io/docs/blockchain/Cardano/coinpath) — multi-hop ADA flow tracing +- [Cardano Inputs and Outputs API](/docs/blockchain/Cardano/inputs-outputs) — UTXO-level balance reconstruction +- [Cardano Transactions API](/docs/blockchain/Cardano/transactions) — transaction-level data with fees +- [Cardano Coinpath API](/docs/blockchain/Cardano/coinpath) — multi-hop ADA flow tracing diff --git a/docs/blockchain/Cardano/blocks.md b/docs/blockchain/Cardano/blocks.md index d13dbb4a..68cf9094 100644 --- a/docs/blockchain/Cardano/blocks.md +++ b/docs/blockchain/Cardano/blocks.md @@ -1,7 +1,7 @@ --- title: Cardano Blocks API - Query Blocks by Height, Slot & Epoch sidebar_label: Cardano Blocks API -description: Look up Cardano blocks by height or time window with hash, epoch, slot, slot-leader, and transaction count via Bitquery's GraphQL Blocks API. +description: "Cardano Blocks API - Query Blocks by Height, Slot & Epoch: query and stream Cardano on-chain data with Bitquery GraphQL examples for developers." keywords: - Cardano blocks API - Cardano block explorer API @@ -12,7 +12,6 @@ keywords: - Cardano block height query - Bitquery Cardano --- - # Cardano Blocks API The Blocks API exposes everything you'd expect from a Cardano block: height, hash, size, protocol version, epoch and slot context, slot-leader metadata, VRF key, transaction count, and timestamp. Use it to power explorer front-ends, monitor chain progression, or pull historical block context for downstream analytics. @@ -81,5 +80,5 @@ Sort ascending with `asc: "height"` to walk the chain forward, and widen the `ti ## Related resources -- [Cardano Transactions API](https://docs.bitquery.io/docs/blockchain/Cardano/transactions) — per-block transaction details and fees -- [Cardano Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Cardano/inputs-outputs) — UTXO data tied to each transaction +- [Cardano Transactions API](/docs/blockchain/Cardano/transactions) — per-block transaction details and fees +- [Cardano Inputs and Outputs API](/docs/blockchain/Cardano/inputs-outputs) — UTXO data tied to each transaction diff --git a/docs/blockchain/Cardano/coinpath.md b/docs/blockchain/Cardano/coinpath.md index 4dfe78a3..5dc10317 100644 --- a/docs/blockchain/Cardano/coinpath.md +++ b/docs/blockchain/Cardano/coinpath.md @@ -1,7 +1,7 @@ --- title: Cardano Coinpath API - Trace ADA Flows Across Multiple Hops sidebar_label: Cardano Coinpath API -description: Use Bitquery Coinpath on Cardano to trace ADA fund flows between addresses with multi-hop inbound and outbound paths for compliance, treasury, and forensic analysis. +description: "Cardano Coinpath API - Trace ADA Flows Across Multiple Hops: query and stream Cardano on-chain data with Bitquery GraphQL examples for developers." keywords: - Cardano coinpath API - Cardano fund tracing @@ -12,7 +12,6 @@ keywords: - Cardano GraphQL - Bitquery Cardano --- - # Cardano Coinpath API Coinpath walks ADA flows between Cardano addresses across multiple hops — forward to see where funds went, backward to see where they came from. Because Cardano uses an eUTXO model, the API stitches chains of UTXOs together and returns senders, receivers, hop depth, amounts, and transaction counts at each level. Common use cases: AML / compliance screening, DAO treasury audits, exchange deposit tracing, and source-of-funds verification. @@ -106,5 +105,5 @@ For forensic work, depths of 5–7 are common. Add `direction: inbound` to `opti ## Related resources -- [Cardano Address API](https://docs.bitquery.io/docs/blockchain/Cardano/address) — wallet balances, staking, and `addressStats` -- [Cardano Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Cardano/inputs-outputs) — UTXO-level inflows and outflows +- [Cardano Address API](/docs/blockchain/Cardano/address) — wallet balances, staking, and `addressStats` +- [Cardano Inputs and Outputs API](/docs/blockchain/Cardano/inputs-outputs) — UTXO-level inflows and outflows diff --git a/docs/blockchain/Cardano/djed.md b/docs/blockchain/Cardano/djed.md index 3eab6f1c..d6d22074 100644 --- a/docs/blockchain/Cardano/djed.md +++ b/docs/blockchain/Cardano/djed.md @@ -1,7 +1,7 @@ --- -title: Djed Stablecoin API on Cardano - Track DJED Mints, Burns & Transfers +title: "Cardano Djed Stablecoin API" sidebar_label: Djed Stablecoin API on Cardano -description: Query the Djed stablecoin on Cardano with Bitquery GraphQL. Track DJED mints, burns, recent transfers, wallet balances, and per-address DJED activity. +description: "Cardano Djed: query and stream Cardano on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." keywords: - Djed API - DJED Cardano @@ -13,14 +13,13 @@ keywords: - Bitquery Djed - DJED supply tracking --- - # Djed Stablecoin API [Djed](https://djed.xyz) is an overcollateralized, USD-pegged stablecoin on Cardano, issued by COTI and designed in collaboration with Input Output Global. It trades under the ticker **DJED** (asset name `DjedMicroUSD`) and is backed by ADA reserves. Every issuance is an on-chain **mint** of the DJED native token, and every redemption is a **burn** — which means Djed's full lifecycle maps cleanly onto Bitquery's existing Cardano primitives: -- Mint and burn activity → [Cardano Mints API](https://docs.bitquery.io/docs/blockchain/Cardano/mints) -- Holder balances → [Cardano Address API](https://docs.bitquery.io/docs/blockchain/Cardano/address) -- Movements between wallets → [Cardano Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Cardano/inputs-outputs) +- Mint and burn activity → [Cardano Mints API](/docs/blockchain/Cardano/mints) +- Holder balances → [Cardano Address API](/docs/blockchain/Cardano/address) +- Movements between wallets → [Cardano Inputs and Outputs API](/docs/blockchain/Cardano/inputs-outputs) You can verify the on-chain asset on Cardanoscan: [DjedMicroUSD token page](https://cardanoscan.io/token/8db269c3ec630e06ae29f74bc39edd1f87c819f1056206e879a1cd61446a65644d6963726f555344). @@ -117,7 +116,7 @@ Good for portfolio tracking of Djed holders, wallet-level risk analytics, or bal } ``` -Drop the `staking` block when you don't need stake context, or pair this with `addressStats` (see the [Cardano Address API](https://docs.bitquery.io/docs/blockchain/Cardano/address)) to combine per-asset balances with aggregate activity metrics in a single request. +Drop the `staking` block when you don't need stake context, or pair this with `addressStats` (see the [Cardano Address API](/docs/blockchain/Cardano/address)) to combine per-asset balances with aggregate activity metrics in a single request. ## Recent DJED movements network-wide @@ -260,10 +259,10 @@ Combine this with the "received" query above to reconstruct a wallet's complete ## Related resources -- [Cardano Mints API](https://docs.bitquery.io/docs/blockchain/Cardano/mints) — generic mint and burn query patterns -- [Cardano Address API](https://docs.bitquery.io/docs/blockchain/Cardano/address) — wallet balances and the `addressStats` cube -- [Cardano Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Cardano/inputs-outputs) — full UTXO query reference -- [Cardano Coinpath API](https://docs.bitquery.io/docs/blockchain/Cardano/coinpath) — multi-hop fund tracing +- [Cardano Mints API](/docs/blockchain/Cardano/mints) — generic mint and burn query patterns +- [Cardano Address API](/docs/blockchain/Cardano/address) — wallet balances and the `addressStats` cube +- [Cardano Inputs and Outputs API](/docs/blockchain/Cardano/inputs-outputs) — full UTXO query reference +- [Cardano Coinpath API](/docs/blockchain/Cardano/coinpath) — multi-hop fund tracing - [Djed official site](https://djed.xyz) - [Djed app (mint / redeem UI)](https://app.djed.xyz/) - [Djed launch announcement on COTI Medium](https://medium.com/cotinetwork/a-new-era-for-stablecoins-begins-djed-is-live-on-mainnet-55971971f2a8) diff --git a/docs/blockchain/Cardano/index.mdx b/docs/blockchain/Cardano/index.mdx index f24f41b8..62275fd6 100644 --- a/docs/blockchain/Cardano/index.mdx +++ b/docs/blockchain/Cardano/index.mdx @@ -1,6 +1,6 @@ --- title: Cardano API Documentation -description: Query Cardano blocks, transactions, UTXOs, native tokens, addresses, staking, and coin-flow data with Bitquery's GraphQL API. +description: "Cardano API Documentation: query and stream Cardano on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." slug: /blockchain/Cardano/ keywords: - Cardano API @@ -15,7 +15,6 @@ keywords: - eUTXO API - Cardano transactions API --- - # Cardano API Documentation ## Overview @@ -69,22 +68,22 @@ This query returns the 5 most recent Cardano blocks with hash, height, transacti ### Core data -- [Cardano Blocks API](https://docs.bitquery.io/docs/blockchain/Cardano/blocks) — block lookups by height or time, epoch/slot context, slot-leader metadata. -- [Cardano Transactions API](https://docs.bitquery.io/docs/blockchain/Cardano/transactions) — transaction details, fees in ADA and USD, mint counts, daily counts. -- [Cardano Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Cardano/inputs-outputs) — UTXO-level data for balance reconstruction and transfer feeds. +- [Cardano Blocks API](/docs/blockchain/Cardano/blocks) — block lookups by height or time, epoch/slot context, slot-leader metadata. +- [Cardano Transactions API](/docs/blockchain/Cardano/transactions) — transaction details, fees in ADA and USD, mint counts, daily counts. +- [Cardano Inputs and Outputs API](/docs/blockchain/Cardano/inputs-outputs) — UTXO-level data for balance reconstruction and transfer feeds. ### Addresses and staking -- [Cardano Address API](https://docs.bitquery.io/docs/blockchain/Cardano/address) — per-asset balances, staking snapshot, and the `addressStats` aggregate cube. +- [Cardano Address API](/docs/blockchain/Cardano/address) — per-asset balances, staking snapshot, and the `addressStats` aggregate cube. ### Native tokens -- [Cardano Mints API](https://docs.bitquery.io/docs/blockchain/Cardano/mints) — native-token mint and burn events, including NFT drops and fungible issuance. +- [Cardano Mints API](/docs/blockchain/Cardano/mints) — native-token mint and burn events, including NFT drops and fungible issuance. ### Stablecoins -- [Djed Stablecoin API](https://docs.bitquery.io/docs/blockchain/Cardano/djed) — DJED mints, burns, transfers, and wallet-level balance examples. +- [Djed Stablecoin API](/docs/blockchain/Cardano/djed) — DJED mints, burns, transfers, and wallet-level balance examples. ### Fund tracing -- [Cardano Coinpath API](https://docs.bitquery.io/docs/blockchain/Cardano/coinpath) — multi-hop inbound and outbound ADA flow tracing for compliance and treasury work. +- [Cardano Coinpath API](/docs/blockchain/Cardano/coinpath) — multi-hop inbound and outbound ADA flow tracing for compliance and treasury work. diff --git a/docs/blockchain/Cardano/inputs-outputs.md b/docs/blockchain/Cardano/inputs-outputs.md index 2ac3d498..35415002 100644 --- a/docs/blockchain/Cardano/inputs-outputs.md +++ b/docs/blockchain/Cardano/inputs-outputs.md @@ -1,7 +1,7 @@ --- -title: Cardano Inputs and Outputs API - UTXO Data & Address Balances +title: "Cardano Inputs and Outputs API" sidebar_label: Cardano Inputs & Outputs API -description: Query Cardano UTXO inputs and outputs to reconstruct address balances, list transfers in a date range, and build wallet activity feeds via Bitquery GraphQL. +description: "Cardano Inputs and Outputs API: query and stream Cardano on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." keywords: - Cardano inputs outputs API - Cardano UTXO API @@ -12,7 +12,6 @@ keywords: - ADA inputs outputs - Bitquery Cardano --- - # Cardano Inputs and Outputs API Cardano runs on an **eUTXO** model — there are no account balances stored on-chain. To get an address's balance or activity you walk its inputs (UTXOs being spent) and outputs (UTXOs being received). These APIs return that UTXO-level data with transaction hash, output index, ADA and USD values, and block timestamps. @@ -54,7 +53,7 @@ In the eUTXO model, an address balance is simply `sum(outputs received) - sum(in Add `date: {since: ..., till: ...}` to scope a window, pass `inputAddress: {in: [...]}` / `outputAddress: {in: [...]}` to aggregate across multiple wallets in one call, or drop the `currency: {is: "ADA"}` filter to include native tokens alongside ADA. -For the aggregate shortcut (with pre-computed inflows, outflows, counterparty counts, etc.) see the [`addressStats` query](https://docs.bitquery.io/docs/blockchain/Cardano/address#get-cardano-address-activity-stats-addressstats). +For the aggregate shortcut (with pre-computed inflows, outflows, counterparty counts, etc.) see the [`addressStats` query](/docs/blockchain/Cardano/address#get-cardano-address-activity-stats-addressstats). ## List UTXO outputs received by a Cardano address @@ -151,6 +150,6 @@ The `properties` field on the currency object contains the parsed datum: ## Related resources -- [Cardano Address API](https://docs.bitquery.io/docs/blockchain/Cardano/address) — balances, staking, and the `addressStats` aggregate cube -- [Cardano Coinpath API](https://docs.bitquery.io/docs/blockchain/Cardano/coinpath) — multi-hop ADA flow tracing across addresses -- [Cardano Transactions API](https://docs.bitquery.io/docs/blockchain/Cardano/transactions) — transaction-level totals and fees +- [Cardano Address API](/docs/blockchain/Cardano/address) — balances, staking, and the `addressStats` aggregate cube +- [Cardano Coinpath API](/docs/blockchain/Cardano/coinpath) — multi-hop ADA flow tracing across addresses +- [Cardano Transactions API](/docs/blockchain/Cardano/transactions) — transaction-level totals and fees diff --git a/docs/blockchain/Cardano/mints.md b/docs/blockchain/Cardano/mints.md index 69c5c9c6..47f1bb96 100644 --- a/docs/blockchain/Cardano/mints.md +++ b/docs/blockchain/Cardano/mints.md @@ -1,7 +1,7 @@ --- -title: Cardano Mints API - Track Native Token Mints, Burns & NFT Drops +title: "Cardano Mints API - Track Native Token Mints" sidebar_label: Cardano Mints API -description: Query Cardano native token mint and burn events with policy IDs, asset metadata, amounts, and block context. Track NFT collection drops and fungible token issuance via Bitquery GraphQL. +description: "Cardano Mints API - Track Native Token Mints: query and stream Cardano on-chain data with Bitquery GraphQL examples for developers." keywords: - Cardano mints API - Cardano native tokens API @@ -12,7 +12,6 @@ keywords: - Cardano GraphQL - Bitquery Cardano --- - # Cardano Mints API Cardano doesn't mint tokens through smart contracts the way EVM chains do. Every native token — fungible or NFT — is issued under a **minting policy**, and every mint or burn shows up on-chain as a single event tied to that policy. The Mints API exposes those events with amounts, transaction hash, block context, and the full asset metadata. Use it to track NFT collection drops, fungible-token issuance, stablecoin supply changes, or any kind of on-chain supply movement. @@ -53,7 +52,7 @@ Pull the 10 most recent mint events across every minting policy on a given date. } ``` -To find the largest single mints, sort by `desc: "value"`. To filter by a specific policy or asset, add `currency: {is: ""}` — see the [DJED examples](https://docs.bitquery.io/docs/blockchain/Cardano/djed) for the pattern. On Cardano, the policy ID is the first 56 hex characters of `currency.address`; the remainder is the hex-encoded asset name. +To find the largest single mints, sort by `desc: "value"`. To filter by a specific policy or asset, add `currency: {is: ""}` — see the [DJED examples](/docs/blockchain/Cardano/djed) for the pattern. On Cardano, the policy ID is the first 56 hex characters of `currency.address`; the remainder is the hex-encoded asset name. ## Aggregate Cardano mints by month @@ -86,5 +85,5 @@ Change `startOfInterval(unit: month)` to `week` or `day` for finer buckets. To d ## Related resources -- [Djed Stablecoin API](https://docs.bitquery.io/docs/blockchain/Cardano/djed) — currency-filtered mint and burn examples on a real asset -- [Cardano Transactions API](https://docs.bitquery.io/docs/blockchain/Cardano/transactions) — full transaction context for mint events +- [Djed Stablecoin API](/docs/blockchain/Cardano/djed) — currency-filtered mint and burn examples on a real asset +- [Cardano Transactions API](/docs/blockchain/Cardano/transactions) — full transaction context for mint events diff --git a/docs/blockchain/Cardano/transactions.md b/docs/blockchain/Cardano/transactions.md index 4d352a9f..a73e0caa 100644 --- a/docs/blockchain/Cardano/transactions.md +++ b/docs/blockchain/Cardano/transactions.md @@ -1,7 +1,7 @@ --- title: Cardano Transactions API - Fees, Inputs, Outputs & Mints sidebar_label: Cardano Transactions API -description: Query Cardano transactions with input and output totals, fees in ADA and USD, mint counts, withdrawals, and daily transaction counts via Bitquery GraphQL. +description: "Cardano Transactions API - Fees, Inputs, Outputs & Mints: query and stream Cardano on-chain data with Bitquery GraphQL examples for developers." keywords: - Cardano transactions API - Cardano fee API @@ -12,7 +12,6 @@ keywords: - ADA transaction fees - Bitquery Cardano --- - # Cardano Transactions API The Transactions API returns transaction-level data on Cardano: input and output totals, fees in ADA and USD, mint counts, withdrawals, and block context. Use it for daily reporting, fee analysis, spotting outlier transactions, and building activity dashboards. @@ -75,6 +74,6 @@ Use `startOfInterval(unit: day, interval: 10)` for coarser buckets, raise `limit ## Related resources -- [Cardano Blocks API](https://docs.bitquery.io/docs/blockchain/Cardano/blocks) — block-level lookups and time-window queries -- [Cardano Inputs and Outputs API](https://docs.bitquery.io/docs/blockchain/Cardano/inputs-outputs) — UTXO-level transaction data -- [Cardano Mints API](https://docs.bitquery.io/docs/blockchain/Cardano/mints) — drill into the mint events behind `mintCount` +- [Cardano Blocks API](/docs/blockchain/Cardano/blocks) — block-level lookups and time-window queries +- [Cardano Inputs and Outputs API](/docs/blockchain/Cardano/inputs-outputs) — UTXO-level transaction data +- [Cardano Mints API](/docs/blockchain/Cardano/mints) — drill into the mint events behind `mintCount` diff --git a/docs/blockchain/Ethereum/_category_.json b/docs/blockchain/Ethereum/_category_.json index 64c70b83..f0c4fe94 100644 --- a/docs/blockchain/Ethereum/_category_.json +++ b/docs/blockchain/Ethereum/_category_.json @@ -2,6 +2,6 @@ "label": "Ethereum", "link": { "type": "doc", - "id": "/index" + "id": "blockchain/Ethereum/index" } } diff --git a/docs/blockchain/Ethereum/balances/balance-api.md b/docs/blockchain/Ethereum/balances/balance-api.md index d9a08fa9..71f90050 100644 --- a/docs/blockchain/Ethereum/balances/balance-api.md +++ b/docs/blockchain/Ethereum/balances/balance-api.md @@ -1,12 +1,14 @@ --- sidebar_position: 2 +title: "Ethereum Balance API" +description: "Ethereum Balance API: fetch current and historical Ethereum balances with Bitquery GraphQL balance queries. Great for bots, dashboards, and alerts." --- import FAQ from "@site/src/components/FAQ"; # Address Balance API :::caution Deprecated API -`EVM.BalanceUpdates` is deprecated as of **20 May 2026** and will be removed on **15 June 2026**. Use **`EVM.Balances`** (this page) instead. +`EVM.BalanceUpdates` was deprecated as of **20 May 2026** and removed on **15 June 2026**. Use **`EVM.Balances`** (this page) instead. ::: The **Balances** API returns current and historical token balances for an address on Ethereum. To return only non-zero balances, add `Amount(selectWhere: { gt: "0" })` on the `Balance` field (not in `where`). Use `dataset: combined` or `dataset: archive` as follows: diff --git a/docs/blockchain/Ethereum/balances/index.md b/docs/blockchain/Ethereum/balances/index.md index f7b610f1..6f61ccaf 100644 --- a/docs/blockchain/Ethereum/balances/index.md +++ b/docs/blockchain/Ethereum/balances/index.md @@ -1,6 +1,6 @@ --- title: Balances API Documentation -description: Collection of Balance APIs on Ethereum organized by functionality. +description: "Balances API Documentation: fetch current and historical Ethereum balances with Bitquery GraphQL balance queries. Great for bots, dashboards, and alerts." slug: /blockchain/Ethereum/balances/ keywords: - Balance API @@ -11,12 +11,11 @@ keywords: - Transaction Balance Tracker - Ethereum Balance Data --- - # Balances API Documentation This section covers how to fetch balance-related data on Ethereum via **Bitquery GraphQL APIs** and **Streams**. -To get started, [signup](https://account.bitquery.io/user/account) with Bitquery and get your [Access Token](https://account.bitquery.io/user/api_v2/access_tokens) by following [these](https://docs.bitquery.io/docs/authorisation/how-to-generate/) steps. +To get started, [signup](https://account.bitquery.io/user/account) with Bitquery and get your [Access Token](https://account.bitquery.io/user/api_v2/access_tokens) by following [these](/docs/authorization/how-to-generate/) steps. If you need help getting balance data, reach out to [support](https://t.me/Bloxy_info). diff --git a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-gas-balance-tracker.md b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-gas-balance-tracker.md index 069dce73..3178ba47 100644 --- a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-gas-balance-tracker.md +++ b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-gas-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 6 +title: "Ethereum Gas Balance Tracker" +description: "Ethereum Gas Balance Tracker: stream Ethereum balance changes with reason codes using Bitquery GraphQL subscriptions. See examples in the Bitquery IDE." --- - # Ethereum Gas Balance Tracker The Ethereum Gas Balance Tracker API provides real-time balance updates related to Gas Fee activities, including transaction fee rewards, monitoring gas fee spent, and other Gas-related balance changes. - - - - - - - - - - - - - - - - - - - ## Get Top Gas Fee Collectors [This](https://ide.bitquery.io/top-gas-fee-collectors_1) API endpoint returns the list of top gas fee collectors. We are tracking the Gas Collection Event causing Balance Update by appliying condition on `BalanceChangeReasonCode` to be equal to `5`. @@ -311,4 +287,4 @@ subscription { } } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-mev-balance-tracker.md b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-mev-balance-tracker.md index dc5a02cc..52f33c5a 100644 --- a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-mev-balance-tracker.md +++ b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-mev-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 4 +title: "Ethereum MEV Balance Tracker" +description: "Ethereum MEV Balance Tracker: stream Ethereum balance changes with reason codes using Bitquery GraphQL subscriptions. See examples in the Bitquery IDE." --- - # Ethereum MEV Balance Tracker The Ethereum MEV (Maximal Extractable Value) Balance Tracker API provides real-time balance updates related to MEV activities, including transaction fee rewards, block builder rewards, and other MEV-related balance changes. - - - - - - - - - - - - - - - - - - - ## Track MEV-Boost Relay Transaction Balances Track balance changes for MEV-boost relay addresses to monitor their activity and rewards. This example uses the `BloXroute Max Profit` address. diff --git a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-miner-balance-tracker.md b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-miner-balance-tracker.md index 64400ec8..3071f807 100644 --- a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-miner-balance-tracker.md +++ b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-miner-balance-tracker.md @@ -1,7 +1,8 @@ --- sidebar_position: 3 +title: "Ethereum Miner Balance Tracker" +description: "Ethereum Miner Balance Tracker: stream Ethereum balance changes with reason codes using Bitquery GraphQL subscriptions. See examples in the Bitquery IDE." --- - import VideoPlayer from "../../../../../src/components/videoplayer.js"; # Ethereum Miner Balance Tracker @@ -10,31 +11,6 @@ The Ethereum Miner Balance Tracker API provides real-time balance updates for Et - - - - - - - - - - - - - - - - - - - ## Track Miner Balance Updates Monitor balance changes for Ethereum miners, including block rewards, uncle block rewards, and transaction fee rewards. Try the API [here](https://ide.bitquery.io/Track-Miner-Balance-Updates). diff --git a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-self-destruct-balance-api.md b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-self-destruct-balance-api.md index c48e3143..dc699755 100644 --- a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-self-destruct-balance-api.md +++ b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-self-destruct-balance-api.md @@ -1,36 +1,12 @@ --- sidebar_position: 5 +title: "Ethereum Self-Destruct Balance Tracker" +description: "Ethereum Self-Destruct Balance Tracker: stream Ethereum balance changes with reason codes using Bitquery GraphQL subscriptions." --- - # Ethereum Self-Destruct Balance Tracker The Ethereum Self-Destruct Balance Tracker API provides real-time balance updates for contracts that self-destruct and addresses that receive funds from self-destructed contracts. This API helps you monitor contract destruction events, track ephemeral contracts (like MEV bots), and analyze security incidents. - - - - - - - - - - - - - - - - - - - ## What is Self-Destruct? The `selfdestruct` opcode allows a smart contract to permanently remove its bytecode from the blockchain and send its remaining ETH balance to a specified recipient address. Once a contract self-destructs, it can no longer execute code or receive transactions. diff --git a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transaction-balance-tracker.md b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transaction-balance-tracker.md index b424a6af..84595c8c 100644 --- a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transaction-balance-tracker.md +++ b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transaction-balance-tracker.md @@ -1,36 +1,12 @@ --- sidebar_position: 1 +title: "Ethereum Transaction Balance Tracker" +description: "Ethereum Transaction Balance Tracker: stream Ethereum balance changes with reason codes using Bitquery GraphQL subscriptions." --- - # Ethereum Transaction Balance Tracker The Ethereum Transaction Balance Tracker API provides real-time balance updates for all addresses involved in transactions on the Ethereum blockchain, including detailed information about the reason for each balance change. - - - - - - - - - - - - - - - - - - - ## Subscribe to All Transaction Balances This subscription provides real-time balance updates for all addresses involved in transactions on the Ethereum network. diff --git a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transfer-balance-tracker.md b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transfer-balance-tracker.md index 3302045f..98b7863c 100644 --- a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transfer-balance-tracker.md +++ b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transfer-balance-tracker.md @@ -1,7 +1,8 @@ --- sidebar_position: 7 +title: "Ethereum Transfer Balance Tracker" +description: "Ethereum Transfer Balance Tracker: monitor Ethereum native and token transfers in real time with Bitquery GraphQL APIs. See examples in the Bitquery IDE." --- - # Ethereum Transfer Balance Tracker The Ethereum Transfer Balance Tracker API provides real-time balance updates for all addresses involved in Transfers on the Ethereum blockchain, and provides option to filter out based on the direction of transfer you want to target. The Ethereum Transfer Balance is tracked by marking the the `BalanceUpdateReason` equals `10`. @@ -10,31 +11,6 @@ The Ethereum Transfer Balance Tracker API provides real-time balance updates for The queries covered this section are only valid for the Native Currency Transfer. ::: - - - - - - - - - - - - - - - - - - - ## Get Balance Info for an Address after Transfer [This](https://ide.bitquery.io/balance-update-from-transfer-for-an-address#) query returns the Balance Info such as PreBalance, PostBalance, Balances in USD and transfer amount for a particular address after a transfer, irrespective of the direction of transfer. @@ -327,7 +303,6 @@ subscription { ```
- ## Get Balance Info for an Address after Transfer Recieved [This](https://ide.bitquery.io/Balance-update-after-transfer-received_1) query returns the Balance Info such as PreBalance, PostBalance, Balances in USD and transfer amount for a particular address after it recieves a transfer. diff --git a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-validator-balance-tracker.md b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-validator-balance-tracker.md index c6ed9447..69095be4 100644 --- a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-validator-balance-tracker.md +++ b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-validator-balance-tracker.md @@ -1,38 +1,14 @@ --- sidebar_position: 2 +title: "Ethereum Validator Balance Tracker" +description: "Ethereum Validator Balance Tracker: stream Ethereum balance changes with reason codes using Bitquery GraphQL subscriptions." --- - # Ethereum Validator Balance Tracker The Ethereum Validator Balance Tracker API provides real-time balance updates for Ethereum validators, tracking their staking rewards, withdrawals, and balance changes. For a sample application, see the [Validators Rewards Tax Calculator](https://docs.bitquery.io/crypto-reward-tax-calculator). - - - - - - - - - - - - - - - - - - - ## Track Validator Balance Updates Monitor balance changes for Ethereum validators, including staking rewards and withdrawals from the beacon chain. diff --git a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/index.md b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/index.md index b1ff3836..0205ce29 100644 --- a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/index.md +++ b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/index.md @@ -1,6 +1,6 @@ --- title: Ethereum Transaction Balance Tracker API -description: Access comprehensive Ethereum Transaction Balance Tracker APIs for real-time balance updates, validator tracking, miner rewards, MEV analysis, and self-destruct monitoring. GraphQL API with subscriptions. +description: "Ethereum Transaction Balance Tracker API: stream Ethereum balance changes with reason codes using Bitquery GraphQL subscriptions." slug: /blockchain/Ethereum/balances/transaction-balance-tracker/ keywords: - Ethereum Transaction Balance Tracker @@ -16,7 +16,6 @@ keywords: - Ethereum Token Balance API - Ethereum NFT Balance API --- - # Ethereum Transaction Balance Tracker API - Complete Guide ## What is Transaction Balance Tracker? @@ -39,8 +38,8 @@ Our Transaction Balance Tracker APIs track balance changes across different scen New to Transaction Balance Tracker? Here's how to get started: 1. **[Create a free account](https://ide.bitquery.io/)** - Get instant access to our GraphQL IDE -2. **[Generate your API key](https://docs.bitquery.io/docs/authorisation/how-to-generate/)** - Required for API access -3. **[Run your first query](https://docs.bitquery.io/docs/start/first-query/)** - Learn the basics in 5 minutes +2. **[Generate your API key](/docs/authorization/how-to-generate/)** - Required for API access +3. **[Run your first query](/docs/start/first-query/)** - Learn the basics in 5 minutes 4. **[Explore examples](#ethereum-transaction-balance-tracker-apis)** - Copy-paste ready queries below Need help crafting a query or subscription? Message us on [support](https://t.me/Bloxy_info). @@ -61,11 +60,11 @@ Get live Ethereum balance updates through our streaming solutions: - **GraphQL Subscriptions**: Convert any query to a live stream by changing `query` to `subscription` - **Kafka Streaming**: High-throughput streaming for enterprise applications -See examples and code snippets [here](https://docs.bitquery.io/docs/subscriptions/websockets/) for GraphQL subscription implementation, and learn about [Kafka streaming](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) for high-volume use cases. +See examples and code snippets [here](/docs/subscriptions/websockets/) for GraphQL subscription implementation, and learn about [Kafka streaming](/docs/streams/kafka-streaming-concepts/) for high-volume use cases. ## Ethereum Transaction Balance Tracker APIs -### [Ethereum Transaction Balance Tracker](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transaction-balance-tracker) +### [Ethereum Transaction Balance Tracker](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transaction-balance-tracker) The core Transaction Balance Tracker API provides real-time balance updates for all addresses involved in transactions on the Ethereum network, including detailed information about the reason for each balance change. Track native ETH, ERC-20 tokens, and NFTs with pre/post balances, USD values, and balance change reason codes. @@ -77,7 +76,7 @@ The core Transaction Balance Tracker API provides real-time balance updates for - Track ERC-20, ERC-721, and ERC-1155 tokens - Access pre and post balance values -### [Ethereum Transaction Balance Tracker](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transfer-balance-tracker) +### [Ethereum Transaction Balance Tracker](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-transfer-balance-tracker) Transfer Balance Tracker API provides real-time balance updates for all addresses involved in transfer of Native Currency on the Ethereum network. @@ -87,7 +86,7 @@ Transfer Balance Tracker API provides real-time balance updates for all addresse - Filter by specific addresses - Access pre and post balance values -### [Ethereum Validator Balance Tracker](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-validator-balance-tracker) +### [Ethereum Validator Balance Tracker](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-validator-balance-tracker) Track Ethereum validator balances, staking rewards, and withdrawals from the beacon chain. Monitor validator activity including block rewards, withdrawal events, and transaction fee rewards. @@ -99,7 +98,7 @@ Track Ethereum validator balances, staking rewards, and withdrawals from the bea - Filter by specific validator addresses - Real-time validator balance updates -### [Ethereum Gas Balance Tracker](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-gas-balance-tracker) +### [Ethereum Gas Balance Tracker](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-gas-balance-tracker) Track Ethereum balance changes for gas burn, unused gas returned for unused gas at the end of execution, and transaction tips. @@ -109,7 +108,7 @@ Track Ethereum balance changes for gas burn, unused gas returned for unused gas - Track gas burnt (Code 6) - Track gas returned for unused gas at the end of execution (Code 7) -### [Ethereum Miner Balance Tracker](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-miner-balance-tracker) +### [Ethereum Miner Balance Tracker](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-miner-balance-tracker) Monitor Ethereum miner balances, mining rewards, uncle block rewards, and transaction fee rewards. Track historical and real-time mining activity across the Ethereum network. @@ -121,7 +120,7 @@ Monitor Ethereum miner balances, mining rewards, uncle block rewards, and transa - Filter by specific miner addresses - Historical mining reward data -### [Ethereum MEV Balance Tracker](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-mev-balance-tracker) +### [Ethereum MEV Balance Tracker](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-mev-balance-tracker) Track MEV (Maximal Extractable Value) related balance changes including transaction fee rewards, block builder rewards, and other MEV extraction activities. Monitor MEV bots and block builders in real-time. @@ -133,7 +132,7 @@ Track MEV (Maximal Extractable Value) related balance changes including transact - Track large MEV transactions - Aggregate MEV reward statistics -### [Ethereum Self-Destruct Balance Tracker](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-self-destruct-balance-api) +### [Ethereum Self-Destruct Balance Tracker](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/eth-self-destruct-balance-api) Monitor contract self-destruct events, ephemeral contracts (like MEV bots), and security incidents. Track contracts that self-destruct and addresses that receive funds from self-destructed contracts. @@ -145,7 +144,7 @@ Monitor contract self-destruct events, ephemeral contracts (like MEV bots), and - Security incident monitoring - Aggregate self-destruct statistics -### [Ethereum Token Balance API](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/token-balance-api) +### [Ethereum Token Balance API](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/token-balance-api) Track ERC-20 fungible token balances, total supply, and market capitalization for any address on Ethereum. Monitor token holdings, portfolio values, and token balance changes in real-time. @@ -159,7 +158,7 @@ Track ERC-20 fungible token balances, total supply, and market capitalization fo - Stream token balance updates in real-time - Monitor token balance changes by transaction -### [Ethereum NFT Balance API](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/nft-balance-api) +### [Ethereum NFT Balance API](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/nft-balance-api) Track ERC-721 and ERC-1155 non-fungible token balances, ownership, and token IDs for any address on Ethereum. Monitor NFT collections, ownership changes, and specific token ownership in real-time. diff --git a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/nft-balance-api.md b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/nft-balance-api.md index 942675b8..4309e3a4 100644 --- a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/nft-balance-api.md +++ b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/nft-balance-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 9 +title: "Ethereum NFT Balance API" +description: "Ethereum NFT Balance API: stream Ethereum balance changes with reason codes using Bitquery GraphQL subscriptions. Works with WebSocket live subscriptions." --- - # Ethereum NFT Balance API The Ethereum NFT Balance API provides real-time balance updates for ERC-721 and ERC-1155 non-fungible tokens on the Ethereum blockchain. Track NFT ownership, token IDs, and ownership status for any address holding NFTs. @@ -13,31 +14,6 @@ For NFTs (ERC-721 / ERC-1155), the following fields are available: - **Not Provided**: `PreBalance`, `BalanceChangeReasonCode`, `TotalSupply`, `TotalSupplyInUSD`, `PostBalanceInUSD` ::: - - - - - - - - - - - - - - - - - - - ## Get Latest NFT Balance for an Address Get the latest NFT balance for a specific address and NFT collection. This query returns the current NFT count and ownership information. diff --git a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/token-balance-api.md b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/token-balance-api.md index e237eea7..76241cc8 100644 --- a/docs/blockchain/Ethereum/balances/transaction-balance-tracker/token-balance-api.md +++ b/docs/blockchain/Ethereum/balances/transaction-balance-tracker/token-balance-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 8 +title: "Ethereum Token Balance API" +description: "Ethereum Token Balance API: stream Ethereum balance changes with reason codes using Bitquery GraphQL subscriptions. Built for traders and analytics teams." --- - # Ethereum Token Balance API The Ethereum Token Balance API provides real-time balance updates for ERC-20 fungible tokens on the Ethereum blockchain. Track token balances, total supply, market capitalization, and USD values for any address holding ERC-20 tokens. @@ -13,31 +14,6 @@ For ERC-20 tokens, the following fields are available: - **Not Provided**: `PreBalance`, `BalanceChangeReasonCode`, `TokenOwnership` ::: - - - - - - - - - - - - - - - - - - - ## Get Latest Token Balance for an Address Get the latest balance of a specific ERC-20 token for a given address. This query returns the current token balance, USD value, and token information. diff --git a/docs/blockchain/Ethereum/blocks/blocks-api.md b/docs/blockchain/Ethereum/blocks/blocks-api.md index f0bd03e0..487ec7d1 100644 --- a/docs/blockchain/Ethereum/blocks/blocks-api.md +++ b/docs/blockchain/Ethereum/blocks/blocks-api.md @@ -1,64 +1,62 @@ ---- -sidebar_position: 1 ---- - -# Blocks API - -## Latest blocks in the Ethereum network - -This GraphQL query retrieves the latest blocks in real time on the Ethereum network that were mined after March 3rd, 2023. It includes information on the block number, hash, mix digest, date, base fee, coinbase, transaction hash, transaction count, and result (including gas and errors). You can find the query [here](https://graphql.bitquery.io/ide/Latest-blocks-in-the-Ethereum-network_1). - - - -```graphql -subscription { - EVM(network: eth) { - Blocks( - limit: { count: 10 } - orderBy: { descending: Block_Time } - where: { Block: { Date: { after: "2023-03-03" } } } - ) { - Block { - Number - Hash - MixDigest - Date - BaseFee - Coinbase - TxHash - TxCount - Result { - Errors - Gas - } - } - } - } -} -``` - - -### Parameters - -- `network`: The blockchain network to query (e.g., `eth`, `bsc`, `polygon`). -- `limit`: The maximum number of blocks to retrieve (here set to 10). -- `orderBy`: The field and direction to sort the results (e.g., `orderBy: {descending: Block_Time}`). -- `where`: Conditions to filter blocks by (e.g., `where: {Block: {Date: {after: "2023-03-03"}}}`). - -### Results - -- **Block**: Information about each block, including: - - - `Number` - - `Hash` - - `MixDigest` - - `Date` - - `BaseFee` - - `Coinbase` - - `TxHash` - - `TxCount` - -- **Result**: Execution details for each block: - - - `Errors` - - `Gas` +--- +sidebar_position: 1 +title: "Ethereum Blocks API" +description: "Ethereum Blocks API: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." +--- +# Blocks API + +## Latest blocks in the Ethereum network + +This GraphQL query retrieves the latest blocks in real time on the Ethereum network that were mined after March 3rd, 2023. It includes information on the block number, hash, mix digest, date, base fee, coinbase, transaction hash, transaction count, and result (including gas and errors). You can find the query [here](https://graphql.bitquery.io/ide/Latest-blocks-in-the-Ethereum-network_1). + +```graphql +subscription { + EVM(network: eth) { + Blocks( + limit: { count: 10 } + orderBy: { descending: Block_Time } + where: { Block: { Date: { after: "2023-03-03" } } } + ) { + Block { + Number + Hash + MixDigest + Date + BaseFee + Coinbase + TxHash + TxCount + Result { + Errors + Gas + } + } + } + } +} +``` + +### Parameters + +- `network`: The blockchain network to query (e.g., `eth`, `bsc`, `polygon`). +- `limit`: The maximum number of blocks to retrieve (here set to 10). +- `orderBy`: The field and direction to sort the results (e.g., `orderBy: {descending: Block_Time}`). +- `where`: Conditions to filter blocks by (e.g., `where: {Block: {Date: {after: "2023-03-03"}}}`). + +### Results + +- **Block**: Information about each block, including: + + - `Number` + - `Hash` + - `MixDigest` + - `Date` + - `BaseFee` + - `Coinbase` + - `TxHash` + - `TxCount` + +- **Result**: Execution details for each block: + + - `Errors` + - `Gas` diff --git a/docs/blockchain/Ethereum/calls/contract-creation.md b/docs/blockchain/Ethereum/calls/contract-creation.md index 4802b4db..ae122163 100644 --- a/docs/blockchain/Ethereum/calls/contract-creation.md +++ b/docs/blockchain/Ethereum/calls/contract-creation.md @@ -1,14 +1,15 @@ --- sidebar_position: 1 +title: "Smart Contract Creation" +description: "Smart Contract Creation: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." --- - # Smart Contract Creation Smart contract creators can use these queries to track the deployment of their own smart contracts and to monitor the deployment of new smart contracts by others. ## Subscription to track new smart contract creation in real-time -This subscription will return information on each new smart contract created on Ethereum. You can create a [websocket](https://docs.bitquery.io/docs/start/websocket/) to monitor the same in real-time. +This subscription will return information on each new smart contract created on Ethereum. You can create a [websocket](/docs/subscriptions/websockets/) to monitor the same in real-time. ``` subscription { diff --git a/docs/blockchain/Ethereum/calls/smartcontract-filterby.md b/docs/blockchain/Ethereum/calls/smartcontract-filterby.md index 43ac78cb..17115b8c 100644 --- a/docs/blockchain/Ethereum/calls/smartcontract-filterby.md +++ b/docs/blockchain/Ethereum/calls/smartcontract-filterby.md @@ -1,17 +1,15 @@ --- sidebar_position: 1 +title: "Ethereum Smartcontract Filterby" +description: "Ethereum Smartcontract Filterby: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." --- - # SmartContract API ## Smart Contract Calls by Method Signature - - This query retrieves the 10 most recent smart contract calls that match a specific function signature (harvest()) on the Binance Smart Chain (BSC) network. It also includes transaction and block data associated with each call. You can find the GraphQL query [here](https://graphql.bitquery.io/ide/Calls-by-Method-Signature) - ``` query MyQuery { EVM(dataset: archive, network: bsc) { @@ -63,7 +61,6 @@ The query returns the following data for each smart contract call: ## Smart Contract Calls by Opcode - This GraphQL query retrieves information about the latest STATICCALL EVM (Ethereum Virtual Machine) calls on the Binance Smart Chain network. You can find the GraphQL query [here](https://graphql.bitquery.io/ide/Smart-Contract-Calls-by-Opcode) @@ -106,7 +103,6 @@ query MyQuery { - `orderBy` parameter is used to sort the results by the Block_Date field in descending order. - `where` parameter is used to filter the results based on certain conditions. In this case, the where parameter filters the results to include only STATICCALL calls made after January 1st, 2023. - **Returned Data** - `Call`: Returns information about the STATICCALL call, including the number of logs generated, internal calls made, and the name of the opcode used. @@ -115,8 +111,7 @@ query MyQuery { ## Smart Contract Calls by Arguments - -The Array-like structure of [Arguments and Returns](https://docs.bitquery.io/docs/schema/evm/arguments/) in Smart Contract Calls allows us to insert specific filters, enabling us to effectively narrow down our search. Further we can better understand the details of smart contract interactions in specific contexts. +The Array-like structure of [Arguments and Returns](/docs/schema/evm/arguments/) in Smart Contract Calls allows us to insert specific filters, enabling us to effectively narrow down our search. Further we can better understand the details of smart contract interactions in specific contexts. **Example 1** @@ -253,4 +248,4 @@ query MyQuery { **Returned Data** -The response will contain the first 10 calls that match these filter conditions, along with the details of the arguments and the function signature of each call. \ No newline at end of file +The response will contain the first 10 calls that match these filter conditions, along with the details of the arguments and the function signature of each call. diff --git a/docs/blockchain/Ethereum/calls/smartcontract.md b/docs/blockchain/Ethereum/calls/smartcontract.md index 7a8bd32b..64bab834 100644 --- a/docs/blockchain/Ethereum/calls/smartcontract.md +++ b/docs/blockchain/Ethereum/calls/smartcontract.md @@ -1,30 +1,12 @@ --- sidebar_position: 2 +title: "SmartContract Calls API" +description: "SmartContract Calls API: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Scale further with Kafka or gRPC streams." --- import FAQ from "@site/src/components/FAQ"; # SmartContract Calls API - - - - - - - - - - - - - - - - - - - - **Before you start**: Not sure when to use Calls vs Transfers vs Events vs DexTrades? Read our [Mental Model guide](https://docs.bitquery.io/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. +> **Before you start**: Not sure when to use Calls vs Transfers vs Events vs DexTrades? Read our [Mental Model guide](/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. This API helps retrieve information about smart contract transactions, including details about the contract function that was called, the input and output parameters, and more. With this data, you can build applications that interact with smart contracts, perform analytics on contract activity, and more. @@ -79,9 +61,6 @@ This query retrieves the most recent smart contract calls on the Ethereum networ - - - ## Recent Smart Contract Creation Calls This GraphQL query fetches data from the "eth" network about the 10 most recent calls made in Ethereum that were contract creation calls. @@ -118,6 +97,5 @@ query MyQuery { } } - ``` diff --git a/docs/blockchain/Ethereum/dextrades/DEXScreener/evm_dexscreener.mdx b/docs/blockchain/Ethereum/dextrades/DEXScreener/evm_dexscreener.mdx index f1c38afb..9f404865 100644 --- a/docs/blockchain/Ethereum/dextrades/DEXScreener/evm_dexscreener.mdx +++ b/docs/blockchain/Ethereum/dextrades/DEXScreener/evm_dexscreener.mdx @@ -1,14 +1,15 @@ --- sidebar_position: 1 sidebar_label: DEXScreener +title: "Ethereum EVM DEXscreener API" +description: "Ethereum EVM DEXscreener API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. See examples in the Bitquery IDE." --- - # DEXScreener EVM API Everything you see on the DEXScreener EVM dashboard—live pairs, trades, prices, volumes, makers/buyers/sellers, and more—can be accessed via APIs/Streams with Bitquery. We expose the same on-chain data via GraphQL APIs, real-time WebSocket streams, and enterprise Kafka topics, with optional cloud connectors (AWS, GCP, Snowflake) for analytics pipelines. -Checkout our [DEXScreener Solana API documentation](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/DEXScreener/solana_dexscreener/) if you are interested in getting Solana data which DEXScreener shows. +Checkout our [DEXScreener Solana API documentation](/docs/blockchain/Solana/DEXScreener/solana_dexscreener/) if you are interested in getting Solana data which DEXScreener shows. :::note DEXScreener EVM APIs include data apis for EVM chains like Ethereum, Binance Smart Chain(BSC), Arbitrum, Base, Matic, Optimism, etc @@ -23,9 +24,9 @@ DEXScreener EVM APIs include data apis for EVM chains like Ethereum, Binance Sma ## Getting Started with EVM -- **[EVM API Examples](https://docs.bitquery.io/docs/blockchain/Ethereum/)** - Complete collection of EVM API examples -- **[EVM DEX Trades](https://docs.bitquery.io/docs/category/dex-trades/)** - Real-time DEX trading data and analytics -- **[EVM Subscriptions](https://docs.bitquery.io/docs/subscriptions/subscription)** - Learn how to set up real-time data streams +- **[EVM API Examples](/docs/blockchain/Ethereum/)** - Complete collection of EVM API examples +- **[EVM DEX Trades](/docs/category/dex-trades/)** - Real-time DEX trading data and analytics +- **[EVM Subscriptions](/docs/subscriptions/subscription)** - Learn how to set up real-time data streams - **[IDE for EVM](https://graphql.bitquery.io/ide)** - Interactive development environment for testing EVM queries This guide shows how to retrieve the same EVM DEX data that DEXScreener displays—real-time trades, pair stats, volumes, buyers/sellers, and more—using Bitquery APIs, streams, and Kafka. @@ -72,7 +73,6 @@ query TrendingPairs { } } - ``` ## Get Trade Transactions for a particular pair in realtime @@ -121,7 +121,6 @@ subscription{ } } - ``` ## Get Price of a Token @@ -184,7 +183,6 @@ query MyQuery { } } - ``` ## Get the Buys, Sells, Buy Volume, Sell Volume and Makers diff --git a/docs/blockchain/Ethereum/dextrades/crypto-coin-ticker.md b/docs/blockchain/Ethereum/dextrades/crypto-coin-ticker.md index 4ca3d714..c686b822 100644 --- a/docs/blockchain/Ethereum/dextrades/crypto-coin-ticker.md +++ b/docs/blockchain/Ethereum/dextrades/crypto-coin-ticker.md @@ -1,15 +1,15 @@ --- sidebar_position: 3 sidebar_label: Coin Ticker API +title: "Crypto Coin Ticker API" +description: "Crypto Coin Ticker API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Scale further with Kafka or gRPC streams." --- - # Crypto Coin Ticker API -You can build your crypto coin ticker using our [DEX APIs](https://bitquery.io/products/dex) based on the requirements of the data field. For pre-aggregated price data with OHLC, consider using our [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/). +You can build your crypto coin ticker using our [DEX APIs](https://bitquery.io/products/dex) based on the requirements of the data field. For pre-aggregated price data with OHLC, consider using our [Crypto Price API](/docs/trading/crypto-price-api/introduction/). For **per-swap ticks**, see the **[Crypto Trades API](/docs/trading/crypto-trades-api/trades-api)**. - ## Using Crypto price API For a **live ticker**, use the **[Crypto Price API](/docs/trading/crypto-price-api/introduction/)** stream. @@ -80,7 +80,6 @@ subscription { } ``` - ## OHLC ticker from DEXTradeByTokens Open this API on our [GraphQL IDE](https://ide.bitquery.io/Coin-ticker-api_4). diff --git a/docs/blockchain/Ethereum/dextrades/dex-api.md b/docs/blockchain/Ethereum/dextrades/dex-api.md index 98f86b63..442e18d6 100644 --- a/docs/blockchain/Ethereum/dextrades/dex-api.md +++ b/docs/blockchain/Ethereum/dextrades/dex-api.md @@ -1,20 +1,21 @@ --- sidebar_label: DEX Trades API +title: "Ethereum DEX Trades API" +description: "Compare DEXTrades, DEXTradeByTokens, and Trading cubes for Ethereum DEX analytics using Bitquery GraphQL examples. Keep queries fast with indexed filters." --- import FAQ from "@site/src/components/FAQ"; # DEX API :::tip Need real-time Ethereum DEX data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Ethereum DEX swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Ethereum DEX data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Ethereum DEX swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Ethereum DEX data older than ~30 days**, raw per-swap detail, or call / event context. ::: - -Read [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. +Read [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. For **live swaps** with trader, USD prices and mcap on each row, start with the **[Crypto Trades API](/docs/trading/crypto-trades-api/trades-api)**. For **historical** work—long lookbacks, archive datasets, pool-level detail, OHLC built from raw trades, and DEX-wide stats—**`DEXTrades`** and **`DEXTradeByTokens`** are usually the better fit; the queries on this page follow that path. -**DEX APIs across chains:** [Solana DEX](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades) (Pump.fun, Raydium, Orca, Jupiter) · [Base DEX](https://docs.bitquery.io/docs/blockchain/Base/base-dextrades) · [BSC DEX](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades) · [Uniswap API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/uniswap-api) · [PancakeSwap API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/pancakeswap-api) · [DEXScreener API](https://docs.bitquery.io/docs/examples/dextrades/DEXScreener/evm_dexscreener) +**DEX APIs across chains:** [Solana DEX](/docs/blockchain/Solana/solana-dextrades) (Pump.fun, Raydium, Orca, Jupiter) · [Base DEX](/docs/blockchain/Base/base-dextrades) · [BSC DEX](/docs/blockchain/BSC/bsc-dextrades) · [Uniswap API](/docs/blockchain/Ethereum/dextrades/uniswap-api) · [PancakeSwap API](/docs/blockchain/Ethereum/dextrades/pancakeswap-api) · [DEXScreener API](/docs/blockchain/Ethereum/dextrades/DEXScreener/evm_dexscreener/) For curated token groups with live multi-chain DEX prices and volume (LSTs, memes, stablecoins, launchpads, and more), browse [DEXrabbit Categories](https://dexrabbit.bitquery.io/categories). @@ -23,7 +24,7 @@ We have two main APIs to get DEX trading data. - DEXTrades - DEXTradeByTokens -To learn the difference between two APIs, please check [this doc](https://docs.bitquery.io/docs/schema/evm/dextrades/). +To learn the difference between two APIs, please check [this doc](/docs/schema/evm/dextrades/). ## Get all the DEXs info on a Ethereum network diff --git a/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api.md b/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api.md index e6a87e93..424afa4e 100644 --- a/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api.md +++ b/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api.md @@ -1,41 +1,15 @@ --- sidebar_position: 6 sidebar_label: Pool Liquidity & Reserves +title: "Ethereum Liquidity API" +description: "Ethereum Liquidity API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Great for bots, dashboards, and alerts." --- - # Ethereum Liquidity API In this section we will see how to get Ethereum DEX pool liquidity information using Bitquery API. The liquidity API helps you monitor real-time liquidity changes, track pool reserves, and analyze liquidity depth for token pairs on Ethereum DEX pools. > **Note:** This API also works for other EVM chains such as Base, BSC, and Arbitrum—just change the network parameters in your request. - - - - - - - - - - - - - - - - - - - - - ## Understanding Liquidity and Pool Reserves Liquidity in DEX pools refers to the amount of tokens available for trading. Pool reserves (the balance of each token in the pool) determine the pool's ability to handle trades without significant price impact. Monitoring liquidity changes helps you: @@ -52,7 +26,7 @@ The DEXPoolEvents API provides real-time information about: - Pool and token pair information - Transaction details for liquidity-changing events -For a comprehensive explanation of how DEX pools work, liquidity calculations, and when pool events are emitted, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/). +For a comprehensive explanation of how DEX pools work, liquidity calculations, and when pool events are emitted, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/). ## Realtime Liquidity Stream @@ -536,7 +510,7 @@ Kafka streams provide the same liquidity data as GraphQL subscriptions but with - Ability to read from latest offset without gaps - Better scalability with multiple consumers -For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](/docs/streams/kafka-streaming-concepts/). > **Note:** IDE credentials will not work with Kafka Streams. You need separate Kafka credentials. Please contact sales on our official telegram channel or fill out the [form on our website](https://bitquery.io/forms/api). @@ -569,7 +543,7 @@ The `DEXPoolEvents` API response contains the following information: - `Hash`: Transaction hash - `Gas`: Gas used for the transaction -For more details on when new pool events are emitted and how liquidity is calculated, see the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). +For more details on when new pool events are emitted and how liquidity is calculated, see the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). ## Use Cases @@ -607,4 +581,4 @@ Track liquidity events that may create trading opportunities: - Monitor liquidity removals that may signal pool abandonment - Identify pools experiencing rapid liquidity growth -For more advanced use cases, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). +For more advanced use cases, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). diff --git a/docs/blockchain/Ethereum/dextrades/ethereum-slippage-api.md b/docs/blockchain/Ethereum/dextrades/ethereum-slippage-api.md index d9fb224b..f6d18b10 100644 --- a/docs/blockchain/Ethereum/dextrades/ethereum-slippage-api.md +++ b/docs/blockchain/Ethereum/dextrades/ethereum-slippage-api.md @@ -1,6 +1,8 @@ --- sidebar_position: 3 sidebar_label: Slippage & Price Impact +title: "EVM DEX Slippage API" +description: "EVM DEX Slippage API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Includes filters and field selection tips." --- import FAQ from "@site/src/components/FAQ"; @@ -10,33 +12,6 @@ In this section we will see how to get Ethereum DEX pool slippage information us > **Note:** This API also works for other EVM chains such as Base, BSC, and Arbitrum—just change the network parameters in your request. - - - - - - - - - - - - - - - - - - - - - ## What is Slippage and Price Impact in Crypto DEX pools? Slippage refers to the difference between the expected price of a trade and the actual execution price. When swapping tokens in a DEX pool, larger trades can move the price due to limited liquidity, resulting in slippage. @@ -47,7 +22,7 @@ The DEXPoolSlippages API provides detailed information about: - Average execution prices for different trade sizes - Price impact calculations for both swap directions (A to B and B to A) -For a comprehensive explanation of how DEX pools work, liquidity calculations, and price tables, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/). +For a comprehensive explanation of how DEX pools work, liquidity calculations, and price tables, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/). ## Realtime Slippage Monitoring for Uniswap Pools @@ -112,7 +87,6 @@ subscription { This query retrieves the latest slippage data for a specific DEX pool on Ethereum. Use it to calculate slippage and check Uniswap V3 price impact slippage for a particular token pair before trading. - You can find the query [here](https://ide.bitquery.io/Latest-slippage-of-a-pool-on-Uniswap-v3-Ethereum) ```graphql @@ -247,7 +221,7 @@ Kafka streams provide the same slippage data as GraphQL subscriptions but with s - Ability to read from latest offset without gaps - Better scalability with multiple consumers -For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](/docs/streams/kafka-streaming-concepts/). > **Note:** IDE credentials will not work with Kafka Streams. You need separate Kafka credentials. Please contact sales on our official telegram channel or fill out the [form on our website](https://bitquery.io/forms/api). @@ -269,7 +243,7 @@ The `DEXPoolSlippages` API response contains the following information: - `Time`: Timestamp of the block - `Number`: Block number -For more details on how slippage is calculated and when new pool records are emitted, see the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). +For more details on how slippage is calculated and when new pool records are emitted, see the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). ## Use Cases @@ -316,7 +290,7 @@ For a practical implementation example of using slippage data for automated trad - Execute fade trades against temporary price impacts - Manage positions with dynamic stop losses and take profits based on slippage data -For more advanced use cases, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). +For more advanced use cases, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). - - - - - - - - - - - - - - - - import VideoPlayer from "../../../../src/components/videoplayer.js"; ## Get the Top Trading Pairs @@ -89,7 +73,6 @@ query TrendingPairs { } } - ``` ## Get Trade Transactions for a particular pair in realtime @@ -138,7 +121,6 @@ subscription{ } } - ``` ## Get Price of a Token @@ -171,7 +153,6 @@ query MyQuery { } } - ``` ## Get Liquidity of a specific pair by using its Pair Address @@ -195,7 +176,6 @@ query MyQuery { } } - ``` ## Get the Buys, Sells, Buy Volume, Sell Volume and Makers diff --git a/docs/blockchain/Ethereum/dextrades/evm-gmgn-api.md b/docs/blockchain/Ethereum/dextrades/evm-gmgn-api.md index f37877be..2e4b6882 100644 --- a/docs/blockchain/Ethereum/dextrades/evm-gmgn-api.md +++ b/docs/blockchain/Ethereum/dextrades/evm-gmgn-api.md @@ -1,6 +1,6 @@ --- -title: "GMGN API for Ethereum & EVM | Trending Pairs, Token Stats, DEX Trades" -description: "Build GMGN-style dashboards on Ethereum and EVM chains: trending DEX pairs, live pair trades, token price, buy/sell volume, makers, OHLC, pool liquidity, top traders, and new Uniswap v3 pools via Bitquery GraphQL and WebSocket." +title: "Ethereum EVM Gmgn API" +description: "Ethereum EVM Gmgn API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. See examples in the Bitquery IDE." sidebar_label: GMGN keywords: - GMGN API @@ -26,19 +26,6 @@ Use Bitquery’s **GraphQL** and **subscription** APIs to reproduce **GMGN**-sty import VideoPlayer from "../../../../src/components/videoplayer.js"; - - - - - - - - - - - - - ## Related APIs - **[GMGN Solana API](/docs/blockchain/Solana/solana-gmgn-api)** — Same style of trending tokens, pair stats, and live trades on **Solana** (`DEXTradeByTokens`). @@ -87,7 +74,6 @@ query TrendingPairs { } } - ``` ## Get Trade Transactions for a particular pair in realtime @@ -136,7 +122,6 @@ subscription{ } } - ``` ## Get Price of a Token @@ -169,7 +154,6 @@ query MyQuery { } } - ``` ## Get Liquidity of a specific pair by using its Pair Address @@ -193,7 +177,6 @@ query MyQuery { } } - ``` ## Get the Buys, Sells, Buy Volume, Sell Volume and Makers diff --git a/docs/blockchain/Ethereum/dextrades/evm-photon-api.md b/docs/blockchain/Ethereum/dextrades/evm-photon-api.md index 8a2f67d4..b9a5bd5c 100644 --- a/docs/blockchain/Ethereum/dextrades/evm-photon-api.md +++ b/docs/blockchain/Ethereum/dextrades/evm-photon-api.md @@ -1,7 +1,8 @@ --- sidebar_label: Photon +title: "Ethereum EVM Photon API" +description: "Ethereum EVM Photon API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Built for traders and analytics teams." --- - # Photon EVM API This section will guide you through different APIs which will tell you how to get data like realtime trades, price of a token, buys, sells, sell volume, makers, top holders of a token, liquidity of a pair and many more just like how Photon shows for EVM Chains. @@ -46,7 +47,6 @@ query TrendingPairs { } } - ``` ## Get Trade Transactions for a particular pair in realtime @@ -95,7 +95,6 @@ subscription{ } } - ``` ## Get Price of a Token @@ -128,7 +127,6 @@ query MyQuery { } } - ``` ## Get Liquidity of a specific pair by using its Pair Address @@ -152,7 +150,6 @@ query MyQuery { } } - ``` ## Get the Buys, Sells, Buy Volume, Sell Volume and Makers diff --git a/docs/blockchain/Ethereum/dextrades/fluid-dex-api.md b/docs/blockchain/Ethereum/dextrades/fluid-dex-api.md index 404ca2c0..7a970a59 100644 --- a/docs/blockchain/Ethereum/dextrades/fluid-dex-api.md +++ b/docs/blockchain/Ethereum/dextrades/fluid-dex-api.md @@ -1,14 +1,14 @@ --- sidebar_label: Fluid DEX Trades +title: "Ethereum Fluid DEX API" +description: "Ethereum Fluid DEX API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Run it in the IDE, then ship in your app." --- - # Fluid DEX API :::tip Need real-time Fluid DEX data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Fluid DEX swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Fluid DEX data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Fluid DEX swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Fluid DEX data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Fluid DEX is a decentralized exchange protocol built on Ethereum and other EVM chains. Bitquery's APIs support tracking Fluid DEX vault positions, events, and contract interactions in real-time and across historical data. You can get data on other EVM chains like Base, Arbitrum, and Polygon by changing the contract address based on the [Fluid contracts deployments](https://github.com/Instadapp/fluid-contracts-public/blob/main/deployments/deployments.md) and the `network` parameter diff --git a/docs/blockchain/Ethereum/dextrades/get-trading-pairs-of-token.md b/docs/blockchain/Ethereum/dextrades/get-trading-pairs-of-token.md index 7c03c456..634f86cb 100644 --- a/docs/blockchain/Ethereum/dextrades/get-trading-pairs-of-token.md +++ b/docs/blockchain/Ethereum/dextrades/get-trading-pairs-of-token.md @@ -1,8 +1,9 @@ --- sidebar_position: 2 sidebar_label: Pairs for a Token +title: "Ethereum Get Trading Pairs Of Token API" +description: "Ethereum Get Trading Pairs Of Token API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams." --- - # Trading Pairs API If you want to get all trades of a token, you might want to know all its trading pairs. @@ -192,8 +193,6 @@ The query returns an object containing a list of DEX trades, each with the follo - `Buy`: An object containing information about the buy currency, including the name and smart contract address. - `Sell`: An object containing information about the sell currency, including the name and smart contract address. - - ## Get liquidity of token pool/pair To get liquidity of token pairs you need 2 things. 1. Pair address 2. Addresses of tokens in the pair. @@ -206,8 +205,6 @@ USDT address - `0xdAC17F958D2ee523a2206206994597C13D831ec7` USDC address - `0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48` - - ```graphql query MyQuery { EVM(dataset: combined, network: eth) { diff --git a/docs/blockchain/Ethereum/dextrades/latest-trading-pairs-api.md b/docs/blockchain/Ethereum/dextrades/latest-trading-pairs-api.md index 0e05e8d8..288e0bb5 100644 --- a/docs/blockchain/Ethereum/dextrades/latest-trading-pairs-api.md +++ b/docs/blockchain/Ethereum/dextrades/latest-trading-pairs-api.md @@ -1,8 +1,9 @@ --- sidebar_position: 4 sidebar_label: Newly Created Pairs +title: "Getting Latest Pairs" +description: "Getting Latest Pairs: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Keep queries fast with indexed filters." --- - # Getting Latest Pairs ## Latest Trading Pairs for a DEX @@ -60,7 +61,6 @@ Let's see how we can get latest trading pairs created on DEXs. In this example w } } - ``` Open this query on our GraphQL IDE using this [link](https://ide.bitquery.io/uniswap-v3-pairs). diff --git a/docs/blockchain/Ethereum/dextrades/pair-creation-time.md b/docs/blockchain/Ethereum/dextrades/pair-creation-time.md index 3a8d898a..f720909a 100644 --- a/docs/blockchain/Ethereum/dextrades/pair-creation-time.md +++ b/docs/blockchain/Ethereum/dextrades/pair-creation-time.md @@ -1,8 +1,9 @@ --- sidebar_position: 4 sidebar_label: Pair Creation Time +title: "Pair Creation Time API" +description: "Pair Creation Time API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. See examples in the Bitquery IDE." --- - # Pair Creation Time API ## Pair Creation Time for a Specific Pair diff --git a/docs/blockchain/Ethereum/dextrades/pancakeswap-api.mdx b/docs/blockchain/Ethereum/dextrades/pancakeswap-api.mdx index e2f56c69..ba10756c 100644 --- a/docs/blockchain/Ethereum/dextrades/pancakeswap-api.mdx +++ b/docs/blockchain/Ethereum/dextrades/pancakeswap-api.mdx @@ -1,14 +1,15 @@ --- sidebar_label: PancakeSwap Trades +title: "Ethereum Pancakeswap API" +description: "Ethereum Pancakeswap API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Great for bots, dashboards, and alerts." --- - # PancakeSwap API Bitquery provides PancakeSwap data through APIs, Streams and Data Dumps. The below graphQL APIs and Streams are examples of data points you can get with Bitquery. If you have any question on other data points reach out to [support](https://t.me/Bloxy_info) -Need zero-latency Pumpfun data? [Read about our Kafka Streams and Contact us for a Trial](https://docs.bitquery.io/docs/streams/protobuf/chains/EVM-protobuf/). +Need zero-latency Pumpfun data? [Read about our Kafka Streams and Contact us for a Trial](/docs/streams/protobuf/chains/EVM-protobuf/). The PancakSwap DEX Data is also available for view as a dashboard [at DEXRABBIT](https://dexrabbit.com/eth/dex_market/pancake_swap_v3) @@ -168,7 +169,6 @@ query topTraders { } } - ``` diff --git a/docs/blockchain/Ethereum/dextrades/token-trades-apis.mdx b/docs/blockchain/Ethereum/dextrades/token-trades-apis.mdx index 205a3c24..9b5873b7 100644 --- a/docs/blockchain/Ethereum/dextrades/token-trades-apis.mdx +++ b/docs/blockchain/Ethereum/dextrades/token-trades-apis.mdx @@ -1,21 +1,21 @@ --- sidebar_label: Token Trades API +title: "Ethereum Token Trades APIs" +description: "Ethereum Token Trades Apis: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. See examples in the Bitquery IDE." --- - # Token Trades API :::tip Need real-time token trade data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered token trade swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical token trade data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered token trade swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical token trade data older than ~30 days**, raw per-swap detail, or call / event context. ::: - We have three main APIs to get DEX trading data. - DEXTrades - DEXTradeByTokens - Trades cube -Read [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. +Read [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. ## Subscribe to realtime DEXTrades on Ethereum Mainnet @@ -1952,7 +1952,7 @@ query { ## Trader-Focused Trade APIs (with USD Price, Market Cap & Supply) -The queries below use the **[Trades cube](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. +The queries below use the **[Trades cube](/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. ### Get All DEX Trades on Ethereum With Price, Market Cap, and Supply diff --git a/docs/blockchain/Ethereum/dextrades/trades-of-an-address-api.md b/docs/blockchain/Ethereum/dextrades/trades-of-an-address-api.md index e984e665..2f109be9 100644 --- a/docs/blockchain/Ethereum/dextrades/trades-of-an-address-api.md +++ b/docs/blockchain/Ethereum/dextrades/trades-of-an-address-api.md @@ -1,19 +1,20 @@ --- sidebar_position: 7 sidebar_label: Wallet Trades API +title: "Ethereum Trades Of An Address API" +description: "Ethereum Trades Of An Address API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams." --- - # Address Trades API ## How do I get trades made by a specific wallet on a DEX? This GraphQL query retrieves the latest trades executed by a particular maker on the Ethereum network. You can view the query in the IDE [here](https://ide.bitquery.io/latest-trades-by-market-maker) -On **EVM**, use the chain-specific **DEXTrades** cube (GraphQL: `EVM { DEXTrades }`) or **`DEXTradeByTokens`** for a token-centric view. Filter by the wallet as transaction sender or as **`Trade.Sender`** / buyer–seller fields depending on protocol. The [DEXTrades example](#latest-trades-by-address) filters `Transaction.From` on Ethereum; adjust `network`, `dataset`, and DEX filters for BSC, Base, etc. For **Solana**, see [Solana DEX Trades API](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/). +On **EVM**, use the chain-specific **DEXTrades** cube (GraphQL: `EVM { DEXTrades }`) or **`DEXTradeByTokens`** for a token-centric view. Filter by the wallet as transaction sender or as **`Trade.Sender`** / buyer–seller fields depending on protocol. The [DEXTrades example](#latest-trades-by-address) filters `Transaction.From` on Ethereum; adjust `network`, `dataset`, and DEX filters for BSC, Base, etc. For **Solana**, see [Solana DEX Trades API](/docs/blockchain/Solana/solana-dextrades/). ### Stream wallet swaps on Ethereum -[Crypto Trades API](/docs/trading/crypto-trades-api/trades-api): filter **`Pair.Market.Network: Ethereum`** and **`Trader.Address`**. More examples: [Trades API](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api), [trader + token (IDE)](https://ide.bitquery.io/trades-of-a-specific-trader-of-a-specific-token). +[Crypto Trades API](/docs/trading/crypto-trades-api/trades-api): filter **`Pair.Market.Network: Ethereum`** and **`Trader.Address`**. More examples: [Trades API](/docs/trading/crypto-trades-api/trades-api), [trader + token (IDE)](https://ide.bitquery.io/trades-of-a-specific-trader-of-a-specific-token). [Bitquery IDE](https://ide.bitquery.io) diff --git a/docs/blockchain/Ethereum/dextrades/uniswap-api.mdx b/docs/blockchain/Ethereum/dextrades/uniswap-api.mdx index 9562b08c..67c92111 100644 --- a/docs/blockchain/Ethereum/dextrades/uniswap-api.mdx +++ b/docs/blockchain/Ethereum/dextrades/uniswap-api.mdx @@ -1,5 +1,7 @@ --- sidebar_label: Uniswap v1–v3 Trades +title: "Ethereum Uniswap API" +description: "Ethereum Uniswap API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Works with WebSocket live subscriptions." --- import FAQ from "@site/src/components/FAQ"; @@ -7,36 +9,13 @@ import FAQ from "@site/src/components/FAQ"; Uniswap is a decentralized exchange on Ethereum for trading ERC-20 tokens. Bitquery’s APIs support Uniswap trades, pool creations, and active user metrics across v1, v2, v3 and v4 in real-time and across archive data since genesis. -To get details on Uniswap v3 Positions, check the examples available in [this page](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/uniswap-position-api/) +To get details on Uniswap v3 Positions, check the examples available in [this page](/docs/blockchain/Ethereum/dextrades/uniswap-position-api/) You can also explore Uniswap APIs on other chains: -- [BNB Smart Chain](https://docs.bitquery.io/docs/blockchain/Ethereum/BSC/bsc-uniswap-api/) -- [Base](https://docs.bitquery.io/docs/blockchain/Ethereum/Base/base-uniswap-api/) -- [Polygon](https://docs.bitquery.io/docs/blockchain/Ethereum/Matic/matic-uniswap-api/) - - - - - - - - - - - - - - - - - +- [BNB Smart Chain](/docs/blockchain/BSC/bsc-uniswap-api/) +- [Base](/docs/blockchain/Base/base-uniswap-api/) +- [Polygon](/docs/blockchain/Matic/matic-uniswap-api/) import VideoPlayer from "../../../../src/components/videoplayer.js"; @@ -117,7 +96,7 @@ subscription { ## TradingView OHLC Stream on Uniswap Across Chains -The new [Price Index Stream](https://docs.bitquery.io/docs/trading/price-index/introduction/) helps you get token-level, pair-level, and market-level OHLC data for 1 sec interval( or higher), in real-time across all chains. +The new [Price Index Stream](/docs/trading/crypto-price-api/introduction/) helps you get token-level, pair-level, and market-level OHLC data for 1 sec interval( or higher), in real-time across all chains. These also includes trading metrics like SMA, EMA, VWAP, and more. [Run Stream](https://ide.bitquery.io/Stream-all-Uniswap-Seconds-OHLC-Kline_1) @@ -559,7 +538,7 @@ query ActiveUniswapTraders { ## Get Latest Trading Price for a Uniswap Token Pair -We launched the [Price Index](https://docs.bitquery.io/docs/category/price-index/) in August 2025, allowing you to track price for any onchain token pair. +We launched the [Price Index](/docs/trading/crypto-price-api/) in August 2025, allowing you to track price for any onchain token pair. Here's an example of tracking Uniswap token pair trading price. @@ -674,7 +653,7 @@ query MyQuery { ## Uniswap Kafka Streams -You can get Uniswap data with sub-second latency via Kafka Streams. Read more [here](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) +You can get Uniswap data with sub-second latency via Kafka Streams. Read more [here](/docs/streams/kafka-streaming-concepts/) Contact us on our telegram channel for a trial credentials. diff --git a/docs/blockchain/Ethereum/dextrades/uniswap-position-api.md b/docs/blockchain/Ethereum/dextrades/uniswap-position-api.md index a05541a0..f394f7c5 100644 --- a/docs/blockchain/Ethereum/dextrades/uniswap-position-api.md +++ b/docs/blockchain/Ethereum/dextrades/uniswap-position-api.md @@ -1,9 +1,8 @@ --- title: "Uniswap V3 Position API - Track Liquidity Positions" -description: "Track Uniswap V3 NFT positions, monitor liquidity changes, position creation, and position management using Bitquery's Position API." +description: "Uniswap V3 Position API - Track Liquidity Positions: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams." sidebar_label: Uniswap v3 LP Positions --- - # Uniswap V3 Position API - Track Liquidity Positions Uniswap V3 introduced NFT-based liquidity positions, where each position is represented as an ERC-721 NFT. Bitquery's Position API allows you to track position creation, liquidity additions, removals, burns, and query position details in real-time. @@ -15,29 +14,6 @@ The Uniswap V3 NonfungiblePositionManager contract (`0xC36442b4a4522E871399CD717 - **IncreaseLiquidity/DecreaseLiquidity**: Modifies existing positions (requires NFT ID) - **Positions**: Queries position details by token ID - - - - - - - - - - - - - - - - - ## Table of Contents ### 1. Position Creation & Tracking diff --git a/docs/blockchain/Ethereum/dextrades/uniswap-v4-api.md b/docs/blockchain/Ethereum/dextrades/uniswap-v4-api.md index 46512f2d..65f662d7 100644 --- a/docs/blockchain/Ethereum/dextrades/uniswap-v4-api.md +++ b/docs/blockchain/Ethereum/dextrades/uniswap-v4-api.md @@ -1,6 +1,6 @@ --- -title: "Uniswap V4 API - Track Trader Activities, Token Trades and Market Behaviour" -description: "Track Uniswap V4 trades, trader activities, token trades, and market behaviour in real time using Bitquery's DEX Trades API." +title: "Ethereum Uniswap V4 API" +description: "Ethereum Uniswap V4 API: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Works with WebSocket live subscriptions." sidebar_label: Uniswap v4 Trades --- import FAQ from "@site/src/components/FAQ"; @@ -8,10 +8,9 @@ import FAQ from "@site/src/components/FAQ"; # Uniswap v4 Trades API :::tip Need real-time Uniswap V4 (Ethereum) data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Uniswap V4 (Ethereum) swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Uniswap V4 (Ethereum) data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Uniswap V4 (Ethereum) swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Uniswap V4 (Ethereum) data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Uniswap v4 introduces a major shift in protocol architecture. Instead of deploying a separate smart contract for each liquidity pool, Uniswap v4 uses a singleton PoolManager contract that manages all pools internally as structured state. Each pool in Uniswap v4 is uniquely identified by a `PoolId`, which is derived from the pool configuration (token pair, fee, tick spacing, and optional hooks), rather than a dedicated contract address. Using Bitquery’s Uniswap v4 APIs, you can track: diff --git a/docs/blockchain/Ethereum/dextrades/uniswap-v4-liquidity-api.md b/docs/blockchain/Ethereum/dextrades/uniswap-v4-liquidity-api.md index e4195297..054913be 100644 --- a/docs/blockchain/Ethereum/dextrades/uniswap-v4-liquidity-api.md +++ b/docs/blockchain/Ethereum/dextrades/uniswap-v4-liquidity-api.md @@ -1,7 +1,8 @@ --- sidebar_label: Uniswap v4 Pool Liquidity +title: "Uniswap v4 Liquidity on Ethereum" +description: "Uniswap v4 Liquidity on Ethereum: get Ethereum DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams." --- - # Uniswap v4 Liquidity on Ethereum Uniswap **v4** changes **where** liquidity lives and **how** you identify a “pool.” This page explains that mechanism, contrasts it with earlier versions, and shows how **Bitquery** lets you read **one concrete pool’s** liquidity for a token pair using **`PoolId`**—something that is awkward or misleading if you only filter by **token addresses** or a **single factory contract**. @@ -417,6 +418,6 @@ query MyQuery { ## Related documentation -- [Uniswap v4 DEX Trades API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/uniswap-v4-api/) — trades, `PoolId` filters, pair stats -- [Ethereum Liquidity API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api/) — more `DEXPoolEvents` patterns, including Uniswap v4 subscription examples -- [DEXPools cube](https://docs.bitquery.io/docs/cubes/evm-dexpool/) — field semantics and event types +- [Uniswap v4 DEX Trades API](/docs/blockchain/Ethereum/dextrades/uniswap-v4-api/) — trades, `PoolId` filters, pair stats +- [Ethereum Liquidity API](/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api/) — more `DEXPoolEvents` patterns, including Uniswap v4 subscription examples +- [DEXPools cube](/docs/cubes/evm-dexpool/) — field semantics and event types diff --git a/docs/blockchain/Ethereum/ethers-library/debug_traceCall.md b/docs/blockchain/Ethereum/ethers-library/debug_traceCall.md index c2a7a23e..620b6798 100644 --- a/docs/blockchain/Ethereum/ethers-library/debug_traceCall.md +++ b/docs/blockchain/Ethereum/ethers-library/debug_traceCall.md @@ -1,30 +1,11 @@ +--- +title: "Ethereum Debug Tracecall" +description: "Ethereum Debug Tracecall: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Copy GraphQL snippets for production apps." +--- # debug_traceCall In this section, we will discuss how we can use Bitquery APIs as an alternative to the debug_traceCall JSON RPC method, which runs an eth_call within the context of the given block execution using the final state of parent block as the base. - - - - - - - - - - - - - - - - - ## Trace Calls with Reciever Address Using [this](https://ide.bitquery.io/debug_traceCall) query, you can trace all the calls sent to the address, and get details like the following. - Chain ID @@ -150,4 +131,4 @@ query MyQuery { } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/Ethereum/ethers-library/debug_traceTransaction.md b/docs/blockchain/Ethereum/ethers-library/debug_traceTransaction.md index c03d073f..da896daf 100644 --- a/docs/blockchain/Ethereum/ethers-library/debug_traceTransaction.md +++ b/docs/blockchain/Ethereum/ethers-library/debug_traceTransaction.md @@ -1,30 +1,11 @@ +--- +title: "debug_traceTransaction" +description: "debug_traceTransaction: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Scale further with Kafka or gRPC streams." +--- # debug_traceTransaction debug_traceTransaction is a JSON RPC method that returns tracing results for the specified transaction. In this section, we are looking for a way to build an alternative for the same using Bitquery API. - - - - - - - - - - - - - - - - - # Debug Trace Transaction To trace a transaction using the debug_traceTransaction we need the `transaction hash`. We are using [this](https://ide.bitquery.io/debug_traceTransaction) API given below for tracing the transaction, with transaction hash as `0x4fe59dcf4f834f17acdcd0f244538c119523009ce47817ccd56423404ba34ffa`. @@ -97,4 +78,4 @@ The response from running the above API is given below, and returns. } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/Ethereum/ethers-library/eth-getbalance.md b/docs/blockchain/Ethereum/ethers-library/eth-getbalance.md index a2e7ff6b..58597c05 100644 --- a/docs/blockchain/Ethereum/ethers-library/eth-getbalance.md +++ b/docs/blockchain/Ethereum/ethers-library/eth-getbalance.md @@ -1,26 +1,12 @@ +--- +title: "Ethereum Eth Getbalance API" +description: "Ethereum Eth Getbalance API: fetch current and historical Ethereum balances with Bitquery GraphQL balance queries. Works with WebSocket live subscriptions." +--- # eth_getBalance Ethereum getBalance is an API endpoint that retrieves the balance for a particular address for any given currency on the Ethereum blockchain. In this section we will see how to create queries that serves as an alternative for the eth_getBalance JSON RPC method and how to customize it to get data we need. - - - - - - - - - - - - - - - - - - ## eth_getBalance for One Address ### Get balance for all currencies diff --git a/docs/blockchain/Ethereum/ethers-library/eth_blockNumber.md b/docs/blockchain/Ethereum/ethers-library/eth_blockNumber.md index 7004cf2b..e3225335 100644 --- a/docs/blockchain/Ethereum/ethers-library/eth_blockNumber.md +++ b/docs/blockchain/Ethereum/ethers-library/eth_blockNumber.md @@ -1,30 +1,11 @@ +--- +title: "Ethereum Eth Blocknumber" +description: "Ethereum Eth Blocknumber: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." +--- # eth_blockNumber In this section, we will discuus the eth_blockNumber API endpoint that returns the latest block number of the blockchain. - - - - - - - - - - - - - - - - - ## Latest Block Number [This](https://ide.bitquery.io/eth_blockNumber-stream) subscription returns the latest block number. @@ -56,4 +37,4 @@ subscription { } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/Ethereum/ethers-library/eth_gasPrice.md b/docs/blockchain/Ethereum/ethers-library/eth_gasPrice.md index ec711ec1..54f5ad36 100644 --- a/docs/blockchain/Ethereum/ethers-library/eth_gasPrice.md +++ b/docs/blockchain/Ethereum/ethers-library/eth_gasPrice.md @@ -1,30 +1,11 @@ +--- +title: "Ethereum Eth Gasprice" +description: "Ethereum Eth Gasprice: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." +--- # eth_gasPrice In this section, we will build a data stream that returns the gas fee of the latest transaction in WEI. Unlike any JSON RPC method like eht_gasPrice that returns the hexadecimal equivalent of an integer representing the current gas price in WEI, this returns the integer value itself. - - - - - - - - - - - - - - - - - [This](https://ide.bitquery.io/eth_gasPrice_1) is the stream that returns the current gas price in `WEI`. ``` graphql @@ -59,4 +40,4 @@ The above stream returns the following response. } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/Ethereum/ethers-library/eth_getBlockReceipts.md b/docs/blockchain/Ethereum/ethers-library/eth_getBlockReceipts.md index b9747579..4ae2e2f2 100644 --- a/docs/blockchain/Ethereum/ethers-library/eth_getBlockReceipts.md +++ b/docs/blockchain/Ethereum/ethers-library/eth_getBlockReceipts.md @@ -1,30 +1,11 @@ +--- +title: "eth_getBlockReceipts" +description: "eth_getBlockReceipts: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Includes filters and field selection tips." +--- # eth_getBlockReceipts In this section we will build an API that serves as an alternative to the eth_getBlockReceipts JSON RPC method that takes `Block Number` as an input and returns all transaction receipts for the given block. - - - - - - - - - - - - - - - - - ## Get Block Receipts [This](https://ide.bitquery.io/eth_getBlockReceipt) query serves as an alternative to the eth_getBlockReceipts method with `Block Number` as `20525804`. @@ -108,4 +89,4 @@ The above API returns the following output. } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/Ethereum/ethers-library/eth_getCode.md b/docs/blockchain/Ethereum/ethers-library/eth_getCode.md index c8cb2d37..1701a60f 100644 --- a/docs/blockchain/Ethereum/ethers-library/eth_getCode.md +++ b/docs/blockchain/Ethereum/ethers-library/eth_getCode.md @@ -1,30 +1,11 @@ +--- +title: "Ethereum Eth Getcode" +description: "Ethereum Eth Getcode: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Covers archive history and realtime data." +--- # eth_getCode In this section we will build a query that serves as an alternative to the eth_getCode JSON RPC method. However unlike the method that requires two arameters, namely `address` and `block number`, this API only needs an `address`. - - - - - - - - - - - - - - - - - The [below](https://ide.bitquery.io/eth_getCode) query serves as the alternative API to the method, with address as `0xc923D39fA2d97fb4B660Fc66DAdB1421605975E0`. ``` graphql @@ -48,4 +29,4 @@ The [below](https://ide.bitquery.io/eth_getCode) query serves as the alternative } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/Ethereum/ethers-library/eth_getLogs.md b/docs/blockchain/Ethereum/ethers-library/eth_getLogs.md index c5ec4903..08f8a0da 100644 --- a/docs/blockchain/Ethereum/ethers-library/eth_getLogs.md +++ b/docs/blockchain/Ethereum/ethers-library/eth_getLogs.md @@ -1,30 +1,11 @@ +--- +title: "Ethereum Eth Getlogs" +description: "Ethereum Eth Getlogs: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." +--- # eth_getLogs In this section, we will see how we can use Bitquery APIs as an alternative to the eth_getLogs JSON RPC method and return an array of `Logs` object matching the filter object(*optional). - - - - - - - - - - - - - - - - - The Logs object consist of the following data. - `removed`: (boolean) true when the log was removed, due to a chain reorganization. false if it's a valid log. @@ -190,4 +171,4 @@ Using [this](https://ide.bitquery.io/eth_getLogs-with-filters_4) query, you can } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/Ethereum/ethers-library/eth_getTransactionByHash.md b/docs/blockchain/Ethereum/ethers-library/eth_getTransactionByHash.md index 4cf96772..1f09d46b 100644 --- a/docs/blockchain/Ethereum/ethers-library/eth_getTransactionByHash.md +++ b/docs/blockchain/Ethereum/ethers-library/eth_getTransactionByHash.md @@ -1,30 +1,11 @@ +--- +title: "eth_getTransactionByHash" +description: "eth_getTransactionByHash: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Scale further with Kafka or gRPC streams." +--- # eth_getTransactionByHash In this section we will discuss how we can build eth_getTransactionByHash alternatives using Bitquery APIs. - - - - - - - - - - - - - - - - - ## Get Transaction Hash We will use [this](https://ide.bitquery.io/Get-Transaction-Hash) stream to get the latest transactions hash. We will use this transaction hash as an input for the eth_getTransactionByHash alternative API. @@ -126,4 +107,4 @@ After running the above query this is the expected result. ] } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/Ethereum/ethers-library/eth_getTransactionReceipt.md b/docs/blockchain/Ethereum/ethers-library/eth_getTransactionReceipt.md index 18b59e89..700a7553 100644 --- a/docs/blockchain/Ethereum/ethers-library/eth_getTransactionReceipt.md +++ b/docs/blockchain/Ethereum/ethers-library/eth_getTransactionReceipt.md @@ -1,30 +1,11 @@ +--- +title: "eth_getTransactionReceipt" +description: "eth_getTransactionReceipt: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." +--- # eth_getTransactionReceipt In this section, we will build an alternative to the eth_getTransactionReceipt JSON RPC method using the Bitquery APIs. The method is used to provide the receipt of a transaction given `transaction hash`. Note that the receipt is not available for pending transactions. - - - - - - - - - - - - - - - - - # Get Transaction Receipt We can get the receipt of a transaction using the transaction hash, `0x4fe59dcf4f834f17acdcd0f244538c119523009ce47817ccd56423404ba34ffa` for this example, using [this](https://ide.bitquery.io/eth_getTransactionReceipt_1) API given below. @@ -101,4 +82,4 @@ The response of the above API is given below. } ``` -Now, you may note that unlike the JSON RPC method, this API does'nt return any `log` object. However, if that is something you might need then checkout the following page for [eth_getLogs](https://docs.bitquery.io/docs/blockchain/Ethereum/ethers-library/eth_getLogs/). \ No newline at end of file +Now, you may note that unlike the JSON RPC method, this API does'nt return any `log` object. However, if that is something you might need then checkout the following page for [eth_getLogs](/docs/blockchain/Ethereum/ethers-library/eth_getLogs/). diff --git a/docs/blockchain/Ethereum/ethers-library/eth_subscribe.md b/docs/blockchain/Ethereum/ethers-library/eth_subscribe.md index 3a8b47c9..8caa3072 100644 --- a/docs/blockchain/Ethereum/ethers-library/eth_subscribe.md +++ b/docs/blockchain/Ethereum/ethers-library/eth_subscribe.md @@ -1,30 +1,11 @@ +--- +title: "Ethereum Eth Subscribe" +description: "Ethereum Eth Subscribe: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Run it in the IDE, then ship in your app." +--- # eth_subscribe Ethereum Subscription API allows developers to build websockets that receive real-time notifications about the Ethereum blockchain. In this section we will see how to create subscription for each eth_subscribe JSON RPC method and how to customize it to get data we need. - - - - - - - - - - - - - - - - - ## eth_subscribe(“pendingTransactions”) To subscribe to incoming pending transactions, use the below subscription. You can run it [here](https://ide.bitquery.io/eth_subscribependingTransactions) @@ -96,7 +77,6 @@ subscription { } } - ``` ## eth_subscribe("newBlockHeaders") diff --git a/docs/blockchain/Ethereum/events/events-api.md b/docs/blockchain/Ethereum/events/events-api.md index 37777f05..bded39ec 100644 --- a/docs/blockchain/Ethereum/events/events-api.md +++ b/docs/blockchain/Ethereum/events/events-api.md @@ -1,23 +1,23 @@ --- sidebar_position: 2 +title: "Ethereum Events API" +description: "Ethereum Events API: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." --- - # Events API -> **Before you start**: Not sure when to use Events vs Transfers vs Calls vs DexTrades? Read our [Mental Model guide](https://docs.bitquery.io/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. +> **Before you start**: Not sure when to use Events vs Transfers vs Calls vs DexTrades? Read our [Mental Model guide](/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. The Event API gives you access real-time blockchain event data. Events represent changes to the state of a blockchain, such as transactions, token transfers, or contract creations. -You can find the **Ethers Library equivalents** for these queries at **[Bitquery Ethers Library Section](https://docs.bitquery.io/docs/blockchain/Ethereum/ethers-library/debug_traceCall/)**. - +You can find the **Ethers Library equivalents** for these queries at **[Bitquery Ethers Library Section](/docs/blockchain/Ethereum/ethers-library/debug_traceCall/)**. -You can find the **NFT Events Examples** at **[Bitquery NFT API Section](https://docs.bitquery.io/docs/blockchain/Ethereum/nft/nft-blur-marketplace-api/)**. +You can find the **NFT Events Examples** at **[Bitquery NFT API Section](/docs/blockchain/Ethereum/nft/nft-blur-marketplace-api/)**. ## Is it possible to subscribe to smart contract events using Bitquery streams? {#is-it-possible-to-subscribe-to-smart-contract-events-using-bitquery-streams} -**Yes.** On **EVM** chains (Ethereum, BSC, Base, and other `EVM(network: …)` networks in the API), Bitquery exposes decoded **contract logs** under the **`Events`** field. Use a GraphQL **`subscription`** (not `query`) with the same `where` filters you would use for historical pulls—typically **`Log`** (signature name, smart contract address, topics) and **`Transaction`**—and deliver it over a **WebSocket** to [`wss://streaming.bitquery.io/graphql`](https://docs.bitquery.io/docs/subscriptions/websockets/) as in [WebSocket access](https://docs.bitquery.io/docs/subscriptions/websockets/) and [subscription basics](https://docs.bitquery.io/docs/subscriptions/subscription/). Filter reference: [GraphQL filters](https://docs.bitquery.io/docs/graphql/filters/). For **high-throughput or replay**, event-style data is also available via **Kafka** topics; see [streaming overview](https://docs.bitquery.io/docs/streams/). +**Yes.** On **EVM** chains (Ethereum, BSC, Base, and other `EVM(network: …)` networks in the API), Bitquery exposes decoded **contract logs** under the **`Events`** field. Use a GraphQL **`subscription`** (not `query`) with the same `where` filters you would use for historical pulls—typically **`Log`** (signature name, smart contract address, topics) and **`Transaction`**—and deliver it over a **WebSocket** to [`wss://streaming.bitquery.io/graphql`](/docs/subscriptions/websockets/) as in [WebSocket access](/docs/subscriptions/websockets/) and [subscription basics](/docs/subscriptions/subscription/). Filter reference: [GraphQL filters](/docs/graphql/filters/). For **high-throughput or replay**, event-style data is also available via **Kafka** topics; see [streaming overview](/docs/streams/). -**Solana** does not use this EVM `Events` shape; for live program activity use **`Solana`** subscriptions (e.g. instructions) as in [Solana instructions](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions/). +**Solana** does not use this EVM `Events` shape; for live program activity use **`Solana`** subscriptions (e.g. instructions) as in [Solana instructions](/docs/blockchain/Solana/solana-instructions/). Example: stream logs from a specific contract (here USDT on Ethereum) as they are indexed: @@ -282,7 +282,6 @@ query MyQuery { } } - ``` ## Subscribe to the Same Event Across Multiple Contracts @@ -317,7 +316,6 @@ subscription { } } - ``` ## Latest Liquidity Removal on Uniswap diff --git a/docs/blockchain/Ethereum/fees/fees-api.mdx b/docs/blockchain/Ethereum/fees/fees-api.mdx index 72947aff..20a8fa4f 100644 --- a/docs/blockchain/Ethereum/fees/fees-api.mdx +++ b/docs/blockchain/Ethereum/fees/fees-api.mdx @@ -1,26 +1,7 @@ --- -title: EVM Fees API +title: "Ethereum Fees API" +description: "Ethereum Fees API: analyze Ethereum transaction fees and costs with Bitquery GraphQL queries and streams. See examples in the Bitquery IDE." --- - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../../src/components/videoplayer.js"; ## Get Trades with Transaction fees diff --git a/docs/blockchain/Ethereum/index.md b/docs/blockchain/Ethereum/index.md index f05d9be3..f31f68da 100644 --- a/docs/blockchain/Ethereum/index.md +++ b/docs/blockchain/Ethereum/index.md @@ -1,6 +1,6 @@ --- title: Ethereum API - Best Blockchain Data API for Developers -description: Access comprehensive Ethereum API with real-time blockchain data, transactions, DEX trades, liquidity pools, slippage data, token balances, and more. Free tier available. GraphQL API with subscriptions and Kafka streaming. +description: "Ethereum API - Best Blockchain Data API for Developers: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers." slug: /blockchain/Ethereum/ keywords: - Ethereum API @@ -21,17 +21,15 @@ keywords: - free ethereum rpc - ethereum data api --- - import VideoPlayer from "../../../src/components/videoplayer.js"; import FAQ from "@site/src/components/FAQ"; # Ethereum API - Complete Developer Guide :::tip Building a trading app or DEX UI on Ethereum? -For **real-time trades and prices on Ethereum** (and the last ~30 days), use the curated [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. For **historical Ethereum data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. +For **real-time trades and prices on Ethereum** (and the last ~30 days), use the curated [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. For **historical Ethereum data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. ::: - ## What is Bitquery? Bitquery is the leading blockchain data platform that provides comprehensive **Ethereum API** solutions for developers. Instead of running your own Ethereum node or building complex indexing infrastructure, you can use our pre-built **Ethereum API** to get the blockchain data you need in seconds. @@ -43,9 +41,9 @@ Our **Ethereum API** provides comprehensive access to all Ethereum blockchain da New to Bitquery? Here's how to get started: 1. **[Create a free account](https://ide.bitquery.io/)** - Get instant access to our GraphQL IDE -2. **[Generate your API key](https://docs.bitquery.io/docs/authorisation/how-to-generate/)** - Required for API access -3. **[Run your first query](https://docs.bitquery.io/docs/start/first-query/)** - Learn the basics in 5 minutes -4. **[Explore examples](https://docs.bitquery.io/docs/start/starter-queries/)** - Copy-paste ready queries +2. **[Generate your API key](/docs/authorization/how-to-generate/)** - Required for API access +3. **[Run your first query](/docs/start/first-query/)** - Learn the basics in 5 minutes +4. **[Explore examples](/docs/start/starter-queries/)** - Copy-paste ready queries **Free Trial**: 100,000 API points for 1 month. No credit card required. @@ -63,7 +61,6 @@ Unlike traditional Ethereum JSON-RPC providers, our **Ethereum API** stores, ind - **High Performance**: Sub-second response times for complex queries - **Cost-Effective**: Free tier with 1,000 API calls per day - ## How is it different from raw Ethereum RPC or Ethereum node API? **Ethereum RPC** @@ -96,85 +93,83 @@ Get live Ethereum data through our streaming solutions: - **GraphQL Subscriptions**: Convert any query to a live stream by changing `query` to `subscription` - **Kafka Streaming**: High-throughput streaming for enterprise applications -See examples and code snippets [here](https://docs.bitquery.io/docs/subscriptions/websockets/) for GraphQL subscription implementation, and learn about [Kafka streaming](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) for high-volume use cases. +See examples and code snippets [here](/docs/subscriptions/websockets/) for GraphQL subscription implementation, and learn about [Kafka streaming](/docs/streams/kafka-streaming-concepts/) for high-volume use cases. ## Ethereum DEX Trades APIs -- [Ethereum DEX API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/dex-api) -- [Ethereum Token Trades APIs](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/token-trades-apis) -- [Trades of an Ethereum Address API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/trades-of-an-address-api) -- [Uniswap API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/uniswap-api) -- [Pancakeswap API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/pancakeswap-api) -- [DEXScreener (EVM)](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/DEXScreener/evm_dexscreener) +- [Ethereum DEX API](/docs/blockchain/Ethereum/dextrades/dex-api) +- [Ethereum Token Trades APIs](/docs/blockchain/Ethereum/dextrades/token-trades-apis) +- [Trades of an Ethereum Address API](/docs/blockchain/Ethereum/dextrades/trades-of-an-address-api) +- [Uniswap API](/docs/blockchain/Ethereum/dextrades/uniswap-api) +- [Pancakeswap API](/docs/blockchain/Ethereum/dextrades/pancakeswap-api) +- [DEXScreener (EVM)](/docs/blockchain/Ethereum/dextrades/DEXScreener/evm_dexscreener) Query and subscribe to on‑chain swaps, OHLCV, liquidity events, pools, and per‑wallet trading activity across major EVM DEXes. ## Ethereum Slippage API -- [Ethereum Slippage API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/ethereum-slippage-api) +- [Ethereum Slippage API](/docs/blockchain/Ethereum/dextrades/ethereum-slippage-api) Get slippage and price impact data for Ethereum DEX pools. Understand price impact and liquidity depth for token swaps, calculate maximum input amounts at different slippage tolerances, and monitor real-time slippage data across all DEX pools on Ethereum. ## Ethereum Liquidity API -- [Ethereum Liquidity API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api) +- [Ethereum Liquidity API](/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api) Monitor real-time liquidity changes, track pool reserves, and analyze liquidity depth for token pairs on Ethereum DEX pools. Track when liquidity is added or removed, monitor pool health and depth, and analyze liquidity patterns across different pools. ## Ethereum Token Holders API -- [Token Holder API](https://docs.bitquery.io/docs/blockchain/Ethereum/token-holders/token-holder-api) +- [Token Holder API](/docs/blockchain/Ethereum/token-holders/token-holder-api) Track and analyze token holder distributions with comprehensive historical and real-time data. Get top holders by balance, monitor holder count changes, calculate distribution metrics like Gini coefficient and Nakamoto coefficient for decentralization analysis, identify new and active holders, and track first/last activity dates for any ERC-20 token on Ethereum. - ## Ethereum Balance API -- [Balance API](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/balance-api) +- [Balance API](/docs/blockchain/Ethereum/balances/balance-api) Get real‑time and historical token and native ETH balances for any Ethereum address. Track balance changes over time, calculate portfolio values in USD, and monitor wallet holdings across ERC20, ERC721, and ERC1155 tokens. Perfect for building portfolio trackers, tax tools, and wallet analytics. ## Ethereum Token Transfers API -- [ERC20 Token Transfer API](https://docs.bitquery.io/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api) -- [Ethereum Token Total Supply API](https://docs.bitquery.io/docs/blockchain/Ethereum/transfers/total-supply) +- [ERC20 Token Transfer API](/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api) +- [Ethereum Token Total Supply API](/docs/blockchain/Ethereum/transfers/total-supply) Track comprehensive token transfer activity across Ethereum with support for all major ERC standards including ERC20, ERC721, ERC1155, and more. Monitor transfers for any Ethereum address or smart contract, analyze inflow and outflow patterns, and discover specific transfers across the entire blockchain for any token. Get enriched data with corresponding USD values, transfer volumes, and detailed transaction context to power portfolio tracking, Tax tools, compliance monitoring, and token analytics applications. ## Ethereum Blocks API -- [Ethereum Blocks API](https://docs.bitquery.io/docs/blockchain/Ethereum/blocks/blocks-api) +- [Ethereum Blocks API](/docs/blockchain/Ethereum/blocks/blocks-api) Access comprehensive Ethereum block data including block headers, timestamps, gas usage, miner/validator information, base fees, and transaction counts. Build time‑series analytics, monitor network health, track block production patterns, analyze fee dynamics, and compute blockchain metrics. Perfect for building block explorers, network monitoring tools, and blockchain analytics dashboards. ## Ethereum Smart Contract Events API -- [Ethereum Smart Contract Events API](https://docs.bitquery.io/docs/blockchain/Ethereum/events/events-api) +- [Ethereum Smart Contract Events API](/docs/blockchain/Ethereum/events/events-api) Access and analyze smart contract events across Ethereum with comprehensive filtering and decoding capabilities. Query contract logs by specific topics, parameters, addresses, and event signatures to track contract interactions, state changes, and protocol activity. Get decoded event data with parameter names and values, filter by block ranges or time periods, and monitor real-time contract events. Essential for building DeFi analytics, protocol monitoring tools, governance trackers, and smart contract auditing systems. ## Ethereum Transaction Fees API -- [Ethereum Transaction Fees API](https://docs.bitquery.io/docs/blockchain/Ethereum/fees/fees-api) +- [Ethereum Transaction Fees API](/docs/blockchain/Ethereum/fees/fees-api) Analyze comprehensive transaction fee data across Ethereum including gas usage patterns, base fee dynamics, priority fees, and transaction cost distributions. Track gas consumption by transaction type, monitor EIP-1559 fee market mechanics, calculate average gas prices over time, and analyze fee optimization strategies. Get detailed gas usage statistics, fee predictions, and cost analysis to power gas estimation tools, transaction optimization services, and fee market analytics dashboards. ## Ethereum Mempool API -- [Ethereum Mempool API](https://docs.bitquery.io/docs/blockchain/Ethereum/mempool/mempool-api) +- [Ethereum Mempool API](/docs/blockchain/Ethereum/mempool/mempool-api) Monitor and analyze Ethereum's mempool to track pending transactions before they are included in blocks. Get real-time insights into transaction queues, fee estimations, and network congestion patterns. Track pending transactions by address, value, gas price, and transaction type to build MEV strategies, optimize transaction timing, and provide better fee estimation services. Additionally, simulate mempool transactions to preview potential transfers, trades, and contract interactions before execution, enabling advanced analysis of transaction outcomes and state changes. Essential for building frontrunning protection, transaction monitoring tools, MEV detection systems, and advanced DeFi applications that need to react to pending on-chain activity. - ## Ethereum NFT API -- [Ethereum NFT API](https://docs.bitquery.io/docs/blockchain/Ethereum/nft/nft-api) +- [Ethereum NFT API](/docs/blockchain/Ethereum/nft/nft-api) Access comprehensive NFT data across Ethereum including collections, ownership tracking, transfer history, marketplace trades, and metadata. Query NFT collections by contract address, track ownership changes and holder distributions, monitor NFT transfers and sales across major marketplaces like OpenSea and LooksRare, and retrieve detailed token metadata including images, attributes, and rarity information. Get enriched trading data with USD values, floor prices, and volume metrics to power NFT analytics dashboards, portfolio trackers, rarity tools, and marketplace monitoring applications. ## Ethereum Transactions API -- [Ethereum Transaction API](https://docs.bitquery.io/docs/blockchain/Ethereum/transactions/transaction-api) +- [Ethereum Transaction API](/docs/blockchain/Ethereum/transactions/transaction-api) Query detailed Ethereum transaction data including transaction hashes, from/to addresses, values transferred, gas prices, gas limits, gas used, nonce values, and transaction status. Access transaction input data, method signatures, internal transactions, and execution traces. Filter transactions by sender, receiver, value ranges, time periods, or transaction type to analyze payment flows, contract calls, and wallet behavior. Retrieve comprehensive transaction receipts with logs, events, and error details for both successful and failed transactions. Essential for transaction monitoring, forensic analysis, compliance reporting, and building comprehensive blockchain data applications. diff --git a/docs/blockchain/Ethereum/mempool/mempool-api.md b/docs/blockchain/Ethereum/mempool/mempool-api.md index 5c053b28..17a494e8 100644 --- a/docs/blockchain/Ethereum/mempool/mempool-api.md +++ b/docs/blockchain/Ethereum/mempool/mempool-api.md @@ -1,14 +1,15 @@ --- sidebar_position: 2 +title: "Ethereum Mempool API" +description: "Watch Ethereum pending transactions before confirmation with Bitquery mempool GraphQL subscriptions, filters, and stream examples." --- - # Mempool API -In this section we will look at some examples of how to write mempool queries to extract the necessary data from broadcasted transactions. To read more about how we offer mempool data, read the introduction [here](/docs/subscriptions/mempool-subscriptions.md) +In this section we will look at some examples of how to write mempool queries to extract the necessary data from broadcasted transactions. To read more about how we offer mempool data, read the introduction [here](/docs/subscriptions/mempool-subscriptions/) ## How do I get unconfirmed/pending transactions for an address? -Subscribe to **`EVM(mempool: true)`** **`Transactions`** with **`where.any`** on **`Transaction.From`** and **`Transaction.To`** so you see pending txs **to or from** the wallet. Mempool support varies by **`network`**; the example under [Transactions from an Address](#transactions-from-an-address) shows a **from** filter you can extend with `any`. For **BSC**-specific streaming, see [BSC mempool stream](https://docs.bitquery.io/docs/blockchain/BSC/bsc-mempool-stream/). +Subscribe to **`EVM(mempool: true)`** **`Transactions`** with **`where.any`** on **`Transaction.From`** and **`Transaction.To`** so you see pending txs **to or from** the wallet. Mempool support varies by **`network`**; the example under [Transactions from an Address](#transactions-from-an-address) shows a **from** filter you can extend with `any`. For **BSC**-specific streaming, see [BSC mempool stream](/docs/blockchain/BSC/bsc-mempool-stream/). ## Simulating Pending Transactions @@ -50,7 +51,6 @@ subscription{ } } - ``` ## Get Recommended Fees @@ -87,7 +87,6 @@ You can run the query [here](https://ide.bitquery.io/Get-Mempool-Fees) } } - ``` ## PairCreated Events @@ -234,7 +233,6 @@ subscription { } } - ``` ## Balance Updates in Mempool in Real-time @@ -263,7 +261,6 @@ subscription { } } - ``` ## V, R, S Signature of Mempool Transactions diff --git a/docs/blockchain/Ethereum/nft/nft-api.md b/docs/blockchain/Ethereum/nft/nft-api.md index 6d58f5a3..9814c404 100644 --- a/docs/blockchain/Ethereum/nft/nft-api.md +++ b/docs/blockchain/Ethereum/nft/nft-api.md @@ -1,5 +1,7 @@ --- sidebar_position: 1 +title: "Ethereum NFT API" +description: "Query Ethereum NFT trades, ownership, metadata, and transfers with Bitquery GraphQL APIs, filters, and live streams. See examples in the Bitquery IDE." --- import FAQ from "@site/src/components/FAQ"; diff --git a/docs/blockchain/Ethereum/nft/nft-blur-marketplace-api.md b/docs/blockchain/Ethereum/nft/nft-blur-marketplace-api.md index 25b8262d..ab226a7a 100644 --- a/docs/blockchain/Ethereum/nft/nft-blur-marketplace-api.md +++ b/docs/blockchain/Ethereum/nft/nft-blur-marketplace-api.md @@ -1,12 +1,12 @@ --- sidebar_position: 8 +title: "NFT Blur MarketPlace API" +description: "NFT Blur MarketPlace API: track Ethereum NFT trades, ownership, and metadata with Bitquery GraphQL and streams. Covers archive history and realtime data." --- - # NFT Blur MarketPlace API The NFT Blur Marketplace API provides a wide range of data related to the BLUR NFT Marketplace. With this API, We can access data on the latest traded NFTs, buy-sell activity of specific NFT tokens, top buyers of NFTs, specific buyer statistics for NFTs, NFT loan transactions, loan history, refinancing actions and much more. - ## Latest Trades on Blur The Blur Marketplace supports the [Seaport protocol](https://opensea.io/blog/articles/introducing-seaport-protocol), which can be utilize to retrieve the most recent Blur trades - [query](https://ide.bitquery.io/Latest-10-Trades-on-Blur). @@ -122,12 +122,10 @@ query MyQuery { - `nfts` : Shows the count of distinct NFTs involved in the trades. - `Trade` : Includes information about the trade, specifically the currency details from the buy side of the trade. - ## Total Buy-Sell of an NFT Token on Blur Here, the [query](https://ide.bitquery.io/Total-buy-sell-of-an-NFT-token-onBLUR) gather total trades, trade volume, unique buyers, and sellers for a specific NFT token on Blur Marketplace - in this case, the [Nakamigos NFT token](https://explorer.bitquery.io/ethereum/token/0xd774557b647330c91bf44cfeab205095f7e6c367). - ``` query MyQuery { EVM(dataset: combined, network: eth) { @@ -216,7 +214,6 @@ query MyQuery { - `difffernt_nfts` : Displays a count of different NFTs bought by each buyer. - `total_money_paid` : The total amount of money paid by each buyer for their purchases. - ## Specific Buyer stats for an NFT on Blur In [this](https://ide.bitquery.io/Specific-buyer-stats-for-an-NFT-onBLUR) query, we are getting details for a specific address on Blur NFT marketplace. We are also getting the first and last trade dates for the address. @@ -284,7 +281,6 @@ Blur uses [Blend protocol](https://www.paradigm.xyz/2023/05/blend) for NFT loans We're using LogHeader instead of Log → SmartContract for queries due to a [delegated proxy contract](https://medium.com/coinmonks/proxy-pattern-and-upgradeable-smart-contracts-45d68d6f15da). - ``` { EVM(dataset: combined, network: eth) { @@ -429,7 +425,6 @@ We're using LogHeader instead of Log → SmartContract for queries due to a [del Same as previous queries, this query will return details about the block, transaction, log, and arguments. By modifying the 'Arguments.includes' filter, you can track loan activities for different NFT collections on the Blur marketplace. - ## Latest Loans for a specific lender Using argument filtering, [this](https://ide.bitquery.io/Latest-Loans-for-a-specificlender) query fetches the latest loans for a specific lender address. The same method can be applied to find loans for a specific borrower address - [query](https://ide.bitquery.io/Latest-Loans-for-a-specificborrower-on-Blur-marketplace). @@ -719,7 +714,6 @@ The Blur's Blend protocol utilizes LienID as a primary key to track individual l The response will include details about the block, transaction, log, and event arguments. By adjusting the LienID in Arguments.includes, you can fetch loan details for various LienIDs on the Blur marketplace. - ## Latest Loan Refinances on Blur Refinancing in NFTs refers to securing a new loan using an NFT as collateral to repay an existing loan. The following [query](https://ide.bitquery.io/loan-refinance-on-Blur) retrieves the latest refinance events on BLUR. @@ -784,7 +778,6 @@ Refinancing in NFTs refers to securing a new loan using an NFT as collateral to `where` : 'LogHeader.Address' sets the address to the Blur: Blend Contract. 'Log.Signature.Name' filters for the event name "Refinance". - ## All Refinance loans for specific NFT To retrieve all refinance loans for a specific NFT collection, we filter Refinance event arguments in [this](https://ide.bitquery.io/All-refinance-loans-for-specificNFT-collection) query @@ -993,12 +986,10 @@ The 'StartAuction' event is triggered when an NFT auction starts on the Blur : `where` : 'LogHeader.Address' sets the address to the Blur: Blend Contract. 'Log.Signature.Name' filters for the event name "StartAuction". - # Latest Locked NFTs Buy Trades Locked NFTs are temporarily non-transferrable and can be traded or transferred after the lock period. These NFTs are often cheaper than non-locked. The following [query](https://ide.bitquery.io/Locked-NFT-bought-on-Blur-marketplace) retrieves the latest trades of locked NFTs by filtering for the 'BuyLocked' event under the Blur : [Blend Contract](https://explorer.bitquery.io/ethereum/smart_contract/0x29469395eaf6f95920e59f858042f0e28d98a20b/events). - ``` { EVM(dataset: combined, network: eth) { @@ -1188,8 +1179,7 @@ When a seizure event happens, control of the NFT shifts to the lender or an enfo - `where`: 'LogHeader' filters the results where the Address matches the Blur: Blend contract address. 'Log' Further filters the results where the Name of Signature matches the "Seize" event. - **Returned Data** - `Log` : Information about the event log, including the smart contract that emitted the event and the event's name and signature. -- `Arguments` : Details of the arguments passed in the event, including their names, indexes, types, and values. \ No newline at end of file +- `Arguments` : Details of the arguments passed in the event, including their names, indexes, types, and values. diff --git a/docs/blockchain/Ethereum/nft/nft-calls-apI.md b/docs/blockchain/Ethereum/nft/nft-calls-api.md similarity index 90% rename from docs/blockchain/Ethereum/nft/nft-calls-apI.md rename to docs/blockchain/Ethereum/nft/nft-calls-api.md index 8e9ce9f7..b6621fab 100644 --- a/docs/blockchain/Ethereum/nft/nft-calls-apI.md +++ b/docs/blockchain/Ethereum/nft/nft-calls-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 4 +title: "Ethereum NFT Calls API" +description: "Ethereum NFT Calls API: track Ethereum NFT trades, ownership, and metadata with Bitquery GraphQL and streams. Keep queries fast with indexed filters." --- - # NFT Calls API This API helps retrieve information about smart contract transactions, including details about the contract function that was called, the input and output parameters, and more. @@ -71,4 +72,4 @@ Here's an example query that retrieve the most recent smart contract calls made * `Value` : The amount of Ether transferred in the call. - `Arguments { Name Value {....} }` : Retrieves Array of arguments passed in the smart contract call, including their names and values, refer to [arguments](/docs/schema/evm/arguments) for data structure. -You can find the graphql query [here](https://ide.bitquery.io/Smart-contract-calls-to-an-nft-contract). \ No newline at end of file +You can find the graphql query [here](https://ide.bitquery.io/Smart-contract-calls-to-an-nft-contract). diff --git a/docs/blockchain/Ethereum/nft/nft-collection-api.md b/docs/blockchain/Ethereum/nft/nft-collection-api.md index b99bd3ba..c72a3d75 100644 --- a/docs/blockchain/Ethereum/nft/nft-collection-api.md +++ b/docs/blockchain/Ethereum/nft/nft-collection-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 7 +title: "Ethereum NFT Collection API" +description: "Ethereum NFT Collection API: track Ethereum NFT trades, ownership, and metadata with Bitquery GraphQL and streams. Works with WebSocket live subscriptions." --- - # NFT Collection API ## Get All NFTs in a Collection @@ -33,7 +34,6 @@ Here is a query that retrieves all the NFTs in a Collection. ``` You can find the graphql query [here](https://ide.bitquery.io/Get-all-NFTs-for-a-collection). - ## Get All Token Holders of a Collection This query retrieves the token holders of a collection. We use the BalanceUpdates method to query all the addresses that had added the NFT whose SmartContract is mentioned in the query. To get more wallets, increase the count. diff --git a/docs/blockchain/Ethereum/nft/nft-metadata-api.md b/docs/blockchain/Ethereum/nft/nft-metadata-api.md index a16cf294..dd4dbcb4 100644 --- a/docs/blockchain/Ethereum/nft/nft-metadata-api.md +++ b/docs/blockchain/Ethereum/nft/nft-metadata-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 6 +title: "Ethereum NFT Metadata API" +description: "Ethereum NFT Metadata API: track Ethereum NFT trades, ownership, and metadata with Bitquery GraphQL and streams. Built for traders and analytics teams." --- - # NFT Metadata API The NFT Metadata API retrieves the metadata of NFT. @@ -45,7 +46,6 @@ Let see an example query that retrieves the metadata of an NFT based on its toke - `orderBy` : Orders the results in descending order based on the Block_Number. - `where` : This parameter specifies the conditions to filter the results by. In this case, the token ID is `4226` and the Currency with the Smart Contract being `0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D`. - **Returned Data** - `Currency {....}` : Represent currency details. @@ -54,7 +54,6 @@ Let see an example query that retrieves the metadata of an NFT based on its toke You can find the graphql query [here](https://ide.bitquery.io/NFT-metadata_1_1). - ## Get the Creator of an NFT The Following query retrieves the Creator of the NFT. @@ -86,7 +85,6 @@ The Following query retrieves the Creator of the NFT. - `limit` : Specifies the maximum results to return. In this query, the limit is 1. - `where` : It filters the results to include only calls made to the smart contract with the specified address `0x23581767a106ae21c074b2276d25e5c3e136a68b` and only includes create call. - **Returned Data** - `Call`: The `creator: From` field represent the address of the creator. diff --git a/docs/blockchain/Ethereum/nft/nft-ownership-api.md b/docs/blockchain/Ethereum/nft/nft-ownership-api.md index b5727b02..1eace476 100644 --- a/docs/blockchain/Ethereum/nft/nft-ownership-api.md +++ b/docs/blockchain/Ethereum/nft/nft-ownership-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 2 +title: "Ethereum NFT Ownership API" +description: "Ethereum NFT Ownership API: track Ethereum NFT trades, ownership, and metadata with Bitquery GraphQL and streams. Built for traders and analytics teams." --- - # NFT Ownership API The NFT Ownership API can be used to retrieve information about the ownership of a specific NFT ( Non-Fungible Token ) on the supported blockchain. For instance using this we can access the owners of an NFT including their addresses and associated metadata and also we can retrieve a list of the top holders of a particular NFT. @@ -142,15 +143,12 @@ query MyQuery { } } - ``` - ## Past (churned) holders of tokens Check past (churned) token holders of a NFT token [using following query](https://ide.bitquery.io/past-token-holder-of-a-token_1). - ``` { EVM(dataset: combined) { @@ -175,4 +173,4 @@ Check past (churned) token holders of a NFT token [using following query](https: } } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/Ethereum/nft/nft-trades-apI.md b/docs/blockchain/Ethereum/nft/nft-trades-api.md similarity index 98% rename from docs/blockchain/Ethereum/nft/nft-trades-apI.md rename to docs/blockchain/Ethereum/nft/nft-trades-api.md index 5333bbdb..add0f96a 100644 --- a/docs/blockchain/Ethereum/nft/nft-trades-apI.md +++ b/docs/blockchain/Ethereum/nft/nft-trades-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 5 +title: "Ethereum NFT Trades API" +description: "Ethereum NFT Trades API: track Ethereum NFT trades, ownership, and metadata with Bitquery GraphQL and streams. See examples in the Bitquery IDE." --- - # NFT Trades API The NFT Trades API provides access to diverse NFT DEX trades data on supported blockchain. @@ -69,17 +70,14 @@ Let's dive into an example query that fetches the most recent NFT trades associa - `orderBy` : Orders the results in descending order based on the Block_Time. - `where` : It filters results based on specified conditions. Here, it selects transfers where the currency is non-fungible and buyer's address is `0x6afdf83501af209d2455e49ed9179c209852a701`. - **Returned Data** - `Trade`: It displays the details of the trade, `DEX {}` provides DEX information (protocol name, owner address, delegated status, delegated to address, and smart contract address), `Buy{}` and `sell{}` represents the buy side details ( price, seller, buyer, currency information, NFT IDs, order ID, and URIs ), and the sell side details ( price, amount, currency information, buyer, and seller ) respectively. - `Transaction` : Represents the hash of the transaction associated with the trade. - `Block` - Represents the block time of the trade. - You can find the graphql query [here](https://ide.bitquery.io/NFT-trades-of-an-address). - ## Get Top Traded NFT Tokens This query retrieves the Top Traded NFT Tokens of the month. @@ -184,7 +182,6 @@ query MyQuery { You can find the graphql query [here](https://ide.bitquery.io/Latests-OpenSea-Trades). - ## Top Traded NFTs on Opensea This query retrieves the Top Traded NFTs on Opensea based on trade count and can also aggregate trading vol, trade count, buyer, seller, and nfts. @@ -228,7 +225,6 @@ query MyQuery { You can find the graphql query [here](https://ide.bitquery.io/Top-Traded-NFTs-on-Opensea). - ## Total Buy & Sell of an NFT on Opensea To Retrieve Total Buy & sell of specific NFT on Opensea, we just need to specify the currency contract address in the Buy filter. @@ -264,7 +260,6 @@ To Retrieve Total Buy & sell of specific NFT on Opensea, we just need to specify You can find the graphql query [here](https://ide.bitquery.io/Total-buy-sell-of-an-NFT-on-opensea). - ## Latest NFT buyer on Opensea This query retrieves the Latest NFT buyer on Opensea. @@ -298,7 +293,6 @@ This query retrieves the Latest NFT buyer on Opensea. You can find the graphql query [here](https://ide.bitquery.io/Total-buy-sell-of-an-NFT-on-opensea). - ## Specific Buyer stats of an NFT on Opensea This query retrieves the Specific Buyer stats of an NFT on Opensea. diff --git a/docs/blockchain/Ethereum/nft/nft-transfer-api.md b/docs/blockchain/Ethereum/nft/nft-transfer-api.md index a8b55eba..bdc77c70 100644 --- a/docs/blockchain/Ethereum/nft/nft-transfer-api.md +++ b/docs/blockchain/Ethereum/nft/nft-transfer-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 3 +title: "Ethereum NFT Transfer API" +description: "Ethereum NFT Transfer API: monitor Ethereum native and token transfers in real time with Bitquery GraphQL APIs. Copy GraphQL snippets for production apps." --- - # NFT Transfer API The NFT Transfer API provides access to diverse NFT transfer data on supported blockchains and have various use cases. For instance we can retrieve daily transfers, monitor top NFT transfers, track the latest transfers of specific NFTs, and subscribe to real-time transfers for instant updates etc. @@ -181,4 +182,4 @@ subscription { } ``` -You can find the graphql query [here](https://ide.bitquery.io/Subscription-WebSocket---Latest-NFT-Transfers). \ No newline at end of file +You can find the graphql query [here](https://ide.bitquery.io/Subscription-WebSocket---Latest-NFT-Transfers). diff --git a/docs/blockchain/Ethereum/pepe-api.md b/docs/blockchain/Ethereum/pepe-api.md index 864d403f..7d14adaf 100644 --- a/docs/blockchain/Ethereum/pepe-api.md +++ b/docs/blockchain/Ethereum/pepe-api.md @@ -1,9 +1,8 @@ --- -title: "PEPE Coin API" -description: "Get real-time and historical on-chain data for PEPE coin on Ethereum — OHLCV price feeds, whale transfers, DEX volume, top buyers and sellers, and holder rankings using Bitquery's GraphQL API." +title: "Ethereum Pepe API" +description: "Ethereum Pepe API: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Run it in the IDE, then ship in your app." keywords: ["PEPE API", "PEPE coin API", "PEPE on-chain data", "PEPE price API", "PEPE OHLCV", "PEPE whale tracker", "PEPE DEX trades", "PEPE holder API", "Ethereum memecoin API", "PEPE GraphQL", "PEPE market cap API", "PEPE trading API"] --- - # PEPE Coin API Query real-time and historical on-chain data for [PEPE](https://explorer.bitquery.io/ethereum/token/0x6982508145454ce325ddbe47a25d4ec3d2311933), a popular ERC-20 memecoin on Ethereum. All examples below target PEPE's contract address: `0x6982508145454ce325ddbe47a25d4ec3d2311933`. @@ -799,4 +798,4 @@ Track unique buyers and sellers per day — a measure of market breadth and comm } ``` ---- --> \ No newline at end of file +--- --> diff --git a/docs/blockchain/Ethereum/token-holders/token-holder-api.mdx b/docs/blockchain/Ethereum/token-holders/token-holder-api.mdx index e87fa71a..69f87940 100644 --- a/docs/blockchain/Ethereum/token-holders/token-holder-api.mdx +++ b/docs/blockchain/Ethereum/token-holders/token-holder-api.mdx @@ -1,12 +1,14 @@ --- sidebar_position: 1 +title: "Ethereum Token Holder API" +description: "Ethereum Token Holder API: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. Scale further with Kafka or gRPC streams." --- import FAQ from "@site/src/components/FAQ"; # Token Holders API :::caution Deprecated API -`EVM.TokenHolders` is deprecated as of **20 May 2026** and will be removed on **15 June 2026**. Use **`EVM.Holders`** (this page) instead. +`EVM.TokenHolders` was deprecated as of **20 May 2026** and removed on **15 June 2026**. Use **`EVM.Holders`** (this page) instead. ::: The **Holders** API returns token holder data for ERC-20 tokens on Ethereum: top holders, holder counts, and balance thresholds. Non-zero balances use `Amount(selectWhere: { gt: "0" })` on the `Balance` field (not in `where`). Use `dataset: combined` or `dataset: archive` as follows: @@ -160,11 +162,11 @@ query { ## Track Whale Wallets and Token Holdings -For whale monitoring, combine **[Top Holders](#top-holders-of-a-currency-current)** (`orderBy: { descending: Balance_Amount }`, `limit`) with **[Holder Count Above a Threshold](#holder-count-with-balance-above-a-threshold)**. Pair with [ERC-20 transfers](https://docs.bitquery.io/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api) to see recent inflows and outflows from large wallets. +For whale monitoring, combine **[Top Holders](#top-holders-of-a-currency-current)** (`orderBy: { descending: Balance_Amount }`, `limit`) with **[Holder Count Above a Threshold](#holder-count-with-balance-above-a-threshold)**. Pair with [ERC-20 transfers](/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api) to see recent inflows and outflows from large wallets. ## Historical Top Holders by Date -The **Holders** cube does not support `Block.Date`. Filter by `Balance.LastChangeTime` using datetime format (for example `"2026-05-01T00:00:00Z"`). For address balances on a calendar date, use the [Balances API](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/balance-api/#balance-on-a-specific-date) with `Block.Date`. +The **Holders** cube does not support `Block.Date`. Filter by `Balance.LastChangeTime` using datetime format (for example `"2026-05-01T00:00:00Z"`). For address balances on a calendar date, use the [Balances API](/docs/blockchain/Ethereum/balances/balance-api/#balance-on-a-specific-date) with `Block.Date`. [Run in IDE](https://ide.bitquery.io/ethereum-holders-top-by-date) @@ -469,7 +471,7 @@ import VideoPlayer from "../../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - :::note Trading API and EVM addresses In the **Trading** API, use **lowercase** hex for EVM contract addresses in token/currency **`Id`** values (e.g. `eth:0xabc…`, not checksum `0xAbC…`). ::: diff --git a/docs/blockchain/Ethereum/token-supply/evm-token-supply.md b/docs/blockchain/Ethereum/token-supply/evm-token-supply.md index 203cdf9d..8d333649 100644 --- a/docs/blockchain/Ethereum/token-supply/evm-token-supply.md +++ b/docs/blockchain/Ethereum/token-supply/evm-token-supply.md @@ -1,30 +1,12 @@ --- sidebar_position: 1 +title: "EVM Token Supply API" +description: "EVM Token Supply API: stream Ethereum market cap, FDV, supply, and price using Bitquery Trading GraphQL APIs. Run it in the IDE, then ship in your app." --- - # EVM Token Supply API Track real-time and historical token supply data across all EVM-compatible blockchains including Ethereum, BNB Chain (BSC), Base, Arbitrum, Polygon, and more using Bitquery's Token Supply API. - - - - - - - - - - - - - - - - - - - :::info Looking for Solana Token Supply? Bitquery also provides comprehensive **[Solana Token Supply API](/docs/blockchain/Solana/token-supply-cube/)** with features including: - Real-time token supply changes and market cap tracking @@ -53,10 +35,10 @@ Token supply refers to the total number of tokens that exist for a particular cr ### EVM APIs -- **[EVM Balance Updates API](https://docs.bitquery.io/docs/evm/balances/)** - Track wallet balance changes -- **[EVM Token Holders API](https://docs.bitquery.io/docs/evm/token-holders/)** - Get top holders of any token -- **[EVM Transfers API](https://docs.bitquery.io/docs/evm/transfers/)** - Monitor token transfers -- **[EVM DEX Trades API](https://docs.bitquery.io/docs/evm/dextrades/)** - Track trading activity +- **[EVM Balance Updates API](/docs/schema/evm/balances/)** - Track wallet balance changes +- **[EVM Token Holders API](/docs/schema/evm/token-holders/)** - Get top holders of any token +- **[EVM Transfers API](/docs/schema/evm/transfers/)** - Monitor token transfers +- **[EVM DEX Trades API](/docs/schema/evm/dextrades/)** - Track trading activity ### Solana APIs @@ -278,5 +260,5 @@ Maintain audit trails of supply changes for regulatory compliance and financial 2. **Try in IDE**: Test queries in the [Bitquery IDE](https://ide.bitquery.io/) 3. **Integrate**: Use the GraphQL endpoint in your application -For more information on authentication and API usage, see our [Getting Started Guide](https://docs.bitquery.io/docs/start/first-query/). +For more information on authentication and API usage, see our [Getting Started Guide](/docs/start/first-query/). diff --git a/docs/blockchain/Ethereum/transactions/transaction-api.md b/docs/blockchain/Ethereum/transactions/transaction-api.md index 94de742b..8af05b96 100644 --- a/docs/blockchain/Ethereum/transactions/transaction-api.md +++ b/docs/blockchain/Ethereum/transactions/transaction-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 1 +title: "Token Transaction API" +description: "Token Transaction API: query and stream Ethereum on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." --- - # Token Transaction API The Transaction API provides access to transaction data on the blockchain. Transactions are the fundamental unit of account on a blockchain and represent the transfer of value from one address to another. @@ -80,7 +81,6 @@ You can run the query [here](https://ide.bitquery.io/Latest-Transactions-fromto- } } - ``` @@ -128,7 +128,6 @@ query MyQuery { } } - ``` ## Transaction Value in USD diff --git a/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api.md b/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api.md index c1441d47..254b6064 100644 --- a/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api.md +++ b/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api.md @@ -1,5 +1,7 @@ --- sidebar_position: 1 +title: "ERC20 Token Transfers API" +description: "ERC20 Token Transfers API: monitor Ethereum native and token transfers in real time with Bitquery GraphQL APIs. Keep queries fast with indexed filters." --- import FAQ from "@site/src/components/FAQ"; @@ -7,25 +9,6 @@ import FAQ from "@site/src/components/FAQ"; Track and analyze ERC20 token transfers across the Ethereum blockchain in real-time and historically. Monitor token movements, analyze transfer volumes, track wallet activity, and build comprehensive token transfer analytics using Bitquery's ERC20 Token Transfers API. - - - - - - - - - - - - - - - - - - - ## What are ERC20 Token Transfers? ERC20 is the most widely adopted token standard on Ethereum, enabling fungible tokens that can be transferred between addresses. ERC20 token transfers represent the movement of tokens from one wallet to another, forming the foundation of DeFi, trading, and token-based applications. @@ -41,27 +24,27 @@ Understanding ERC20 transfers is essential for: ## 🔗 Related APIs ### Ethereum APIs -- **[Ethereum Balance API](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/balance-api)** - Get wallet balances for ERC20, ERC721, and ERC1155 tokens -- **[Ethereum Transaction Balance Tracker](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/)** - Track real-time balance changes with reason codes -- **[Ethereum Token Holders API](https://docs.bitquery.io/docs/blockchain/Ethereum/token-holders/token-holder-api)** - Get top token holders and distribution data -- **[Ethereum Token Supply API](https://docs.bitquery.io/docs/blockchain/Ethereum/token-supply/evm-token-supply)** - Track total supply and supply changes -- **[Ethereum DEX Trades API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/dex-api)** - Monitor DEX trading activity -- **[Ethereum Transactions API](https://docs.bitquery.io/docs/blockchain/Ethereum/transactions/transaction-api)** - Get comprehensive transaction data -- **[Ethereum Events API](https://docs.bitquery.io/docs/blockchain/Ethereum/events/events-api)** - Query smart contract events +- **[Ethereum Balance API](/docs/blockchain/Ethereum/balances/balance-api)** - Get wallet balances for ERC20, ERC721, and ERC1155 tokens +- **[Ethereum Transaction Balance Tracker](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/)** - Track real-time balance changes with reason codes +- **[Ethereum Token Holders API](/docs/blockchain/Ethereum/token-holders/token-holder-api)** - Get top token holders and distribution data +- **[Ethereum Token Supply API](/docs/blockchain/Ethereum/token-supply/evm-token-supply)** - Track total supply and supply changes +- **[Ethereum DEX Trades API](/docs/blockchain/Ethereum/dextrades/dex-api)** - Monitor DEX trading activity +- **[Ethereum Transactions API](/docs/blockchain/Ethereum/transactions/transaction-api)** - Get comprehensive transaction data +- **[Ethereum Events API](/docs/blockchain/Ethereum/events/events-api)** - Query smart contract events ### EVM APIs -- **[EVM Transfers API](https://docs.bitquery.io/docs/evm/transfers)** - General EVM token transfers documentation -- **[EVM Balance Updates API](https://docs.bitquery.io/docs/evm/balances)** - Track balance changes across EVM chains -- **[EVM DEX Trades API](https://docs.bitquery.io/docs/evm/dextrades)** - DEX trading data across EVM chains +- **[EVM Transfers API](/docs/schema/evm/transfers)** - General EVM token transfers documentation +- **[EVM Balance Updates API](/docs/schema/evm/balances)** - Track balance changes across EVM chains +- **[EVM DEX Trades API](/docs/schema/evm/dextrades)** - DEX trading data across EVM chains ### NFT & Other Token Standards -- **[NFT Transfer API](https://docs.bitquery.io/docs/blockchain/Ethereum/transfers/nft-token-transfer-api)** - Track ERC721 and ERC1155 NFT transfers -- **[RWA Token API](https://docs.bitquery.io/docs/blockchain/Ethereum/transfers/rwa-api)** - Real World Asset token transfers +- **[NFT Transfer API](/docs/blockchain/Ethereum/transfers/nft-token-transfer-api)** - Track ERC721 and ERC1155 NFT transfers +- **[RWA Token API](/docs/blockchain/Ethereum/transfers/rwa-api)** - Real World Asset token transfers ### Solana APIs -- **[Solana Transfers API](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/)** - Track SPL token transfers and SOL transfers on Solana -- **[Solana Balance Updates API](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/)** - Monitor Solana wallet balance changes -- **[Solana DEX Trades API](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/)** - Track Solana DEX trading activity +- **[Solana Transfers API](/docs/blockchain/Solana/solana-transfers/)** - Track SPL token transfers and SOL transfers on Solana +- **[Solana Balance Updates API](/docs/blockchain/Solana/solana-balance-updates/)** - Monitor Solana wallet balance changes +- **[Solana DEX Trades API](/docs/blockchain/Solana/solana-dextrades/)** - Track Solana DEX trading activity --- @@ -252,7 +235,7 @@ The example below queries transfers for USDT, USDC, WETH, and native ETH (`0x` r } ``` -**Solana Token Transfers**: For SPL token transfers on Solana, see our **[Solana Transfers API](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/)** documentation. +**Solana Token Transfers**: For SPL token transfers on Solana, see our **[Solana Transfers API](/docs/blockchain/Solana/solana-transfers/)** documentation. ::: --- @@ -297,7 +280,7 @@ subscription { ``` :::tip Real-Time Monitoring -For more information on setting up real-time subscriptions, see our [GraphQL Subscriptions documentation](https://docs.bitquery.io/docs/subscriptions/subscription). +For more information on setting up real-time subscriptions, see our [GraphQL Subscriptions documentation](/docs/subscriptions/subscription). ::: --- @@ -397,7 +380,7 @@ query ($addresses: [String!]) { ``` :::note Array Intersect Function -Learn more about the `array_intersect` function in our [Array Intersect documentation](https://docs.bitquery.io/docs/graphql/capabilities/array-intersect). +Learn more about the `array_intersect` function in our [Array Intersect documentation](/docs/graphql/capabilities/array-intersect). ::: --- @@ -570,8 +553,8 @@ Track all token transfers for a wallet to build comprehensive portfolio dashboar - Build transaction timelines **Related APIs:** -- [Ethereum Balance API](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/balance-api) - Get current wallet balances -- [Transaction Balance Tracker](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/) - Real-time balance updates +- [Ethereum Balance API](/docs/blockchain/Ethereum/balances/balance-api) - Get current wallet balances +- [Transaction Balance Tracker](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/) - Real-time balance updates ### 2. Tax & Accounting @@ -607,8 +590,8 @@ Analyze token flows in and out of DeFi protocols: - Measure protocol adoption **Related APIs:** -- [Ethereum DEX Trades API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/dex-api) - Track DEX trading activity -- [Ethereum Events API](https://docs.bitquery.io/docs/blockchain/Ethereum/events/events-api) - Monitor smart contract events +- [Ethereum DEX Trades API](/docs/blockchain/Ethereum/dextrades/dex-api) - Track DEX trading activity +- [Ethereum Events API](/docs/blockchain/Ethereum/events/events-api) - Monitor smart contract events ### 4. Token Distribution Analysis @@ -619,8 +602,8 @@ Understand how tokens are distributed across addresses: - Identify distribution patterns **Related APIs:** -- [Token Holders API](https://docs.bitquery.io/docs/blockchain/Ethereum/token-holders/token-holder-api) - Get top holders -- [Token Supply API](https://docs.bitquery.io/docs/blockchain/Ethereum/token-supply/evm-token-supply) - Track supply changes +- [Token Holders API](/docs/blockchain/Ethereum/token-holders/token-holder-api) - Get top holders +- [Token Supply API](/docs/blockchain/Ethereum/token-supply/evm-token-supply) - Track supply changes ### 5. Security & Fraud Detection @@ -684,10 +667,10 @@ Build comprehensive wallet analysis tools: 1. **Get API Access**: Sign up at [Bitquery](https://bitquery.io/) to get your API key 2. **Try in IDE**: Test queries in the [Bitquery IDE](https://ide.bitquery.io/) -3. **Read Documentation**: Explore our [Getting Started Guide](https://docs.bitquery.io/docs/start/first-query/) -4. **Check Examples**: See more examples in [Starter Queries](https://docs.bitquery.io/docs/start/starter-queries) +3. **Read Documentation**: Explore our [Getting Started Guide](/docs/start/first-query/) +4. **Check Examples**: See more examples in [Starter Queries](/docs/start/starter-queries) -For more information on authentication and API usage, see our [Authorization Guide](https://docs.bitquery.io/docs/authorisation/how-to-use). +For more information on authentication and API usage, see our [Authorization Guide](/docs/authorization/how-to-use). ## Deterministic Pagination for Backfilling Transfers diff --git a/docs/blockchain/Ethereum/transfers/ico-token-ownership-transfer.mdx b/docs/blockchain/Ethereum/transfers/ico-token-ownership-transfer.mdx index 242081ee..e0ab4138 100644 --- a/docs/blockchain/Ethereum/transfers/ico-token-ownership-transfer.mdx +++ b/docs/blockchain/Ethereum/transfers/ico-token-ownership-transfer.mdx @@ -1,12 +1,13 @@ --- sidebar_position: 1 +title: "Analyzing Token ICO with Transfers APIs" +description: "Analyzing Token ICO with Transfers APIs: monitor Ethereum native and token transfers in real time with Bitquery GraphQL APIs." --- import VideoPlayer from "../../../../src/components/videoplayer.js"; +# Analyzing Token ICO with Transfers APIs -# Analysing Token ICO with Transfers APIs - -In this segment we will learn how you can analyse a project's ICO performance, to help investors in taking smart investment decisions based on that knowledge. For this tutorial, we will look up the info related to [PEPU](https://explorer.bitquery.io/ethereum/token/0x906cc2ad139eb6637e28605f908903c8adce566a) token +In this segment we will learn how you can analyze a project's ICO performance, to help investors in taking smart investment decisions based on that knowledge. For this tutorial, we will look up the info related to [PEPU](https://explorer.bitquery.io/ethereum/token/0x906cc2ad139eb6637e28605f908903c8adce566a) token ## Decoding the ICO Process @@ -90,6 +91,6 @@ query MyQuery { ``` -## Video Tutorial on How to Analyse ICO of PEPU Token +## Video Tutorial on How to Analyze ICO of PEPU Token - \ No newline at end of file + diff --git a/docs/blockchain/Ethereum/transfers/nft-token-transfer-api.md b/docs/blockchain/Ethereum/transfers/nft-token-transfer-api.md index 607b8d45..1f3f7e25 100644 --- a/docs/blockchain/Ethereum/transfers/nft-token-transfer-api.md +++ b/docs/blockchain/Ethereum/transfers/nft-token-transfer-api.md @@ -1,7 +1,8 @@ --- sidebar_position: 2 +title: "NFT Token Transfers API" +description: "NFT Token Transfers API: monitor Ethereum native and token transfers in real time with Bitquery GraphQL APIs. Covers archive history and realtime data." --- - # NFT Token Transfers API Let's see how to get the latest NFT token transfers. We are taking Cryptokitties(CK) token example in the following query. The token address for Cryptokitties(CK) token is [0x06012c8cf97bead5deae237070f9587f8e7a266d](https://explorer.bitquery.io/ethereum/token/0x06012c8cf97bead5deae237070f9587f8e7a266d) diff --git a/docs/blockchain/Ethereum/transfers/rwa-api.md b/docs/blockchain/Ethereum/transfers/rwa-api.md index 3aaad78c..0e1d1b34 100644 --- a/docs/blockchain/Ethereum/transfers/rwa-api.md +++ b/docs/blockchain/Ethereum/transfers/rwa-api.md @@ -1,10 +1,14 @@ +--- +title: "RWA (Real World Assets) API" +description: "RWA (Real World Assets) API: monitor Ethereum native and token transfers in real time with Bitquery GraphQL APIs. Built for traders and analytics teams." +--- # RWA (Real World Assets) API In this section, we will explore some of the APIs that help us obtain information about Real World Assets (RWAs) on Ethereum, Arbitrum, and other EVM chains. These APIs can be executed on any EVM chain simply by changing the `network: eth` parameter to the appropriate chain and using the correct address. -We have written about analysing RWA data in the blog [here](https://bitquery.io/blog/real-world-asset-tracking-arbitrum-bitquery-apis) and how it has influenced tokenized real-estate [here](https://bitquery.io/blog/tokenized-real-estate-transforming-property-investment). +We have written about analyzing RWA data in the blog [here](https://bitquery.io/blog/real-world-asset-tracking-arbitrum-bitquery-apis) and how it has influenced tokenized real-estate [here](https://bitquery.io/blog/tokenized-real-estate-transforming-property-investment). ## Top Holders of an RWA diff --git a/docs/blockchain/Ethereum/transfers/total-supply.mdx b/docs/blockchain/Ethereum/transfers/total-supply.mdx index 047b3a7d..00a9c559 100644 --- a/docs/blockchain/Ethereum/transfers/total-supply.mdx +++ b/docs/blockchain/Ethereum/transfers/total-supply.mdx @@ -1,12 +1,11 @@ --- sidebar_position: 2 +title: "Get Supply and Marketcap of a Token" +description: "Get Supply and Marketcap of a Token: monitor Ethereum native and token transfers in real time with Bitquery GraphQL APIs." --- - # Get Supply and Marketcap of a Token -We will use the [Transaction Balance Tracker APIs](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/) for this query. - - +We will use the [Transaction Balance Tracker APIs](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/) for this query. ```graphql { @@ -117,4 +116,4 @@ Try the query [here](https://ide.bitquery.io/supply-and-latest-price-of-token-to import VideoPlayer from "../../../../src/components/videoplayer.js"; - \ No newline at end of file + diff --git a/docs/blockchain/Matic/index.mdx b/docs/blockchain/Matic/index.mdx index cf65cc9f..49363805 100644 --- a/docs/blockchain/Matic/index.mdx +++ b/docs/blockchain/Matic/index.mdx @@ -1,6 +1,6 @@ --- title: Polygon (MATIC) API Documentation -description: Collection of Polygon (MATIC) APIs organized by project including DEX trades, liquidity pools, slippage data, and more. +description: "Polygon (MATIC) API Documentation: query and stream Polygon on-chain data with Bitquery GraphQL examples for developers." slug: /blockchain/Matic/ keywords: - API @@ -15,7 +15,6 @@ keywords: - Polygon (MATIC) token api - Polygon (MATIC) transaction api --- - import VideoPlayer from "../../../src/components/videoplayer.js"; Discover everything you need to build powerful Polygon (MATIC) applications—from real-time DEX trading analytics, liquidity monitoring, slippage analysis, and token holder insights to NFT tracking and transaction monitoring. This comprehensive guide provides ready-to-use GraphQL APIs, live streaming data, and step-by-step examples for tracking swaps, balances, transfers, liquidity pools, and more across the Polygon ecosystem. Whether you're building trading bots, dashboards, or DeFi analytics tools, find all the Polygon data solutions you need right here. @@ -25,10 +24,9 @@ Need help crafting a query or subscription? Message us on [support](https://t.me ## What is the Bitquery Polygon (MATIC) API? :::tip Building a trading app or DEX UI on Polygon (MATIC)? -For **real-time trades and prices on Polygon (MATIC)** (and the last ~30 days), use the curated [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. For **historical Polygon (MATIC) data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. +For **real-time trades and prices on Polygon (MATIC)** (and the last ~30 days), use the curated [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. For **historical Polygon (MATIC) data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. ::: - It's a GraphQL interface over curated, indexed Polygon (MATIC) data. Write concise queries instead of building and maintaining your own indexer. ## What can you build with it? @@ -48,7 +46,7 @@ Track wallet portfolios and token holders, monitor DEX price/volume, liquidity e ## WebSockets and Webhooks -Most queries can be turned into live streams by switching `query` to `subscription`, and consumed over WebSocket. See examples and code snippets [here](https://docs.bitquery.io/docs/subscriptions/websockets/). +Most queries can be turned into live streams by switching `query` to `subscription`, and consumed over WebSocket. See examples and code snippets [here](/docs/subscriptions/websockets/). ## DEX Trades diff --git a/docs/blockchain/Matic/matic-balance-api.md b/docs/blockchain/Matic/matic-balance-api.md index 4f916265..53c6b404 100644 --- a/docs/blockchain/Matic/matic-balance-api.md +++ b/docs/blockchain/Matic/matic-balance-api.md @@ -1,11 +1,12 @@ --- sidebar_position: 1 +title: "Polygon (MATIC) Address Balance API" +description: "Polygon (MATIC) Address Balance API: fetch current and historical Polygon balances with Bitquery GraphQL balance queries." --- - # Polygon (MATIC) Address Balance API :::caution Deprecated APIs -On EVM, **`BalanceUpdates`** and **`TokenHolders`** are deprecated as of **20 May 2026** and will be removed on **15 June 2026**. Use **`EVM.Balances`** (this page) and **[Token Holders API](/docs/blockchain/Ethereum/token-holders/token-holder-api)** (`EVM.Holders`) instead. +On EVM, **`BalanceUpdates`** and **`TokenHolders`** were deprecated as of **20 May 2026** and removed on **15 June 2026**. Use **`EVM.Balances`** (this page) and **[Token Holders API](/docs/blockchain/Ethereum/token-holders/token-holder-api)** (`EVM.Holders`) instead. ::: The **Balances** API returns current and historical token balances for an address on Polygon (MATIC). To return only non-zero balances, add `Amount(selectWhere: { gt: "0" })` on the `Balance` field (not in `where`). Use `dataset: combined` or `dataset: archive` as follows: diff --git a/docs/blockchain/Matic/matic-dextrades.md b/docs/blockchain/Matic/matic-dextrades.md index fcaed831..53f18938 100644 --- a/docs/blockchain/Matic/matic-dextrades.md +++ b/docs/blockchain/Matic/matic-dextrades.md @@ -1,43 +1,16 @@ --- sidebar_position: 2 +title: "Polygon (MATIC) DEX Trades API" +description: "Polygon (MATIC) DEX Trades API: get Polygon DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. See examples in the Bitquery IDE." --- - # Polygon (MATIC) DEX Trades API :::tip Need real-time Polygon (MATIC) DEX data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API** (filter with `Pair.Market.Network: Matic`). Use this page when you need **historical Polygon (MATIC) data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API** (filter with `Pair.Market.Network: Matic`). Use this page when you need **historical Polygon (MATIC) data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. ::: - In this section we will see how to get Matic DEX trades information using our API. - - - - - - - - - - - - - - - - - - - - - ## Live DEX swap stream (Polygon) {#crypto-trades-live-stream} [Crypto Trades API](/docs/trading/crypto-trades-api/trades-api): one row per swap, with USD and supply. For Polygon use **`Pair.Market.Network: Matic`**. [When to use this vs chain DEX APIs](/docs/cubes/dextrades-dextradebytokens-trading-trades). @@ -129,7 +102,7 @@ subscription { This example uses the chain-specific **DEXTrades** cube via `EVM(network: matic) { DEXTrades }` (pool-side Buy/Sell; see [DEXTrades cube](/docs/cubes/dextrades)). USD can be weak on thin pools. For trader + USD swap rows, use the [stream at the top](#crypto-trades-live-stream). -Read [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. +Read [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. You can find the query [here](https://ide.bitquery.io/Realtime-matic-dex-trades-websocket) ``` @@ -178,8 +151,6 @@ subscription { } } - - ``` ## Subscribe to Latest Price of a Token in Real-time @@ -231,7 +202,6 @@ subscription { } } - ``` ## Latest USD Price of a Token diff --git a/docs/blockchain/Matic/matic-liquidity-api.md b/docs/blockchain/Matic/matic-liquidity-api.md index be022c99..24979132 100644 --- a/docs/blockchain/Matic/matic-liquidity-api.md +++ b/docs/blockchain/Matic/matic-liquidity-api.md @@ -1,38 +1,12 @@ --- sidebar_position: 7 +title: "Polygon Matic Liquidity API" +description: "Polygon Matic Liquidity API: read Polygon pool reserves and liquidity updates via Bitquery GraphQL DEX APIs. Great for bots, dashboards, and alerts." --- - # Matic Liquidity API In this section we will see how to get Matic DEX pool liquidity information using Bitquery API. The liquidity API helps you monitor real-time liquidity changes, track pool reserves, and analyze liquidity depth for token pairs on Matic DEX pools. - - - - - - - - - - - - - - - - - - - - - ## Understanding Liquidity and Pool Reserves Liquidity in DEX pools refers to the amount of tokens available for trading. Pool reserves (the balance of each token in the pool) determine the pool's ability to handle trades without significant price impact. Monitoring liquidity changes helps you: @@ -49,7 +23,7 @@ The DEXPoolEvents API provides real-time information about: - Pool and token pair information - Transaction details for liquidity-changing events -For a comprehensive explanation of how DEX pools work, liquidity calculations, and when pool events are emitted, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/). +For a comprehensive explanation of how DEX pools work, liquidity calculations, and when pool events are emitted, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/). ## Realtime Liquidity Stream @@ -282,7 +256,7 @@ Kafka streams provide the same liquidity data as GraphQL subscriptions but with - Ability to read from latest offset without gaps - Better scalability with multiple consumers -For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](/docs/streams/kafka-streaming-concepts/). > **Note:** IDE credentials will not work with Kafka Streams. You need separate Kafka credentials. Please contact sales on our official telegram channel or fill out the [form on our website](https://bitquery.io/forms/api). @@ -315,7 +289,7 @@ The `DEXPoolEvents` API response contains the following information: - `Hash`: Transaction hash - `Gas`: Gas used for the transaction -For more details on when new pool events are emitted and how liquidity is calculated, see the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). +For more details on when new pool events are emitted and how liquidity is calculated, see the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). ## Use Cases @@ -353,4 +327,4 @@ Track liquidity events that may create trading opportunities: - Monitor liquidity removals that may signal pool abandonment - Identify pools experiencing rapid liquidity growth -For more advanced use cases, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). +For more advanced use cases, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). diff --git a/docs/blockchain/Matic/matic-nft.md b/docs/blockchain/Matic/matic-nft.md index 17c677a2..00d0bf92 100644 --- a/docs/blockchain/Matic/matic-nft.md +++ b/docs/blockchain/Matic/matic-nft.md @@ -1,36 +1,11 @@ +--- +title: "Polygon (MATIC) NFT API" +description: "Polygon (MATIC) NFT API: track Polygon NFT trades, ownership, and metadata with Bitquery GraphQL and streams. Keep queries fast with indexed filters." +--- # Polygon (MATIC) NFT API In this section we'll have a look at some examples using the Matic NFT API. - - - - - - - - - - - - - - - - - - - - - - - ## Track transfers of an NFT in Realtime This query subscribes you to the real time transfers of a specific non-fungible token (NFT) on the Matic network. @@ -67,6 +42,4 @@ subscription { } } - - ``` diff --git a/docs/blockchain/Matic/matic-slippage-api.md b/docs/blockchain/Matic/matic-slippage-api.md index b49ee361..1d6b95ad 100644 --- a/docs/blockchain/Matic/matic-slippage-api.md +++ b/docs/blockchain/Matic/matic-slippage-api.md @@ -1,38 +1,12 @@ --- sidebar_position: 3 +title: "Polygon Matic Slippage API" +description: "Polygon Matic Slippage API: measure Polygon DEX price impact and slippage with Bitquery GraphQL pool metrics. Covers archive history and realtime data." --- - # Matic Slippage API In this section we will see how to get Matic DEX pool slippage information using our API. The slippage API helps you understand price impact and liquidity depth for token swaps on Matic DEX pools. - - - - - - - - - - - - - - - - - - - - - ## Understanding Slippage and Price Impact Slippage refers to the difference between the expected price of a trade and the actual execution price. When swapping tokens in a DEX pool, larger trades can move the price due to limited liquidity, resulting in slippage. @@ -43,7 +17,7 @@ The DEXPoolSlippages API provides detailed information about: - Average execution prices for different trade sizes - Price impact calculations for both swap directions (A to B and B to A) -For a comprehensive explanation of how DEX pools work, liquidity calculations, and price tables, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/). +For a comprehensive explanation of how DEX pools work, liquidity calculations, and price tables, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/). ## Realtime Slippage Monitoring @@ -181,7 +155,7 @@ Kafka streams provide the same slippage data as GraphQL subscriptions but with s - Ability to read from latest offset without gaps - Better scalability with multiple consumers -For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). +For detailed information on how to connect to Kafka streams, subscribe to topics, and parse messages, refer to the [Kafka Streaming Concepts documentation](/docs/streams/kafka-streaming-concepts/). > **Note:** IDE credentials will not work with Kafka Streams. You need separate Kafka credentials. Please contact sales on our official telegram channel or fill out the [form on our website](https://bitquery.io/forms/api). @@ -203,7 +177,7 @@ The `DEXPoolSlippages` API response contains the following information: - `Time`: Timestamp of the block - `Number`: Block number -For more details on how slippage is calculated and when new pool records are emitted, see the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). +For more details on how slippage is calculated and when new pool records are emitted, see the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#when-is-a-new-dexpool-record-emitted-in-the-apis--streams). ## Use Cases @@ -250,4 +224,4 @@ For a practical implementation example of using slippage data for automated trad - Execute fade trades against temporary price impacts - Manage positions with dynamic stop losses and take profits based on slippage data -For more advanced use cases, refer to the [DEXPools Cube documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). +For more advanced use cases, refer to the [DEXPools Cube documentation](/docs/cubes/evm-dexpool/#advanced-use-cases-and-processing-patterns). diff --git a/docs/blockchain/Matic/matic-token-marketcap-api.md b/docs/blockchain/Matic/matic-token-marketcap-api.md index b88f78e8..c439620b 100644 --- a/docs/blockchain/Matic/matic-token-marketcap-api.md +++ b/docs/blockchain/Matic/matic-token-marketcap-api.md @@ -1,28 +1,14 @@ --- sidebar_position: 3 +title: "Polygon (Matic) Token Market Cap API" +description: "Polygon (Matic) Token Market Cap API: stream Polygon market cap, FDV, supply, and price using Bitquery Trading GraphQL APIs." --- - # Polygon (Matic) Token Market Cap API Use Bitquery’s **Trading** API **`Tokens`** cube to stream or query **market cap**, **fully diluted valuation (USD)**, **total supply**, **price** (OHLC and averages), and **volume** for tokens on **Polygon** (network id **`matic`** in the Trading API). Filter with **`matic:`** plus a **lowercase** contract address in **`Token.Id`** / **`Currency.Id`**. For schema details and field meanings, see the **[Tokens cube](/docs/trading/crypto-price-api/tokens)** and **[Supply fields](/docs/trading/crypto-price-api/supply-fields)**. - - - - - - - - - - - - - - - :::note Trading API and EVM addresses On **Polygon** (**`matic`** in Trading), use **lowercase** hex in **`Id`** values (e.g. `matic:0xeb51…`, not mixed-case checksum addresses). ::: diff --git a/docs/blockchain/Matic/matic-transfers.md b/docs/blockchain/Matic/matic-transfers.md index 10b0cf95..57d02e95 100644 --- a/docs/blockchain/Matic/matic-transfers.md +++ b/docs/blockchain/Matic/matic-transfers.md @@ -1,36 +1,11 @@ +--- +title: "Polygon (MATIC) Transfers API" +description: "Polygon (MATIC) Transfers API: monitor Polygon native and token transfers in real time with Bitquery GraphQL APIs. Works with WebSocket live subscriptions." +--- # Polygon (MATIC) Transfers API In this section we'll have a look at some examples using the Polygon (MATIC) Transfers API. - - - - - - - - - - - - - - - - - - - - - - - # Subscribe to Recent Whale Transactions of a particular currency The subscription query below fetches the whale transactions on the MATIC network. We have used USDC address `0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359`. You can find the query [here](https://ide.bitquery.io/Whale-transfers-of-USDC-on-matic) @@ -62,7 +37,6 @@ subscription{ } } - ``` # Sender is a particular address @@ -95,9 +69,6 @@ subscription { } } - - - ``` # Subscribe to the latest NFT token transfers on Polygon (MATIC) @@ -130,7 +101,6 @@ subscription { } } - ``` # Check if an address ever interacted with Polymarket (CTF collateral transfer) diff --git a/docs/blockchain/Matic/matic-uniswap-api.md b/docs/blockchain/Matic/matic-uniswap-api.md index 087155c1..fe6e9aac 100644 --- a/docs/blockchain/Matic/matic-uniswap-api.md +++ b/docs/blockchain/Matic/matic-uniswap-api.md @@ -1,5 +1,7 @@ --- sidebar_position: 7 +title: "Polygon Matic Uniswap API" +description: "Polygon Matic Uniswap API: query Polygon Uniswap trades, pools, and prices with Bitquery GraphQL DEX APIs. Copy GraphQL snippets for production apps." --- import FAQ from "@site/src/components/FAQ"; @@ -9,29 +11,6 @@ import VideoPlayer from "../../../src/components/videoplayer.js"; This section provides you with a set of queries that provides an insight about the Uniswap DEX on MATIC. - - - - - - - - - - - - - - - - - ## Get Latest Trades on Uniswap v3 Below query will subscribe you to the latest DEX Trades on MATIC Uniswap v3. Try out the API [here](https://ide.bitquery.io/uniswap-v3-trades-matic) diff --git a/docs/blockchain/Matic/uniswap-v4-api.md b/docs/blockchain/Matic/uniswap-v4-api.md index be611206..df54d369 100644 --- a/docs/blockchain/Matic/uniswap-v4-api.md +++ b/docs/blockchain/Matic/uniswap-v4-api.md @@ -1,15 +1,13 @@ --- -title: "Uniswap V4 API on Matic - Track Trader Activities, Token Trades and Market Behaviour" -description: "Track Uniswap V4 trades, trader activities, token trades, and market behaviour in real time using Bitquery's DEX Trades API on Matic." +title: "Polygon Uniswap V4 API" +description: "Polygon Uniswap V4 API: query Polygon Uniswap trades, pools, and prices with Bitquery GraphQL DEX APIs. Copy GraphQL snippets for production apps." --- - -# Uniswap V4 API - Track Trader Activities, Token Trades and Market Behaviour +# Uniswap V4 API - Track Trader Activities, Token Trades and Market Behavior :::tip Need real-time Uniswap V4 (Polygon) data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Uniswap V4 (Polygon) swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Uniswap V4 (Polygon) data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Uniswap V4 (Polygon) swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Uniswap V4 (Polygon) data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Uniswap v4 introduces a major shift in protocol architecture. Instead of deploying a separate smart contract for each liquidity pool, Uniswap v4 uses a singleton PoolManager contract that manages all pools internally as structured state. Each pool in Uniswap v4 is uniquely identified by a `PoolId`, which is derived from the pool configuration (token pair, fee, tick spacing, and optional hooks), rather than a dedicated contract address. Using Bitquery's Uniswap v4 APIs, you can track: diff --git a/docs/blockchain/Optimism/index.mdx b/docs/blockchain/Optimism/index.mdx index d00520a7..68c8b09f 100644 --- a/docs/blockchain/Optimism/index.mdx +++ b/docs/blockchain/Optimism/index.mdx @@ -1,6 +1,6 @@ --- title: Optimism API Documentation -description: Collection of Optimism APIs organized by topic. +description: "Optimism API Documentation: query and stream Optimism on-chain data with Bitquery GraphQL examples for developers. Keep queries fast with indexed filters." slug: /blockchain/Optimism/ keywords: - Optimism API @@ -18,14 +18,12 @@ keywords: - Optimism DEX API - Optimism uniswap trades --- - # Optimism API Documentation :::tip Building a trading app or DEX UI on Optimism? -For **real-time trades and prices on Optimism** (and the last ~30 days), use the curated [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. For **historical Optimism data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. +For **real-time trades and prices on Optimism** (and the last ~30 days), use the curated [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. For **historical Optimism data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. ::: - ## Overview In this section we will see how to fetch data on different tokens, transactions, and DEXs on Optimism via APIs and Streams. @@ -52,7 +50,7 @@ To access Bitquery Tron API you would require your own **[Access Token](https:// ### Does Bitquery support Optimism Websocket and Webhooks? -Bitquery supports websocket and webhooks; you can convert most GraphQL APIs into GraphQL streams by changing the word `query` to `subscription`. You can monitor this data via a websocket. More docs and code samples are available [here](https://docs.bitquery.io/docs/subscriptions/websockets/). +Bitquery supports websocket and webhooks; you can convert most GraphQL APIs into GraphQL streams by changing the word `query` to `subscription`. You can monitor this data via a websocket. More docs and code samples are available [here](/docs/subscriptions/websockets/). ## Quick start @@ -92,14 +90,13 @@ query LatestOptimismTrades { ## DEX APIs -- [Optimism Dex Trades](https://docs.bitquery.io/docs/examples/Optimism/optimism-dextrades/) +- [Optimism Dex Trades](./optimism-dextrades) ## Core Optimism APIs - [Balance API](./optimism-balance-api) -- [NFT](http://localhost:3000/docs/examples/Optimism/optimism-nft/) -- [Transactions](https://docs.bitquery.io/docs/examples/Optimism/Optimism-transactions-api/) -- [Transfers](https://docs.bitquery.io/docs/examples/Optimism/optimism-transfers/) +- [NFT](./optimism-nft) +- [Transfers](./optimism-transfers) ## Videos diff --git a/docs/blockchain/Optimism/optimism-balance-api.md b/docs/blockchain/Optimism/optimism-balance-api.md index 172f58d4..d351239c 100644 --- a/docs/blockchain/Optimism/optimism-balance-api.md +++ b/docs/blockchain/Optimism/optimism-balance-api.md @@ -1,11 +1,12 @@ --- sidebar_position: 4 +title: "Optimism Address Balance API" +description: "Optimism Address Balance API: fetch current and historical Optimism balances with Bitquery GraphQL balance queries. Great for bots, dashboards, and alerts." --- - # Optimism Address Balance API :::caution Deprecated APIs -On EVM, **`BalanceUpdates`** and **`TokenHolders`** are deprecated as of **20 May 2026** and will be removed on **15 June 2026**. Use **`EVM.Balances`** (this page) and **[Token Holders API](/docs/blockchain/Ethereum/token-holders/token-holder-api)** (`EVM.Holders`) instead. +On EVM, **`BalanceUpdates`** and **`TokenHolders`** were deprecated as of **20 May 2026** and removed on **15 June 2026**. Use **`EVM.Balances`** (this page) and **[Token Holders API](/docs/blockchain/Ethereum/token-holders/token-holder-api)** (`EVM.Holders`) instead. ::: The **Balances** API returns current and historical token balances for an address on Optimism. To return only non-zero balances, add `Amount(selectWhere: { gt: "0" })` on the `Balance` field (not in `where`). Use `dataset: combined` or `dataset: archive` as follows: diff --git a/docs/blockchain/Optimism/optimism-dextrades.md b/docs/blockchain/Optimism/optimism-dextrades.md index 8a56fb90..9614da20 100644 --- a/docs/blockchain/Optimism/optimism-dextrades.md +++ b/docs/blockchain/Optimism/optimism-dextrades.md @@ -1,47 +1,20 @@ --- sidebar_position: 2 +title: "Optimism DEX Trades API" +description: "Optimism DEX Trades API: get Optimism DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Works with WebSocket live subscriptions." --- - # Optimism DEX Trades API :::tip Need real-time Optimism DEX data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API** (filter with `Pair.Market.Network: Optimism`). Use this page when you need **historical Optimism data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API** (filter with `Pair.Market.Network: Optimism`). Use this page when you need **historical Optimism data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. ::: - If you were using Optimism RPC till now to get data, forget about it. Our Optimism real time streams are perfect alternative for Optimism web3 subscribe. In this section we will see how to get Optimism DEX trades information using our GraphQL APIs. - - - - - - - - - - - - - - - - - - - - - ## Live DEX swap stream (Optimism) {#crypto-trades-live-stream} [Crypto Trades API](/docs/trading/crypto-trades-api/trades-api): one row per swap, with USD and supply. Filter **`Pair.Market.Network: Optimism`**. [When to use this vs chain DEX APIs](/docs/cubes/dextrades-dextradebytokens-trading-trades). @@ -128,7 +101,7 @@ subscription { [This](https://ide.bitquery.io/trending-pairs-on-optimism) query returns the top trending trading pairs on Optimism based on the `Trade Volume`, and returns info like unique buyers and sellers, number of markets where the pair exist, latest price and price at a given time and much more. -Read [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. +Read [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. ```graphql query pairs( @@ -224,7 +197,7 @@ query pairs( The example of this could be seen on the [DEXRabbit](https://dexrabbit.com/optimism). -![Trending Pairs on Optimism](../../../static/img/dexrabbit/optimism_trending_pairs.png) +![Trending Pairs on Optimism](/img/dexrabbit/optimism_trending_pairs.png) ## Subscribe to Latest Optimism Trades @@ -278,7 +251,6 @@ subscription { } } - ``` ## Get Top Traders on Optimism @@ -306,7 +278,7 @@ query topTraders($network: evm_network, $time_ago: DateTime) { You can checkout a completed product using this info on [DEXRabbit](https://dexrabbit.com/optimism/trader). -![Top Traders on Optimism](../../../static/img/dexrabbit/optimism_top_traders.png) +![Top Traders on Optimism](/img/dexrabbit/optimism_top_traders.png) ## Get Top Traders for a Pair on Optimism @@ -355,7 +327,7 @@ query pairTopTraders( An example for the same could be seen in the [DEXRabbit](https://dexrabbit.com/optimism/pair/0xdc6ff44d5d932cbd77b52e5612ba0529dc6226f1/0x0b2c639c533813f4aa9d7837caf62653d097ff85#pair_top_traders) as shown below. -![Top Traders for a Pair](../../../static/img/dexrabbit/optimism_top_pair_traders.png) +![Top Traders for a Pair](/img/dexrabbit/optimism_top_pair_traders.png) ## Subscribe to Latest Price of a Token in Real-time @@ -436,7 +408,7 @@ query topTokens($network: evm_network, $time_ago: DateTime!) { An example of the utilisation of this data could be seen on [DEXRabbit](https://dexrabbit.com/optimism/token). -![Top Tokens on Optimism](../../../static/img/dexrabbit/optimism_top_tokens.png) +![Top Tokens on Optimism](/img/dexrabbit/optimism_top_tokens.png) ## Latest USD Price of a Token @@ -484,6 +456,4 @@ subscription { } } - - ``` diff --git a/docs/blockchain/Optimism/optimism-nft.md b/docs/blockchain/Optimism/optimism-nft.md index 4cb4b807..16e34378 100644 --- a/docs/blockchain/Optimism/optimism-nft.md +++ b/docs/blockchain/Optimism/optimism-nft.md @@ -1,34 +1,11 @@ +--- +title: "Optimism NFT API" +description: "Optimism NFT API: track Optimism NFT trades, ownership, and metadata with Bitquery GraphQL and streams. Scale further with Kafka or gRPC streams." +--- # Optimism NFT API In this section we'll have a look at some examples using the Optimism NFT data API. - - - - - - - - - - - - - - - - - - - - - ## Track transfers of an NFT in Realtime on Optimism This query subscribes you to the real time transfers of a specific non-fungible token (NFT) on the Optimism blockchain. diff --git a/docs/blockchain/Optimism/optimism-transfers.md b/docs/blockchain/Optimism/optimism-transfers.md index 85371e45..03ba695c 100644 --- a/docs/blockchain/Optimism/optimism-transfers.md +++ b/docs/blockchain/Optimism/optimism-transfers.md @@ -1,34 +1,11 @@ +--- +title: "Optimism Transfers API" +description: "Optimism Transfers API: monitor Optimism native and token transfers in real time with Bitquery GraphQL APIs. Includes filters and field selection tips." +--- # Optimism Transfers API In this section we'll have a look at some examples using the Optimism Transfers API. - - - - - - - - - - - - - - - - - - - - - # Subscribe to Recent Whale Transactions of a particular currency The subscription query below fetches the whale transactions on the Optimism network. We have used USDT address `0x94b008aA00579c1307B0EF2c499aD98a8ce58e58` @@ -61,7 +38,6 @@ subscription { } } - ``` # Sender is a particular address @@ -94,7 +70,6 @@ subscription { } } - ``` # Subscribe to the latest NFT token transfers on Optimism @@ -127,8 +102,6 @@ subscription { } } - - ``` ## Deterministic Pagination for Backfilling Transfers diff --git a/docs/blockchain/Optimism/uniswap-v4-api.md b/docs/blockchain/Optimism/uniswap-v4-api.md index 078b671f..dc2dc933 100644 --- a/docs/blockchain/Optimism/uniswap-v4-api.md +++ b/docs/blockchain/Optimism/uniswap-v4-api.md @@ -1,9 +1,8 @@ --- -title: "Uniswap V4 API - Track Trader Activities, Token Trades and Market Behaviour" -description: "Track Uniswap V4 trades, trader activities, token trades, and market behaviour in real time using Bitquery's DEX Trades API on Optimism." +title: "Optimism Uniswap V4 API" +description: "Optimism Uniswap V4 API: query Optimism Uniswap trades, pools, and prices with Bitquery GraphQL DEX APIs. Built for traders and analytics teams." --- - -# Uniswap V4 API - Track Trader Activities, Token Trades and Market Behaviour +# Uniswap V4 API - Track Trader Activities, Token Trades and Market Behavior Uniswap v4 introduces a major shift in protocol architecture. Instead of deploying a separate smart contract for each liquidity pool, Uniswap v4 uses a singleton PoolManager contract that manages all pools internally as structured state. diff --git a/docs/blockchain/Solana/Believe-API.md b/docs/blockchain/Solana/Believe-API.md index 46d945e4..95d262e0 100644 --- a/docs/blockchain/Solana/Believe-API.md +++ b/docs/blockchain/Solana/Believe-API.md @@ -1,9 +1,13 @@ +--- +title: "Believe Launchpad API" +description: "Believe Launchpad API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." +--- # Believe Launchpad API import VideoPlayer from "../../../src/components/videoplayer.js"; :::tip Need real-time Believe data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Believe data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Believe data older than ~30 days**, raw per-swap detail, or call / event context. ::: ## 🎯 What is Believe Launchpad? @@ -12,9 +16,9 @@ The Believe Launchpad is a decentralized token launchpad built on the Solana blo ## Related APIs -- **[Meteora Dynamic Bonding Curve API](https://docs.bitquery.io/docs/blockchain/Solana/meteora-dynamic-bonding-curve-api/)** - Core DBC functionality -- **[Moonshot APIs](https://docs.bitquery.io/docs/blockchain/Solana/Moonshot-API/)** - Alternative launchpad -- **[FourMeme APIs](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/)** - BSC-based token creation +- **[Meteora Dynamic Bonding Curve API](/docs/blockchain/Solana/meteora-dynamic-bonding-curve-api/)** - Core DBC functionality +- **[Moonshot APIs](/docs/blockchain/Solana/Moonshot-API/)** - Alternative launchpad +- **[FourMeme APIs](/docs/blockchain/BSC/four-meme-api/)** - BSC-based token creation ## Pro Tips @@ -27,31 +31,6 @@ The Believe Launchpad is a decentralized token launchpad built on the Solana blo `Trade Side Account` field will not be available for aggregate queries in Archive and Combined Datasets ::: - -Believe Launchpad API - Solana | Get Believe Tokens data - - - - - - - - - - - - - - - - If you want fastest data without any latency, we can provide Kafka streams, please [fill this form](https://bitquery.io/forms/api) for it. Our Team will reach out. ## Track Token creation using Believe Launchpad on Meteora DBC in realtime @@ -217,7 +196,7 @@ query MyQuery($tokenAddress: String!) { ## Get the Believe Launchpad tokens which are graduated to Meteora -For checking which Believe tokens graduated, we need to get all the tokens created by Believe on Meteora DBC using this [Get All Token Creations by Believe - API](https://docs.bitquery.io/docs/blockchain/Solana/Believe-API/#get-latest-meteora-dbc-token-creations-using-believe-protocol) and then after getting all the token addresses put them in [Check if the Believe Tokens has Graduated - API](https://ide.bitquery.io/Check-if-the-tokens-have-migrated-from-Meteora-DBC_1) to check which of them graduated to Meteora. +For checking which Believe tokens graduated, we need to get all the tokens created by Believe on Meteora DBC using this [Get All Token Creations by Believe - API](/docs/blockchain/Solana/Believe-API/#get-latest-meteora-dbc-token-creations-using-believe-launchpad) and then after getting all the token addresses put them in [Check if the Believe Tokens has Graduated - API](https://ide.bitquery.io/Check-if-the-tokens-have-migrated-from-Meteora-DBC_1) to check which of them graduated to Meteora. ``` query MyQuery { diff --git a/docs/blockchain/Solana/BonkSwap-API.md b/docs/blockchain/Solana/BonkSwap-API.md index 6876a9f1..bdad7bd5 100644 --- a/docs/blockchain/Solana/BonkSwap-API.md +++ b/docs/blockchain/Solana/BonkSwap-API.md @@ -1,18 +1,21 @@ +--- +title: "Solana Bonkswap API" +description: "Solana Bonkswap API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Includes filters and field selection tips." +--- # BonkSwap API :::tip Need real-time BonkSwap data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered BonkSwap swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical BonkSwap data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered BonkSwap swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical BonkSwap data older than ~30 days**, raw per-swap detail, or call / event context. ::: - In this document, we will explore several examples related to BonkSwap data. -Need zero-latency BonkSwap data? [Read about our Shred Streams and Contact us for a Trial](https://docs.bitquery.io/docs/streams/real-time-solana-data/). +Need zero-latency BonkSwap data? [Read about our Shred Streams and Contact us for a Trial](/docs/streams/real-time-solana-data/). :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: import VideoPlayer from "../../../src/components/videoplayer.js"; @@ -25,29 +28,6 @@ import VideoPlayer from "../../../src/components/videoplayer.js"; - [Get Latest Trades By Trader on BonkSwap](#get-latest-trades-by-trader-on-bonkswap) - [OHLC of a token on BonkSwap](#get-ohlc-for-a-bonkswap-token) - - - - - - - - - - - - - - - - - If you want fastest data without any latency, we can provide Kafka streams, please [fill this form](https://bitquery.io/forms/api) for it. Our Team will reach out. ## BonkSwap Examples @@ -280,5 +260,4 @@ query MyQuery { } } - ``` diff --git a/docs/blockchain/Solana/Boop-Fun-API.md b/docs/blockchain/Solana/Boop-Fun-API.md index fa6e00f4..185b952d 100644 --- a/docs/blockchain/Solana/Boop-Fun-API.md +++ b/docs/blockchain/Solana/Boop-Fun-API.md @@ -1,42 +1,23 @@ +--- +title: "Solana Boop Fun API" +description: "Solana Boop Fun API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." +--- # Boop Fun API import VideoPlayer from "../../../src/components/videoplayer.js"; :::tip Need real-time Boop.fun data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Boop.fun data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Boop.fun data older than ~30 days**, raw per-swap detail, or call / event context. ::: -In this document, we will explore several examples related to Boop fun data. We also have [Raydium Launchpad APIs](https://docs.bitquery.io/docs/blockchain/Solana/launchpad-raydium/). -Additionally, you can also check out our [Moonshot APIs](https://docs.bitquery.io/docs/blockchain/Solana/Moonshot-API/), [FourMeme APIs](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/). +In this document, we will explore several examples related to Boop fun data. We also have [Raydium Launchpad APIs](/docs/blockchain/Solana/launchpad-raydium/). +Additionally, you can also check out our [Moonshot APIs](/docs/blockchain/Solana/Moonshot-API/), [FourMeme APIs](/docs/blockchain/BSC/four-meme-api/). These APIs can be provided through different streams including Kafka for zero latency requirements. Please contact us on [telegram](https://t.me/Bloxy_info). :::note `Trade Side Account` field will not be available for aggregate queries in Archive and Combined Datasets ::: - - - - - - - - - - - - - - - - - If you want fastest data without any latency, we can provide Kafka streams, please [fill this form](https://bitquery.io/forms/api) for it. Our Team will reach out. ## Get the latest Boop.Fun token migrations diff --git a/docs/blockchain/Solana/DEXScreener/solana_dexscreener.mdx b/docs/blockchain/Solana/DEXScreener/solana_dexscreener.mdx index 0e6a818f..11342711 100644 --- a/docs/blockchain/Solana/DEXScreener/solana_dexscreener.mdx +++ b/docs/blockchain/Solana/DEXScreener/solana_dexscreener.mdx @@ -1,7 +1,7 @@ --- sidebar_position: 1 title: "DEXScreener API Documentation - Solana Trades, Pairs, Prices" -description: "DEXScreener API documentation for Solana: get real-time trades, pair data, prices, volumes. Same data as DEXScreener dashboard via GraphQL, WebSocket, and Kafka." +description: "DEXScreener API Documentation - Solana Trades, Pairs, Prices: query and stream Solana on-chain data with Bitquery GraphQL examples for developers." keywords: - DEXScreener API - DEXScreener API documentation @@ -10,29 +10,12 @@ keywords: - DEX pairs API - real-time DEX trades --- - - - - - - - - # DEXScreener API Documentation - Solana Trades, Pairs, Prices Everything you see on the DEXScreener Solana dashboard—live pairs, trades, prices, volumes, makers/buyers/sellers, and more—can be accessed via APIs/Streams with Bitquery. We expose the same on-chain data via GraphQL APIs, real-time WebSocket streams, and enterprise Kafka topics, with optional cloud connectors (AWS, GCP, Snowflake) for analytics pipelines. -Checkout our [DEXScreener EVM API documentation](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/DEXScreener/evm_dexscreener/) if you are interested in getting EVM chains(Ethereum, Binance Smart Chain(BSC), Arbitrum, Base, Matic, Optimism, etc) data which DEXScreener shows. +Checkout our [DEXScreener EVM API documentation](/docs/blockchain/Ethereum/dextrades/DEXScreener/evm_dexscreener/) if you are interested in getting EVM chains(Ethereum, Binance Smart Chain(BSC), Arbitrum, Base, Matic, Optimism, etc) data which DEXScreener shows. ## Bitquery Solana Data Access Options @@ -43,9 +26,9 @@ Checkout our [DEXScreener EVM API documentation](https://docs.bitquery.io/docs/b ## Getting Started with Solana -- **[Solana API Examples](https://docs.bitquery.io/docs/blockchain/Solana/)** - Complete collection of Solana API examples -- **[Solana DEX Trades](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades)** - Real-time DEX trading data and analytics -- **[Solana Subscriptions](https://docs.bitquery.io/docs/subscriptions/subscription)** - Learn how to set up real-time data streams +- **[Solana API Examples](/docs/blockchain/Solana/)** - Complete collection of Solana API examples +- **[Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades)** - Real-time DEX trading data and analytics +- **[Solana Subscriptions](/docs/subscriptions/subscription)** - Learn how to set up real-time data streams - **[IDE for Solana](https://graphql.bitquery.io/ide)** - Interactive development environment for testing Solana queries This guide shows how to retrieve the same Solana DEX data that DEXScreener displays—real-time trades, pair stats, volumes, buyers/sellers, and more—using Bitquery APIs, streams, and Kafka. @@ -347,7 +330,7 @@ query MyQuery { ## Trader-Focused Trade APIs (with USD Price, Market Cap & Supply) -The queries below use the **[Trades cube](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. +The queries below use the **[Trades cube](/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. ### Get All DEX Trades on Solana With Price, Market Cap, and Supply diff --git a/docs/blockchain/Solana/Meteora-DAMM-v2-API.md b/docs/blockchain/Solana/Meteora-DAMM-v2-API.md index d95d09b5..01e111e0 100644 --- a/docs/blockchain/Solana/Meteora-DAMM-v2-API.md +++ b/docs/blockchain/Solana/Meteora-DAMM-v2-API.md @@ -1,12 +1,15 @@ +--- +title: "Solana Meteora Damm V2 API" +description: "Solana Meteora Damm V2 API: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. Keep queries fast with indexed filters." +--- import FAQ from "@site/src/components/FAQ"; # Meteora DAMM v2 API :::tip Need real-time Meteora DAMM v2 data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Meteora DAMM v2 swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Meteora DAMM v2 data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Meteora DAMM v2 swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Meteora DAMM v2 data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Bitquery provides comprehensive real-time and historical data APIs and Streams for the Solana blockchain, enabling developers and traders to build powerful applications and execute trades based on reliable information from Meteora's Dynamic Automated Market Maker (DAMM) v2. ## Meteora DAMM v2 API Guide @@ -17,32 +20,6 @@ In this section we will see how to get data on Meteora DAMM v2 trades in real-ti `Trade Side Account` field will not be available as aggregates in Archive and Combined Datasets ::: - - - - - - - - - - - - - - - - - - - - ## Subscribe to Realtime DAMM v2 Trades This query subscribes to real-time trades on the Meteora DAMM v2 (Dynamic Automated Market Maker) on the Solana blockchain by filtering using the program address `cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG`. @@ -362,11 +339,11 @@ query MyQuery { ## Related Documentation -- [Solana DEX Trades API](https://docs.bitquery.io/docs/blockchain/Solana/dextrades/) -- [Solana Token Holders API](https://docs.bitquery.io/docs/blockchain/Solana/token-holders/) -- [Real-time Solana Data Streams](https://docs.bitquery.io/docs/streams/real-time-solana-data/) -- [GraphQL Reference](https://docs.bitquery.io/docs/graphql-reference/) -- [API Authorization](https://docs.bitquery.io/docs/authorisation/how-to-use/) +- [Solana DEX Trades API](/docs/blockchain/Solana/solana-dextrades/) +- [Solana Token Holders API](/docs/blockchain/Solana/solana-token-holders/) +- [Real-time Solana Data Streams](/docs/streams/real-time-solana-data/) +- [Schema overview](/docs/schema/schema-intro/) +- [API Authorization](/docs/authorization/how-to-use/) ## Support diff --git a/docs/blockchain/Solana/Meteora-DLMM-API.md b/docs/blockchain/Solana/Meteora-DLMM-API.md index 4925fa90..d5b16ba7 100644 --- a/docs/blockchain/Solana/Meteora-DLMM-API.md +++ b/docs/blockchain/Solana/Meteora-DLMM-API.md @@ -1,12 +1,15 @@ +--- +title: "Solana Meteora Dlmm API" +description: "Solana Meteora Dlmm API: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. Covers archive history and realtime data." +--- import FAQ from "@site/src/components/FAQ"; # Meteora DLMM API :::tip Need real-time Meteora DLMM data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Meteora DLMM swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Meteora DLMM data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Meteora DLMM swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Meteora DLMM data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Bitquery provides comprehensive real-time and historical data APIs and Streams for the Solana blockchain, enabling developers and traders to build powerful applications and execute trades based on reliable information from Meteora's Dynamic Liquidity Market Maker (DLMM). ## Meteora DLMM API Guide @@ -17,32 +20,6 @@ In this section we will see how to get data on Meteora DLMM trades in real-time. `Trade Side Account` field will not be available as aggregates in Archive and Combined Datasets ::: - - - - - - - - - - - - - - - - - - - - ## Latest Pool Creation on Meteora DLMM The below query tracks latest pool creation on Meteora DLMM. @@ -354,11 +331,11 @@ query MyQuery { ## Related Documentation -- [Solana DEX Trades API](https://docs.bitquery.io/docs/blockchain/Solana/dextrades/) -- [Solana Token Holders API](https://docs.bitquery.io/docs/blockchain/Solana/token-holders/) -- [Real-time Solana Data Streams](https://docs.bitquery.io/docs/streams/real-time-solana-data/) -- [GraphQL Reference](https://docs.bitquery.io/docs/graphql-reference/) -- [API Authorization](https://docs.bitquery.io/docs/authorisation/how-to-use/) +- [Solana DEX Trades API](/docs/blockchain/Solana/solana-dextrades/) +- [Solana Token Holders API](/docs/blockchain/Solana/solana-token-holders/) +- [Real-time Solana Data Streams](/docs/streams/real-time-solana-data/) +- [Schema overview](/docs/schema/schema-intro/) +- [API Authorization](/docs/authorization/how-to-use/) ## Support diff --git a/docs/blockchain/Solana/Meteora-DYN-API.md b/docs/blockchain/Solana/Meteora-DYN-API.md index 1a43fd3c..8ec6f016 100644 --- a/docs/blockchain/Solana/Meteora-DYN-API.md +++ b/docs/blockchain/Solana/Meteora-DYN-API.md @@ -1,32 +1,15 @@ +--- +title: "Solana Meteora Dyn API" +description: "Solana Meteora Dyn API: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. Keep queries fast with indexed filters." +--- # Meteora API - DYN :::tip Need real-time Meteora DYN data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Meteora DYN swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Meteora DYN data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Meteora DYN swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Meteora DYN data older than ~30 days**, raw per-swap detail, or call / event context. ::: - import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - - - - ## Track Latest created pools on Meteora DYN Below query will give you the latest created Meteora DYN pools in realtime. You can test the query [here](https://ide.bitquery.io/Track-Latest-created-pools-on-MeteoraDYN) diff --git a/docs/blockchain/Solana/Moonshot-API.md b/docs/blockchain/Solana/Moonshot-API.md index b3412884..05552d11 100644 --- a/docs/blockchain/Solana/Moonshot-API.md +++ b/docs/blockchain/Solana/Moonshot-API.md @@ -1,10 +1,14 @@ +--- +title: "Solana Moonshot API" +description: "Solana Moonshot API: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. Copy GraphQL snippets for production apps." +--- # Moonit API :::tip Need real-time Moonit data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Moonit data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Moonit data older than ~30 days**, raw per-swap detail, or call / event context. ::: -In this section we will see how to get real-time data on Moonit trades, transactions and wallet updates. Similarly you can get [pump.fun data here](https://docs.bitquery.io/docs/examples/dextrades/Pump-Fun-API/) +In this section we will see how to get real-time data on Moonit trades, transactions and wallet updates. Similarly you can get [pump.fun data here](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) :::note `Trade Side Account` field will not be available as aggregates in Archive and Combined Datasets @@ -12,29 +16,6 @@ In this section we will see how to get real-time data on Moonit trades, transact import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - - - - ## Moonit Trades in Real-Time The below query gets real-time information whenever there's a new trade on the Moonshot including program method called , buy and sell details, details of the currencies involved, and the transaction specifics like signature. diff --git a/docs/blockchain/Solana/Orbic-API.md b/docs/blockchain/Solana/Orbic-API.md index 44c38c58..f4f03415 100644 --- a/docs/blockchain/Solana/Orbic-API.md +++ b/docs/blockchain/Solana/Orbic-API.md @@ -1,32 +1,15 @@ +--- +title: "Solana Orbic API" +description: "Solana Orbic API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Includes filters and field selection tips." +--- # Orbic API :::tip Need real-time Orbic data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Orbic swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Orbic data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Orbic swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Orbic data older than ~30 days**, raw per-swap detail, or call / event context. ::: - import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - - - - ## Orbic Trades in Real-Time The below query gets real-time information whenever there's a new trade on the Orbic DEX including detailed information about the trade, including the buy and sell details, the block information, and the transaction specifics. diff --git a/docs/blockchain/Solana/Pumpfun/Pump-Fun-API.mdx b/docs/blockchain/Solana/Pumpfun/Pump-Fun-API.mdx index a2f9cc71..674cdaf9 100644 --- a/docs/blockchain/Solana/Pumpfun/Pump-Fun-API.mdx +++ b/docs/blockchain/Solana/Pumpfun/Pump-Fun-API.mdx @@ -1,15 +1,14 @@ --- title: "Pump.fun API - Live Prices, OHLCV, ATH, MarketCap" -description: "Get live Pump.fun token prices, OHLCV, ATH, market cap, and trades via Bitquery's GraphQL API, WebSocket streams, gRPC, or Kafka. Covers new tokens, migrations to PumpSwap, and bonding curve data on Solana." +description: "Pump.fun API - Live Prices, OHLCV, ATH, MarketCap: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams." --- - import VideoPlayer from "../../../../src/components/videoplayer.js"; import FAQ from "@site/src/components/FAQ"; # Pump.fun API - Live Prices, OHLCV, ATH, MarketCap :::tip Need real-time Pump.fun data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Pump.fun examples using `Trading.Trades` are also shown in the **"Trader-Focused Trade APIs"** section below. Use the raw chain-level queries on this page when you need **historical Pump.fun data older than ~30 days**, bonding-curve internals, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Pump.fun examples using `Trading.Trades` are also shown in the **"Trader-Focused Trade APIs"** section below. Use the raw chain-level queries on this page when you need **historical Pump.fun data older than ~30 days**, bonding-curve internals, or call / event context. ::: The Bitquery Pump.fun API provides real-time and historical data for Pump.fun memecoin trades on Solana via GraphQL. Use the API to get live trades, new token launches, OHLCV, bonding curve progress, top traders, and tokens migrated to PumpSwap. Access it via REST, WebSocket subscriptions, gRPC streams, or Kafka, and filter by the program address `6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P`. For other data points, reach out to [support](https://t.me/Bloxy_info). @@ -18,55 +17,22 @@ The Bitquery Pump.fun API provides real-time and historical data for Pump.fun me Want to analyze Pump.fun tokens for potential phishing risks? Check out our [**PumpFun Token Sniffer**](https://pumpfun-token-sniffer.vercel.app/) — a proof-of-concept tool that helps identify suspicious token behavior by analyzing transfers and trades. ::: -Need zero-latency Pump.fun data? [Read about our Shred Streams and contact us for a trial](https://docs.bitquery.io/docs/streams/real-time-solana-data/). For gRPC streaming, see [Pump.fun gRPC Streams →](https://docs.bitquery.io/docs/grpc/solana/examples/pump-fun-grpc-streams/). +Need zero-latency Pump.fun data? [Read about our Shred Streams and contact us for a trial](/docs/streams/real-time-solana-data/). For gRPC streaming, see [Pump.fun gRPC Streams →](/docs/grpc/solana/examples/pump-fun-grpc-streams/). You may also be interested in: -- [LetsBonk.fun APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/letsbonk-api/) -- [PumpSwap APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/pump-swap-api/) -- [Moonshot APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/Moonshot-API/) -- [FourMeme APIs ➤](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/) +- [LetsBonk.fun APIs ➤](/docs/blockchain/Solana/letsbonk-api/) +- [PumpSwap APIs ➤](/docs/blockchain/Solana/Pumpfun/pump-swap-api/) +- [Moonshot APIs ➤](/docs/blockchain/Solana/Moonshot-API/) +- [FourMeme APIs ➤](/docs/blockchain/BSC/four-meme-api/) - [DEXrabbit Pump.fun tokens](https://dexrabbit.bitquery.io/categories/pump-fun) — live multi-chain DEX prices and 24h volume :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - -Pump.fun API - Live Prices, OHLCV, ATH, MarketCap - - - - - - - - - - - - - - - - ## What is the Program Address for Pump.fun on Solana? The Pump.fun program address on Solana mainnet is `6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P`. Use Bitquery's GraphQL API to filter DEX trades, token creation, and bonding curve data by this program ID. @@ -594,7 +560,7 @@ This method reliably identifies whether a token's initial mint followed the Mayh ### How do I get the latest price of a Pump.fun token? -We launched the [Price Index](https://docs.bitquery.io/docs/category/price-index/) in August 2025, allowing you to track price of any token trading onchain. +We launched the [Price Index](/docs/trading/crypto-price-api/) in August 2025, allowing you to track price of any token trading onchain. Here's an example of tracking PumpFun token prices. @@ -936,13 +902,13 @@ query PumpFunRecentTrades { ### How do I get a wallet's PnL on Pump.fun tokens? {#how-do-i-get-a-wallets-pnl-on-pumpfun-tokens} -Bitquery does not return a single “PnL” field for Pump.fun: derive it from **historical buys and sells** for that wallet and mint. Query **`Solana.DEXTrades`** or **`DEXTradeByTokens`** with **`Dex.ProtocolName: pump`**, the token **`MintAddress`**, **`Transaction.Signer`** or buy/sell accounts, and a time window; then compute realized PnL from USD volumes (see the **[Realised PnL example on Solana DEX Trades](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/#realised-pnl-avg-buy-price-buy-volume-sell-volume)** and [starter PnL queries](https://docs.bitquery.io/docs/start/starter-queries/)). Use the **Crypto Price API** if you need mark-to-market for open positions. +Bitquery does not return a single “PnL” field for Pump.fun: derive it from **historical buys and sells** for that wallet and mint. Query **`Solana.DEXTrades`** or **`DEXTradeByTokens`** with **`Dex.ProtocolName: pump`**, the token **`MintAddress`**, **`Transaction.Signer`** or buy/sell accounts, and a time window; then compute realized PnL from USD volumes (see the **[Realised PnL example on Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades/#realised-pnl-avg-buy-price-buy-volume-sell-volume)** and [starter PnL queries](/docs/start/starter-queries/)). Use the **Crypto Price API** if you need mark-to-market for open positions. ## Trade Activity & Volume ### How do I get live trades from Pump.fun using Bitquery? -Use Bitquery's `DEXTrades` GraphQL subscription filtered by `ProtocolName: "pump"` to stream live Pump.fun trades including buy/sell sides, amounts, accounts, and methods. For gRPC or Kafka, see [Pump.fun gRPC Streams](https://docs.bitquery.io/docs/grpc/solana/examples/pump-fun-grpc-streams/). +Use Bitquery's `DEXTrades` GraphQL subscription filtered by `ProtocolName: "pump"` to stream live Pump.fun trades including buy/sell sides, amounts, accounts, and methods. For gRPC or Kafka, see [Pump.fun gRPC Streams](/docs/grpc/solana/examples/pump-fun-grpc-streams/). [Pump.fun real-time trades — Stream ➤](https://ide.bitquery.io/Pumpfun-DEX-Trades-stream)
@@ -1105,7 +1071,7 @@ query MyQuery {
-In addition, you can get the last 7 days of trading volume using the [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/). Example: +In addition, you can get the last 7 days of trading volume using the [Crypto Price API](/docs/trading/crypto-price-api/introduction/). Example: [Last 7 days of volume for any token — Query ➤](https://ide.bitquery.io/Last-7-days-of-volume-for-any-token_2) @@ -2181,7 +2147,7 @@ subscription { ## Trader-Focused Trade APIs (with USD Price, Market Cap & Supply) -The queries below use the **[Trades cube](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. +The queries below use the **[Trades cube](/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. ### Get All DEX Trades on PumpFun With Price, Market Cap, and Supply diff --git a/docs/blockchain/Solana/Pumpfun/Pump-Fun-Marketcap-Bonding-Curve-API.mdx b/docs/blockchain/Solana/Pumpfun/Pump-Fun-Marketcap-Bonding-Curve-API.mdx index 1a5d3ef3..a48620f2 100644 --- a/docs/blockchain/Solana/Pumpfun/Pump-Fun-Marketcap-Bonding-Curve-API.mdx +++ b/docs/blockchain/Solana/Pumpfun/Pump-Fun-Marketcap-Bonding-Curve-API.mdx @@ -1,6 +1,6 @@ --- title: "Pump.fun Marketcap & Bonding Curve API" -description: "Get bonding curve progress, market cap, and migration status for Pump.fun tokens with the Bitquery Pump.fun API — real-time Solana data via GraphQL." +description: "Pump.fun Marketcap & Bonding Curve API: stream Solana market cap, FDV, supply, and price using Bitquery Trading GraphQL APIs." keywords: - Pump.fun API - Pump.fun bonding curve API @@ -9,15 +9,13 @@ keywords: - Solana memecoin API - Bitquery Pump.fun --- - # Pump.fun Marketcap & Bonding Curve API :::tip Need real-time Pump.fun market-cap data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Pump.fun market-cap swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Pump.fun market-cap data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Pump.fun market-cap swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Pump.fun market-cap data older than ~30 days**, raw per-swap detail, or call / event context. ::: - -In this document, we explore examples that retrieve market cap, bonding curve progress, and whether a token has migrated to PumpSwap. The fully exhaustive Pump.fun API documentation is available [here](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/). The Moonshot API is also available — you can access its documentation [here](https://docs.bitquery.io/docs/blockchain/Solana/Moonshot-API/). +In this document, we explore examples that retrieve market cap, bonding curve progress, and whether a token has migrated to PumpSwap. The fully exhaustive Pump.fun API documentation is available [here](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/). The Moonshot API is also available — you can access its documentation [here](/docs/blockchain/Solana/Moonshot-API/). These APIs can also be delivered through different streams, including Kafka, for zero-latency requirements. Please contact us on Telegram. @@ -25,29 +23,6 @@ These APIs can also be delivered through different streams, including Kafka, for The `Trade Side Account` field is not available for aggregate queries in the Archive and Combined datasets. ::: - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../../src/components/videoplayer.js"; ## Get Latest Marketcap of a PumpFun Token @@ -166,7 +141,7 @@ subscription { -You can also use **`TokenSupplyUpdates`** for supply-driven views; see the [token supply cube](https://docs.bitquery.io/docs/blockchain/Solana/token-supply-cube/). +You can also use **`TokenSupplyUpdates`** for supply-driven views; see the [token supply cube](/docs/blockchain/Solana/token-supply-cube/). ## Top Pump.fun tokens by market cap change in the last 1 hour @@ -380,7 +355,6 @@ query { - ## Pumpfun Token Migrations on a specific date - Historical Retrieve Pump.fun token migrations on a specific date. The API returns transfers to the PumpSwap migration receiver address for the given date. @@ -457,7 +431,6 @@ Retrieve Pump.fun token migrations on a specific date. The API returns transfers - ## Check if the Pump Fun Token has migrated to PumpSwap - API To check if a Pump Fun Token has migrated to PumpSwap, we can use the below query. In this query we are checking if this token `6SmgaPU4LMd8eWhamtpTtArr7JYPKZSF8AKK2Uy5pump` has migrated to PumpSwap. You can run the query [here](https://ide.bitquery.io/check-if-a-pump-fun-token-has-migrated_1). @@ -616,7 +589,7 @@ BondingCurveProgress = 100 - (((balance - 206900000) \* 100) / 793100000) - **Balance Retrieval**: - The `balance` is the token balance at the market address. - - Use this query to fetch the balance and then we use `espressions` to calculate the bonding curve progress percentage in the query itself: [Query Link](https://ide.bitquery.io/get-the-bonding-curve-progress-percentage_1). + - Use this query to fetch the balance and then we use `expressions` to calculate the bonding curve progress percentage in the query itself: [Query Link](https://ide.bitquery.io/get-the-bonding-curve-progress-percentage_1).
Click to expand GraphQL query diff --git a/docs/blockchain/Solana/Pumpfun/_category_.json b/docs/blockchain/Solana/Pumpfun/_category_.json index 494f4d47..f9d316a1 100644 --- a/docs/blockchain/Solana/Pumpfun/_category_.json +++ b/docs/blockchain/Solana/Pumpfun/_category_.json @@ -1,7 +1,7 @@ { - "label": "Pumpfun", - "link": { - "type": "doc", - "id": "/index" - } - } \ No newline at end of file + "label": "Pumpfun", + "link": { + "type": "doc", + "id": "blockchain/Solana/Pumpfun/index" + } +} diff --git a/docs/blockchain/Solana/Pumpfun/index.mdx b/docs/blockchain/Solana/Pumpfun/index.mdx index 4e9e2120..92a406fd 100644 --- a/docs/blockchain/Solana/Pumpfun/index.mdx +++ b/docs/blockchain/Solana/Pumpfun/index.mdx @@ -1,7 +1,7 @@ --- title: PumpFun API Documentation -description: Collection of Bitquery's PumpFun APIs on Solana, organized by functionality — trades, prices, OHLCV, bonding curve, market cap, and PumpSwap migration data. -slug: /blockchain/Solana/PumpFun/ +description: "PumpFun API Documentation: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. Great for bots, dashboards, and alerts." +slug: /blockchain/Solana/Pumpfun/ keywords: - PumpFun API - Pump Fun Solana API @@ -14,14 +14,13 @@ keywords: - Best PumpFun API - PumpFun token data API --- - :::tip Need real-time Pump.fun data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Pump.fun and PumpSwap swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Pre-aggregated 1-second OHLC is available via [`Trading.Tokens`](https://docs.bitquery.io/docs/trading/crypto-price-api/tokens) and [`Trading.Pairs`](https://docs.bitquery.io/docs/trading/crypto-price-api/pairs). Use the Pump.fun pages below when you need **historical data older than ~30 days**, bonding-curve internals, or raw on-chain detail. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Pump.fun and PumpSwap swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Pre-aggregated 1-second OHLC is available via [`Trading.Tokens`](/docs/trading/crypto-price-api/tokens) and [`Trading.Pairs`](/docs/trading/crypto-price-api/pairs). Use the Pump.fun pages below when you need **historical data older than ~30 days**, bonding-curve internals, or raw on-chain detail. ::: In this section, we will see how to fetch PumpFun-related data via **Bitquery APIs** and **Streams**. -To get started, [sign up](https://account.bitquery.io/auth/signup?redirect_to=https%3A%2F%2Fide.bitquery.io%2F) with Bitquery and generate your [access token](https://account.bitquery.io/user/api_v2/access_tokens) by following [these steps](https://docs.bitquery.io/docs/authorisation/how-to-generate/). +To get started, [sign up](https://account.bitquery.io/auth/signup?redirect_to=https%3A%2F%2Fide.bitquery.io%2F) with Bitquery and generate your [access token](https://account.bitquery.io/user/api_v2/access_tokens) by following [these steps](/docs/authorization/how-to-generate/). If you need help getting data on PumpFun, reach out to [support](https://t.me/Bloxy_info). @@ -71,29 +70,29 @@ The Bitquery PumpFun APIs are based on GraphQL and are highly flexible. You can - **Data & Protocol**: Provides fully managed Kafka topics—`solana.dextrades.proto`, `solana.tokens.proto`, and `solana.transactions.proto`—delivering pre-parsed, enriched Protocol-Buffers events (DEX trades, token transfers, supply/balance updates, instructions, blocks, etc.). - **Infra & Maintenance**: Enterprise-grade, auto-scaling Kafka streams with sub-second latency, schema-based filtering, instruction-level balance updates, built-in replication/failover—no node ops or custom parsing needed. -Read more [here](https://docs.bitquery.io/docs/streams/real-time-solana-data/) and contact sales via [Telegram](https://t.me/Bloxy_info) or [form](https://bitquery.io/forms/api) for a **Trial**. +Read more [here](/docs/streams/real-time-solana-data/) and contact sales via [Telegram](https://t.me/Bloxy_info) or [form](https://bitquery.io/forms/api) for a **Trial**. ## Does Bitquery support PumpFun WebSockets and Webhooks? -Yes — Bitquery supports both WebSockets and webhooks. You can convert most of the GraphQL APIs into **GraphQL streams** by changing `query` to `subscription` and monitor the data over a WebSocket. More information and [code samples are available here](https://docs.bitquery.io/docs/subscriptions/websockets/). +Yes — Bitquery supports both WebSockets and webhooks. You can convert most of the GraphQL APIs into **GraphQL streams** by changing `query` to `subscription` and monitor the data over a WebSocket. More information and [code samples are available here](/docs/subscriptions/websockets/). ## PumpFun APIs -- [Pump Fun API](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API) -- [Pump Swap API](https://docs.bitquery.io/docs/blockchain/Solana/pump-swap-api) -- [Marketcap Bonding Curve API](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-Marketcap-Bonding-Curve-API) -- [Pump Fun to Pump Swap](https://docs.bitquery.io/docs/blockchain/Solana/pump-fun-to-pump-swap) +- [Pump Fun API](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) +- [Pump Swap API](/docs/blockchain/Solana/Pumpfun/pump-swap-api/) +- [Marketcap Bonding Curve API](/docs/blockchain/Solana/Pumpfun/Pump-Fun-Marketcap-Bonding-Curve-API/) +- [Pump Fun to Pump Swap](/docs/blockchain/Solana/Pumpfun/pump-fun-to-pump-swap/) ## Related Solana APIs -- [Solana Dex Trades](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades) -- [Solana Transactions](https://docs.bitquery.io/docs/blockchain/Solana/solana-transactions) -- [Solana Transfers](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers) -- [Solana Balance Updates](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates) -- [Solana Instructions](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions) -- [Solana Fees API](https://docs.bitquery.io/docs/blockchain/Solana/solana_fees_api) +- [Solana Dex Trades](/docs/blockchain/Solana/solana-dextrades) +- [Solana Transactions](/docs/blockchain/Solana/solana-transactions) +- [Solana Transfers](/docs/blockchain/Solana/solana-transfers) +- [Solana Balance Updates](/docs/blockchain/Solana/solana-balance-updates) +- [Solana Instructions](/docs/blockchain/Solana/solana-instructions) +- [Solana Fees API](/docs/blockchain/Solana/solana_fees_api) -- [Building an AI Trading Agent on Solana](https://docs.bitquery.io/docs/blockchain/Solana/ai-agent-solana-data) +- [Building an AI Trading Agent on Solana](/docs/blockchain/Solana/ai-agent-solana-data) ## Videos diff --git a/docs/blockchain/Solana/Pumpfun/pump-fun-to-pump-swap.md b/docs/blockchain/Solana/Pumpfun/pump-fun-to-pump-swap.md index 9475a526..31dad4d6 100644 --- a/docs/blockchain/Solana/Pumpfun/pump-fun-to-pump-swap.md +++ b/docs/blockchain/Solana/Pumpfun/pump-fun-to-pump-swap.md @@ -1,6 +1,6 @@ --- title: "Pump.fun to PumpSwap API - Token Migration Tracking" -description: "Track the full lifecycle of a Pump.fun token with the Bitquery API: bonding curve progress, graduation events, PumpSwap migrations, and real-time DEX trades on Solana." +description: "Pump.fun to PumpSwap API - Token Migration Tracking: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams." keywords: - Pump.fun API - PumpSwap API @@ -11,14 +11,12 @@ keywords: - real-time Solana DEX API - Bitquery Pump.fun --- - # Understanding Pump.fun: From Launchpad to PumpSwap :::tip Need real-time Pump.fun & PumpSwap data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Pump.fun & PumpSwap swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Pump.fun & PumpSwap data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Pump.fun & PumpSwap swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Pump.fun & PumpSwap data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Pump.fun is a Solana-based memecoin launchpad that has reshaped how tokens are created and traded. At its core is a bonding curve model that lets anyone launch a token with a fixed supply of 1 billion tokens, of which around 800 million are made available for bonding. As traders buy into the curve, the price increases non-linearly—early buyers benefit the most. The bonding curve progress, a very useful metric for developers and traders, can be computed as: @@ -36,28 +34,11 @@ Once a token reaches full bonding (100%), it automatically migrates to PumpSwap, To help developers, traders, and analysts follow this journey, Bitquery offers a comprehensive real-time API suite that spans the entire lifecycle of a Pump.fun token. Let’s walk through it: - - - - - - - - - - - - - - - - - ## Track New Token Creations in Real-Time Every token on Pump.fun starts with a launch event. You can track these launches in real time using a streaming API: -- [Track Pump.fun Token Creations in Real-Time Using a Subscription](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#track-newly-created-pump-fun-tokens) +- [Track Pump.fun Token Creations in Real-Time Using a Subscription](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-get-newly-created-pumpfun-tokens) This API streams metadata such as token name, symbol, mint, creator address, and timestamp the moment a new token is created. @@ -65,11 +46,11 @@ This API streams metadata such as token name, symbol, mint, creator address, and Pump.fun tokens are actively traded as they climb the bonding curve. Traders need up-to-the-second price feeds and trade streams: -- [Track Price of a Token in Real-Time](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#track-price-of-a-token-in-real-time) +- [Track Price of a Token in Real-Time](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-track-the-price-of-a-pumpfun-token-in-real-time) -- [Get Real-Time Trades on Pump Fun](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#get-real-time-trades-on-pump-fun) +- [Get Real-Time Trades on Pump Fun](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-get-live-trades-from-pumpfun-using-bitquery) -- [Get OHLC Data of a Token](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#get-ohlc-data-of-a-token) +- [Get OHLC Data of a Token](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-get-pumpfun-token-ohlcv-data-historically) These APIs provide: @@ -85,13 +66,13 @@ These APIs provide: For deeper insights and analytics, developers can extract: -- [Token Price Change Over Time (Delta from X Minutes Back)](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#token-price-change-over-time-delta-from-x-minutes-back) +- [Token Price Change Over Time (Delta from X Minutes Back)](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-get-token-price-change-over-time-delta-from-x-minutes-back) -- [ATH Market Cap in a Specific Timeframe](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#ath-market-cap-in-a-specific-timeframe) +- [ATH Market Cap in a Specific Timeframe](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-get-a-tokens-all-time-high-ath-price-on-pumpfun) -- [Get Market Cap, Price, Liquidity, Bonding Curve, and Volume](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#get-market-cap-price-liquidity-bonding-curve-and-volume) +- [Get Market Cap, Price, Liquidity, Bonding Curve, and Volume](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-get-bonding-curve-progress-for-a-pumpfun-token) -- [Get Detailed Trade Stats: Volume, Buys, Sells, Makers, Buyers, Sellers](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#get-detailed-trade-stats-volume-buys-sells-makers-buyers-sellers) +- [Get Detailed Trade Stats: Volume, Buys, Sells, Makers, Buyers, Sellers](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-get-detailed-trade-stats-volume-buys-sells-makers-buyers-sellers) These endpoints help answer questions like: @@ -105,11 +86,11 @@ These endpoints help answer questions like: Traders constantly seek trending tokens or insider holds: -- [Top Pump Fun Tokens by Market Cap](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#top-pump-fun-tokens-by-market-cap) +- [Top Pump Fun Tokens by Market Cap](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-get-top-pumpfun-tokens-by-market-cap) -- [Track “King of the Hill” Tokens (30K–35K Market Cap)](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#track-king-of-the-hill-tokens-30k35k-market-cap) +- [Track “King of the Hill” Tokens (30K–35K Market Cap)](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-track-king-of-the-hill-pumpfun-tokens-30k35k-market-cap) -- [Get Dev’s Holdings of a Token](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#get-devs-holdings-of-a-token) +- [Get Dev’s Holdings of a Token](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-get-devs-holdings-of-a-pumpfun-token) These tools surface: @@ -139,13 +120,13 @@ Once graduated: You can track these graduation events in real-time using Bitquery’s API: -- [Track Pump Fun Token Migrations to PumpSwap](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-Marketcap-Bonding-Curve-API/#track-pump-fun-token-migrations-to-pumpswap) +- [Track Pump Fun Token Migrations to PumpSwap](/docs/blockchain/Solana/Pumpfun/Pump-Fun-Marketcap-Bonding-Curve-API/#track-pump-fun-token-migrations-to-pumpswap-in-realtime---subscription) Post-migration, tokens trade as standard AMM pairs. Bitquery continues to offer real-time data support: -- [Latest Trades for a Token on Pumpswap - Websocket](https://docs.bitquery.io/docs/blockchain/Solana/pump-swap-api/#latest-trades-for-a-token-on-pumpswap---websocket) +- [Latest Trades for a Token on Pumpswap - Websocket](/docs/blockchain/Solana/Pumpfun/pump-swap-api/#latest-trades-for-a-token-on-pumpswap---websocket) -- [Get Buy Volume, Sell Volume, Buys, Sells, Makers, Total Trade Volume, Buyers, Sellers of a Specific Token](https://docs.bitquery.io/docs/blockchain/Solana/pump-swap-api/#get-buy-volume-sell-volume-buys-sells-makers-total-trade-volume-buyers-sellers-of-a-specific-token) +- [Get Buy Volume, Sell Volume, Buys, Sells, Makers, Total Trade Volume, Buyers, Sellers of a Specific Token](/docs/blockchain/Solana/Pumpfun/pump-swap-api/#get-buy-volume-sell-volume-buys-sells-makers-total-trade-volume-buyers-sellers-of-a-specific-token) ## Tracking a Pump.fun Token’s Journey with Bitquery Shred Streams @@ -161,7 +142,7 @@ Bitquery offers three main Kafka topics for Solana: - `solana.tokens.proto` — covers token transfers, supply changes, and balance updates at both the account and instruction level - `solana.transactions.proto` — delivers detailed data for blocks, transactions, and instructions -You can find more details about the Solana Shred Streams provided by Bitquery [here](https://docs.bitquery.io/docs/streams/protobuf/chains/Solana-protobuf/) and Python code examples [here](https://docs.bitquery.io/docs/streams/protobuf/kafka-protobuf-python/). +You can find more details about the Solana Shred Streams provided by Bitquery [here](/docs/streams/protobuf/chains/Solana-protobuf/) and Python code examples [here](/docs/streams/protobuf/kafka-protobuf-python/). ## Conclusion diff --git a/docs/blockchain/Solana/Pumpfun/pump-swap-api.md b/docs/blockchain/Solana/Pumpfun/pump-swap-api.md index 344c6ae2..2f1c71f4 100644 --- a/docs/blockchain/Solana/Pumpfun/pump-swap-api.md +++ b/docs/blockchain/Solana/Pumpfun/pump-swap-api.md @@ -1,6 +1,6 @@ --- title: "PumpSwap API - Solana - Tokens, Trades, Live Prices" -description: "Query and stream PumpSwap trades, prices, OHLC, volume, and pool events on Solana with the Bitquery PumpSwap API. Track PumpSwap trades in real time via WebSocket and pull historical data with dataset combined." +description: "PumpSwap API - Solana - Tokens, Trades, Live Prices: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams." keywords: - PumpSwap API - track PumpSwap trades in real time @@ -8,14 +8,12 @@ keywords: - Solana PumpSwap GraphQL - PumpSwap program address --- - # PumpSwap API :::tip Need real-time PumpSwap data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered PumpSwap swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical PumpSwap data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered PumpSwap swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical PumpSwap data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Bitquery’s **PumpSwap API** exposes the PumpSwap AMM on Solana through GraphQL: **live and historical trades**, **prices**, **OHLC**, **volume**, **pool creation**, and **Pump.fun → PumpSwap migrations**. Use **queries** for snapshots, **subscriptions** to track PumpSwap trades in real time, and **`dataset: combined`** when you need more history than **`dataset: realtime`** (~recent window). Filter trades with **`Dex.ProgramAddress: "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA"`**. For live DEX prices across Pump.fun tokens, see [DEXrabbit's Pump.fun category](https://dexrabbit.bitquery.io/categories/pump-fun). For other data points, reach out to [support](https://t.me/Bloxy_info). @@ -23,41 +21,17 @@ For other data points, reach out to [support](https://t.me/Bloxy_info). :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: -- You can also explore [Pump Fun Data documentation ➤](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/) -- Also check out [LetsBonk.fun APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/letsbonk-api/) -- Need zero-latency PumpSwap data? [Read about our Shred Streams and Contact us for a Trial](https://docs.bitquery.io/docs/streams/real-time-solana-data/). +- You can also explore [Pump Fun Data documentation ➤](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) +- Also check out [LetsBonk.fun APIs ➤](/docs/blockchain/Solana/letsbonk-api/) +- Need zero-latency PumpSwap data? [Read about our Shred Streams and Contact us for a Trial](/docs/streams/real-time-solana-data/). Join us on [Telegram](https://t.me/Bloxy_info) for support and integration help. import VideoPlayer from "../../../../src/components/videoplayer.js"; - -PumpSwap API - Solana - Tokens, Trades, Live Prices - - - - - - - - - - - - - - - - ## What is the PumpSwap program address on Solana? {#what-is-the-pumpswap-program-address-on-solana} The PumpSwap AMM program on Solana mainnet is **`pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA`**. Use this value in **`Trade.Dex.ProgramAddress`** or **`Instruction.Program.Address`** filters in Bitquery GraphQL so results are limited to PumpSwap (not other Solana DEXs). @@ -160,7 +134,7 @@ subscription { ## How do I track Pump.fun pool migrations to PumpSwap in real time? {#track-pools-that-are-migrated-to-pumpswap} -Subscribe to **`create_pool`** instructions on the PumpSwap program when they follow a Pump.fun **`migrate`** flow. **`Instruction.Accounts[]`** carries pool and token accounts; argument **`Value`** fields include liquidity added. Pair with the [Pump Fun to PumpSwap](https://docs.bitquery.io/docs/blockchain/Solana/pump-fun-to-pump-swap/) guide for full migration logic. +Subscribe to **`create_pool`** instructions on the PumpSwap program when they follow a Pump.fun **`migrate`** flow. **`Instruction.Accounts[]`** carries pool and token accounts; argument **`Value`** fields include liquidity added. Pair with the [Pump Fun to PumpSwap](/docs/blockchain/Solana/Pumpfun/pump-fun-to-pump-swap/) guide for full migration logic. [Run in Bitquery IDE — Pump.fun → PumpSwap migrations](https://ide.bitquery.io/pumpfun-migration-stream_2#) @@ -1178,7 +1152,7 @@ Use a GraphQL **`subscription`** on **`DEXTrades`** (all PumpSwap trades) or **` ### Why do I only see recent PumpSwap data with `dataset: realtime`? -**`dataset: realtime`** covers a **rolling recent window** (roughly the last several hours of activity). For **full history**, use **`dataset: combined`** (or archive where applicable) on **`Solana`**, as described in [historical aggregate data](https://docs.bitquery.io/docs/blockchain/Solana/historical-aggregate-data/). +**`dataset: realtime`** covers a **rolling recent window** (roughly the last several hours of activity). For **full history**, use **`dataset: combined`** (or archive where applicable) on **`Solana`**, as described in [historical aggregate data](/docs/blockchain/Solana/historical-aggregate-data/). ### Can I run PumpSwap volume or OHLC aggregates as a subscription? @@ -1186,11 +1160,11 @@ Use a GraphQL **`subscription`** on **`DEXTrades`** (all PumpSwap trades) or **` ### Where can I get Pump.fun data before a token moves to PumpSwap? -Use the [Pump.fun API](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/) and [Pump Fun to PumpSwap](https://docs.bitquery.io/docs/blockchain/Solana/pump-fun-to-pump-swap/) guides. This page focuses on **PumpSwap** only after migration. +Use the [Pump.fun API](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) and [Pump Fun to PumpSwap](/docs/blockchain/Solana/Pumpfun/pump-fun-to-pump-swap/) guides. This page focuses on **PumpSwap** only after migration. ## I can only get 8 hours of PumpSwap data with dataset: realtime — how do I get older data? {#pumpswap-realtime-vs-combined-history} -**`dataset: realtime`** on Solana only covers a **rolling recent window** (on the order of **hours**). For **older PumpSwap history**, switch to **`dataset: combined`** or **`dataset: archive`** on your **`Solana { ... }`** query so archive-backed rows are included. See [Historical Solana aggregate data](https://docs.bitquery.io/docs/blockchain/Solana/historical-aggregate-data/) and the **OHLC / volume** examples later on this page. +**`dataset: realtime`** on Solana only covers a **rolling recent window** (on the order of **hours**). For **older PumpSwap history**, switch to **`dataset: combined`** or **`dataset: archive`** on your **`Solana { ... }`** query so archive-backed rows are included. See [Historical Solana aggregate data](/docs/blockchain/Solana/historical-aggregate-data/) and the **OHLC / volume** examples later on this page. --- diff --git a/docs/blockchain/Solana/SolFi-api.md b/docs/blockchain/Solana/SolFi-api.md index 8ab99175..65a2767d 100644 --- a/docs/blockchain/Solana/SolFi-api.md +++ b/docs/blockchain/Solana/SolFi-api.md @@ -1,29 +1,15 @@ +--- +title: "Solana Solfi API" +description: "Solana Solfi API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Keep queries fast with indexed filters." +--- # SolFi DEX API :::tip Need real-time SolFi data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered SolFi swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical SolFi data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered SolFi swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical SolFi data older than ~30 days**, raw per-swap detail, or call / event context. ::: - import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - - - - ## SolFi Trades in Real-Time The below query gets real-time information whenever there's a new trade on the SolFi DEX including detailed information about the trade, including the buy and sell details, the block information, and the transaction specifics. diff --git a/docs/blockchain/Solana/Solana-AldrinAmm-api.md b/docs/blockchain/Solana/Solana-AldrinAmm-api.md index 3e2997e8..64fe8581 100644 --- a/docs/blockchain/Solana/Solana-AldrinAmm-api.md +++ b/docs/blockchain/Solana/Solana-AldrinAmm-api.md @@ -1,10 +1,13 @@ +--- +title: "Solana Aldrinamm API" +description: "Solana Aldrinamm API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Run it in the IDE, then ship in your app." +--- # AldrinAmm DEX API :::tip Need real-time AldrinAmm data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered AldrinAmm swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical AldrinAmm data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered AldrinAmm swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical AldrinAmm data older than ~30 days**, raw per-swap detail, or call / event context. ::: - :::note `Trade Side Account` field will not be available for aggregate queries in Archive and Combined Datasets ::: diff --git a/docs/blockchain/Solana/Solana-DEX-Orders-API.md b/docs/blockchain/Solana/Solana-DEX-Orders-API.md index 1ddd8c4b..e9aa726b 100644 --- a/docs/blockchain/Solana/Solana-DEX-Orders-API.md +++ b/docs/blockchain/Solana/Solana-DEX-Orders-API.md @@ -1,33 +1,17 @@ +--- +title: "Solana DEX Orders API" +description: "Solana DEX Orders API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Scale further with Kafka or gRPC streams." +--- import FAQ from "@site/src/components/FAQ"; # Solana DEX Orders API :::tip Need real-time Solana DEX orders data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Solana DEX orders swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Solana DEX orders data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Solana DEX orders swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Solana DEX orders data older than ~30 days**, raw per-swap detail, or call / event context. ::: - In this section, you'll learn how to access Solana-based decentralized exchange (DEX) trading data using our DEX Orders API. - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Get Solana DEX Orders in Real-Time diff --git a/docs/blockchain/Solana/Solana-DexPools-API.md b/docs/blockchain/Solana/Solana-DexPools-API.md index 8d7c6606..190f00e3 100644 --- a/docs/blockchain/Solana/Solana-DexPools-API.md +++ b/docs/blockchain/Solana/Solana-DexPools-API.md @@ -1,44 +1,18 @@ --- sidebar_position: 2 +title: "Solana DEX Pools API" +description: "Solana DEX Pools API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." --- import FAQ from "@site/src/components/FAQ"; # Solana DEX Pools API :::tip Need real-time Solana DEX pool data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Solana DEX pool swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Solana DEX pool data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Solana DEX pool swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Solana DEX pool data older than ~30 days**, raw per-swap detail, or call / event context. ::: - In this section we will see how to get Solana DEX Pools information using our API. - - - - - - - - - - - - - - - - - - - - - ## Get all Liquidity Pools updates on Solana To get all Liquidity pools updates on solana use [this stream](https://ide.bitquery.io/solana-dex-pools-update-stream). diff --git a/docs/blockchain/Solana/Solana-Jito-Bundle-api.mdx b/docs/blockchain/Solana/Solana-Jito-Bundle-api.mdx index 8a29e45a..0b9269ed 100644 --- a/docs/blockchain/Solana/Solana-Jito-Bundle-api.mdx +++ b/docs/blockchain/Solana/Solana-Jito-Bundle-api.mdx @@ -1,10 +1,13 @@ +--- +title: "Solana Jito Bundle API" +description: "Solana Jito Bundle API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Built for traders and analytics teams." +--- # Jito Bundle API :::tip Need real-time Jito bundle data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Jito bundle swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Jito bundle data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Jito bundle swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Jito bundle data older than ~30 days**, raw per-swap detail, or call / event context. ::: - In this section, we will show you how to access information about Jito Bundles using Bitquery APIs. ## Transfers to the Tip Payment Accounts diff --git a/docs/blockchain/Solana/Solana-Lifinity-dex-api.mdx b/docs/blockchain/Solana/Solana-Lifinity-dex-api.mdx index 73c718f0..e5311435 100644 --- a/docs/blockchain/Solana/Solana-Lifinity-dex-api.mdx +++ b/docs/blockchain/Solana/Solana-Lifinity-dex-api.mdx @@ -1,10 +1,13 @@ +--- +title: "Solana Lifinity DEX API" +description: "Solana Lifinity DEX API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Includes filters and field selection tips." +--- # Lifinity DEX API :::tip Need real-time Lifinity data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Lifinity swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Lifinity data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Lifinity swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Lifinity data older than ~30 days**, raw per-swap detail, or call / event context. ::: - :::note `Trade Side Account` field will not be available for aggregate queries in Archive and Combined Datasets ::: diff --git a/docs/blockchain/Solana/Solana-OpenBook-api.mdx b/docs/blockchain/Solana/Solana-OpenBook-api.mdx index 4996e6c5..b996427e 100644 --- a/docs/blockchain/Solana/Solana-OpenBook-api.mdx +++ b/docs/blockchain/Solana/Solana-OpenBook-api.mdx @@ -1,10 +1,13 @@ +--- +title: "Solana Openbook API" +description: "Solana Openbook API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Scale further with Kafka or gRPC streams." +--- # OpenBook DEX API :::tip Need real-time OpenBook data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered OpenBook swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical OpenBook data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered OpenBook swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical OpenBook data older than ~30 days**, raw per-swap detail, or call / event context. ::: - :::note `Trade Side Account` field will not be available for aggregate queries in Archive and Combined Datasets ::: diff --git a/docs/blockchain/Solana/Solana-Phoenix-api.md b/docs/blockchain/Solana/Solana-Phoenix-api.md index e3f4cd05..9d9f7488 100644 --- a/docs/blockchain/Solana/Solana-Phoenix-api.md +++ b/docs/blockchain/Solana/Solana-Phoenix-api.md @@ -1,29 +1,15 @@ +--- +title: "Solana Phoenix API" +description: "Solana Phoenix API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Includes filters and field selection tips." +--- # Phoenix DEX API :::tip Need real-time Phoenix data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Phoenix swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Phoenix data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Phoenix swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Phoenix data older than ~30 days**, raw per-swap detail, or call / event context. ::: - import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - - - - ## Phoenix Trades in Real-Time The below query gets real-time information whenever there's a new trade on the Phoenix DEX including detailed information about the trade, including the buy and sell details, the block information, and the transaction specifics. diff --git a/docs/blockchain/Solana/Solana-Raydium-DEX-API.mdx b/docs/blockchain/Solana/Solana-Raydium-DEX-API.mdx index 3ab6cbf8..30165c4e 100644 --- a/docs/blockchain/Solana/Solana-Raydium-DEX-API.mdx +++ b/docs/blockchain/Solana/Solana-Raydium-DEX-API.mdx @@ -1,49 +1,24 @@ --- sidebar_position: 7 +title: "Raydium DEX API - Solana Trades, Pools, OHLC" +description: "Raydium DEX API - Solana Trades, Pools, OHLC: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams." --- import FAQ from "@site/src/components/FAQ"; # Raydium DEX API - Solana Trades, Pools, OHLC :::tip Need real-time Raydium data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Raydium swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Raydium data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Raydium swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Raydium data older than ~30 days**, raw per-swap detail, or call / event context. ::: - In this section, we will see how to get Raydium information using Bitquery APIs. -For gRPC streaming of Raydium DEX trades: [Solana gRPC Streams (CoreCast) →](https://docs.bitquery.io/docs/grpc/solana/introduction/) +For gRPC streaming of Raydium DEX trades: [Solana gRPC Streams (CoreCast) →](/docs/grpc/solana/introduction/) :::note `Trade Side Account` field will not be available for aggregate queries in Archive and Combined Datasets ::: - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## New Liquidity Pools Created on Solana Raydium DEX (Using Websocket) @@ -185,7 +160,6 @@ You can run this query using [this link](https://ide.bitquery.io/Specific-pair-c } } - ```
diff --git a/docs/blockchain/Solana/_category_.json b/docs/blockchain/Solana/_category_.json index 7f026966..bb2c5135 100644 --- a/docs/blockchain/Solana/_category_.json +++ b/docs/blockchain/Solana/_category_.json @@ -2,6 +2,6 @@ "label": "Solana", "link": { "type": "doc", - "id": "/index" + "id": "blockchain/Solana/index" } } diff --git a/docs/blockchain/Solana/ai-agent-solana-data.mdx b/docs/blockchain/Solana/ai-agent-solana-data.mdx index 563da7d3..303c04e9 100644 --- a/docs/blockchain/Solana/ai-agent-solana-data.mdx +++ b/docs/blockchain/Solana/ai-agent-solana-data.mdx @@ -1,3 +1,7 @@ +--- +title: "Build AI Trading Agents with Bitquery Solana Data" +description: "Build AI Trading Agents with Bitquery Solana Data: query and stream Solana on-chain data with Bitquery GraphQL examples for developers." +--- # Build AI Trading Agents with Bitquery Solana Data In this section, we will explore how to use **Bitquery APIs and real-time streams** to build AI-enabled trading agents for the **Solana blockchain**. @@ -8,7 +12,6 @@ For **ready-made [OpenClaw](https://openclaw.ai/) skills** that pipe Bitquery We **Your AI Trading Agent's Mission:** - >You are a specialized trading agent operating on the Solana blockchain, you will optimize an existing portfolio by analyzing and trading trending tokens using Bitquery data. Your primary goal is to identify profitable tokens in the market, assess wallet balances, and execute calculated swap decisions to enhance portfolio value. ``` @@ -32,7 +35,7 @@ This is a rough draft of what an AI agent can do using on-chain and off-chain da 2. For each trending token, retrieve detailed information to evaluate its market cap, liquidity, volatility, and security. 3. Check the wallet balance to understand the available assets and decide on a safe percentage to invest. 4. Execute swaps to acquire trending tokens, ensuring the chosen amount. -5. Continuously monitor token performance and adjust holdings to maximize profits. For this you can use [Bitquery Shred Streams](https://docs.bitquery.io/docs/streams/real-time-solana-data/#kafka-stream-by-bitquery) to monitor token prices, new token creation and other activities with sub-second latency. +5. Continuously monitor token performance and adjust holdings to maximize profits. For this you can use [Bitquery Shred Streams](/docs/streams/real-time-solana-data/#kafka-stream-by-bitquery) to monitor token prices, new token creation and other activities with sub-second latency. ## Code Structure and Logic: A Good Starting Point @@ -68,7 +71,7 @@ import VideoPlayer from "../../../src/components/videoplayer.js"; Detect tokens with rising popularity and trader activity. -**Docs:** [Top 10 Trending Solana Tokens](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/#top-10-trending-solana-tokens) +**Docs:** [Top 10 Trending Solana Tokens](/docs/blockchain/Solana/solana-dextrades/#top-50-trending-solana-token-pairs-with-all-the-data)
Click to expand GraphQL query @@ -103,7 +106,7 @@ query TrendingTokens { Evaluate token liquidity to avoid low-volume or illiquid tokens. -**Docs:** [Top Pools based on Liquidity](https://docs.bitquery.io/docs/blockchain/Solana/Solana-DexPools-API/#get-top-pools-based-on-liquidity) +**Docs:** [Top Pools based on Liquidity](/docs/blockchain/Solana/Solana-DexPools-API/#get-top-pools-based-on-liquidity) [Run Query](https://ide.bitquery.io/top-10-liquidity-pools_1) @@ -160,7 +163,7 @@ query GetTopPoolsByDex { You can fetch Marketcap of a token using below query. [Run Query](https://ide.bitquery.io/market-cap-of-token_1) -[Docs](https://docs.bitquery.io/docs/blockchain/Solana/token-supply-cube/#marketcap-of-a-token) +[Docs](/docs/blockchain/Solana/token-supply-cube/#marketcap-of-a-token)
Click to expand GraphQL query @@ -180,7 +183,6 @@ Solana { } } - ```
@@ -191,7 +193,7 @@ Solana { Review current portfolio composition before making swaps. -**Docs:** [Account Balances on Solana](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/#get-all-the-tokens-owned-by-an-address) +**Docs:** [Account Balances on Solana](/docs/blockchain/Solana/solana-balance-updates/#get-all-the-tokens-owned-by-an-address) [Run Query](https://ide.bitquery.io/tokens-owned-by-an-address) @@ -227,7 +229,7 @@ Subscribe to continuous streams of Solana DEX trades for live market intelligenc [Solana Trade Stream Run](https://ide.bitquery.io/solana-trades-subscription_3) -The same stream can be obtained with lower latency via [Kafka containing Solana Shreds](https://docs.bitquery.io/docs/streams/protobuf/chains/Solana-protobuf/). +The same stream can be obtained with lower latency via [Kafka containing Solana Shreds](/docs/streams/protobuf/chains/Solana-protobuf/).
Click to expand GraphQL Stream @@ -371,7 +373,7 @@ Your AI Trading Agent should monitor **bot activity** on DEXs. Bots can cause ** ## Calculating Trading Indicators -You can SMA, EMA, RSI etc with Bitquery data. A tutorial is available [here](https://docs.bitquery.io/docs/usecases/trading-indicators/) +You can SMA, EMA, RSI etc with Bitquery data. A tutorial is available [here](/docs/usecases/trading-indicators/) Your AI Agent can reconstruct price charts and calculate: @@ -401,7 +403,6 @@ Your AI Trading Agent combines the above streams as follows: 5. Execute Swaps on high-potential tokens. 6. Continuously monitor market data and adjust holdings as needed. - ## Next Steps - Integrate these Bitquery APIs into your AI agent. diff --git a/docs/blockchain/Solana/bags-fm-api.md b/docs/blockchain/Solana/bags-fm-api.md index 7e53bcd8..4ce6427c 100644 --- a/docs/blockchain/Solana/bags-fm-api.md +++ b/docs/blockchain/Solana/bags-fm-api.md @@ -1,6 +1,6 @@ --- title: "Bags FM API - Bitquery" -description: "Access real-time Bags FM token data, USD price streams, token transfers, trades, and creation events on Solana. Complete blockchain API for Bags FM with Bitquery's low-latency data." +description: "Bags FM API - Bitquery: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Built for traders and analytics teams." keywords: [ "Bags FM API", @@ -14,11 +14,10 @@ keywords: "Bitquery Bags FM API", ] --- - # Bags FM API Documentation :::tip Need real-time Bags FM data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Bags FM data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Bags FM data older than ~30 days**, raw per-swap detail, or call / event context. ::: Welcome to the **Bags FM API documentation**, powered by **Bitquery blockchain data APIs**. @@ -666,24 +665,24 @@ Track **all transfers of Bags FM tokens** across wallets. This **Bags FM token t The **Bags FM token trades** endpoints aggregate data from multiple Solana DEXs: -- [Meteora API](https://docs.bitquery.io/docs/blockchain/Solana/Meteora-DAMM-v2-API/) -- [Raydium API](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Raydium-DEX-API/) -- [Orca API](https://docs.bitquery.io/docs/blockchain/Solana/solana-orca-dex-api/) -- [Jupiter API](https://docs.bitquery.io/docs/blockchain/Solana/solana-jupiter-api/) -- [PumpFun API](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/) -- [Letsbonk API](https://docs.bitquery.io/docs/blockchain/Solana/letsbonk-api/) +- [Meteora API](/docs/blockchain/Solana/Meteora-DAMM-v2-API/) +- [Raydium API](/docs/blockchain/Solana/Solana-Raydium-DEX-API/) +- [Orca API](/docs/blockchain/Solana/solana-orca-dex-api/) +- [Jupiter API](/docs/blockchain/Solana/solana-jupiter-api/) +- [PumpFun API](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) +- [Letsbonk API](/docs/blockchain/Solana/letsbonk-api/) ## 🔗 Related Solana APIs -- **[Solana Instructions API](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions/)** - Track token creation and burn instructions -- **[Solana DEX Trades API](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/)** - Monitor trading activities across all DEXs -- **[Solana Transfers API](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/)** - Track token transfers and movements -- **[Solana Balance Updates API](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/)** - Monitor balance changes from trades and transfers -- **[Solana Token Supply API](https://docs.bitquery.io/docs/blockchain/Solana/token-supply-cube/)** - Track token supply and creation events +- **[Solana Instructions API](/docs/blockchain/Solana/solana-instructions/)** - Track token creation and burn instructions +- **[Solana DEX Trades API](/docs/blockchain/Solana/solana-dextrades/)** - Monitor trading activities across all DEXs +- **[Solana Transfers API](/docs/blockchain/Solana/solana-transfers/)** - Track token transfers and movements +- **[Solana Balance Updates API](/docs/blockchain/Solana/solana-balance-updates/)** - Monitor balance changes from trades and transfers +- **[Solana Token Supply API](/docs/blockchain/Solana/token-supply-cube/)** - Track token supply and creation events ## Conclusion The **Bags FM API (via Bitquery)** delivers **complete blockchain data access** for Bags FM tokens. -From **token creation** and **supply updates** to **real-time USD prices** through [crypto price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/), **DEX trades**, and **transfers**, it provides everything you need to build apps, dashboards, and trading systems. +From **token creation** and **supply updates** to **real-time USD prices** through [crypto price API](/docs/trading/crypto-price-api/introduction/), **DEX trades**, and **transfers**, it provides everything you need to build apps, dashboards, and trading systems. The **Bitquery Bags FM API** is your comprehensive solution for accessing **Bags FM token data**, **Bags FM token transfers**, **Bags FM token trades**, and **real-time Bags FM price API** streams on the Solana blockchain. diff --git a/docs/blockchain/Solana/byreal-api.md b/docs/blockchain/Solana/byreal-api.md index 277c8447..dfff64c6 100644 --- a/docs/blockchain/Solana/byreal-api.md +++ b/docs/blockchain/Solana/byreal-api.md @@ -1,48 +1,32 @@ +--- +title: "Solana Byreal API" +description: "Solana Byreal API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Covers archive history and realtime data." +--- import FAQ from "@site/src/components/FAQ"; # Byreal API :::tip Need real-time Byreal data or anything from the last ~30 days? -Use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) for swap-level rows and [`Trading.Pairs`](https://docs.bitquery.io/docs/trading/crypto-price-api/pairs) for **OHLC**, **volume**, and **market cap**. Both include **USD price and supply** on every row. For **historical data older than ~30 days** and **historical aggregates** (OHLC, volume, top traders), see [Historical Solana aggregate data](https://docs.bitquery.io/docs/blockchain/Solana/historical-aggregate-data/). +Use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) for swap-level rows and [`Trading.Pairs`](/docs/trading/crypto-price-api/pairs) for **OHLC**, **volume**, and **market cap**. Both include **USD price and supply** on every row. For **historical data older than ~30 days** and **historical aggregates** (OHLC, volume, top traders), see [Historical Solana aggregate data](/docs/blockchain/Solana/historical-aggregate-data/). ::: -Bitquery provides real-time and historical data APIs and streams for **Byreal**, a Solana trading protocol. For **prices, OHLC, volume, market cap, and trader analytics** over the **last ~30 days**, use the [**Crypto Price API**](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) (`Trading.Pairs`) and [**Crypto Trades API**](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) (`Trading.Trades`), filtering by **`Market.Program`** **`REALQqNEomY6cQGZJUGwywTBD2UmDT32rZcNnfxQ5N2`**. +Bitquery provides real-time and historical data APIs and streams for **Byreal**, a Solana trading protocol. For **prices, OHLC, volume, market cap, and trader analytics** over the **last ~30 days**, use the [**Crypto Price API**](/docs/trading/crypto-price-api/introduction/) (`Trading.Pairs`) and [**Crypto Trades API**](/docs/trading/crypto-trades-api/trades-api) (`Trading.Trades`), filtering by **`Market.Program`** **`REALQqNEomY6cQGZJUGwywTBD2UmDT32rZcNnfxQ5N2`**. -For **historical aggregates** going back to **May 2024** — OHLC candlesticks, volume, and time-bucketed analytics on **`DEXTradeByTokens`** with **`dataset: combined`** or **`dataset: archive`** — see [Historical Solana aggregate data](https://docs.bitquery.io/docs/blockchain/Solana/historical-aggregate-data/). Filter those queries by **`Trade.Dex.ProgramAddress`** **`REALQqNEomY6cQGZJUGwywTBD2UmDT32rZcNnfxQ5N2`** for Byreal-specific history. +For **historical aggregates** going back to **May 2024** — OHLC candlesticks, volume, and time-bucketed analytics on **`DEXTradeByTokens`** with **`dataset: combined`** or **`dataset: archive`** — see [Historical Solana aggregate data](/docs/blockchain/Solana/historical-aggregate-data/). Filter those queries by **`Trade.Dex.ProgramAddress`** **`REALQqNEomY6cQGZJUGwywTBD2UmDT32rZcNnfxQ5N2`** for Byreal-specific history. -Need zero-latency Byreal data? [Read about our Shred Streams and Contact us for a Trial](https://docs.bitquery.io/docs/streams/real-time-solana-data/). +Need zero-latency Byreal data? [Read about our Shred Streams and Contact us for a Trial](/docs/streams/real-time-solana-data/). :::note To query or stream data via GraphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - - - - - - - - - - - - - - - - - ## Byreal Trades in Real-Time — Crypto Trades API Stream new Byreal swaps via **`Trading.Trades`** with **USD price**, **market cap**, **FDV**, **supply**, **trader address**, and **transaction metadata** on every row. Filter by **`Pair.Market.Program`** **`REALQqNEomY6cQGZJUGwywTBD2UmDT32rZcNnfxQ5N2`**. -For schema details, see the [**Crypto Trades API**](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) and [**Supply fields**](https://docs.bitquery.io/docs/trading/crypto-price-api/supply-fields). +For schema details, see the [**Crypto Trades API**](/docs/trading/crypto-trades-api/trades-api) and [**Supply fields**](/docs/trading/crypto-price-api/supply-fields). Run the subscription [in the Bitquery IDE](https://ide.bitquery.io/Real-time-trades-on-Byreal-DEX-on-Solana). @@ -184,7 +168,7 @@ subscription { Use **`Trading.Pairs`** with **`Market.Program`** **`REALQqNEomY6cQGZJUGwywTBD2UmDT32rZcNnfxQ5N2`** for aggregated **market cap**, **FDV**, **supply**, **price**, and **volume**. Replace **`solana:`** in **`Token.Id`** with your token. -See the [**Pairs cube**](https://docs.bitquery.io/docs/trading/crypto-price-api/pairs) for full field reference. +See the [**Pairs cube**](/docs/trading/crypto-price-api/pairs) for full field reference. ### Get latest market cap for a specific Byreal token @@ -509,7 +493,7 @@ The **Trading APIs** on this page cover **real-time streams** and roughly the ** For **older Byreal history** and **historical aggregates** — OHLC candlesticks, volume buckets, and time-series analytics from **May 2024** onward — use chain-level queries on **`Solana(dataset: combined)`** or **`Solana(dataset: archive)`** with **`DEXTradeByTokens`**. Filter by **`Trade.Dex.ProgramAddress`** **`REALQqNEomY6cQGZJUGwywTBD2UmDT32rZcNnfxQ5N2`**. -See the full guide with working examples: [Historical Solana aggregate data](https://docs.bitquery.io/docs/blockchain/Solana/historical-aggregate-data/). +See the full guide with working examples: [Historical Solana aggregate data](/docs/blockchain/Solana/historical-aggregate-data/). For a Byreal-specific historical OHLC starting point, try [Byreal historical OHLC — DEXTradeByTokens](https://ide.bitquery.io/Byreal-historical-OHLC-DEXTradeByTokens) in the IDE (uses **`Solana(dataset: combined)`** and **`Trade.Dex.ProgramAddress`** **`REALQqNEomY6cQGZJUGwywTBD2UmDT32rZcNnfxQ5N2`**). @@ -529,10 +513,10 @@ items={[ ## Related Documentation -- [Crypto Trades API](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) -- [Crypto Price API — Pairs](https://docs.bitquery.io/docs/trading/crypto-price-api/pairs) -- [Crypto Price API — OHLC](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api) -- [Traders API](https://docs.bitquery.io/docs/trading/crypto-trades-api/traders-api) -- [Historical Solana aggregate data](https://docs.bitquery.io/docs/blockchain/Solana/historical-aggregate-data/) -- [Real-time Solana Data Streams](https://docs.bitquery.io/docs/streams/real-time-solana-data/) -- [API Authorization](https://docs.bitquery.io/docs/authorisation/how-to-use/) +- [Crypto Trades API](/docs/trading/crypto-trades-api/trades-api) +- [Crypto Price API — Pairs](/docs/trading/crypto-price-api/pairs) +- [Crypto Price API — OHLC](/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api) +- [Traders API](/docs/trading/crypto-trades-api/traders-api) +- [Historical Solana aggregate data](/docs/blockchain/Solana/historical-aggregate-data/) +- [Real-time Solana Data Streams](/docs/streams/real-time-solana-data/) +- [API Authorization](/docs/authorization/how-to-use/) diff --git a/docs/blockchain/Solana/goonfi-api.md b/docs/blockchain/Solana/goonfi-api.md index 5e5f9d4c..adda8698 100644 --- a/docs/blockchain/Solana/goonfi-api.md +++ b/docs/blockchain/Solana/goonfi-api.md @@ -1,32 +1,15 @@ +--- +title: "Solana Goonfi API" +description: "Solana Goonfi API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Covers archive history and realtime data." +--- # GoonFi API :::tip Need real-time GoonFi data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered GoonFi swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical GoonFi data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered GoonFi swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical GoonFi data older than ~30 days**, raw per-swap detail, or call / event context. ::: - import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - - - - ## GoonFi Trades in Real-Time The below query gets real-time information whenever there's a new trade on the GoonFi DEX including detailed information about the trade, including the buy and sell details, the block information, and the transaction specifics. diff --git a/docs/blockchain/Solana/heaven-dex-api.md b/docs/blockchain/Solana/heaven-dex-api.md index 2f5f84ab..c637a223 100644 --- a/docs/blockchain/Solana/heaven-dex-api.md +++ b/docs/blockchain/Solana/heaven-dex-api.md @@ -1,45 +1,25 @@ +--- +title: "Solana Heaven DEX API" +description: "Solana Heaven DEX API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Includes filters and field selection tips." +--- # Heaven DEX API :::tip Need real-time Heaven DEX data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Heaven DEX swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Heaven DEX data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Heaven DEX swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Heaven DEX data older than ~30 days**, raw per-swap detail, or call / event context. ::: - import VideoPlayer from "../../../src/components/videoplayer.js"; -In this document, we will explore several examples related to Heaven Dex. You can also check out our [Pump Fun API Docs](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/) and [FourMeme API Docs](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/). +In this document, we will explore several examples related to Heaven Dex. You can also check out our [Pump Fun API Docs](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) and [FourMeme API Docs](/docs/blockchain/BSC/four-meme-api/). -Need zero-latency Heaven DEX data? [Read about our Shred Streams and Contact us for a Trial](https://docs.bitquery.io/docs/streams/real-time-solana-data/). +Need zero-latency Heaven DEX data? [Read about our Shred Streams and Contact us for a Trial](/docs/streams/real-time-solana-data/). :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - - - - - - - - - - - - - - - - - If you want fastest data without any latency, we can provide Kafka streams, please [fill this form](https://bitquery.io/forms/api) for it. Our Team will reach out. ## Track Heaven DEX Token Creation diff --git a/docs/blockchain/Solana/historical-aggregate-data.mdx b/docs/blockchain/Solana/historical-aggregate-data.mdx index 0eb571b4..453cfcdc 100644 --- a/docs/blockchain/Solana/historical-aggregate-data.mdx +++ b/docs/blockchain/Solana/historical-aggregate-data.mdx @@ -1,20 +1,8 @@ --- -title: "Historical Solana Data API - OHLC, Volume & Aggregate Queries" -description: "Query historical Solana aggregate data via Bitquery V2: OHLC candlesticks, DEX trade volume, and time-series analytics from May 2024. V1 endpoint for full genesis transfers." +title: "Historical Solana Data API" +description: "Historical Solana Data API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Built for traders and analytics teams." keywords: ["historical Solana data", "Solana OHLC API", "Solana archive data", "Solana historical volume", "DEXTradeByTokens", "Solana aggregate API"] --- - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; # Historical Solana Data @@ -25,14 +13,13 @@ However the options to use the historical data are quite limited and currently o **To get historical transfers data going back to genesis of the chain, use the V1 endpoint. Docs available [here](https://docs.bitquery.io/v1/docs/Examples/Solana/transfers).** - :::note `Trade Side Account` field will not be available for aggregate queries in Archive and Combined Datasets ::: ## Historical Trades for Solana -**Historical trades for upto past 30 days could be retrieved via Trading API. Docs available [here](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/).** +**Historical trades for upto past 30 days could be retrieved via Trading API. Docs available [here](/docs/trading/crypto-trades-api/trades-api/).** [This](https://ide.bitquery.io/historical-Solana-trades_1) example showcase how trades for the duration of upto past 30 days could be recieved via trading API. ```graphql @@ -151,7 +138,7 @@ For this example the pair between the tokens listed below is considered. - **Derived from block time**: All time-based grouping (daily, hourly, etc.) depends on block timestamps. -**Alternative approach**: You can get all trades and calculate OHLC locally in your own system. Complete guide [here](https://docs.bitquery.io/docs/usecases/ohlcv-complete-guide/) +**Alternative approach**: You can get all trades and calculate OHLC locally in your own system. Complete guide [here](/docs/usecases/ohlcv-complete-guide/) ::: @@ -325,7 +312,7 @@ query MyQuery { In this query we use the 95th percentile (`level: 0.95`) to find the highest price of a token. We also use `PriceAsymmetry` and `AmountInUSD` in combination to filter outliers as much as possible. -Read more about quantiles [here](https://docs.bitquery.io/docs/graphql/metrics/quantile/) +Read more about quantiles [here](/docs/graphql/metrics/quantile/) You can run the query [here](https://ide.bitquery.io/Price-ATH-query) ``` @@ -580,7 +567,7 @@ That is **not** full ledger genesis history. For **SPL transfers and older histo ## What fields are available in Solana DEXTradeByTokens with dataset: combined? -**`Solana(dataset: combined)`** (and **`archive`**) **`DEXTradeByTokens`** supports **aggregate-friendly** fields: **time / intervals**, **amounts**, **prices**, **trade counts**, **`Trade.Currency`**, **`Trade.Side.Currency`**, **`Dex`**, pool/market identifiers, and similar columns shown in the examples below. **Fine-grained per-account fields** on the trade side (e.g. **`Trade Side Account`**-style projections) are often **unsupported**—the API returns “columns not available.” **Add fields one at a time** in the IDE and rely on the live schema. See [combined vs realtime on Solana](https://docs.bitquery.io/docs/graphql/dataset/combined#why-does-dataset-combined-return-fewer-fields-than-dataset-realtime-on-solana) and [Pump.fun combined note](https://docs.bitquery.io/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#why-does-my-pumpfun-query-return-columns-not-available-in-combined-dataset). +**`Solana(dataset: combined)`** (and **`archive`**) **`DEXTradeByTokens`** supports **aggregate-friendly** fields: **time / intervals**, **amounts**, **prices**, **trade counts**, **`Trade.Currency`**, **`Trade.Side.Currency`**, **`Dex`**, pool/market identifiers, and similar columns shown in the examples below. **Fine-grained per-account fields** on the trade side (e.g. **`Trade Side Account`**-style projections) are often **unsupported**—the API returns “columns not available.” **Add fields one at a time** in the IDE and rely on the live schema. See [combined vs realtime on Solana](/docs/graphql/dataset/combined#why-does-dataset-combined-return-fewer-fields-than-dataset-realtime-on-solana) and [Pump.fun combined note](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#why-does-my-pumpfun-query-return-columns-not-available-in-combined-dataset). ## Video Tutorial for Querying Historical Solana Data diff --git a/docs/blockchain/Solana/index.mdx b/docs/blockchain/Solana/index.mdx index 3b2367b5..e21eecac 100644 --- a/docs/blockchain/Solana/index.mdx +++ b/docs/blockchain/Solana/index.mdx @@ -1,6 +1,6 @@ --- title: "Solana API - DEX Trades, Token Data, Real-Time Streams" -description: "Solana API for DEX trades, token transfers, prices, and real-time data. Pump.fun, Raydium, Meteora, GMGN, Orca. GraphQL, WebSocket, Kafka. Free tier." +description: "Solana API - DEX Trades, Token Data, Real-Time Streams: query and stream Solana on-chain data with Bitquery GraphQL examples for developers." slug: /blockchain/Solana/ keywords: - Solana API @@ -23,13 +23,12 @@ import FAQ from "@site/src/components/FAQ"; # Solana API - DEX Trades, Token Data, Real-Time Streams :::tip Building a trading app or DEX UI on Solana? -For **real-time trades and prices on Solana** (and the last ~30 days), use the curated [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. For **historical Solana data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. +For **real-time trades and prices on Solana** (and the last ~30 days), use the curated [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. For **historical Solana data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. ::: +Access data from **[Pump.fun API](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/)**, **[Raydium DEX API](/docs/blockchain/Solana/Solana-Raydium-DEX-API)**, **[Orca API](/docs/blockchain/Solana/solana-orca-dex-api)**, **[DEXScreener API](/docs/blockchain/Solana/DEXScreener/solana_dexscreener/)**, **[Jupiter API](/docs/blockchain/Solana/solana-jupiter-api)**, **[Meteora](/docs/blockchain/Solana/Meteora-DAMM-v2-API)**, **[GMGN](/docs/blockchain/Solana/solana-gmgn-api)**, **[Phoenix](/docs/blockchain/Solana/Solana-Phoenix-api)**, and more via GraphQL APIs and Streams. -Access data from **[Pump.fun API](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API)**, **[Raydium DEX API](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Raydium-DEX-API)**, **[Orca API](https://docs.bitquery.io/docs/blockchain/Solana/solana-orca-dex-api)**, **[DEXScreener API](https://docs.bitquery.io/docs/examples/dextrades/DEXScreener/solana_dexscreener)**, **[Jupiter API](https://docs.bitquery.io/docs/blockchain/Solana/solana-jupiter-api)**, **[Meteora](https://docs.bitquery.io/docs/blockchain/Solana/Meteora-DAMM-v2-API)**, **[GMGN](https://docs.bitquery.io/docs/blockchain/Solana/solana-gmgn-api)**, **[Phoenix](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Phoenix-api)**, and more via GraphQL APIs and Streams. - -> **Before you start**: Not sure when to use Transfers vs DEX Trades vs other data primitives? Read our [Mental Model guide](https://docs.bitquery.io/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. +> **Before you start**: Not sure when to use Transfers vs DEX Trades vs other data primitives? Read our [Mental Model guide](/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. If you need help getting data on Solana,reach out to [support](https://t.me/Bloxy_info) @@ -67,84 +66,84 @@ Bitquery Solana APIs are very flexible, you can fetch trade, transaction, balanc - **Data & Protocol**: Provides fully managed Kafka topics—`solana.dextrades.proto`, `solana.tokens.proto`, and `solana.transactions.proto`—delivering pre-parsed, enriched Protocol-Buffers events (DEX trades, token transfers, supply/balance updates, instructions, blocks, etc.). - **Infra & Maintenance**: Enterprise-grade, auto-scaling Kafka streams with sub-second latency, schema-based filtering, instruction-level balance updates, built-in replication/failover—no node ops or custom parsing needed. -Read more [here](https://docs.bitquery.io/docs/streams/real-time-solana-data/) and contact sales via [Telegram](https://t.me/Bloxy_info) or [form](https://bitquery.io/forms/api) for a **Trial**. +Read more [here](/docs/streams/real-time-solana-data/) and contact sales via [Telegram](https://t.me/Bloxy_info) or [form](https://bitquery.io/forms/api) for a **Trial**. ## Solana gRPC Streams (CoreCast) -Bitquery **[Solana gRPC Streams](https://docs.bitquery.io/docs/grpc/solana/introduction/)** (CoreCast) provide ultra-low-latency, real-time data over gRPC with protobuf encoding. Subscribe to DEX trades, transfers, transactions, balances, and more with context-aware filtering — ideal for trading bots, copy trading, and high-frequency applications. +Bitquery **[Solana gRPC Streams](/docs/grpc/solana/introduction/)** (CoreCast) provide ultra-low-latency, real-time data over gRPC with protobuf encoding. Subscribe to DEX trades, transfers, transactions, balances, and more with context-aware filtering — ideal for trading bots, copy trading, and high-frequency applications. -- **[CoreCast Introduction](https://docs.bitquery.io/docs/grpc/solana/introduction/)** — Topics, filters, and quick start -- **[Pump.fun gRPC Streams](https://docs.bitquery.io/docs/grpc/solana/examples/pump-fun-grpc-streams/)** — Real-time Pump.fun trades -- **[Copy Trading Bot](https://docs.bitquery.io/docs/grpc/solana/examples/grpc-copy-trading-bot/)** — Build a Solana copy trading bot with gRPC +- **[CoreCast Introduction](/docs/grpc/solana/introduction/)** — Topics, filters, and quick start +- **[Pump.fun gRPC Streams](/docs/grpc/solana/examples/pump-fun-grpc-streams/)** — Real-time Pump.fun trades +- **[Copy Trading Bot](/docs/grpc/solana/examples/grpc-copy-trading-bot/)** — Build a Solana copy trading bot with gRPC ## Does Bitquery support Solana Websocket and Solana Webhooks? -Bitquery supports websocket and webhooks, you can convert most of the graphQL APIs into graphQL streams by changing the word `query` to `subscription`. You can monitor this data via a websocket. More and [code samples available here](https://docs.bitquery.io/docs/subscriptions/websockets/) +Bitquery supports websocket and webhooks, you can convert most of the graphQL APIs into graphQL streams by changing the word `query` to `subscription`. You can monitor this data via a websocket. More and [code samples available here](/docs/subscriptions/websockets/) ## PumpFun - [DEXrabbit Pump.fun tokens](https://dexrabbit.bitquery.io/categories/pump-fun) — live DEX prices and 24h volume -- [Pump Fun API](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API) -- [Pump Swap API](https://docs.bitquery.io/docs/blockchain/Solana/pump-swap-api) -- [Marketcap Bonding Curve API](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-Marketcap-Bonding-Curve-API) -- [Pump Fun to Pump Swap](https://docs.bitquery.io/docs/blockchain/Solana/pump-fun-to-pump-swap) +- [Pump Fun API](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) +- [Pump Swap API](/docs/blockchain/Solana/Pumpfun/pump-swap-api/) +- [Marketcap Bonding Curve API](/docs/blockchain/Solana/Pumpfun/Pump-Fun-Marketcap-Bonding-Curve-API/) +- [Pump Fun to Pump Swap](/docs/blockchain/Solana/Pumpfun/pump-fun-to-pump-swap/) ## Raydium -- [Raydium Launchpad](https://docs.bitquery.io/docs/blockchain/Solana/launchpad-raydium) -- [Raydium DEX API](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Raydium-DEX-API) -- [Raydium CLMM API](https://docs.bitquery.io/docs/blockchain/Solana/raydium-clmm-API) -- [Raydium CPMM API](https://docs.bitquery.io/docs/blockchain/Solana/raydium-cpmm-API) +- [Raydium Launchpad](/docs/blockchain/Solana/launchpad-raydium) +- [Raydium DEX API](/docs/blockchain/Solana/Solana-Raydium-DEX-API) +- [Raydium CLMM API](/docs/blockchain/Solana/raydium-clmm-API) +- [Raydium CPMM API](/docs/blockchain/Solana/raydium-cpmm-API) ## Meteora -- [Meteora DAMM v2 API](https://docs.bitquery.io/docs/blockchain/Solana/Meteora-DAMM-v2-API) -- [Meteora DLMM API](https://docs.bitquery.io/docs/blockchain/Solana/Meteora-DLMM-API) -- [Meteora DYN API](https://docs.bitquery.io/docs/blockchain/Solana/Meteora-DYN-API) -- [Meteora Dynamic Bonding Curve API](https://docs.bitquery.io/docs/blockchain/Solana/meteora-dynamic-bonding-curve-api) +- [Meteora DAMM v2 API](/docs/blockchain/Solana/Meteora-DAMM-v2-API) +- [Meteora DLMM API](/docs/blockchain/Solana/Meteora-DLMM-API) +- [Meteora DYN API](/docs/blockchain/Solana/Meteora-DYN-API) +- [Meteora Dynamic Bonding Curve API](/docs/blockchain/Solana/meteora-dynamic-bonding-curve-api) ## Solana DEX APIs -- [Solana Dex Trades](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades) -- [Solana Trader API](https://docs.bitquery.io/docs/blockchain/Solana/solana-trader-API) -- [Historical Aggregate Data](https://docs.bitquery.io/docs/blockchain/Solana/historical-aggregate-data) -- [Solana Zeta](https://docs.bitquery.io/docs/blockchain/Solana/solana-zeta) -- [Solana Jupiter API](https://docs.bitquery.io/docs/blockchain/Solana/solana-jupiter-api) -- [Solana GMGN API](https://docs.bitquery.io/docs/blockchain/Solana/solana-gmgn-api) -- [Solana BullX API](https://docs.bitquery.io/docs/blockchain/Solana/solana-bullx-api) -- [Solana Photon API](https://docs.bitquery.io/docs/blockchain/Solana/solana-photon-api) -- [Moonshot API](https://docs.bitquery.io/docs/blockchain/Solana/Moonshot-API) -- [Solana Aldrin AMM API](https://docs.bitquery.io/docs/blockchain/Solana/Solana-AldrinAmm-api) -- [Solana DEX Orders API](https://docs.bitquery.io/docs/blockchain/Solana/Solana-DEX-Orders-API) -- [Solana Dex Pools API](https://docs.bitquery.io/docs/blockchain/Solana/Solana-DexPools-API) -- [Solana Jito Bundle API](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Jito-Bundle-api) -- [Solana Lifinity DEX API](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Lifinity-dex-api) -- [Believe API](https://docs.bitquery.io/docs/blockchain/Solana/Believe-API) -- [Solana OpenBook API](https://docs.bitquery.io/docs/blockchain/Solana/Solana-OpenBook-api) -- [Solana Phoenix API](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Phoenix-api) -- [SolFi API](https://docs.bitquery.io/docs/blockchain/Solana/SolFi-api) -- [Orbic API](https://docs.bitquery.io/docs/blockchain/Solana/Orbic-API) -- [DEX Screener (Solana)](https://docs.bitquery.io/docs/examples/dextrades/DEXScreener/solana_dexscreener) +- [Solana Dex Trades](/docs/blockchain/Solana/solana-dextrades) +- [Solana Trader API](/docs/blockchain/Solana/solana-trader-API) +- [Historical Aggregate Data](/docs/blockchain/Solana/historical-aggregate-data) +- [Solana Zeta](/docs/blockchain/Solana/solana-zeta) +- [Solana Jupiter API](/docs/blockchain/Solana/solana-jupiter-api) +- [Solana GMGN API](/docs/blockchain/Solana/solana-gmgn-api) +- [Solana BullX API](/docs/blockchain/Solana/solana-bullx-api) +- [Solana Photon API](/docs/blockchain/Solana/solana-photon-api) +- [Moonshot API](/docs/blockchain/Solana/Moonshot-API) +- [Solana Aldrin AMM API](/docs/blockchain/Solana/Solana-AldrinAmm-api) +- [Solana DEX Orders API](/docs/blockchain/Solana/Solana-DEX-Orders-API) +- [Solana Dex Pools API](/docs/blockchain/Solana/Solana-DexPools-API) +- [Solana Jito Bundle API](/docs/blockchain/Solana/Solana-Jito-Bundle-api) +- [Solana Lifinity DEX API](/docs/blockchain/Solana/Solana-Lifinity-dex-api) +- [Believe API](/docs/blockchain/Solana/Believe-API) +- [Solana OpenBook API](/docs/blockchain/Solana/Solana-OpenBook-api) +- [Solana Phoenix API](/docs/blockchain/Solana/Solana-Phoenix-api) +- [SolFi API](/docs/blockchain/Solana/SolFi-api) +- [Orbic API](/docs/blockchain/Solana/Orbic-API) +- [DEX Screener (Solana)](/docs/blockchain/Solana/DEXScreener/solana_dexscreener/) ## Other Solana APIs -- [Solana Balance Updates](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates) -- [Token Supply Cube](https://docs.bitquery.io/docs/blockchain/Solana/token-supply-cube) -- [Solana Instructions](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions) -- [Solana Transactions](https://docs.bitquery.io/docs/blockchain/Solana/solana-transactions) -- [Solana Transfers](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers) -- [Solana Fees API](https://docs.bitquery.io/docs/blockchain/Solana/solana_fees_api) -- [Boop Fun API](https://docs.bitquery.io/docs/blockchain/Solana/Boop-Fun-API) -- [BonkSwap API](https://docs.bitquery.io/docs/blockchain/Solana/BonkSwap-API) -- [BonkSwap API](https://docs.bitquery.io/docs/blockchain/Solana/letsbonk-api) -- [Solana Logs](https://docs.bitquery.io/docs/blockchain/Solana/solana-logs) -- [Solana NFT](https://docs.bitquery.io/docs/blockchain/Solana/solana-nft) -- [Solana Orca DEX API](https://docs.bitquery.io/docs/blockchain/Solana/solana-orca-dex-api) -- [Solana Rewards](https://docs.bitquery.io/docs/blockchain/Solana/solana-rewards) -- [Solana Search Tokens](https://docs.bitquery.io/docs/blockchain/Solana/solana-search-tokens) +- [Solana Balance Updates](/docs/blockchain/Solana/solana-balance-updates) +- [Token Supply Cube](/docs/blockchain/Solana/token-supply-cube) +- [Solana Instructions](/docs/blockchain/Solana/solana-instructions) +- [Solana Transactions](/docs/blockchain/Solana/solana-transactions) +- [Solana Transfers](/docs/blockchain/Solana/solana-transfers) +- [Solana Fees API](/docs/blockchain/Solana/solana_fees_api) +- [Boop Fun API](/docs/blockchain/Solana/Boop-Fun-API) +- [BonkSwap API](/docs/blockchain/Solana/BonkSwap-API) +- [BonkSwap API](/docs/blockchain/Solana/letsbonk-api) +- [Solana Logs](/docs/blockchain/Solana/solana-logs) +- [Solana NFT](/docs/blockchain/Solana/solana-nft) +- [Solana Orca DEX API](/docs/blockchain/Solana/solana-orca-dex-api) +- [Solana Rewards](/docs/blockchain/Solana/solana-rewards) +- [Solana Search Tokens](/docs/blockchain/Solana/solana-search-tokens) - [Historical Solana Transfer Data](https://docs.bitquery.io/v1/docs/Examples/Solana/transfers) -- [Building an AI Trading Agent on Solana](https://docs.bitquery.io/docs/blockchain/Solana/ai-agent-solana-data) +- [Building an AI Trading Agent on Solana](/docs/blockchain/Solana/ai-agent-solana-data) ## Videos diff --git a/docs/blockchain/Solana/jupiter-studio-api.md b/docs/blockchain/Solana/jupiter-studio-api.md index 2c25697f..b2e85658 100644 --- a/docs/blockchain/Solana/jupiter-studio-api.md +++ b/docs/blockchain/Solana/jupiter-studio-api.md @@ -1,12 +1,11 @@ --- -title: "Jupiter Studio API - Live Token Launches, Trades, OHLC, Migration Data" -description: "Ultra low latency Jupiter Studio launchpad data, token trades, OHLC, migration tracking, and Meteora DBC analytics. Get real-time Jupiter Studio API data for token launches, trading, and migration insights." +title: "Solana Jupiter Studio API" +description: "Solana Jupiter Studio API: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. Covers archive history and realtime data." --- - # Jupiter Studio API - Live Token Launches, Trades, OHLC, Migration Data :::tip Need real-time Jupiter Studio data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Jupiter Studio data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Jupiter Studio data older than ~30 days**, raw per-swap detail, or call / event context. ::: Get ultra low latency Jupiter Studio launchpad data, token trades, OHLC, migration tracking, and Meteora DBC analytics from Jupiter Studio API, Streams and Data Dumps. @@ -14,14 +13,14 @@ Access real-time data for Jupiter Studio token launches, trading activity, migra The below GraphQL APIs and Streams are examples of data points you can get with Bitquery. If you have any question on other data points reach out to [support](https://t.me/Bloxy_info) -Need zero-latency Jupiter Studio data? [Read about our Shred Streams and Contact us for a Trial](https://docs.bitquery.io/docs/streams/real-time-solana-data/). +Need zero-latency Jupiter Studio data? [Read about our Shred Streams and Contact us for a Trial](/docs/streams/real-time-solana-data/). You may also be interested in: -- [Jupiter API ➤](https://docs.bitquery.io/docs/blockchain/Solana/solana-jupiter-api/) -- [Pump.fun APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/) -- [Meteora APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/meteora-api/) -- [Raydium APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/raydium-api/) +- [Jupiter API ➤](/docs/blockchain/Solana/solana-jupiter-api/) +- [Pump.fun APIs ➤](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) +- [Meteora APIs ➤](/docs/blockchain/Solana/meteora-dynamic-bonding-curve-api/) +- [Raydium APIs ➤](/docs/blockchain/Solana/Solana-Raydium-DEX-API/) :::note Jupiter studio tokens are launched and traded on Meteora DBC. So a Jup Studio token follows a lifecycle of a Meteora DBC Token. @@ -30,44 +29,11 @@ Jupiter studio tokens are launched and traded on Meteora DBC. So a Jup Studio to :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: import VideoPlayer from "../../../src/components/videoplayer.js"; - -Jupiter Studio API - Live Token Launches, Trades, OHLC, Migration Data - - - - - - - - - - - - - - - - --- ### Table of Contents diff --git a/docs/blockchain/Solana/launchpad-raydium.md b/docs/blockchain/Solana/launchpad-raydium.md index a30254bd..5a5ee8d7 100644 --- a/docs/blockchain/Solana/launchpad-raydium.md +++ b/docs/blockchain/Solana/launchpad-raydium.md @@ -1,33 +1,19 @@ +--- +title: "Raydium Launchpad API" +description: "Raydium Launchpad API: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. Works with WebSocket live subscriptions." +--- # Raydium Launchpad API :::tip Need real-time Raydium Launchpad data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Raydium Launchpad swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Raydium Launchpad data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Raydium Launchpad swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Raydium Launchpad data older than ~30 days**, raw per-swap detail, or call / event context. ::: - import VideoPlayer from "../../../src/components/videoplayer.js"; -In this section we see how to get data on Launchpad by Raydium. This includes token creation, latest trades by trader, for a token etc. You can also check out our [Pump Fun API Docs](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/) and [LetsBonk.fun API Docs](https://docs.bitquery.io/docs/blockchain/Solana/letsbonk-api/). +In this section we see how to get data on Launchpad by Raydium. This includes token creation, latest trades by trader, for a token etc. You can also check out our [Pump Fun API Docs](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) and [LetsBonk.fun API Docs](/docs/blockchain/Solana/letsbonk-api/). These APIs can be provided through different streams including Kafka for zero latency requirements. Please contact us on telegram. - - - - - - - - - - - - - - - - - ## Latest Pools Created on Launchpad We will use the `PoolCreateEvent` method to filter latest pools on Launchpad. The `Argument` filed includes more information about the pool like `base_mint_param`( token details), `curve_param`( bonding curve details) and `vesting_param` ( cliff period, amount locked etc). Token address is at the 7th entry in Accounts Array. @@ -442,7 +428,7 @@ BondingCurveProgress = 100 - (((balance - 206900000) \* 100) / 793100000) - **Balance Retrieval**: - The `balance` is the token balance at the market address. - - Use this query to fetch the balance and then we use `espressions` to calculate the bonding curve progress percentage in the query itself: [Query Link](https://ide.bitquery.io/bonding-curve-progress-percentage-of-a-letsbonkfun-token). + - Use this query to fetch the balance and then we use `expressions` to calculate the bonding curve progress percentage in the query itself: [Query Link](https://ide.bitquery.io/bonding-curve-progress-percentage-of-a-letsbonkfun-token).
Click to expand GraphQL query @@ -705,7 +691,7 @@ query LatestTrades {
-Similarly, you can subscribe to trades on launchpad in real-time using [subscription query](https://ide.bitquery.io/Subscribe-to-Trades-on-Launchpad). The same can be tracked using [Bitquery Kafka Streams](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) +Similarly, you can subscribe to trades on launchpad in real-time using [subscription query](https://ide.bitquery.io/Subscribe-to-Trades-on-Launchpad). The same can be tracked using [Bitquery Kafka Streams](/docs/streams/kafka-streaming-concepts/) ## Latest Price of a Token on Launchpad diff --git a/docs/blockchain/Solana/letsbonk-api.md b/docs/blockchain/Solana/letsbonk-api.md index 4c49a88c..04315b6d 100644 --- a/docs/blockchain/Solana/letsbonk-api.md +++ b/docs/blockchain/Solana/letsbonk-api.md @@ -1,3 +1,7 @@ +--- +title: "LetsBonk.Fun API - Solana - New Tokens, Trades, Live Prices" +description: "LetsBonk.Fun API - Solana - New Tokens, Trades, Live Prices: query and stream Solana on-chain data with Bitquery GraphQL examples for developers." +--- import FAQ from "@site/src/components/FAQ"; # LetsBonk.Fun API - Solana - New Tokens, Trades, Live Prices @@ -5,47 +9,23 @@ import FAQ from "@site/src/components/FAQ"; import VideoPlayer from "../../../src/components/videoplayer.js"; :::tip Need real-time LetsBonk.fun data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical LetsBonk.fun data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical LetsBonk.fun data older than ~30 days**, raw per-swap detail, or call / event context. ::: -In this document, we will explore several examples related to LetsBonk.fun. You can also check out our [Pump Fun API Docs](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/) and [FourMeme API Docs](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/). For live DEX prices and volume across LetsBonk tokens, see [DEXrabbit's LetsBonk category](https://dexrabbit.bitquery.io/categories/letsbonk-fun-ecosystem). +In this document, we will explore several examples related to LetsBonk.fun. You can also check out our [Pump Fun API Docs](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) and [FourMeme API Docs](/docs/blockchain/BSC/four-meme-api/). For live DEX prices and volume across LetsBonk tokens, see [DEXrabbit's LetsBonk category](https://dexrabbit.bitquery.io/categories/letsbonk-fun-ecosystem). :::note **LetsBonk.fun tokens are created and traded on Raydium Launchlab.** ::: -Need zero-latency LetsBonk.fun data? [Read about our Shred Streams and Contact us for a Trial](https://docs.bitquery.io/docs/streams/real-time-solana-data/). +Need zero-latency LetsBonk.fun data? [Read about our Shred Streams and Contact us for a Trial](/docs/streams/real-time-solana-data/). :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - -LetsBonk.Fun API - Solana - New Tokens, Trades, Live Prices - - - - - - - - - - - - - - - - If you want fastest data without any latency, we can provide Kafka streams, please [fill this form](https://bitquery.io/forms/api) for it. Our Team will reach out. ## Track LetsBonk.fun Token Creation @@ -166,7 +146,7 @@ BondingCurveProgress = 100 - (((balance - 206900000) \* 100) / 793100000) - **Balance Retrieval**: - The `balance` is the token balance at the market address. - - Use this query to fetch the balance and then we use `espressions` to calculate the bonding curve progress percentage in the query itself: [Query Link](https://ide.bitquery.io/bonding-curve-progress-percentage-of-a-letsbonkfun-token). + - Use this query to fetch the balance and then we use `expressions` to calculate the bonding curve progress percentage in the query itself: [Query Link](https://ide.bitquery.io/bonding-curve-progress-percentage-of-a-letsbonkfun-token).
Click to expand GraphQL query @@ -620,7 +600,7 @@ query LatestTrades {
-Similarly, you can subscribe to trades on launchpad in real-time using [subscription query](https://ide.bitquery.io/Subscribe-to-Trades-on-Launchpad). The same can be tracked using [Bitquery Kafka Streams](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) +Similarly, you can subscribe to trades on launchpad in real-time using [subscription query](https://ide.bitquery.io/Subscribe-to-Trades-on-Launchpad). The same can be tracked using [Bitquery Kafka Streams](/docs/streams/kafka-streaming-concepts/) ## Latest Price of a LetsBonk.fun Token on Raydium Lanchlab diff --git a/docs/blockchain/Solana/meteora-dynamic-bonding-curve-api.md b/docs/blockchain/Solana/meteora-dynamic-bonding-curve-api.md index 5e31b669..a882f3c3 100644 --- a/docs/blockchain/Solana/meteora-dynamic-bonding-curve-api.md +++ b/docs/blockchain/Solana/meteora-dynamic-bonding-curve-api.md @@ -1,40 +1,23 @@ +--- +title: "Meteora Dynamic Bonding Curve API" +description: "Meteora Dynamic Bonding Curve API: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. See examples in the Bitquery IDE." +--- # Meteora Dynamic Bonding Curve API :::tip Need real-time Meteora DBC data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Meteora DBC swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Meteora DBC data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Meteora DBC swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Meteora DBC data older than ~30 days**, raw per-swap detail, or call / event context. ::: - In this section we will see some API examples on tracking tokens on Meteora's dynamic bonding curve. :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - - - - ## Meteora DBC Trades in Real-Time The below query gets real-time information whenever there's a new trade on the Meteora DBC including detailed information about the trade, including the buy and sell details, the block information, and the transaction specifics. @@ -698,7 +681,7 @@ query Volatility { ## Trader-Focused Trade APIs (with USD Price, Market Cap & Supply) -The queries below use the **[Trades cube](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. +The queries below use the **[Trades cube](/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. ### Get All DEX Trades on Meteora DBC With Price, Market Cap, and Supply diff --git a/docs/blockchain/Solana/raydium-clmm-API.md b/docs/blockchain/Solana/raydium-clmm-API.md index 232e2612..9ef4a1d1 100644 --- a/docs/blockchain/Solana/raydium-clmm-API.md +++ b/docs/blockchain/Solana/raydium-clmm-API.md @@ -1,12 +1,15 @@ +--- +title: "Solana Raydium Clmm API" +description: "Solana Raydium Clmm API: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. Keep queries fast with indexed filters." +--- import FAQ from "@site/src/components/FAQ"; # Raydium CLMM API :::tip Need real-time Raydium CLMM data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Raydium CLMM swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Raydium CLMM data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Raydium CLMM swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Raydium CLMM data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Bitquery provides comprehensive real-time and historical data APIs and Streams for the Solana blockchain, enabling developers and traders to build powerful applications and execute trades based on reliable information. ## Raydium CLMM API Guide @@ -19,32 +22,6 @@ In this section we will see how to get data on Raydium CLMM trades in real-time. `Trade Side Account` field will not be available as aggregates in Archive and Combined Datasets ::: - - - - - - - - - - - - - - - - - - - - ## Subscribe to Realtime CLMM Trades This query subscribes to real-time trades on the Raydium CLMM (Concentrated Liquidity Market Maker) on the Solana blockchain by filtering using `{Program: {Address: {is: "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK"}}}:`. diff --git a/docs/blockchain/Solana/raydium-cpmm-API.md b/docs/blockchain/Solana/raydium-cpmm-API.md index 88b5b64d..4bc89017 100644 --- a/docs/blockchain/Solana/raydium-cpmm-API.md +++ b/docs/blockchain/Solana/raydium-cpmm-API.md @@ -1,42 +1,19 @@ +--- +title: "Solana Raydium Cpmm API" +description: "Solana Raydium Cpmm API: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. Works with WebSocket live subscriptions." +--- # Raydium CPMM API :::tip Need real-time Raydium CPMM data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Raydium CPMM swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Raydium CPMM data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Raydium CPMM swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Raydium CPMM data older than ~30 days**, raw per-swap detail, or call / event context. ::: - -In this section we will see how to get data on Raydium CPMM trades in real-time. You can check out our [Pump Fun docs](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/), [Raydium v4 docs](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Raydium-DEX-API/) and [Raydium LaunchPad docs](https://docs.bitquery.io/docs/blockchain/Solana/launchpad-raydium/) too. +In this section we will see how to get data on Raydium CPMM trades in real-time. You can check out our [Pump Fun docs](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/), [Raydium v4 docs](/docs/blockchain/Solana/Solana-Raydium-DEX-API/) and [Raydium LaunchPad docs](/docs/blockchain/Solana/launchpad-raydium/) too. :::note `Trade Side Account` field will not be available as aggregates in Archive and Combined Datasets ::: - - - - - - - - - - - - - - - - - - - - ## Subscribe to Realtime CPMM Trades This query subscribes to real-time trades on the Raydium CPMM on the Solana blockchain by filtering using `{Program: {Address: {is: "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C"}}}:`. diff --git a/docs/blockchain/Solana/solana-balance-updates.mdx b/docs/blockchain/Solana/solana-balance-updates.mdx index 674d126e..6c4aeb5f 100644 --- a/docs/blockchain/Solana/solana-balance-updates.mdx +++ b/docs/blockchain/Solana/solana-balance-updates.mdx @@ -1,7 +1,8 @@ --- sidebar_position: 1 +title: "Solana Balance & Balance Updates API" +description: "Solana Balance & Balance Updates API: fetch current and historical Solana balances with Bitquery GraphQL balance queries." --- - # Solana Balance & Balance Updates API In this section we will see how to monitor real-time balance changes across the Solana blockchain using our BalanceUpdates API. @@ -10,38 +11,11 @@ Note - Our [V1 APIs](https://docs.bitquery.io/v1/docs/category/examples) do supp ## 🔗 Related Solana APIs -- **[Solana Transfers API](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/)** - Track transfers that cause balance changes -- **[Solana Instructions API](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions/)** - Monitor instructions that affect balances -- **[Solana DEX Trades API](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/)** - Track trading activities that impact balances -- **[Solana Fees API](https://docs.bitquery.io/docs/blockchain/Solana/solana_fees_api/)** - Analyze fees that reduce balances -- **[Solana Token Supply API](https://docs.bitquery.io/docs/blockchain/Solana/token-supply-cube/)** - Monitor supply changes affecting balances - - - - - - - - - - - - - - - - - - - - - +- **[Solana Transfers API](/docs/blockchain/Solana/solana-transfers/)** - Track transfers that cause balance changes +- **[Solana Instructions API](/docs/blockchain/Solana/solana-instructions/)** - Monitor instructions that affect balances +- **[Solana DEX Trades API](/docs/blockchain/Solana/solana-dextrades/)** - Track trading activities that impact balances +- **[Solana Fees API](/docs/blockchain/Solana/solana_fees_api/)** - Analyze fees that reduce balances +- **[Solana Token Supply API](/docs/blockchain/Solana/token-supply-cube/)** - Monitor supply changes affecting balances import VideoPlayer from "../../../src/components/videoplayer.js"; @@ -49,7 +23,7 @@ import VideoPlayer from "../../../src/components/videoplayer.js"; The below query retrieves the token addresses and their balances owned by a particular account address You can access the query [here](https://ide.bitquery.io/tokens-owned-by-an-address). -For tracking the transfers that cause these balance changes, see our **[Solana Transfers API](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/)**. +For tracking the transfers that cause these balance changes, see our **[Solana Transfers API](/docs/blockchain/Solana/solana-transfers/)**. ``` query MyQuery { @@ -106,7 +80,6 @@ subscription { } } - ``` ## Get Token Holdings and Holding time of an address @@ -298,8 +271,6 @@ subscription { You can use Solana v1 Transfer API to get historical solana balances.https://docs.bitquery.io/v1/docs/Examples/Solana/transfers - - ## Using Pre-Made Aggregates in Solana Balance Updates When querying Solana balance updates, you can use pre-made aggregates to optimize performance. The `aggregates` flag provides three options to control the use of these aggregates: diff --git a/docs/blockchain/Solana/solana-bullx-api.md b/docs/blockchain/Solana/solana-bullx-api.md index 8904ccae..4cc61e04 100644 --- a/docs/blockchain/Solana/solana-bullx-api.md +++ b/docs/blockchain/Solana/solana-bullx-api.md @@ -1,14 +1,14 @@ --- sidebar_position: 1 +title: "Solana Bullx API" +description: "Solana Bullx API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Covers archive history and realtime data." --- - # BullX Solana API :::tip Need real-time BullX-style trader data or anything from the last ~30 days? -For **real-time trader and wallet data over the last ~30 days** across **8 chains in one API**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **`Trader.Address`** as a first-class filter plus **USD price, market cap, and supply on every row**. Use this page when you need **historical BullX-style trader data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time trader and wallet data over the last ~30 days** across **9 chains in one API**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **`Trader.Address`** as a first-class filter plus **USD price, market cap, and supply on every row**. Use this page when you need **historical BullX-style trader data older than ~30 days**, raw per-swap detail, or call / event context. ::: - This section will guide you through different APIs which will tell you how to get data like realtime trades just like how BullX shows for Solana. :::note diff --git a/docs/blockchain/Solana/solana-dextrades.mdx b/docs/blockchain/Solana/solana-dextrades.mdx index 8e241cc8..eb28cf1d 100644 --- a/docs/blockchain/Solana/solana-dextrades.mdx +++ b/docs/blockchain/Solana/solana-dextrades.mdx @@ -1,39 +1,40 @@ --- sidebar_position: 2 +title: "Solana DEX Trades API" +description: "Stream Solana DEX swaps, prices, and OHLC for Raydium, Jupiter, and more using Bitquery GraphQL queries and live streams." --- import FAQ from "@site/src/components/FAQ"; # Solana DEX Trades API :::tip Need real-time Solana DEX data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API** (filter with `Pair.Market.Network: Solana`). Use this page when you need **historical Solana data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API** (filter with `Pair.Market.Network: Solana`). Use this page when you need **historical Solana data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. ::: - Bitquery provides Solana DEX trade data through APIs, Streams, and Data Dumps. -The GraphQL APIs and subscriptions below are examples of the real-time and historical trade data you can access across [Raydium](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Raydium-DEX-API/), [Orca](https://docs.bitquery.io/docs/blockchain/Solana/solana-orca-dex-api/), [Phoenix](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Phoenix-api/), [Meteora](https://docs.bitquery.io/docs/blockchain/Solana/Meteora-DAMM-v2-API/), [Jupiter](https://docs.bitquery.io/docs/blockchain/Solana/solana-jupiter-api/), and other Solana-based DEXs. +The GraphQL APIs and subscriptions below are examples of the real-time and historical trade data you can access across [Raydium](/docs/blockchain/Solana/Solana-Raydium-DEX-API/), [Orca](/docs/blockchain/Solana/solana-orca-dex-api/), [Phoenix](/docs/blockchain/Solana/Solana-Phoenix-api/), [Meteora](/docs/blockchain/Solana/Meteora-DAMM-v2-API/), [Jupiter](/docs/blockchain/Solana/solana-jupiter-api/), and other Solana-based DEXs. -Read [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. +Read [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) to get a better understanding on when to use which cube. If you have questions or need custom data, reach out to [support](https://t.me/Bloxy_info). Need zero-latency Solana DEX trade data? -[Read about our Shred Streams and contact us for a trial ➤](https://docs.bitquery.io/docs/streams/real-time-solana-data/) -For gRPC streaming: [Solana gRPC Streams (CoreCast) →](https://docs.bitquery.io/docs/grpc/solana/introduction/) +[Read about our Shred Streams and contact us for a trial ➤](/docs/streams/real-time-solana-data/) +For gRPC streaming: [Solana gRPC Streams (CoreCast) →](/docs/grpc/solana/introduction/) ## 🔗 Related Solana APIs -- **[Solana Instructions API](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions/)** - Track real-time instructions and token creation events -- **[Solana Balance Updates API](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/)** - Monitor wallet balance changes from trades -- **[Solana Transfers API](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/)** - Track token transfers and movements -- **[Solana Fees API](https://docs.bitquery.io/docs/blockchain/Solana/solana_fees_api/)** - Analyze trading fees and transaction costs -- **[Solana Token Supply API](https://docs.bitquery.io/docs/blockchain/Solana/token-supply-cube/)** - Monitor token supply changes from trading activities +- **[Solana Instructions API](/docs/blockchain/Solana/solana-instructions/)** - Track real-time instructions and token creation events +- **[Solana Balance Updates API](/docs/blockchain/Solana/solana-balance-updates/)** - Monitor wallet balance changes from trades +- **[Solana Transfers API](/docs/blockchain/Solana/solana-transfers/)** - Track token transfers and movements +- **[Solana Fees API](/docs/blockchain/Solana/solana_fees_api/)** - Analyze trading fees and transaction costs +- **[Solana Token Supply API](/docs/blockchain/Solana/token-supply-cube/)** - Monitor token supply changes from trading activities You may also be interested in: -- [PumpSwap APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/pump-swap-api/) -- [Moonshot APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/Moonshot-API/) -- [FourMeme APIs ➤](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/) +- [PumpSwap APIs ➤](/docs/blockchain/Solana/Pumpfun/pump-swap-api/) +- [Moonshot APIs ➤](/docs/blockchain/Solana/Moonshot-API/) +- [FourMeme APIs ➤](/docs/blockchain/BSC/four-meme-api/) - [DEXrabbit Categories](https://dexrabbit.bitquery.io/categories) — curated token groups with live multi-chain DEX prices (memes, LSTs, stablecoins, launchpads) ## How do I get trades made by a specific wallet on a DEX? @@ -42,43 +43,16 @@ Query `Solana.DEXTrades` (or `DEXTradeByTokens`) with `where` on the wallet as * ## How do I get historical OHLCV for a Solana token? {#how-do-i-get-historical-ohlcv-for-a-solana-token} -For **OHLC**, use the **[Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/)** first (`Trading.Tokens` / `Pairs` with **`Token.Network: solana`**) and [second-level OHLC](#solana-second-level-ohlc-k-line-api) on this page when you want **1-second-style** streams. +For **OHLC**, use the **[Crypto Price API](/docs/trading/crypto-price-api/introduction/)** first (`Trading.Tokens` / `Pairs` with **`Token.Network: solana`**) and [second-level OHLC](#solana-second-level-ohlc-k-line-api) on this page when you want **1-second-style** streams. For **historical OHLC** from on-chain DEX trades, use **`Solana(dataset: combined)`** or **`Solana(dataset: archive)`** with **`DEXTradeByTokens`**: filter **`Trade.Currency.MintAddress`** (and usually **`Trade.Side.Currency`** for the quote, e.g. WSOL/USDC), set **`Block.Time`** range, and bucket with **`Block { Time(interval: { count, in: minutes | hours | days }) }`**. Compute OHLC with **`PriceInUSD`** / **`Trade_Price`** minima and maxima or **`median`/`quantile`** as in [Solana OHLC API](#solana-ohlc-api). :::note To query or stream data via GraphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Live DEX swap stream (Solana) {#crypto-trades-live-stream} @@ -165,7 +139,7 @@ subscription { ## Subscribe to Latest Solana Trades {#subscribe-to-latest-solana-trades} -This example uses the chain-specific **DEXTrades** cube via `Solana { DEXTrades }` (good for signer/account filters). USD can be thin on some tokens. For swap rows with stronger USD, use the [stream at the top](#crypto-trades-live-stream). Fees: [Solana Fees API](https://docs.bitquery.io/docs/blockchain/Solana/solana_fees_api/). +This example uses the chain-specific **DEXTrades** cube via `Solana { DEXTrades }` (good for signer/account filters). USD can be thin on some tokens. For swap rows with stronger USD, use the [stream at the top](#crypto-trades-live-stream). Fees: [Solana Fees API](/docs/blockchain/Solana/solana_fees_api/). You can find the query [here](https://ide.bitquery.io/solana-trades-subscription_3) @@ -399,8 +373,6 @@ query MyQuery { } } - - ```
@@ -523,7 +495,6 @@ query MyQuery { } } - ```
@@ -1890,10 +1861,10 @@ Get realised PnL, average buy price, buy volume, and sell volume for a token on ## Solana Second-level OHLC / K-line API {#solana-second-level-ohlc-k-line-api} -For this we will use the new [Crypto Price APIs](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) +For this we will use the new [Crypto Price APIs](/docs/trading/crypto-price-api/introduction/) You can get OHLC data at 1-second intervals via a subscription query, which can then be monitored via a WebSocket. -Below is an example. You can read more on [quantiles here](https://docs.bitquery.io/docs/graphql/metrics/quantile/) +Below is an example. You can read more on [quantiles here](/docs/graphql/metrics/quantile/) Test the subscription query [here](https://ide.bitquery.io/seconds-oHLC-realtime-solana-usd) @@ -2096,7 +2067,7 @@ When querying Solana DEXTradeByTokens, you can use pre-made aggregates to optimi You want to track or filter DEX trades that interacted with a specific Solana program (e.g., one you deployed or are monitoring). -This query uses the [graphQL joins](https://docs.bitquery.io/docs/graphql/capabilities/joins/) feature to join Solana DEX trades with instructions executed by a specific program address. +This query uses the [graphQL joins](/docs/graphql/capabilities/joins/) feature to join Solana DEX trades with instructions executed by a specific program address. Run this query [here](https://ide.bitquery.io/find-all-trades-interacting-with-a-program)
@@ -2301,7 +2272,7 @@ query { ## Trader-Focused Trade APIs (with USD Price, Market Cap & Supply) -The queries below use the **[Trades cube](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. +The queries below use the **[Trades cube](/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. ### Get All DEX Trades on Solana With Price, Market Cap, and Supply diff --git a/docs/blockchain/Solana/solana-geckoterminal-api.md b/docs/blockchain/Solana/solana-geckoterminal-api.md index 25abbb75..649ce4ef 100644 --- a/docs/blockchain/Solana/solana-geckoterminal-api.md +++ b/docs/blockchain/Solana/solana-geckoterminal-api.md @@ -1,13 +1,14 @@ --- sidebar_position: 1 +title: "GeckoTerminal Solana API" +description: "GeckoTerminal Solana API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." --- - # GeckoTerminal Solana API Everything you see on the GeckoTerminal Solana dashboard—live pairs, trades, prices, volumes, makers/buyers/sellers, and more—can be accessed via APIs/Streams with Bitquery. We expose the same on-chain data via GraphQL APIs, real-time WebSocket streams, and enterprise Kafka topics, with optional cloud connectors (AWS, GCP, Snowflake) for analytics pipelines. -Checkout our [GeckoTerminal EVM API documentation](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/evm-geckoterminal-api/) if you are interested in getting EVM chains(Ethereum, Binance Smart Chain(BSC), Arbitrum, Base, Matic, Optimism, etc) data which GeckoTerminal shows. +Checkout our [GeckoTerminal EVM API documentation](/docs/blockchain/Ethereum/dextrades/evm-geckoterminal-api/) if you are interested in getting EVM chains(Ethereum, Binance Smart Chain(BSC), Arbitrum, Base, Matic, Optimism, etc) data which GeckoTerminal shows. ## Bitquery Solana Data Access Options @@ -20,32 +21,13 @@ import VideoPlayer from "../../../src/components/videoplayer.js"; ## Getting Started with Solana -- **[Solana API Examples](https://docs.bitquery.io/docs/blockchain/Solana/)** - Complete collection of Solana API examples -- **[Solana DEX Trades](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades)** - Real-time DEX trading data and analytics -- **[Solana Subscriptions](https://docs.bitquery.io/docs/subscriptions/subscription)** - Learn how to set up real-time data streams +- **[Solana API Examples](/docs/blockchain/Solana/)** - Complete collection of Solana API examples +- **[Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades)** - Real-time DEX trading data and analytics +- **[Solana Subscriptions](/docs/subscriptions/subscription)** - Learn how to set up real-time data streams - **[IDE for Solana](https://graphql.bitquery.io/ide)** - Interactive development environment for testing Solana queries This guide shows how to retrieve the same Solana DEX data that GeckoTerminal displays—real-time trades, pair stats, volumes, buyers/sellers, and more—using Bitquery APIs, streams, and Kafka. - - - - - - - - - - - - - - - - - - - ## Get Trade Transactions of GeckoTerminal for a particular pair in realtime The query will subscribe you to real-time trade transactions for a Solana pair, providing a continuous stream of data as new trades are processed and recorded. @@ -252,4 +234,4 @@ query MyQuery { ### Get Gecko Terminal Data with Bitquery API and Streams - \ No newline at end of file + diff --git a/docs/blockchain/Solana/solana-gmgn-api.md b/docs/blockchain/Solana/solana-gmgn-api.md index a3d70500..11910922 100644 --- a/docs/blockchain/Solana/solana-gmgn-api.md +++ b/docs/blockchain/Solana/solana-gmgn-api.md @@ -1,6 +1,6 @@ --- -title: "GMGN Solana API | Trending Tokens, Pair Stats, Live DEX Trades" -description: "GMGN-style Solana data via Bitquery: trending tokens, top pairs, buy/sell volume and makers, live pair trades, OHLC charts, and volume leaders—GraphQL queries and WebSocket streams for Raydium and Solana DEXs." +title: "GMGN Solana API | Trending Tokens" +description: "GMGN Solana API | Trending Tokens: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." keywords: - GMGN Solana API - Solana DEX screener API @@ -20,10 +20,9 @@ import FAQ from "@site/src/components/FAQ"; # GMGN Solana API :::tip Need real-time GMGN-style trader data or anything from the last ~30 days? -For **real-time trader and wallet data over the last ~30 days** across **8 chains in one API**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **`Trader.Address`** as a first-class filter plus **USD price, market cap, and supply on every row**. Use this page when you need **historical GMGN-style trader data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time trader and wallet data over the last ~30 days** across **9 chains in one API**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **`Trader.Address`** as a first-class filter plus **USD price, market cap, and supply on every row**. Use this page when you need **historical GMGN-style trader data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Replicate **GMGN**-style **Solana** analytics with Bitquery: **trending tokens**, **top DEX pairs**, **aggregate stats** (buys, sells, buy/sell volume, makers, buyers, sellers), **live trades per pair**, **OHLC** for charts, **volume by token**, and **top traded pairs**. Uses **`DEXTradeByTokens`** and **`Solana`** GraphQL—some patterns work as **queries** only when they rely on heavy aggregates (see notes below). :::note @@ -32,19 +31,6 @@ Replicate **GMGN**-style **Solana** analytics with Bitquery: **trending tokens** import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - ## Related APIs - **[GMGN API for Ethereum & EVM](/docs/blockchain/Ethereum/dextrades/evm-gmgn-api)** — **GMGN**-style **trending pairs**, token stats, **OHLC**, and **liquidity** on **Ethereum** and other **EVM** chains. diff --git a/docs/blockchain/Solana/solana-instruction-balance-updates.md b/docs/blockchain/Solana/solana-instruction-balance-updates.md index 64526afe..8b7e436c 100644 --- a/docs/blockchain/Solana/solana-instruction-balance-updates.md +++ b/docs/blockchain/Solana/solana-instruction-balance-updates.md @@ -1,36 +1,10 @@ --- sidebar_position: 3 +title: "Solana Instructions Balance Updates API" +description: "Solana Instructions Balance Updates API: fetch current and historical Solana balances with Bitquery GraphQL balance queries." --- - # Solana Instructions Balance Updates API - - - - - - - - - - - - - - - - - - - - - ## Latest Solana Instructions Balance Updates The query below gives you balance update associated with a instruction invocation. diff --git a/docs/blockchain/Solana/solana-instructions.mdx b/docs/blockchain/Solana/solana-instructions.mdx index 3eea027e..78f82e6d 100644 --- a/docs/blockchain/Solana/solana-instructions.mdx +++ b/docs/blockchain/Solana/solana-instructions.mdx @@ -1,36 +1,10 @@ --- sidebar_position: 3 +title: "Solana Instructions API" +description: "Solana Instructions API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Great for bots, dashboards, and alerts." --- - # Solana Instructions API - - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Overview @@ -47,11 +21,11 @@ The **Solana Instructions API** provides comprehensive access to decoded instruc ## 🔗 Related APIs -- **[Solana Balance Updates API](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/)** - Monitor real-time balance changes -- **[Solana Token Supply API](https://docs.bitquery.io/docs/blockchain/Solana/token-supply-cube/)** - Track token supply and creation events -- **[Solana DEX Trades API](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/)** - Monitor trading activities across DEXs -- **[Solana Transfers API](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/)** - Track token transfers and movements -- **[Solana Fees API](https://docs.bitquery.io/docs/blockchain/Solana/solana_fees_api/)** - Analyze transaction fees and costs +- **[Solana Balance Updates API](/docs/blockchain/Solana/solana-balance-updates/)** - Monitor real-time balance changes +- **[Solana Token Supply API](/docs/blockchain/Solana/token-supply-cube/)** - Track token supply and creation events +- **[Solana DEX Trades API](/docs/blockchain/Solana/solana-dextrades/)** - Monitor trading activities across DEXs +- **[Solana Transfers API](/docs/blockchain/Solana/solana-transfers/)** - Track token transfers and movements +- **[Solana Fees API](/docs/blockchain/Solana/solana_fees_api/)** - Analyze transaction fees and costs --- @@ -59,7 +33,7 @@ The **Solana Instructions API** provides comprehensive access to decoded instruc The subscription below fetches the latest instructions executed on the Solana blockchain, including details like indices of preceding instructions, signer information, transaction signatures, balance updates, and program details. -For monitoring the balance changes that result from these instructions, see our **[Solana Balance Updates API](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/)**. +For monitoring the balance changes that result from these instructions, see our **[Solana Balance Updates API](/docs/blockchain/Solana/solana-balance-updates/)**. You can run the query [here](https://ide.bitquery.io/Latest-Solana-Instructions) @@ -318,7 +292,6 @@ query MyQuery { } } - ``` ## Get Buyevent instruction details @@ -532,7 +505,7 @@ You can run the query [here](https://ide.bitquery.io/solana-balance-updates-exec You can also track real-time token burn using the TokenSupplyUpdates API. Check out the [following example](https://ide.bitquery.io/token-burn-example-solana). -For more comprehensive token supply tracking, see our **[Solana Token Supply API](https://docs.bitquery.io/docs/blockchain/Solana/token-supply-cube/)** documentation. +For more comprehensive token supply tracking, see our **[Solana Token Supply API](/docs/blockchain/Solana/token-supply-cube/)** documentation. ```graphql { diff --git a/docs/blockchain/Solana/solana-jupiter-api.mdx b/docs/blockchain/Solana/solana-jupiter-api.mdx index 46a0d379..8e739b64 100644 --- a/docs/blockchain/Solana/solana-jupiter-api.mdx +++ b/docs/blockchain/Solana/solana-jupiter-api.mdx @@ -1,6 +1,6 @@ --- -title: "Solana Jupiter API - Live Swaps, Limit Orders, DEX Aggregator Data" -description: "Ultra low latency Jupiter DEX Aggregator swaps, limit orders, routing data, and trading analytics. Get real-time Jupiter API data for Solana token swaps, routing, and DEX aggregator insights." +title: "Solana Jupiter API" +description: "Solana Jupiter API: real-time Solana memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. Includes filters and field selection tips." sidebar_position: 7 --- import FAQ from "@site/src/components/FAQ"; @@ -8,62 +8,28 @@ import FAQ from "@site/src/components/FAQ"; # Solana Jupiter API - Live Swaps, Limit Orders, DEX Aggregator Data :::tip Need real-time Jupiter data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Jupiter swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Jupiter data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Jupiter swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Jupiter data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Get ultra low latency Jupiter DEX Aggregator swaps, limit orders, routing data, and trading analytics from Jupiter API, Streams and Data Dumps. The below GraphQL APIs and Streams are examples of data points you can get with Bitquery. If you have any question on other data points reach out to [support](https://t.me/Bloxy_info) -Need zero-latency Jupiter data? [Read about our Shred Streams and Contact us for a Trial](https://docs.bitquery.io/docs/streams/real-time-solana-data/). +Need zero-latency Jupiter data? [Read about our Shred Streams and Contact us for a Trial](/docs/streams/real-time-solana-data/). You may also be interested in: -- [Pump.fun APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/) -- [Raydium APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/raydium-api/) -- [Orca APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/orca-api/) -- [Serum APIs ➤](https://docs.bitquery.io/docs/blockchain/Solana/serum-api/) +- [Pump.fun APIs ➤](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) +- [Raydium APIs ➤](/docs/blockchain/Solana/Solana-Raydium-DEX-API/) +- [Orca APIs ➤](/docs/blockchain/Solana/solana-orca-dex-api/) +- [Serum APIs ➤](/docs/blockchain/Solana/Solana-OpenBook-api/) :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - -Jupiter API - Live Swaps, Limit Orders, DEX Aggregator Data - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; --- diff --git a/docs/blockchain/Solana/solana-logs.md b/docs/blockchain/Solana/solana-logs.md index ca5ffaac..d686e398 100644 --- a/docs/blockchain/Solana/solana-logs.md +++ b/docs/blockchain/Solana/solana-logs.md @@ -1,9 +1,11 @@ +--- +title: "Solana Logs API" +description: "Solana Logs: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Covers archive history and realtime data." +--- # Solana Logs API Solana Logs API helps you filter program instruction logs using regular expressions. - - # Finding Instructions with Log Matching The Solana Logs API allows you to search for specific instructions based on log content that matches exact phrases. For example, to find logs related to 'AnchorError' with a specific error code and message @@ -153,4 +155,4 @@ You can run the query [here](https://ide.bitquery.io/Solana-Zeta-Market-logs) } } } -``` \ No newline at end of file +``` diff --git a/docs/blockchain/Solana/solana-manifest-api.md b/docs/blockchain/Solana/solana-manifest-api.md index 0aa4e9ca..7bf5c6d0 100644 --- a/docs/blockchain/Solana/solana-manifest-api.md +++ b/docs/blockchain/Solana/solana-manifest-api.md @@ -1,12 +1,15 @@ +--- +title: "Solana Manifest API" +description: "Solana Manifest API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." +--- import VideoPlayer from "../../../src/components/videoplayer.js"; # Manifest DEX API :::tip Need real-time Manifest data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Manifest swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Manifest data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Manifest swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Manifest data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Track real-time trades, token prices, OHLC data, top traders, and trading volume on **Manifest** DEX on Solana using Bitquery's GraphQL API. Filter by `Dex: { ProtocolFamily: { is: "Manifest" } }` to get Manifest-only data. :::note diff --git a/docs/blockchain/Solana/solana-nft.mdx b/docs/blockchain/Solana/solana-nft.mdx index 29793557..e1e94d74 100644 --- a/docs/blockchain/Solana/solana-nft.mdx +++ b/docs/blockchain/Solana/solana-nft.mdx @@ -1,40 +1,12 @@ --- sidebar_position: 4 +title: "Solana NFT API" +description: "Solana NFT API: track Solana NFT trades, ownership, and metadata with Bitquery GraphQL and streams. Covers archive history and realtime data." --- - # Solana NFT API In this section we'll have a look at some examples using the Solana NFT API. - - - - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Track Latest NFT Trades @@ -98,8 +70,6 @@ subscription { } } - - ``` ## Get Most Traded NFTs Recently diff --git a/docs/blockchain/Solana/solana-orca-dex-api.mdx b/docs/blockchain/Solana/solana-orca-dex-api.mdx index 90180f2b..28b9e6e7 100644 --- a/docs/blockchain/Solana/solana-orca-dex-api.mdx +++ b/docs/blockchain/Solana/solana-orca-dex-api.mdx @@ -1,44 +1,22 @@ --- sidebar_position: 7 +title: "Solana Orca DEX API" +description: "Solana Orca DEX API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." --- import FAQ from "@site/src/components/FAQ"; # Orca DEX API :::tip Need real-time Orca data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Orca swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Orca data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Orca swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Orca data older than ~30 days**, raw per-swap detail, or call / event context. ::: - In this section, we'll show you how to access information about Orca DEX data using Bitquery APIs. :::note `Trade Side Account` field will not be available for aggregate queries in Archive and Combined Datasets ::: - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Latest Pools Created On Orca @@ -319,7 +297,6 @@ subscription{ } } - ``` ## Orca OHLC APIs diff --git a/docs/blockchain/Solana/solana-photon-api.md b/docs/blockchain/Solana/solana-photon-api.md index 1cf68b34..30c95512 100644 --- a/docs/blockchain/Solana/solana-photon-api.md +++ b/docs/blockchain/Solana/solana-photon-api.md @@ -1,15 +1,16 @@ --- sidebar_position: 1 +title: "Solana Photon API" +description: "Solana Photon API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Keep queries fast with indexed filters." --- import FAQ from "@site/src/components/FAQ"; # Photon Solana API :::tip Need real-time Photon-style trader data or anything from the last ~30 days? -For **real-time trader and wallet data over the last ~30 days** across **8 chains in one API**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **`Trader.Address`** as a first-class filter plus **USD price, market cap, and supply on every row**. Use this page when you need **historical Photon-style trader data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time trader and wallet data over the last ~30 days** across **9 chains in one API**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **`Trader.Address`** as a first-class filter plus **USD price, market cap, and supply on every row**. Use this page when you need **historical Photon-style trader data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Photon is a routing aggregator on Solana that finds the best execution paths across multiple DEXs. To identify trades that were routed through Photon, we use their program address `BSfD6SHZigAfDWSjzD5Q41jw8LmKwtmjskPH9XW1mrRW` in our queries. This program address appears in the instruction data when Photon routes a trade, allowing us to filter and analyze only the trades that went through their routing system. By joining DEX trade data with instruction data containing this program address, we can accurately track Photon's routing activity and provide insights into their trade execution patterns. @@ -21,7 +22,7 @@ This program address appears in the instruction data when Photon routes a trade, ## Latest Trades Routed via Photon This query retrieves the latest 100 trades that were routed through Photon on Solana. -The query uses a `joinInstructions` function to filter trades that specifically involved Photon's routing program (address: `BSfD6SHZigAfDWSjzD5Q41jw8LmKwtmjskPH9XW1mrRW`). For more information about using joins in Bitquery APIs, see our [graphQL joins documentation](https://docs.bitquery.io/docs/graphql/joins/). +The query uses a `joinInstructions` function to filter trades that specifically involved Photon's routing program (address: `BSfD6SHZigAfDWSjzD5Q41jw8LmKwtmjskPH9XW1mrRW`). For more information about using joins in Bitquery APIs, see our [graphQL joins documentation](/docs/graphql/capabilities/joins/). [Run Query](https://ide.bitquery.io/Trades-Executed-on-Photon) @@ -84,7 +85,6 @@ The query uses a `joinInstructions` function to filter trades that specifically } } - ``` ## Get Trade Transactions Of Photon For A Particular Pair @@ -164,7 +164,7 @@ You can find the query [here](https://ide.bitquery.io/Trades-of-a-Pair-Executed- ## Trader-Focused Trade APIs (with USD Price, Market Cap & Supply) -The queries below use the **[Trades cube](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](https://docs.bitquery.io/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. +The queries below use the **[Trades cube](/docs/trading/crypto-trades-api/trades-api/)** (`Trading { Trades }`) which is trader-focused and provides reliable USD prices including for all tokens. See [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades) for when to use which. ### Get All DEX Trades on Solana With Price, Market Cap, and Supply diff --git a/docs/blockchain/Solana/solana-rewards.mdx b/docs/blockchain/Solana/solana-rewards.mdx index fe47a5da..a43317a5 100644 --- a/docs/blockchain/Solana/solana-rewards.mdx +++ b/docs/blockchain/Solana/solana-rewards.mdx @@ -1,38 +1,12 @@ --- sidebar_position: 5 +title: "Solana Staking Rewards API" +description: "Solana Rewards: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Scale further with Kafka or gRPC streams." --- - # Solana Rewards API Solana rewards are incentives given to investors and validators for staking their SOL tokens to secure the network. This section covers how to access information about the latest Solana rewards among other examples. - - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Latest Rewards diff --git a/docs/blockchain/Solana/solana-search-tokens.mdx b/docs/blockchain/Solana/solana-search-tokens.mdx index edcbc30e..57e28c5c 100644 --- a/docs/blockchain/Solana/solana-search-tokens.mdx +++ b/docs/blockchain/Solana/solana-search-tokens.mdx @@ -1,33 +1,10 @@ --- sidebar_position: 20 +title: "Solana Token Search API" +description: "Solana Token Search API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." --- - # Solana Token Search API - - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Search Tokens on Solana diff --git a/docs/blockchain/Solana/solana-token-holders.md b/docs/blockchain/Solana/solana-token-holders.md index 217242c9..01e77248 100644 --- a/docs/blockchain/Solana/solana-token-holders.md +++ b/docs/blockchain/Solana/solana-token-holders.md @@ -1,35 +1,18 @@ +--- +title: "Solana Token Holders API" +description: "Solana Token Holders API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Scale further with Kafka or gRPC streams." +--- # Solana Token Holders API Get real-time and historical token holder data for any SPL token on Solana. Bitquery provides two approaches to retrieve token holders — choose the one that fits your use case. - - - - - - - - - - - - - - - - - - - - - ## Can I get Solana token holder data using Bitquery? Yes. Bitquery exposes Solana SPL holder analytics via GraphQL: use **V1** transfer-based aggregates for full history and top holders, or **V2** `BalanceUpdates` for fast snapshots on recently active tokens (roughly the last hours of balance updates). Pick V1 for long-lived tokens and trends; V2 for brand-new launches and near-real-time rankings. ## How do I track whale wallets and their token holdings on Solana? -Use V1 holder queries sorted by net balance to list the largest wallets, or V2 `BalanceUpdates` ordered by `PostBalance` for fresh launches. Filter minimum `PostBalance` or post-process balances to focus on whales, then correlate with [Solana transfers](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/) or [DEX trades](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/) for accumulation or distribution. +Use V1 holder queries sorted by net balance to list the largest wallets, or V2 `BalanceUpdates` ordered by `PostBalance` for fresh launches. Filter minimum `PostBalance` or post-process balances to focus on whales, then correlate with [Solana transfers](/docs/blockchain/Solana/solana-transfers/) or [DEX trades](/docs/blockchain/Solana/solana-dextrades/) for accumulation or distribution. ## Choosing the Right API @@ -210,7 +193,7 @@ Use V1 to track how the number of unique holders changes over different date ran Verify that airdrop recipients actually hold the tokens by querying current balances. ### Smart Money Tracking -Identify wallets that consistently hold tokens early in successful launches. Cross-reference with the [Solana Trader API](https://docs.bitquery.io/docs/blockchain/Solana/solana-trader-API/) for deeper analysis. +Identify wallets that consistently hold tokens early in successful launches. Cross-reference with the [Solana Trader API](/docs/blockchain/Solana/solana-trader-API/) for deeper analysis. ## Best Practices @@ -224,12 +207,12 @@ Identify wallets that consistently hold tokens early in successful launches. Cro ## Related APIs -- [Solana Balance Updates API](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/) — Real-time balance change monitoring -- [Solana Transfers API](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/) — Track token transfers -- [Solana DEX Trades API](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/) — Trading activity for tokens -- [Solana Trader API](https://docs.bitquery.io/docs/blockchain/Solana/solana-trader-API/) — Trader analytics and smart money tracking -- [Solana Token Supply API](https://docs.bitquery.io/docs/blockchain/Solana/token-supply-cube/) — Token supply data -- [Pump.fun API](https://docs.bitquery.io/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) — Pump.fun token data +- [Solana Balance Updates API](/docs/blockchain/Solana/solana-balance-updates/) — Real-time balance change monitoring +- [Solana Transfers API](/docs/blockchain/Solana/solana-transfers/) — Track token transfers +- [Solana DEX Trades API](/docs/blockchain/Solana/solana-dextrades/) — Trading activity for tokens +- [Solana Trader API](/docs/blockchain/Solana/solana-trader-API/) — Trader analytics and smart money tracking +- [Solana Token Supply API](/docs/blockchain/Solana/token-supply-cube/) — Token supply data +- [Pump.fun API](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) — Pump.fun token data ## Support diff --git a/docs/blockchain/Solana/solana-token-marketcap-api.md b/docs/blockchain/Solana/solana-token-marketcap-api.md index 98ee4b82..0545225a 100644 --- a/docs/blockchain/Solana/solana-token-marketcap-api.md +++ b/docs/blockchain/Solana/solana-token-marketcap-api.md @@ -1,35 +1,20 @@ --- sidebar_position: 3 +title: "Solana Token Market Cap API" +description: "Solana Token Market Cap API: stream Solana market cap, FDV, supply, and price using Bitquery Trading GraphQL APIs. See examples in the Bitquery IDE." --- - import VideoPlayer from "../../../src/components/videoplayer.js"; # Solana Token Market Cap API :::tip Need real-time Solana token market-cap data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Solana token market-cap swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Solana token market-cap data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Solana token market-cap swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Solana token market-cap data older than ~30 days**, raw per-swap detail, or call / event context. ::: - Use Bitquery’s **Trading** API **`Tokens`** cube to stream or query **market cap**, **fully diluted valuation (USD)**, **total supply**, **price** (OHLC and averages), and **volume** for tokens on **Solana**. Filter with **`solana:`** plus the token **mint** in **`Token.Id`** / **`Currency.Id`**; ranked queries below use **`Token.Network`** **`Solana`**. For schema details and field meanings, see the **[Tokens cube](/docs/trading/crypto-price-api/tokens)** and **[Supply fields](/docs/trading/crypto-price-api/supply-fields)**. - - - - - - - - - - - - - - - ## Related APIs - **[Ethereum Token Market Cap API](/docs/blockchain/Ethereum/token-supply/ethereum-token-marketcap-api)** — **`eth:`** ids diff --git a/docs/blockchain/Solana/solana-trader-API.md b/docs/blockchain/Solana/solana-trader-API.md index b09640bf..e009a30d 100644 --- a/docs/blockchain/Solana/solana-trader-API.md +++ b/docs/blockchain/Solana/solana-trader-API.md @@ -1,37 +1,19 @@ +--- +title: "Solana Trader API" +description: "Solana Trader API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Includes filters and field selection tips." +--- # Solana Trader API :::tip Need real-time Solana trader data or anything from the last ~30 days? -For **real-time trader and wallet data over the last ~30 days** across **8 chains in one API**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **`Trader.Address`** as a first-class filter plus **USD price, market cap, and supply on every row**. Use this page when you need **historical Solana trader data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time trader and wallet data over the last ~30 days** across **9 chains in one API**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **`Trader.Address`** as a first-class filter plus **USD price, market cap, and supply on every row**. Use this page when you need **historical Solana trader data older than ~30 days**, raw per-swap detail, or call / event context. ::: - -In this section we will see how to get Solana trader information using our API. More queries on DEX trades including latest trades, OHLC, and other data points can be found in the [Solana DEX Trades API page](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/). +In this section we will see how to get Solana trader information using our API. More queries on DEX trades including latest trades, OHLC, and other data points can be found in the [Solana DEX Trades API page](/docs/blockchain/Solana/solana-dextrades/). :::note `Trade Side Account` field will not be available for aggregate queries in Archive and Combined Datasets ::: - - - - - - - - - - - - - - - - - - - - - ## Top Traders of a token This query returns the top traders for a specific token by USD volume over a date range. It uses the **combined** dataset and filters by token mint, quote currency (e.g. SOL), and optional date range. For each trader you get buy/sell counts, buy/sell volume, total volume, and trade count. @@ -267,7 +249,7 @@ query MyQuery ($trader:String, $token:String){ ## Subscribe to a Trader in Real-time -The below subscription query will fetch in real-time the trades done by a wallet. You can use websockets to build applications on this data. Read more [here](https://docs.bitquery.io/docs/subscriptions/websockets/) +The below subscription query will fetch in real-time the trades done by a wallet. You can use websockets to build applications on this data. Read more [here](/docs/subscriptions/websockets/) To filter trades by a wallet we will use the condition `Account: {Address: {is}}`. Run the subscription query [here](https://ide.bitquery.io/trades-of-a-wallet_2) diff --git a/docs/blockchain/Solana/solana-transactions.md b/docs/blockchain/Solana/solana-transactions.md index 95bd8700..55f3895c 100644 --- a/docs/blockchain/Solana/solana-transactions.md +++ b/docs/blockchain/Solana/solana-transactions.md @@ -1,5 +1,7 @@ --- sidebar_position: 6 +title: "Solana Transactions API" +description: "Solana Transactions API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." --- import FAQ from "@site/src/components/FAQ"; @@ -7,27 +9,6 @@ import FAQ from "@site/src/components/FAQ"; In this section we'll have a look at some examples using the Solana Transactions API. - - - - - - - - - - - - - - - - - - - - - # Subscribe to Recent Transactions The subscription query below fetches the most recent transactions on the Solana blockchain diff --git a/docs/blockchain/Solana/solana-transfers.mdx b/docs/blockchain/Solana/solana-transfers.mdx index 5ca9cf44..6a115dfc 100644 --- a/docs/blockchain/Solana/solana-transfers.mdx +++ b/docs/blockchain/Solana/solana-transfers.mdx @@ -1,52 +1,29 @@ +--- +title: "Solana Transfers API" +description: "Solana Transfers API: monitor Solana native and token transfers in real time with Bitquery GraphQL APIs. Scale further with Kafka or gRPC streams." +--- # Solana Transfers API -> **Before you start**: Not sure when to use Transfers vs DEX Trades vs other data primitives? Read our [Mental Model guide](https://docs.bitquery.io/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. +> **Before you start**: Not sure when to use Transfers vs DEX Trades vs other data primitives? Read our [Mental Model guide](/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. In this section we'll have a look at some examples using the Solana Transfers API. ## 🔗 Related Solana APIs -- **[Solana Balance Updates API](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/)** - Monitor balance changes from transfers -- **[Solana Instructions API](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions/)** - Track transfer instructions and events -- **[Solana DEX Trades API](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/)** - Monitor trading transfers and swaps -- **[Solana Fees API](https://docs.bitquery.io/docs/blockchain/Solana/solana_fees_api/)** - Analyze transfer fees and transaction costs -- **[Solana Token Supply API](https://docs.bitquery.io/docs/blockchain/Solana/token-supply-cube/)** - Track supply changes from transfers +- **[Solana Balance Updates API](/docs/blockchain/Solana/solana-balance-updates/)** - Monitor balance changes from transfers +- **[Solana Instructions API](/docs/blockchain/Solana/solana-instructions/)** - Track transfer instructions and events +- **[Solana DEX Trades API](/docs/blockchain/Solana/solana-dextrades/)** - Monitor trading transfers and swaps +- **[Solana Fees API](/docs/blockchain/Solana/solana_fees_api/)** - Analyze transfer fees and transaction costs +- **[Solana Token Supply API](/docs/blockchain/Solana/token-supply-cube/)** - Track supply changes from transfers - **[Historical Transfers API](https://docs.bitquery.io/v1/docs/Examples/Solana/transfers)** - - - - - - - - - - - - - - - - - - - - - import VideoPlayer from "../../../src/components/videoplayer.js"; ## Subscribe to all transfers on Solana This includes all types of transactions; transfers, swaps, and other types of transactions on Solana -For monitoring the balance changes that result from these transfers, see our **[Solana Balance Updates API](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/)**. +For monitoring the balance changes that result from these transfers, see our **[Solana Balance Updates API](/docs/blockchain/Solana/solana-balance-updates/)**. [Run Stream >](https://ide.bitquery.io/Subscribe-to-the-all-transfers-on-Solana) @@ -111,7 +88,6 @@ subscription { } } - ``` ## SPL Token Transfers API | Token transfers of a particular token on Solana @@ -145,8 +121,6 @@ subscription { } } - - ``` ## Get transfers in a Transaction Signature diff --git a/docs/blockchain/Solana/solana-zeta.mdx b/docs/blockchain/Solana/solana-zeta.mdx index 66073242..74fcc1d4 100644 --- a/docs/blockchain/Solana/solana-zeta.mdx +++ b/docs/blockchain/Solana/solana-zeta.mdx @@ -1,14 +1,14 @@ --- sidebar_position: 7 +title: "Solana Zeta Markets API" +description: "Solana Zeta: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." --- - # ZETA DEX API :::tip Need real-time Zeta data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Zeta swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Zeta data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered Zeta swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Zeta data older than ~30 days**, raw per-swap detail, or call / event context. ::: - In this section, we'll show you how to access information about Zeta DEX data using Bitquery APIs. import VideoPlayer from "../../../src/components/videoplayer.js"; diff --git a/docs/blockchain/Solana/solana_fees_api.md b/docs/blockchain/Solana/solana_fees_api.md index d183e959..1df226a8 100644 --- a/docs/blockchain/Solana/solana_fees_api.md +++ b/docs/blockchain/Solana/solana_fees_api.md @@ -1,29 +1,16 @@ +--- +title: "Solana Fees API" +description: "Solana Fees API: analyze Solana transaction fees and costs with Bitquery GraphQL queries and streams. Scale further with Kafka or gRPC streams." +--- # Solana Fees API import VideoPlayer from "../../../src/components/videoplayer.js"; In this document, we will explore several examples related to Solana Fees data. -We also have [PumpFun APIs](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/) to track Pump Fun token swaps, [PumpSwap APIs](https://docs.bitquery.io/docs/blockchain/Solana/pump-swap-api/) if you want to track the token after it has been migrated to PumpSwap AMM. -Additionally, you can also check out our [Moonshot APIs](https://docs.bitquery.io/docs/blockchain/Solana/Moonshot-API/), [FourMeme APIs](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/). +We also have [PumpFun APIs](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) to track Pump Fun token swaps, [PumpSwap APIs](/docs/blockchain/Solana/Pumpfun/pump-swap-api/) if you want to track the token after it has been migrated to PumpSwap AMM. +Additionally, you can also check out our [Moonshot APIs](/docs/blockchain/Solana/Moonshot-API/), [FourMeme APIs](/docs/blockchain/BSC/four-meme-api/). These APIs can be provided through different streams including Kafka for zero latency requirements. Please contact us on telegram. - - - - - - - - - - - - - - - - - If you want fastest data without any latency, we can provide Kafka streams, please [fill this form](https://bitquery.io/forms/api) for it. Our Team will reach out. ## Get Trades with Transaction fees @@ -178,8 +165,8 @@ query MyQuery { ## 🔗 Related Solana APIs -- **[Solana DEX Trades API](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/)** - Monitor trading activities and their fees -- **[Solana Transfers API](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/)** - Track transfer fees and costs -- **[Solana Balance Updates API](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/)** - Monitor balance changes including fees -- **[Solana Instructions API](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions/)** - Track instruction execution fees -- **[Solana Token Supply API](https://docs.bitquery.io/docs/blockchain/Solana/token-supply-cube/)** - Monitor supply-related transaction fees +- **[Solana DEX Trades API](/docs/blockchain/Solana/solana-dextrades/)** - Monitor trading activities and their fees +- **[Solana Transfers API](/docs/blockchain/Solana/solana-transfers/)** - Track transfer fees and costs +- **[Solana Balance Updates API](/docs/blockchain/Solana/solana-balance-updates/)** - Monitor balance changes including fees +- **[Solana Instructions API](/docs/blockchain/Solana/solana-instructions/)** - Track instruction execution fees +- **[Solana Token Supply API](/docs/blockchain/Solana/token-supply-cube/)** - Monitor supply-related transaction fees diff --git a/docs/blockchain/Solana/token-supply-cube.mdx b/docs/blockchain/Solana/token-supply-cube.mdx index a6acead0..6e4fff95 100644 --- a/docs/blockchain/Solana/token-supply-cube.mdx +++ b/docs/blockchain/Solana/token-supply-cube.mdx @@ -1,7 +1,8 @@ --- sidebar_position: 2 +title: "Solana Token Supply API" +description: "Solana Token Supply API: stream Solana market cap, FDV, supply, and price using Bitquery Trading GraphQL APIs. Built for traders and analytics teams." --- - # Solana Token Supply API import VideoPlayer from "../../../src/components/videoplayer.js"; @@ -23,44 +24,17 @@ The **Solana Token Supply API** provides comprehensive access to real-time token ## 🔗 Related Solana APIs -- **[Solana Instructions API](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions/)** - Track token creation and burn instructions -- **[Solana Balance Updates API](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/)** - Monitor balance changes from supply updates -- **[Solana Transfers API](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/)** - Track transfers that affect token supply -- **[Solana DEX Trades API](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/)** - Monitor trading activities impacting supply -- **[Solana Fees API](https://docs.bitquery.io/docs/blockchain/Solana/solana_fees_api/)** - Analyze fees from supply-related transactions - - - - - - - - - - - - - - - - - - - - - +- **[Solana Instructions API](/docs/blockchain/Solana/solana-instructions/)** - Track token creation and burn instructions +- **[Solana Balance Updates API](/docs/blockchain/Solana/solana-balance-updates/)** - Monitor balance changes from supply updates +- **[Solana Transfers API](/docs/blockchain/Solana/solana-transfers/)** - Track transfers that affect token supply +- **[Solana DEX Trades API](/docs/blockchain/Solana/solana-dextrades/)** - Monitor trading activities impacting supply +- **[Solana Fees API](/docs/blockchain/Solana/solana_fees_api/)** - Analyze fees from supply-related transactions ## Subscribe to Token Supply Changes This subscription will return the token supply changes in realtime. `PostBalance` will give you the current supply. Check the query [here](https://ide.bitquery.io/token-supply-updates-sub) -For tracking the instructions that cause these supply changes (like token creation and burning), see our **[Solana Instructions API](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions/)**. +For tracking the instructions that cause these supply changes (like token creation and burning), see our **[Solana Instructions API](/docs/blockchain/Solana/solana-instructions/)**. ```graphql subscription { @@ -246,8 +220,6 @@ query MyQuery { } ``` - - ## Marketcap of a Token We use `PostBalanceInUSD` field to get the marketcap. Since it is built on real-time data, you will get the Marketcap if the token was active in the past 8 hours or is being transacted in real-time. @@ -318,7 +290,7 @@ Here is an example which gets both supply and Price. ## Monitor Market Cap Metric for a Pump Fun Token -The subscription given [below](https://ide.bitquery.io/pump-fun-token-mcap-monitoring) could be used to setup a [websocket](https://docs.bitquery.io/docs/subscriptions/websockets/) like solution that monitors market cap of a Pump Fun token in real time, where the `PostBalanceInUSD` is essentially the marketcap of the token. +The subscription given [below](https://ide.bitquery.io/pump-fun-token-mcap-monitoring) could be used to setup a [websocket](/docs/subscriptions/websockets/) like solution that monitors market cap of a Pump Fun token in real time, where the `PostBalanceInUSD` is essentially the marketcap of the token. ```graphql subscription { diff --git a/docs/blockchain/Solana/trends-fun-API.md b/docs/blockchain/Solana/trends-fun-API.md index 889c4f6f..7a98c04d 100644 --- a/docs/blockchain/Solana/trends-fun-API.md +++ b/docs/blockchain/Solana/trends-fun-API.md @@ -1,47 +1,27 @@ +--- +title: "Trends.Fun API - Solana - New Tokens, Trades, Live Prices" +description: "Trends.Fun API - Solana - New Tokens, Trades, Live Prices: query and stream Solana on-chain data with Bitquery GraphQL examples for developers." +--- # Trends.Fun API - Solana - New Tokens, Trades, Live Prices :::tip Need real-time Trends.fun data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical Trends.fun data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical Trends.fun data older than ~30 days**, raw per-swap detail, or call / event context. ::: -In this page, we will explore several examples related to Trends.fun. You can also check out our [Pump Fun API Docs](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/) and [Jupiter Studio API Docs](https://docs.bitquery.io/docs/blockchain/Solana/jupiter-studio-api/). +In this page, we will explore several examples related to Trends.fun. You can also check out our [Pump Fun API Docs](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/) and [Jupiter Studio API Docs](/docs/blockchain/Solana/jupiter-studio-api/). :::note **Trends.fun tokens are created and traded on Meteora Dynamic Bonding Curve (DBC).** ::: -Need zero-latency Trends.fun data? [Read about our Shred Streams and Contact us for a Trial](https://docs.bitquery.io/docs/streams/real-time-solana-data/). +Need zero-latency Trends.fun data? [Read about our Shred Streams and Contact us for a Trial](/docs/streams/real-time-solana-data/). :::note To query or stream data via graphQL **outside the Bitquery IDE**, you need to generate an API access token. -Follow the steps here to create one: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here to create one: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: - -Trends.Fun API - Solana - New Tokens, Trades, Live Prices - - - - - - - - - - - - - - - - If you want fastest data without any latency, we can provide gRPC and Kafka streams, please [fill this form](https://bitquery.io/forms/api) for it. Our Team will reach out. ## Table of Contents @@ -714,6 +694,6 @@ Get all tokens created by a specific Trends.fun developer/creator address. ### Additional Resources -- Need ultra-low latency Trends.fun data? Check out our [Kafka Streaming Services](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) -- Explore more Solana APIs: [Solana Documentation ➤](https://docs.bitquery.io/docs/blockchain/Solana/) +- Need ultra-low latency Trends.fun data? Check out our [Kafka Streaming Services](/docs/streams/kafka-streaming-concepts/) +- Explore more Solana APIs: [Solana Documentation ➤](/docs/blockchain/Solana/) - For technical support, join our [Telegram](https://t.me/Bloxy_info) diff --git a/docs/blockchain/Solana/xstocks-api.md b/docs/blockchain/Solana/xstocks-api.md index e90512c9..eb454c2b 100644 --- a/docs/blockchain/Solana/xstocks-api.md +++ b/docs/blockchain/Solana/xstocks-api.md @@ -1,29 +1,15 @@ +--- +title: "Solana Xstocks API" +description: "Solana Xstocks API: query and stream Solana on-chain data with Bitquery GraphQL examples for developers. Works with WebSocket live subscriptions." +--- # xStocks API :::tip Need real-time xStocks data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered xStocks swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical xStocks data older than ~30 days**, raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered xStocks swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical xStocks data older than ~30 days**, raw per-swap detail, or call / event context. ::: - import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - - - - ## Tesla xStock Trades in Real-Time Below query will give you realtime trades of Tesla xStock (TESLAx). @@ -82,7 +68,7 @@ subscription LatestTrades { ## Latest Price of xStocks using Crypto Price api -You can get latest price of xStocks tokens prices using our [Crypto price api](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/). +You can get latest price of xStocks tokens prices using our [Crypto price api](/docs/trading/crypto-price-api/introduction/). You can run the query [here](https://ide.bitquery.io/xStocks-prices) diff --git a/docs/blockchain/Tron/index.mdx b/docs/blockchain/Tron/index.mdx index 245b3195..64d755d4 100644 --- a/docs/blockchain/Tron/index.mdx +++ b/docs/blockchain/Tron/index.mdx @@ -1,6 +1,6 @@ --- title: Tron API Documentation -description: Collection of Tron APIs organized by topic. +description: "Tron API Documentation: query and stream Tron on-chain data with Bitquery GraphQL examples for developers. Covers archive history and realtime data." slug: /blockchain/Tron/ keywords: - Tron API @@ -22,14 +22,12 @@ keywords: - Tron fees api - Tron liquidity api --- - # Tron API Documentation :::tip Building a trading app or DEX UI on Tron? -For **real-time trades and prices on Tron** (and the last ~30 days), use the curated [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. For **historical Tron data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. +For **real-time trades and prices on Tron** (and the last ~30 days), use the curated [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. For **historical Tron data older than ~30 days**, use the chain-level `DEXTrades` / `DEXTradeByTokens` APIs documented below. ::: - ## Overview In this section we will see how to fetch data on different tokens, transactions, and DEXs like SunPump and Sunswap on Tron via APIs and Streams. @@ -56,7 +54,7 @@ To access Bitquery Tron API you would require your own **[Access Token](https:// ### Does Bitquery support Tron Websocket and Webhooks? -Bitquery supports websocket and webhooks; you can convert most GraphQL APIs into GraphQL streams by changing the word `query` to `subscription`. You can monitor this data via a websocket. More docs and code samples are available [here](https://docs.bitquery.io/docs/subscriptions/websockets/). +Bitquery supports websocket and webhooks; you can convert most GraphQL APIs into GraphQL streams by changing the word `query` to `subscription`. You can monitor this data via a websocket. More docs and code samples are available [here](/docs/subscriptions/websockets/). ## Quick start @@ -96,19 +94,19 @@ query LatestTronTrades { ## DEX APIs -- [SunPump API](https://docs.bitquery.io/docs/blockchain/Tron/tron-sunpump/) -- [SunSwap API](https://docs.bitquery.io/docs/blockchain/Tron/sunswap-api/) -- [Tron Dex Trades](https://docs.bitquery.io/docs/blockchain/Tron/tron-dextrades/) +- [SunPump API](/docs/blockchain/Tron/tron-sunpump/) +- [SunSwap API](/docs/blockchain/Tron/sunswap-api/) +- [Tron Dex Trades](/docs/blockchain/Tron/tron-dextrades/) ## Core Tron APIs -- [Balance Updates](https://docs.bitquery.io/docs/blockchain/Tron/tron-balance-updates/) -- [TRC20 Tokens](https://docs.bitquery.io/docs/blockchain/Tron/usdt-trc20-api/) -- [NFT](https://docs.bitquery.io/docs/blockchain/Tron/tron-nft/) -- [Mempool](https://docs.bitquery.io/docs/blockchain/Tron/tron-mempool/) -- [Fees](https://docs.bitquery.io/docs/blockchain/Tron/tron-fees-api/) -- [Transactions](https://docs.bitquery.io/docs/blockchain/Tron/tron-transactions-api/) -- [Transfers](https://docs.bitquery.io/docs/blockchain/Tron/tron-transfers/) +- [Balance Updates](/docs/blockchain/Tron/tron-balance-updates/) +- [TRC20 Tokens](/docs/blockchain/Tron/usdt-trc20-api/) +- [NFT](/docs/blockchain/Tron/tron-nft/) +- [Mempool](/docs/blockchain/Tron/tron-mempool/) +- [Fees](/docs/blockchain/Tron/tron-fees-api/) +- [Transactions](/docs/blockchain/Tron/tron-transactions-api/) +- [Transfers](/docs/blockchain/Tron/tron-transfers/) ## Does Bitquery support Tron? {#does-bitquery-support-tron} diff --git a/docs/blockchain/Tron/sunswap-api.md b/docs/blockchain/Tron/sunswap-api.md index a967b263..b1ea2896 100644 --- a/docs/blockchain/Tron/sunswap-api.md +++ b/docs/blockchain/Tron/sunswap-api.md @@ -1,22 +1,9 @@ +--- +title: "Tron Sunswap API" +description: "Tron Sunswap API: query and stream Tron on-chain data with Bitquery GraphQL examples for developers. See examples in the Bitquery IDE." +--- # Tron SunSwap API - - - - - - - - - - - - - - - - - **[Bitquery](https://bitquery.io)** provides useful tron activity through **GraphQL** (on-demand queries and live **subscriptions**), and high-throughput Kafks streams for enterprise teams. This page documents **SunSwap**-related examples on **Tron**—events, contracts, and streams you can copy into the IDE. For general Tron DEX trade patterns, see the [Tron DEX Trades API](/docs/blockchain/Tron/tron-dextrades). If you are new here, start with [Your first query](/docs/start/first-query). @@ -115,10 +102,8 @@ query MyQuery { } } - ``` - ## Latest Trades of a Token on Sunswap You can run the query [here](https://ide.bitquery.io/sunswap-latest-Trades-of-token) diff --git a/docs/blockchain/Tron/tron-balance-updates.md b/docs/blockchain/Tron/tron-balance-updates.md index 92fa6c72..8ebb0761 100644 --- a/docs/blockchain/Tron/tron-balance-updates.md +++ b/docs/blockchain/Tron/tron-balance-updates.md @@ -1,12 +1,14 @@ --- sidebar_position: 1 +title: "Tron Address Balance API" +description: "Tron Address Balance API: fetch current and historical Tron balances with Bitquery GraphQL balance queries. Run it in the IDE, then ship in your app." --- import FAQ from "@site/src/components/FAQ"; # Tron Address Balance API :::caution Deprecated API -`Tron.BalanceUpdates` is deprecated as of **18 June 2026** and will be removed on **18 July 2026**. Use **`Tron.Balances`** (this page) instead. +`Tron.BalanceUpdates` was deprecated as of **18 June 2026** and removed on **18 July 2026**. Use **`Tron.Balances`** (this page) instead. ::: The **Balances** API returns current and historical token balances for an address on Tron. To return only non-zero balances, add `Amount(selectWhere: { gt: "0" })` on the `Balance` field (not in `where`). Use `dataset: combined` or `dataset: archive` as follows: @@ -16,33 +18,6 @@ The **Balances** API returns current and historical token balances for an addres | **`combined`** | Latest balances. Queries **realtime and archive** databases and merges results. | | **`archive`** | Historical snapshots with `Block.Date`, and balances for **addresses not recently active**. | - - - - - - - - - - - - - - - - - - - - - ## Portfolio of a Tron Wallet Returns balances for all the currecies owned by a wallet address. Use `Amount(selectWhere: { gt: "0" })` to exclude zero balances and `dataset: combined` for the latest balances. @@ -323,7 +298,7 @@ query TopTokenHolders { ## Deprecated: BalanceUpdates Queries -The examples below use the deprecated **`Tron.BalanceUpdates`** API. Migrate to **`Tron.Balances`** and **`Tron.Holders`** (sections above) before **18 July 2026**. +The examples below use the deprecated **`Tron.BalanceUpdates`** API. Migrate to **`Tron.Balances`** and **`Tron.Holders`** (sections above) — **`Tron.BalanceUpdates`** is no longer available. ### Balance of an Address on Tron diff --git a/docs/blockchain/Tron/tron-dextrades.md b/docs/blockchain/Tron/tron-dextrades.md index a436f42b..dbfd41c5 100644 --- a/docs/blockchain/Tron/tron-dextrades.md +++ b/docs/blockchain/Tron/tron-dextrades.md @@ -1,42 +1,15 @@ --- sidebar_position: 2 +title: "Tron DEXtrades API" +description: "Tron DEXtrades API: get Tron DEX swaps, prices, and OHLC with Bitquery GraphQL queries and live streams. Built for traders and analytics teams." --- - # Tron DEX Trades API :::tip Need real-time Tron DEX data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API** (filter with `Pair.Market.Network: Tron`). Use this page when you need **historical Tron data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API** (filter with `Pair.Market.Network: Tron`). Use this page when you need **historical Tron data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. ::: - -**Tron DEX Trades** help you see **who swapped what, when, and at what price** on Tron decentralized exchanges which is useful for dashboards, alerts, research, and trading tools. The examples below are ready-to-run **GraphQL** queries and subscriptions you can copy into the [Bitquery IDE](https://ide.bitquery.io). You can also stream at scale via [Apache Kafka](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). - - - - - - - - - - - - - - - - - - - - - +**Tron DEX Trades** help you see **who swapped what, when, and at what price** on Tron decentralized exchanges which is useful for dashboards, alerts, research, and trading tools. The examples below are ready-to-run **GraphQL** queries and subscriptions you can copy into the [Bitquery IDE](https://ide.bitquery.io). You can also stream at scale via [Apache Kafka](/docs/streams/kafka-streaming-concepts/). ## Live DEX swap stream (Tron) {#crypto-trades-live-stream} diff --git a/docs/blockchain/Tron/tron-fees-api.md b/docs/blockchain/Tron/tron-fees-api.md index b96386e4..064c15e7 100644 --- a/docs/blockchain/Tron/tron-fees-api.md +++ b/docs/blockchain/Tron/tron-fees-api.md @@ -1,28 +1,14 @@ +--- +title: "Tron Fees API" +description: "Tron Fees API: analyze Tron transaction fees and costs with Bitquery GraphQL queries and streams. Scale further with Kafka or gRPC streams." +--- # Tron Fees API import VideoPlayer from "../../../src/components/videoplayer.js"; In this document, we will explore several examples related to Tron Fees data. -We also have [PumpFun APIs](https://docs.bitquery.io/docs/blockchain/Tron/Pump-Fun-API/) to track Pump Fun token swaps, [PumpSwap APIs](https://docs.bitquery.io/docs/blockchain/Tron/pump-swap-api/) if you want to track the token after it has been migrated to PumpSwap AMM. -Additionally, you can also check out our [Moonshot APIs](https://docs.bitquery.io/docs/blockchain/Tron/Moonshot-API/), [FourMeme APIs](https://docs.bitquery.io/docs/blockchain/BSC/four-meme-api/). -These APIs can be provided through different streams including Kafka for zero latency requirements. Please contact us on telegram. - - - - - - - - - - - - - - - - - +For related memecoin fee and trade analytics on other chains, see [Pump.fun](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/), [PumpSwap](/docs/blockchain/Solana/Pumpfun/pump-swap-api/), [Moonshot](/docs/blockchain/Solana/Moonshot-API/), and [Four.meme](/docs/blockchain/BSC/four-meme-api/). +These APIs can also be delivered through Kafka streams for low-latency use cases — contact us on Telegram. If you want fastest data without any latency, we can provide Kafka streams, please [fill this form](https://bitquery.io/forms/api) for it. Our Team will reach out. diff --git a/docs/blockchain/Tron/tron-mempool.md b/docs/blockchain/Tron/tron-mempool.md index 5e8cb235..3a61806b 100644 --- a/docs/blockchain/Tron/tron-mempool.md +++ b/docs/blockchain/Tron/tron-mempool.md @@ -1,28 +1,11 @@ +--- +title: "Tron Mempool API" +description: "Tron Mempool API: watch Tron pending transactions before confirmation with Bitquery GraphQL subscriptions. Built for traders and analytics teams." +--- # Tron Mempool API In this section we'll have a look at some examples using the Tron Mempool API. - - - - - - - - - - - - - - - ## Latest Mempool Transfers The below subscription provides real-time data on token transfers happening in the TRON mempool including the value of the transferred amount in USD. @@ -46,7 +29,6 @@ subscription { } } - ``` ## Latest Mempool DEX Trades diff --git a/docs/blockchain/Tron/tron-nft.md b/docs/blockchain/Tron/tron-nft.md index 63855268..20a380b5 100644 --- a/docs/blockchain/Tron/tron-nft.md +++ b/docs/blockchain/Tron/tron-nft.md @@ -1,34 +1,11 @@ +--- +title: "Tron NFT API" +description: "Tron NFT API: track Tron NFT trades, ownership, and metadata with Bitquery GraphQL and streams. Keep queries fast with indexed filters." +--- # Tron NFT API In this section we'll have a look at some examples using the Tron NFT API. - - - - - - - - - - - - - - - - - - - - - ## Track transfers of an NFT in Realtime on Tron This query subscribes you to the real time transfers of a specific non-fungible token (NFT) on the Tron network. @@ -59,6 +36,4 @@ subscription{ } } - - ``` diff --git a/docs/blockchain/Tron/tron-sunpump.mdx b/docs/blockchain/Tron/tron-sunpump.mdx index 1adbb1fa..9d0151ee 100644 --- a/docs/blockchain/Tron/tron-sunpump.mdx +++ b/docs/blockchain/Tron/tron-sunpump.mdx @@ -1,3 +1,7 @@ +--- +title: "Tron SunPump API" +description: "Tron Sunpump: real-time Tron memecoin and DEX data via Bitquery GraphQL APIs and Kafka streams. Run it in the IDE, then ship in your app." +--- # Sun Pump API In this section, we will explore several examples related to Sun Pump data. These APIs can be provided through different streams including Kafka for zero latency requirements. Please contact us on telegram. @@ -6,29 +10,6 @@ For live DEX prices and volume across Tron memecoins (including Sun Pump tokens) import VideoPlayer from "../../../src/components/videoplayer.js"; - - - - - - - - - - - - - - - - - ## Latest Created Sunpump token This query will subscribe you to the latest created sun pump tokens. You will find the newly created token address in `Log { SmartContract }`. @@ -265,7 +246,7 @@ You can check the data here on [DEXrabbit](https://dexrabbit.com/tron/sunpump/TM You can also get trades for specific token using DEXTradeByTokens API. Here is [an example](https://ide.bitquery.io/trades-for-a-particular-sunpump-token). -To learn the difference between DEXTrades and DEXTradeByTokens API, read [this](https://docs.bitquery.io/docs/cubes/dextrades/) and [this](https://docs.bitquery.io/docs/cubes/dextradesbyTokens/) doc. +To learn the difference between DEXTrades and DEXTradeByTokens API, read [this](/docs/cubes/dextrades/) and [this](/docs/cubes/dextradesbyTokens/) doc.
Click to expand GraphQL query diff --git a/docs/blockchain/Tron/tron-transactions-api.md b/docs/blockchain/Tron/tron-transactions-api.md index f732ee3d..9d264e42 100644 --- a/docs/blockchain/Tron/tron-transactions-api.md +++ b/docs/blockchain/Tron/tron-transactions-api.md @@ -1,34 +1,11 @@ +--- +title: "Tron Transactions API" +description: "Tron Transactions API: query and stream Tron on-chain data with Bitquery GraphQL examples for developers. Scale further with Kafka or gRPC streams." +--- # Tron Transactions API In this section we'll have a look at some examples using the Tron Transactions API. - - - - - - - - - - - - - - - - - - - - - ## Monitor Real-time Transactions by Wallet The subscription query below fetches the transactions on the Tron network for the wallet address `TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf`. diff --git a/docs/blockchain/Tron/tron-transfers.md b/docs/blockchain/Tron/tron-transfers.md index dcbbf438..172f6923 100644 --- a/docs/blockchain/Tron/tron-transfers.md +++ b/docs/blockchain/Tron/tron-transfers.md @@ -1,34 +1,11 @@ +--- +title: "Tron Transfers API" +description: "Tron Transfers API: monitor Tron native and token transfers in real time with Bitquery GraphQL APIs. Includes filters and field selection tips." +--- # Tron Transfers API In this section we'll have a look at some examples using the Tron Transfers API. - - - - - - - - - - - - - - - - - - - - - ## Subscribe to Recent Whale Transactions of a particular currency The subscription query below fetches the whale transactions on the Tron network. We have used USDT address `TThzxNRLrW2Brp9DcTQU8i4Wd9udCWEdZ3`. You can find the query [here](https://ide.bitquery.io/Whale-transfers-of-USDT-on-Tron) @@ -59,7 +36,6 @@ subscription{ } } - ``` ## Top Transfers of a Token @@ -305,5 +281,4 @@ subscription { } } - ``` diff --git a/docs/blockchain/Tron/usdt-trc20-api.md b/docs/blockchain/Tron/usdt-trc20-api.md index 2549e7ab..5adeba94 100644 --- a/docs/blockchain/Tron/usdt-trc20-api.md +++ b/docs/blockchain/Tron/usdt-trc20-api.md @@ -1,26 +1,11 @@ +--- +title: "Tron Usdt Trc20 API" +description: "Tron Usdt Trc20 API: query and stream Tron on-chain data with Bitquery GraphQL examples for developers. Scale further with Kafka or gRPC streams." +--- # TRC20 API In this section we'll have a look at some examples using the TCR20 API. - - - - - - - - - - - - - - - - - - - ## Tether USD (USDT) Transfers in Realtime To monitor USDT transfers on Tron in real-time, you can use the following query. @@ -113,7 +98,6 @@ subscription { } } - ``` You can run the query [here](https://ide.bitquery.io/USDT-TRC20-DEX-Trades) diff --git a/docs/blockchain/introduction.md b/docs/blockchain/introduction.md index 33750c45..718143bd 100644 --- a/docs/blockchain/introduction.md +++ b/docs/blockchain/introduction.md @@ -1,6 +1,6 @@ --- -title: "Blockchain Data APIs - Multi-Chain Developer Platform" -description: "Access comprehensive blockchain data across Ethereum, Solana, BSC, Arbitrum, Base, Polygon, Tron, and more. Real-time and historical data via GraphQL APIs, WebSocket subscriptions, and Kafka streams. Free tier available." +title: "Blockchain Data APIs Overview" +description: "Explore Bitquery multi-chain blockchain APIs for trades, transfers, balances, NFTs, mempool data, and real-time streams." keywords: ["blockchain API", "blockchain data API", "multi-chain API", "Ethereum API", "Solana API", "BSC API", "Arbitrum API", "Base API", "Polygon API", "Tron API", "blockchain GraphQL API", "real-time blockchain data", "historical blockchain data", "DEX API", "DeFi API", "NFT API", "token API", "transaction API", "balance API", "smart contract API", "mempool API", "blockchain streaming", "WebSocket blockchain", "Kafka blockchain", "blockchain analytics", "blockchain developer tools", "blockchain infrastructure", "blockchain indexing", "blockchain data platform", "stablecoin API", "MEV detection", "mempool monitoring", "crypto price API", "real-time trading data", "cross-chain analytics", "blockchain compliance", "payment processing API"] --- import FAQ from "@site/src/components/FAQ"; @@ -29,21 +29,21 @@ Bitquery provides comprehensive blockchain data across **40+ blockchains** throu Our V2 API version with enhanced features and real-time streaming: **EVM-Compatible Chains:** -- **[Ethereum](https://docs.bitquery.io/docs/blockchain/Ethereum/)** -- **[BSC (Binance Smart Chain)](https://docs.bitquery.io/docs/blockchain/BSC/)** -- **[Arbitrum](https://docs.bitquery.io/docs/blockchain/Arbitrum/)** -- **[Base](https://docs.bitquery.io/docs/blockchain/Base/)** -- **[Polygon](https://docs.bitquery.io/docs/blockchain/Matic/)** -- **[Optimism](https://docs.bitquery.io/docs/blockchain/Optimism/)** -- **[opBNB](https://docs.bitquery.io/docs/blockchain/opBNB/)** -- **[Robinhood](https://docs.bitquery.io/docs/blockchain/robinhood/)** +- **[Ethereum](/docs/blockchain/Ethereum/)** +- **[BSC (Binance Smart Chain)](/docs/blockchain/BSC/)** +- **[Arbitrum](/docs/blockchain/Arbitrum/)** +- **[Base](/docs/blockchain/Base/)** +- **[Polygon](/docs/blockchain/Matic/)** +- **[Optimism](/docs/blockchain/Optimism/)** +- **[opBNB](/docs/blockchain/supported-chains/)** (IDE / limited docs) +- **[Robinhood](/docs/blockchain/robinhood/)** **Non-EVM Chains:** -- **[Solana](https://docs.bitquery.io/docs/blockchain/Solana/)** -- **[Tron](https://docs.bitquery.io/docs/blockchain/Tron/)** -- **[TON](https://docs.bitquery.io/docs/blockchain/TON/)** -- **[Bitcoin](https://docs.bitquery.io/docs/blockchain/Bitcoin/)** -- **[Cardano](https://docs.bitquery.io/docs/blockchain/Cardano/)** +- **[Solana](/docs/blockchain/Solana/)** +- **[Tron](/docs/blockchain/Tron/)** +- **[TON](/docs/blockchain/supported-chains/)** (limited support) +- **[Bitcoin](/docs/blockchain/Bitcoin/)** +- **[Cardano](/docs/blockchain/Cardano/)** ### **V1 APIs** Our comprehensive V1 API supporting 40+ blockchains with historical data: @@ -52,16 +52,16 @@ Our comprehensive V1 API supporting 40+ blockchains with historical data: **Documentation:** - **[Supported chains by interface](/docs/blockchain/supported-chains/)** — Coverage matrix: V1/V2, Kafka, gRPC, ClickHouse, cloud -- **[V2 Documentation](https://docs.bitquery.io/docs/)** - Latest APIs with real-time streaming +- **[V2 Documentation](/docs/intro/)** - Latest APIs with real-time streaming - **[V1 Documentation](https://docs.bitquery.io/v1/)** - Comprehensive APIs with 40+ blockchain support ## Bitquery's Core Blockchain Data Capabilities -**Popular APIs:** [Solana API](https://docs.bitquery.io/docs/blockchain/Solana/) (DEX trades, Pump.fun, Raydium) · [Polymarket API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-api) · [BSC API](https://docs.bitquery.io/docs/blockchain/BSC/) · [Base API](https://docs.bitquery.io/docs/blockchain/Base/) · [DEX API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/dex-api) · [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) +**Popular APIs:** [Solana API](/docs/blockchain/Solana/) (DEX trades, Pump.fun, Raydium) · [Polymarket API](/docs/examples/polymarket-api/polymarket-api) · [BSC API](/docs/blockchain/BSC/) · [Base API](/docs/blockchain/Base/) · [DEX API](/docs/blockchain/Ethereum/dextrades/dex-api) · [Crypto Price API](/docs/trading/crypto-price-api/introduction/) ### **Crypto Price API - Real-Time Multi-Chain Price Data** -Bitquery's dedicated **[Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/)** provides real-time, aggregated cryptocurrency price data with ultra-low latency across multiple blockchains. This specialized API is designed specifically for trading applications, DeFi protocols, and financial analytics. +Bitquery's dedicated **[Crypto Price API](/docs/trading/crypto-price-api/introduction/)** provides real-time, aggregated cryptocurrency price data with ultra-low latency across multiple blockchains. This specialized API is designed specifically for trading applications, DeFi protocols, and financial analytics. **Key Features:** - **Real-time Streaming**: 1-second granularity via GraphQL subscriptions and Kafka streams @@ -107,19 +107,19 @@ Bitquery's dedicated **[Crypto Price API](https://docs.bitquery.io/docs/trading/ - **Marketplace Integration**: OpenSea, LooksRare, and other platforms ### **Stablecoin APIs - Specialized Payment Infrastructure** -Bitquery provides dedicated **[Stablecoin APIs](https://docs.bitquery.io/docs/stablecoin-APIs/)** for comprehensive stablecoin data across multiple blockchains, designed specifically for payment applications, compliance, and financial analytics. +Bitquery provides dedicated **[Stablecoin APIs](/docs/category/stablecoin-apis/)** for comprehensive stablecoin data across multiple blockchains, designed specifically for payment applications, compliance, and financial analytics. **Key Features:** -- **Real-time Price Monitoring**: Track stablecoin [price deviations](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-price-api.md) and arbitrage opportunities -- **Payment Detection**: Instant identification of incoming [stablecoin transfers](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-payments-api.md) +- **Real-time Price Monitoring**: Track stablecoin [price deviations](/docs/stablecoin-APIs/stablecoin-price-api/) and arbitrage opportunities +- **Payment Detection**: Instant identification of incoming [stablecoin transfers](/docs/stablecoin-APIs/stablecoin-payments-api/) - **Multi-chain Support**: USDT, USDC, DAI, and other stablecoins across all supported chains - **Compliance Tools**: AML/KYC support with transaction monitoring - **Cross-chain Analytics**: Unified view of stablecoin movements across ecosystems **Available APIs:** -- **[Stablecoin Price API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-price-api.md)** - Real-time price tracking and deviation monitoring -- **[Stablecoin Payments API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-payments-api.md)** - Payment detection and compliance tools -- **[Stablecoin Trades API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-trades-api.md)** - Trading data and volume analytics +- **[Stablecoin Price API](/docs/stablecoin-APIs/stablecoin-price-api/)** - Real-time price tracking and deviation monitoring +- **[Stablecoin Payments API](/docs/stablecoin-APIs/stablecoin-payments-api/)** - Payment detection and compliance tools +- **[Stablecoin Trades API](/docs/stablecoin-APIs/stablecoin-trades-api/)** - Trading data and volume analytics - **USDT API** - Specialized Tether data across all chains ### **Mempool Monitoring - Pre-Confirmation Data** @@ -138,7 +138,7 @@ Access real-time data from the mempool before transactions are confirmed, enabli - **Tron Mempool**: TRX network pending transaction tracking - **Kafka Mempool Streams**: Ultra-low latency mempool data via Protocol Buffers -**Learn More:** [Mempool Subscriptions](https://docs.bitquery.io/docs/subscriptions/mempool-subscriptions/) +**Learn More:** [Mempool Subscriptions](/docs/subscriptions/mempool-subscriptions/) ### **Advanced Features & Enterprise Capabilities** @@ -156,7 +156,7 @@ Access real-time data from the mempool before transactions are confirmed, enabli - **Custom Aggregations**: Build sophisticated analytics with custom time windows and metrics - **Cross-chain Analytics**: Unified analytics across multiple blockchain ecosystems -**Learn More:** [Advanced Features](https://docs.bitquery.io/docs/subscriptions/backfilling-subscription/) +**Learn More:** [Advanced Features](/docs/subscriptions/backfilling-subscription/) ## Developer Interfaces @@ -221,7 +221,6 @@ Chains from the Early Access Program (EAP) have moved to v2. } ``` - **Advanced Query Features:** - **Nested filtering**: Filter by multiple criteria across related entities - **Time-based queries**: Query by specific time ranges, intervals, or relative periods @@ -232,7 +231,7 @@ Chains from the Early Access Program (EAP) have moved to v2. ### **Real-time Subscriptions (WebSocket)** Convert any query to a live stream by changing `query` to `subscription`. Our WebSocket implementation provides real-time blockchain data with sub-second latency. -**Learn More:** [WebSocket Subscriptions](https://docs.bitquery.io/docs/subscriptions/websockets/) +**Learn More:** [WebSocket Subscriptions](/docs/subscriptions/websockets/) **WebSocket Features:** - **Protocol Support**: Both `graphql-ws` and `subscriptions-transport-ws` protocols @@ -285,7 +284,6 @@ subscription { } ``` - **WebSocket Connection Example (JavaScript):** ```javascript import { createClient } from 'graphql-ws'; @@ -329,7 +327,7 @@ const unsubscribe = client.subscribe( ### **Kafka Streaming** High-throughput streaming for enterprise applications with pre-parsed Protocol Buffers. Our Kafka infrastructure provides enterprise-grade data streaming with guaranteed delivery and horizontal scalability. -**Learn More:** [Kafka Streaming Concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) +**Learn More:** [Kafka Streaming Concepts](/docs/streams/kafka-streaming-concepts/) **Kafka Infrastructure:** - **Broker**: `streaming.bitquery.io:9092` @@ -388,7 +386,6 @@ for message in consumer: print(f"Block: {trade.block.number}") ``` - **Kafka Features:** - **Schema Evolution**: Backward and forward compatible Protocol Buffer schemas - **Consumer Groups**: Scale horizontally with multiple consumers @@ -451,26 +448,26 @@ Raw and processed data available in cloud storage for machine learning, deep ana - Use OAuth2 for secure, programmatic access ### 3. **Run Your First Query** -- Try our [starter queries](https://docs.bitquery.io/docs/start/starter-queries/) for common use cases +- Try our [starter queries](/docs/start/starter-queries/) for common use cases - Use the IDE's autocomplete (Ctrl+Space) for query building - Convert queries to subscriptions for real-time data ### 4. **Explore Blockchain-Specific APIs** -- **[Ethereum APIs](https://docs.bitquery.io/docs/blockchain/Ethereum/)** - Complete EVM ecosystem data -- **[Solana APIs](https://docs.bitquery.io/docs/blockchain/Solana/)** - High-speed blockchain analytics -- **[BSC APIs](https://docs.bitquery.io/docs/blockchain/BSC/)** - Binance Smart Chain data -- **[Trading APIs](https://docs.bitquery.io/docs/trading/)** - Real-time price and trading data +- **[Ethereum APIs](/docs/blockchain/Ethereum/)** - Complete EVM ecosystem data +- **[Solana APIs](/docs/blockchain/Solana/)** - High-speed blockchain analytics +- **[BSC APIs](/docs/blockchain/BSC/)** - Binance Smart Chain data +- **[Trading APIs](/docs/category/trading-apis/)** - Real-time price and trading data ## Use Cases & Applications ### **DeFi Applications** -- **DEX Aggregators**: Best [price discovery](https://docs.bitquery.io/docs/evm/dextrades/) across multiple DEXs +- **DEX Aggregators**: Best [price discovery](/docs/schema/evm/dextrades/) across multiple DEXs - **Yield Farming**: Track liquidity positions and rewards - **Lending Protocols**: Monitor collateral ratios and liquidations - **Cross-chain Bridges**: Track asset movements between chains ### **Trading & Analytics** -- **Trading Bots**: Real-time price feeds with 1-second aggregation and market data via [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) +- **Trading Bots**: Real-time price feeds with 1-second aggregation and market data via [Crypto Price API](/docs/trading/crypto-price-api/introduction/) - **Portfolio Trackers**: Multi-chain wallet monitoring - **Market Analytics**: Volume, liquidity, and price analysis - **Arbitrage Detection**: Cross-chain and cross-DEX opportunities @@ -510,9 +507,9 @@ Raw and processed data available in cloud storage for machine learning, deep ana ## Support & Community ### **Documentation & Resources** -- **[Complete API Documentation](https://docs.bitquery.io/docs/)** - Comprehensive guides for all features -- **[Code Examples](https://docs.bitquery.io/docs/usecases/)** - Real-world implementation examples -- **[Video Tutorials](https://docs.bitquery.io/docs/blockchain/Ethereum/)** - Step-by-step guides +- **[Complete API Documentation](/docs/intro/)** - Comprehensive guides for all features +- **[Code Examples](/docs/category/how-to-guides/)** - Real-world implementation examples +- **[Video Tutorials](/docs/blockchain/Ethereum/)** - Step-by-step guides - **[Postman Collection](https://www.postman.com/interstellar-eclipse-270749/workspace/bitquery)** - Ready-to-use API examples ### **Community Support** @@ -521,22 +518,21 @@ Raw and processed data available in cloud storage for machine learning, deep ana - **[Support Desk](https://support.bitquery.io/)** - Technical issues and data problems ### **Learning Resources** -- **[Learning Path](https://docs.bitquery.io/docs/start/learning-path/)** - Structured learning from beginner to advanced -- **[Starter Queries](https://docs.bitquery.io/docs/start/starter-queries/)** - Pre-built queries for common use cases -- **[GraphQL Guide](https://docs.bitquery.io/docs/graphql/)** - Complete GraphQL reference -- **[Integration Examples](https://docs.bitquery.io/docs/usecases/)** - Real-world application examples +- **[Learning Path](/docs/start/learning-path/)** - Structured learning from beginner to advanced +- **[Starter Queries](/docs/start/starter-queries/)** - Pre-built queries for common use cases +- **[GraphQL Guide](/docs/category/building-queries/)** - Complete GraphQL reference +- **[Integration Examples](/docs/category/how-to-guides/)** - Real-world application examples ## Next Steps Ready to start building with blockchain data? Here's your path forward: 1. **[Create Your Account](https://ide.bitquery.io/)** - Get instant access to our platform -2. **[Run Your First Query](https://docs.bitquery.io/docs/start/first-query/)** - Learn the basics in 5 minutes -3. **[Explore Blockchain APIs](https://docs.bitquery.io/docs/blockchain/)** - Dive into specific blockchain data -4. **[Build Real-time Applications](https://docs.bitquery.io/docs/subscriptions/)** - Set up live data streams +2. **[Run Your First Query](/docs/start/first-query/)** - Learn the basics in 5 minutes +3. **[Explore Blockchain APIs](/docs/blockchain/supported-chains/)** - Dive into specific blockchain data +4. **[Build Real-time Applications](/docs/category/graphql-subscriptions/)** - Set up live data streams 5. **[Join Our Community](https://t.me/Bloxy_info)** - Get help and share your projects - - - - - - - - - - - - - - - # Bags.fm API on Robinhood **[Bags.fm](https://bags.fm/)** is a token launchpad on the **Robinhood** network where tokens trade on a bonding-curve AMM. This guide focuses on **Bags.fm trading data** — live and historical trades, USD prices, OHLCV/K-line candles, market cap, whale trades, top traders, and the raw bonding-curve `TokensBought`/`TokensSold` events — using Bitquery's `Trading` and `EVM(network: robinhood)` APIs. @@ -44,7 +28,7 @@ keywords: :::note API Key Required To query or stream data outside the Bitquery IDE, you need an API access token. -Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorisation/how-to-generate/) +Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: :::tip Related docs diff --git a/docs/blockchain/robinhood/flap-sh-api.md b/docs/blockchain/robinhood/flap-sh-api.md index b620cd30..98b7b6a3 100644 --- a/docs/blockchain/robinhood/flap-sh-api.md +++ b/docs/blockchain/robinhood/flap-sh-api.md @@ -1,6 +1,6 @@ --- title: "Flap.sh API on Robinhood" -description: "Track Flap.sh newly launched tokens and trades on Robinhood with Bitquery. Detect TokenCreated events, mint transfers, and stream Flap.sh market trades via EVM and Trading APIs." +description: "Flap.sh API on Robinhood: query and stream Robinhood on-chain data with Bitquery GraphQL examples for developers. Great for bots, dashboards, and alerts." sidebar_position: 4 keywords: - Flap.sh API @@ -22,7 +22,6 @@ keywords: - Flap.sh VanityTokenCreated - Flap.sh MsgSent social event --- - # Flap.sh API on Robinhood **Flap.sh** is a token launchpad on the **Robinhood** network. This guide shows how to track **newly launched Flap.sh tokens**, **Flap.sh trades**, and **lifecycle events** — token graduations, bonding-curve progress, supply changes, tax paid, vanity tokens, and social messages — with Bitquery GraphQL APIs, using the `EVM(network: robinhood)` and `Trading` cubes. @@ -30,7 +29,7 @@ keywords: :::note API Key Required To query or stream data outside the Bitquery IDE, you need an API access token. -Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorisation/how-to-generate/) +Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: :::tip Related docs diff --git a/docs/blockchain/robinhood/robinhood-meme-coin-launches.md b/docs/blockchain/robinhood/robinhood-meme-coin-launches.md index 06c5a3ec..4fad8ad9 100644 --- a/docs/blockchain/robinhood/robinhood-meme-coin-launches.md +++ b/docs/blockchain/robinhood/robinhood-meme-coin-launches.md @@ -1,6 +1,6 @@ --- title: "Robinhood Meme Coin Launches API" -description: "Track meme coin token launches on Robinhood with Bitquery. Detect new token creations from Flap.sh, Klik Finance, Bankr, Ape.store, Bags.fm, and Clanker." +description: "Robinhood Meme Coin Launches API: query and stream Robinhood on-chain data with Bitquery GraphQL examples for developers." sidebar_position: 3 keywords: - Robinhood meme coin launches API @@ -25,7 +25,6 @@ keywords: - Bitquery Robinhood Events API - Bitquery Robinhood Transfers API --- - # Robinhood Meme Coin Launches API Track **meme coin token launches on Robinhood** with Bitquery GraphQL APIs. This guide shows how to detect newly created tokens from popular Robinhood launchpads and bots — **hood.fun**, **LaunchHood**, **Virtuals**, **Flap.sh**, **Klik Finance**, **Bankr Bot**, **Ape.store**, **Bags.fm**, and **Clanker** — using `EVM(network: robinhood)` Events and Transfers cubes. @@ -33,7 +32,7 @@ Track **meme coin token launches on Robinhood** with Bitquery GraphQL APIs. This :::note API Key Required To query or stream data outside the Bitquery IDE, you need an API access token. -Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorisation/how-to-generate/) +Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: :::tip Related docs diff --git a/docs/blockchain/robinhood/robinhood-token-supply.md b/docs/blockchain/robinhood/robinhood-token-supply.md index ab9f6eb2..c8e0d42b 100644 --- a/docs/blockchain/robinhood/robinhood-token-supply.md +++ b/docs/blockchain/robinhood/robinhood-token-supply.md @@ -1,6 +1,6 @@ --- title: "Robinhood Token Supply API" -description: "Get the latest total supply of a token, stream real-time supply updates, and fetch supply for all active tokens on Robinhood with Bitquery's EVM TransactionBalances API." +description: "Robinhood Token Supply API: stream Robinhood market cap, FDV, supply, and price using Bitquery Trading GraphQL APIs. See examples in the Bitquery IDE." sidebar_position: 5 keywords: - Robinhood token supply API @@ -13,7 +13,6 @@ keywords: - Bitquery Robinhood supply API - Robinhood token circulating supply --- - # Robinhood Token Supply API Get **token total supply** on the **Robinhood** network with Bitquery's `EVM.TransactionBalances` API. This guide covers the **latest supply of a token**, a **real-time supply stream**, and the **supply of all active tokens**. @@ -21,7 +20,7 @@ Get **token total supply** on the **Robinhood** network with Bitquery's `EVM.Tra :::note API Key Required To query or stream data outside the Bitquery IDE, you need an API access token. -Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorisation/how-to-generate/) +Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: :::tip Related docs diff --git a/docs/blockchain/robinhood/robinhood-trades.md b/docs/blockchain/robinhood/robinhood-trades.md index 3644f9a2..f509d6a2 100644 --- a/docs/blockchain/robinhood/robinhood-trades.md +++ b/docs/blockchain/robinhood/robinhood-trades.md @@ -1,6 +1,6 @@ --- title: "Robinhood Trades API" -description: "Query and stream Robinhood token trades, prices, OHLCV, market cap, whale trades, and top traders with Bitquery Trading APIs, scoped with NetworkBid bid:robinhood." +description: "Robinhood Trades API: query and stream Robinhood on-chain data with Bitquery GraphQL examples for developers. Covers archive history and realtime data." sidebar_position: 1 keywords: - Robinhood API @@ -16,22 +16,6 @@ keywords: - Robinhood K-line candles - Bitquery Robinhood Trading API --- - - - - - - - - - - - - - - - - # Robinhood Trades API & Streams Bitquery exposes **Robinhood** trade and price data through the **Trading** APIs. Use these queries and real-time GraphQL subscriptions to get **live trades, USD prices, OHLCV/K-line candles, market cap, whale trades, top traders, and token leaderboards** on Robinhood — all scoped with the `bid:robinhood` network filter. @@ -39,16 +23,16 @@ Bitquery exposes **Robinhood** trade and price data through the **Trading** APIs :::note API Key Required To query or stream data outside the Bitquery IDE, you need an API access token. -Follow the steps here: [How to generate Bitquery API token ➤](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Follow the steps here: [How to generate Bitquery API token ➤](/docs/authorization/how-to-generate/) ::: :::tip Related docs - [Robinhood Transfers](/docs/blockchain/robinhood/robinhood-transfers) - [Robinhood Token Supply API](/docs/blockchain/robinhood/robinhood-token-supply) - [Robinhood Meme Coin Launches API](/docs/blockchain/robinhood/robinhood-meme-coin-launches) -- [Trading data overview](https://docs.bitquery.io/docs/trading/trading-data-overview/) -- [Crypto Trades API](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api/) -- [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) +- [Trading data overview](/docs/trading/trading-data-overview/) +- [Crypto Trades API](/docs/trading/crypto-trades-api/trades-api/) +- [Crypto Price API](/docs/trading/crypto-price-api/introduction/) ::: --- @@ -592,7 +576,7 @@ Rank the biggest traders of a specific token by total USD volume, with a buy/sel Get the latest USD normalised price of a token on Robinhood network using this API endpoint using `Trading.Tokens`. -:::note A single token might be traded on multiple pools, with each pool having a difference in price. As for the price returned by Bitquery we provide the weighted average price across all pools. To know more about the price calculation refer to [this](https://docs.bitquery.io/docs/trading/crypto-price-api/price-index-algorithm/#how-token-prices-are-determined) document. +:::note A single token might be traded on multiple pools, with each pool having a difference in price. As for the price returned by Bitquery we provide the weighted average price across all pools. To know more about the price calculation refer to [this](/docs/trading/crypto-price-api/price-index-algorithm/#how-token-prices-are-determined) document. If you want to monitor price for a particular pool, we suggest usage of `Trading.Pairs` instead of `Trading.Tokens` where you could specify the pool address. ::: diff --git a/docs/blockchain/robinhood/robinhood-transfers.md b/docs/blockchain/robinhood/robinhood-transfers.md index 74b28c4d..317ec311 100644 --- a/docs/blockchain/robinhood/robinhood-transfers.md +++ b/docs/blockchain/robinhood/robinhood-transfers.md @@ -1,6 +1,6 @@ --- -title: "Robinhood Transfers" -description: "Query and stream token transfers on Robinhood with Bitquery EVM Transfers APIs. Track senders, receivers, amounts, and token metadata in real time and historically." +title: "Robinhood Transfers API" +description: "Robinhood Transfers API: monitor Robinhood native and token transfers in real time with Bitquery GraphQL APIs. Keep queries fast with indexed filters." sidebar_position: 2 keywords: - Robinhood transfers API @@ -10,14 +10,13 @@ keywords: - Robinhood token transfers api - Robinhood wallet transfers api --- - # Robinhood Transfers Bitquery exposes **Robinhood** transfer data through the **EVM Transfers** APIs. Use `network: robinhood` on the `EVM` root to scope queries and subscriptions to Robinhood. :::tip Related docs -- [ERC20 Token Transfers API (Ethereum)](https://docs.bitquery.io/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api/) -- [EVM Transfers](https://docs.bitquery.io/docs/evm/transfers/) +- [ERC20 Token Transfers API (Ethereum)](/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api/) +- [EVM Transfers](/docs/schema/evm/transfers/) - [Robinhood Trades](/docs/blockchain/robinhood/robinhood-trades) ::: diff --git a/docs/blockchain/supported-chains.mdx b/docs/blockchain/supported-chains.mdx index 55e5b198..c445b7c4 100644 --- a/docs/blockchain/supported-chains.mdx +++ b/docs/blockchain/supported-chains.mdx @@ -1,6 +1,6 @@ --- -title: Supported blockchains & networks (V1, V2, Kafka, gRPC, ClickHouse) -description: "Compare Bitquery coverage across Bitcoin, Ethereum, Solana, BNB Chain, Polygon, Base, Arbitrum, Optimism, Tron, and 15+ other networks. See which chains are available on V1 GraphQL, V2 GraphQL WebSocket, Kafka protobuf, Solana CoreCast gRPC, ClickHouse replica SQL, and cloud Parquet exports." +title: "Supported Blockchains and Networks" +description: "See which blockchains Bitquery supports across V1, V2 GraphQL, Kafka, gRPC, ClickHouse Cloud, and Parquet exports. Keep queries fast with indexed filters." sidebar_position: 0 image: img/heroImage4.png keywords: @@ -17,7 +17,6 @@ keywords: - GraphQL WebSocket chains - real-time crypto data chains --- - import Head from "@docusaurus/Head"; @@ -33,7 +32,7 @@ import Head from "@docusaurus/Head"; publisher: { "@type": "Organization", name: "Bitquery", url: "https://bitquery.io" }, mainEntityOfPage: { "@type": "WebPage", - "@id": "https://docs.bitquery.io/docs/blockchain/supported-chains/", + "@id": "/docs/blockchain/supported-chains/", }, keywords: "blockchain API, multichain, Ethereum, Solana, Bitcoin, BSC, Polygon, Kafka, GraphQL, ClickHouse", @@ -103,11 +102,11 @@ This guide lists **which blockchains Bitquery indexes** and how that lines up wi | Product | Get started | |--------|-------------| -| **V2** | [Bitquery platform](https://bitquery.io/) · [Data streams](https://bitquery.io/products/data-streams) · [WebSocket streams](https://bitquery.io/products/websocket-streams) · Docs: [Intro](https://docs.bitquery.io/docs/intro/) · Chains: [Ethereum](https://bitquery.io/blockchains/ethereum-blockchain-api), [BNB Chain](https://docs.bitquery.io/docs/blockchain/BSC/), [Arbitrum](https://bitquery.io/blockchains/arbitrum-blockchain-api), [Optimism](https://bitquery.io/blockchains/optimism-blockchain-api), [Base](https://bitquery.io/blockchains/base-blockchain-api), [Polygon](https://bitquery.io/blockchains/polygon-blockchain-api), [Solana](https://bitquery.io/blockchains/solana-blockchain-api), [Tron](https://bitquery.io/blockchains/tron-blockchain-api), [Robinhood](/docs/blockchain/robinhood/) | +| **V2** | [Bitquery platform](https://bitquery.io/) · [Data streams](https://bitquery.io/products/data-streams) · [WebSocket streams](https://bitquery.io/products/websocket-streams) · Docs: [Intro](/docs/intro/) · Chains: [Ethereum](https://bitquery.io/blockchains/ethereum-blockchain-api), [BNB Chain](/docs/blockchain/BSC/), [Arbitrum](https://bitquery.io/blockchains/arbitrum-blockchain-api), [Optimism](https://bitquery.io/blockchains/optimism-blockchain-api), [Base](https://bitquery.io/blockchains/base-blockchain-api), [Polygon](https://bitquery.io/blockchains/polygon-blockchain-api), [Solana](https://bitquery.io/blockchains/solana-blockchain-api), [Tron](https://bitquery.io/blockchains/tron-blockchain-api), [Robinhood](/docs/blockchain/robinhood/) | | **V1** | [Bitquery platform](https://bitquery.io/) · [V1 documentation](https://docs.bitquery.io/v1/) · [V1 vs V2 (IDE & schema)](https://docs.bitquery.io/v1/docs/graphql-ide/v1-and-v2) | -| **Kafka** | [Kafka streams](https://bitquery.io/products/kafka-streams) · [Real-time streaming hub](https://bitquery.io/products/streaming) · Docs: [Streams overview](https://docs.bitquery.io/docs/streams/) · [Kafka concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) | -| **Cloud** | [Streaming & datashares](https://bitquery.io/products/streaming) · Docs: [Cloud data](https://docs.bitquery.io/docs/cloud/) · [EVM](https://docs.bitquery.io/docs/cloud/evm/) · [Solana](https://docs.bitquery.io/docs/cloud/solana/) · [Bitcoin](https://docs.bitquery.io/docs/cloud/bitcoin/) · [Tron](https://docs.bitquery.io/docs/cloud/tron/) | -| **ClickHouse replica** | [ClickHouse data warehouse](https://bitquery.io/products/data-warehouse) · [MCP server](https://bitquery.io/products/bitquery-mcp-server) · [MCP docs](https://docs.bitquery.io/docs/mcp/mcp-server/) | +| **Kafka** | [Kafka streams](https://bitquery.io/products/kafka-streams) · [Real-time streaming hub](https://bitquery.io/products/streaming) · Docs: [Streams overview](/docs/streams/) · [Kafka concepts](/docs/streams/kafka-streaming-concepts/) | +| **Cloud** | [Streaming & datashares](https://bitquery.io/products/streaming) · Docs: [Cloud data](/docs/cloud/) · [EVM](/docs/cloud/evm/) · [Solana](/docs/cloud/solana/) · [Bitcoin](/docs/cloud/bitcoin/) · [Tron](/docs/cloud/tron/) | +| **ClickHouse replica** | [ClickHouse data warehouse](https://bitquery.io/products/data-warehouse) · [MCP server](https://bitquery.io/products/bitquery-mcp-server) · [MCP docs](/docs/mcp/mcp-server/) | --- diff --git a/docs/cloud/bitcoin.md b/docs/cloud/bitcoin.md index df61ca6a..7e176d15 100644 --- a/docs/cloud/bitcoin.md +++ b/docs/cloud/bitcoin.md @@ -1,6 +1,6 @@ --- title: Bitcoin Data - Snowflake, AWS S3, GCP BigQuery -description: Export Bitcoin blockchain data to cloud storage with Parquet datasets optimized for Snowflake, AWS S3, Google BigQuery, and data lakes. Get blocks, transactions, inputs, outputs, and OMNI data for large-scale analytics. +description: "Bitcoin Data - Snowflake, AWS S3, GCP BigQuery from Bitquery cloud datasets using Parquet historical exports for S3, BigQuery, and Snowflake." keywords: - Bitcoin blockchain data - Bitcoin GCP Bigquery @@ -22,7 +22,6 @@ keywords: - Bitcoin data dumps sidebar_position: 3 --- - # Bitcoin Data Bitquery provides **Bitcoin blockchain data dumps** in **Parquet format**, designed for large-scale analytics, historical backfills, and data lake integrations. @@ -62,8 +61,6 @@ https://bitquery-blockchain-dataset.s3.us-east-1.amazonaws.com/bitcoin/blocks/ **Looking for the product-family choice first?** This page is the **cube-by-cube row-shape** comparison. For the higher-level "should I use chain-level trades or the curated Trading cube?" decision (with the full Trading cube family — `Trading.Trades`, `Tokens`, `Currencies`, `Pairs`), start with the [**Trading Data Overview**](https://docs.bitquery.io/docs/trading/trading-data-overview). +> **Looking for the product-family choice first?** This page is the **cube-by-cube row-shape** comparison. For the higher-level "should I use chain-level trades or the curated Trading cube?" decision (with the full Trading cube family — `Trading.Trades`, `Tokens`, `Currencies`, `Pairs`), start with the [**Trading Data Overview**](/docs/trading/trading-data-overview). Bitquery exposes **three** common ways to work with **DEX swap–level** data. They differ by **GraphQL root**, **row shape** (how each swap is represented), and **what fields are normalized for you**. @@ -15,7 +14,7 @@ This page compares them so you can pick the right primitive before you write fil ## At a glance -| | **DEXTrades** | **DEXTradeByTokens** | **Trades cube** (`Trading { Trades }` — [Crypto Trades API](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api)) | +| | **DEXTrades** | **DEXTradeByTokens** | **Trades cube** (`Trading { Trades }` — [Crypto Trades API](/docs/trading/crypto-trades-api/trades-api)) | |---|----------------|----------------------|---------------------------------------------| | **GraphQL root** | Chain APIs such as `EVM(...)`, `Solana { ... }`, `Tron { ... }` | Same chain roots | `Trading { Trades }` | | **Focus (by chain)** | **EVM / Tron:** **Pool-focused**—`Buy`/`Sell` follow the pool’s perspective ([DEXTrades cube](/docs/cubes/dextrades)). **Solana:** **Trader-focused**—natural fit for signer, buyer/seller, and account-style filters (see [Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades), [trader patterns](/docs/blockchain/Solana/solana-trader-API)). | **EVM / Tron:** Still **pool-relative** on the **`Side`** leg (e.g. `Side.Type` vs pool); rows are **token-expanded**, not “wallet-first.” **Solana:** **Trader-focused** in practice—e.g. buyers/sellers and volume by **`Transaction.Signer`** and `Side.Type` in [Solana examples](/docs/blockchain/Solana/solana-dextrades). | **Trader-focused** everywhere: first-class **`Trader.Address`**, **`Pair`**, **`Side`**, and USD fields aligned to the [Price Index](/docs/trading/crypto-price-api/price-index-algorithm). | @@ -25,7 +24,7 @@ This page compares them so you can pick the right primitive before you write fil | **Best when you need** | **EVM:** one record per pool swap, protocol/pool analytics, multi-hop debugging. **Solana:** trades by **wallet** / signer / account, buy vs sell counts, DEX-level analytics on chain. | **EVM:** token-level OHLC from raw trades, “all pairs for this token,” portfolio-style filters (with dedupe discipline). **Solana:** token **and** trader analytics (buyers, sellers, makers) in one model. | **Real-time** (or windowed) **multi-chain** swap stream, **trader-centric** apps, **reliable USD** on each row, **supply snapshot** (market cap, FDV, circulating/total/max). | | **Watch out for** | On **EVM**, `Buy`/`Sell` are **pool**-relative—not the end-user’s intuition without reading the field docs. | **Double counting** if you sum without filtering by token or deduplicating (e.g. by transaction hash / index). | Not a substitute for **pre-aggregated OHLC** on **Tokens** / **Pairs**; for aggregated charts prefer [Crypto Price API](/docs/trading/crypto-price-api/introduction) unless you need raw swap rows | -Full reference pages: [DEXTrades cube](/docs/cubes/dextrades), [DEXTradesByTokens cube](/docs/cubes/dextradesbyTokens), [Crypto Trades API — `Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api). +Full reference pages: [DEXTrades cube](/docs/cubes/dextrades), [DEXTradesByTokens cube](/docs/cubes/dextradesbyTokens), [Crypto Trades API — `Trades`](/docs/trading/crypto-trades-api/trades-api). --- @@ -61,9 +60,9 @@ The [DEXTradesByTokens](/docs/cubes/dextradesbyTokens) / **`DEXTradeByTokens`** ## Trades cube (Crypto Trades API — trader-focused, strong USD) -The **`Trades`** field under **`Trading`** is documented as the [Crypto Trades API — real-time DEX trade streams](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api). It is **not** nested under `EVM` / `Solana` per chain in the same way; you use **`Trading { Trades }`** and narrow with **`Pair.Market.Network`**, token ids, and **`Trader.Address`**. +The **`Trades`** field under **`Trading`** is documented as the [Crypto Trades API — real-time DEX trade streams](/docs/trading/crypto-trades-api/trades-api). It is **not** nested under `EVM` / `Solana` per chain in the same way; you use **`Trading { Trades }`** and narrow with **`Pair.Market.Network`**, token ids, and **`Trader.Address`**. -**Trader-first model:** Rows are built for **who traded**—**`Trader.Address`** is a first-class filter—alongside **`Pair`**, **`Side`**, and amounts. That is the natural API for **wallet streams**, **leaderboards**, and **per-user** trade history across **Solana**, **Ethereum**, **BSC**, **Base**, **Arbitrum**, and **Polygon** in one schema ([Trades API](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api)). +**Trader-first model:** Rows are built for **who traded**—**`Trader.Address`** is a first-class filter—alongside **`Pair`**, **`Side`**, and amounts. That is the natural API for **wallet streams**, **leaderboards**, and **per-user** trade history across **Solana**, **Ethereum**, **BSC**, **Base**, **Arbitrum**, and **Polygon** in one schema ([Trades API](/docs/trading/crypto-trades-api/trades-api)). **USD vs chain DEX cubes:** On **`DEXTrades`** / **`DEXTradeByTokens`**, **`PriceInUSD`** is often **missing or zero** for **meme or thinly traded** tokens (see [DEXTrades cube](/docs/cubes/dextrades) pricing notes). The **`Trades`** cube is different: **`PriceInUsd`** and **`AmountsInUsd`** are tied to the **Trading price index**, so you **usually get usable USD** for the same long-tail assets where raw chain DEX USD fields fail. Details: [Price Index Algorithm](/docs/trading/crypto-price-api/price-index-algorithm). @@ -75,7 +74,7 @@ The **`Trades`** field under **`Trading`** is documented as the [Crypto Trades A - **Token filter:** **`Pair.Token.Id`** with the full id (e.g. `bid:solana:`, `bid:eth:`) per dataset conventions. - **Trader filter:** **`Trader.Address`**. -For **aggregated** token metrics across pairs, use **[Tokens](https://docs.bitquery.io/docs/trading/crypto-price-api/tokens)**; for **pair-level** OHLC intervals, use **[Pairs](https://docs.bitquery.io/docs/trading/crypto-price-api/pairs)**—as noted on the [Trades API page](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api). +For **aggregated** token metrics across pairs, use **[Tokens](/docs/trading/crypto-price-api/tokens)**; for **pair-level** OHLC intervals, use **[Pairs](/docs/trading/crypto-price-api/pairs)**—as noted on the [Trades API page](/docs/trading/crypto-trades-api/trades-api). --- @@ -85,7 +84,7 @@ For **aggregated** token metrics across pairs, use **[Tokens](https://docs.bitqu 2. **Token-expanded rows**, OHLC **from raw DEX trades**, or **Solana** maker/buyer/seller aggregates on **`DEXTradeByTokens`**? → **`DEXTradeByTokens`**, with **strict filters** on **EVM** so counts are not doubled. -3. **Trader-centric** product, **multi-chain** `Trading` stream, **reliable USD** (including meme / long-tail), plus **supply** on each row? → **`Trading { Trades }`** ([Crypto Trades API](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api)). +3. **Trader-centric** product, **multi-chain** `Trading` stream, **reliable USD** (including meme / long-tail), plus **supply** on each row? → **`Trading { Trades }`** ([Crypto Trades API](/docs/trading/crypto-trades-api/trades-api)). 4. **Need pre-built candles / moving averages / mean price** without aggregating raw swaps yourself? → **[Crypto Price API](/docs/trading/crypto-price-api/introduction)** (**Tokens**, **Pairs**, **Currencies**)—not the same as **`Trades`**, as explained in the [mental model](/docs/start/mental-model-transfers-events-calls#trading-crypto-price-cube). @@ -93,7 +92,7 @@ For **aggregated** token metrics across pairs, use **[Tokens](https://docs.bitqu ## Chain hub examples -These guides start with a **live swap stream** from the [Crypto Trades API](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) (IDE link where we ship a saved query), then keep **`DEXTrades`** / **`DEXTradeByTokens`** for pools, OHLC, and analytics: +These guides start with a **live swap stream** from the [Crypto Trades API](/docs/trading/crypto-trades-api/trades-api) (IDE link where we ship a saved query), then keep **`DEXTrades`** / **`DEXTradeByTokens`** for pools, OHLC, and analytics: - [BNB (BSC) DEX Trades](/docs/blockchain/BSC/bsc-dextrades) - [Base DEX Trades](/docs/blockchain/Base/base-dextrades) @@ -110,5 +109,5 @@ These guides start with a **live swap stream** from the [Crypto Trades API](http - [Mental model: transfers, events, calls, DEX, Trading](/docs/start/mental-model-transfers-events-calls) - [DEXTrades cube](/docs/cubes/dextrades) - [DEXTradesByTokens cube](/docs/cubes/dextradesbyTokens) -- [Crypto Trades API — `Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) +- [Crypto Trades API — `Trades`](/docs/trading/crypto-trades-api/trades-api) - [GraphQL limits](/docs/graphql/limits) (paging, `orderBy`, time windows) diff --git a/docs/cubes/dextrades.mdx b/docs/cubes/dextrades.mdx index 39b0957c..efa5effd 100644 --- a/docs/cubes/dextrades.mdx +++ b/docs/cubes/dextrades.mdx @@ -1,12 +1,16 @@ +--- +title: "DEX Trades Cube" +description: "Use Bitquery’s DEX Trades cube to query swap-level DEX activity with filters, aggregates, and GraphQL examples for multi-chain analytics." +--- # DEXTrades Cube import VideoPlayer from "../../src/components/videoplayer.js"; :::tip Need real-time data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this page when you need **historical data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this page when you need **historical data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. ::: -> **Before you start**: Not sure when to use DexTrades vs DexTradesByTokens vs Events vs Calls? Read our [Mental Model guide](https://docs.bitquery.io/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. For a 1-page comparison of these three trade cubes, see [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades). +> **Before you start**: Not sure when to use DexTrades vs DexTradesByTokens vs Events vs Calls? Read our [Mental Model guide](/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. For a 1-page comparison of these three trade cubes, see [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades). The DEXTrades cube provides comprehensive information about the dex trading data, such as buyer, seller, token prices, pairs, transactions, etc. @@ -79,7 +83,6 @@ Take this query for example: } } - ``` Output diff --git a/docs/cubes/dextradesbyTokens.md b/docs/cubes/dextradesbyTokens.md index c64a6a0f..8dc4b4a3 100644 --- a/docs/cubes/dextradesbyTokens.md +++ b/docs/cubes/dextradesbyTokens.md @@ -1,10 +1,14 @@ +--- +title: "DEXTradesByTokens Cube" +description: "DEXTradesByTokens Cube: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance. Keep queries fast with indexed filters." +--- # DEXTradesByTokens Cube :::tip Need real-time data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API**. Use this cube when you need **historical data older than ~30 days** (with `dataset: combined` or `archive`), custom OHLC intervals, or token-expanded rows. +For **real-time + last ~30 days**, use the [**Trading cube**](/docs/trading/trading-data-overview) — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **9 chains in one API**. Use this cube when you need **historical data older than ~30 days** (with `dataset: combined` or `archive`), custom OHLC intervals, or token-expanded rows. ::: -> **Before you start**: Not sure when to use DexTradesByTokens vs DexTrades vs Events vs Calls? Read our [Mental Model guide](https://docs.bitquery.io/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. For a 1-page comparison of these three trade cubes, see [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades). +> **Before you start**: Not sure when to use DexTradesByTokens vs DexTrades vs Events vs Calls? Read our [Mental Model guide](/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. For a 1-page comparison of these three trade cubes, see [DEXTrades vs DEXTradeByTokens vs Trades cube](/docs/cubes/dextrades-dextradebytokens-trading-trades). The DEXTradesByTokens cube provides comprehensive information about DEX trading data from a token-centric perspective, showing both sides of each trade for every participant. This includes buyer, seller, token prices, pairs, transactions, OHLC data, and more. @@ -125,9 +129,9 @@ Trade { ## How do I get OHLC in a DEXTradeByTokens query? {#how-do-i-get-ohlc-in-a-dextradebytokens-query} -For OHLC, use the **[Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/)** (`Trading` → `Tokens` / `Pairs`) as the **main** source—pre-aggregated and simpler. **Use `DEXTradeByTokens` on this page when you need historical OHLC** or when you must derive candles from **raw DEX trades** for a specific token or pool. +For OHLC, use the **[Crypto Price API](/docs/trading/crypto-price-api/introduction/)** (`Trading` → `Tokens` / `Pairs`) as the **main** source—pre-aggregated and simpler. **Use `DEXTradeByTokens` on this page when you need historical OHLC** or when you must derive candles from **raw DEX trades** for a specific token or pool. -Aggregate trades into candles with **`Block { Time(interval: { count, in: minutes | hours | days }) }`** on **`DEXTradeByTokens`**, then derive **open / high / low / close** from **`PriceInUSD`** (or your chain’s price field)—for example **`minimum`** / **`maximum`** of **`Trade_PriceInUSD`** and **`minimum`/`maximum` of `Block_Number`** for open and close. Filter by **`Trade.Currency`** (token address or mint) and optionally **`Trade.Dex`**. The same pattern works on **`EVM`** and **`Solana`**; see also [Solana OHLC API](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/#solana-ohlc-api). +Aggregate trades into candles with **`Block { Time(interval: { count, in: minutes | hours | days }) }`** on **`DEXTradeByTokens`**, then derive **open / high / low / close** from **`PriceInUSD`** (or your chain’s price field)—for example **`minimum`** / **`maximum`** of **`Trade_PriceInUSD`** and **`minimum`/`maximum` of `Block_Number`** for open and close. Filter by **`Trade.Currency`** (token address or mint) and optionally **`Trade.Dex`**. The same pattern works on **`EVM`** and **`Solana`**; see also [Solana OHLC API](/docs/blockchain/Solana/solana-dextrades/#solana-ohlc-api). ```graphql { @@ -160,7 +164,7 @@ Aggregate trades into candles with **`Block { Time(interval: { count, in: minute ## How do I use DEXTradeByTokens vs DEXTrades for OHLCV? {#how-do-i-use-dextradebytokens-vs-dextrades-for-ohlcv} -For **OHLCV**, treat the **Crypto Price API** as the default—see [when to use which](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/#crypto-price-api-vs-dextradebytoken). Among DEX cubes, prefer **`DEXTradeByTokens`** for **one token’s** chart (all pools and sides from the token’s view with **`Trade`** + **`Side`**). Use **`DEXTrades`** when you need **each raw swap** as a row (pool **`Buy`/`Sell`** view, routing, or debugging). Both can power candles; **`DEXTradeByTokens`** is usually simpler for **per-token** open/high/low/close and volume. Compare with [DEXTrades](https://docs.bitquery.io/docs/cubes/dextrades/). +For **OHLCV**, treat the **Crypto Price API** as the default—see [when to use which](/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/#crypto-price-api-vs-dextradebytoken). Among DEX cubes, prefer **`DEXTradeByTokens`** for **one token’s** chart (all pools and sides from the token’s view with **`Trade`** + **`Side`**). Use **`DEXTrades`** when you need **each raw swap** as a row (pool **`Buy`/`Sell`** view, routing, or debugging). Both can power candles; **`DEXTradeByTokens`** is usually simpler for **per-token** open/high/low/close and volume. Compare with [DEXTrades](/docs/cubes/dextrades/). ## Filtering in DEXTradeByTokens Cube @@ -254,4 +258,4 @@ query UserActivityTracking( **`DEXTradeByTokens`** intentionally returns **multiple rows per swap** (token-centric **Trade** + **Side**). If you want to avoid this, please specify the **Side** currency. Alternatively, switch to **`DEXTrades`** if you need **one row per pool swap**. To deduplicate during analysis, group or filter by **`Transaction.Hash`** (and trade index when present). -For paging, use a **stable `orderBy`** and **time/blocks windows**; see [GraphQL limits](https://docs.bitquery.io/docs/graphql/limits/). Background: [DEXTrades vs DEXTradeByTokens](https://docs.bitquery.io/docs/cubes/dextradesbyTokens/#how-do-i-use-dextradebytokens-vs-dextrades-for-ohlcv) and the [mental model](https://docs.bitquery.io/docs/start/mental-model-transfers-events-calls). +For paging, use a **stable `orderBy`** and **time/blocks windows**; see [GraphQL limits](/docs/graphql/limits/). Background: [DEXTrades vs DEXTradeByTokens](/docs/cubes/dextradesbyTokens/#how-do-i-use-dextradebytokens-vs-dextrades-for-ohlcv) and the [mental model](/docs/start/mental-model-transfers-events-calls). diff --git a/docs/cubes/evm-dexpool.md b/docs/cubes/evm-dexpool.md index 84ed4cec..d9ed6ee0 100644 --- a/docs/cubes/evm-dexpool.md +++ b/docs/cubes/evm-dexpool.md @@ -1,13 +1,16 @@ +--- +title: "DEXPools Cube on EVM Chains" +description: "DEXPools Cube on EVM Chains: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance. See examples in the Bitquery IDE." +--- # DEXPools Cube on EVM Chains -This section explains how the dexpool data is built and shared via APIs and [Kafka streams](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). It also explains how to understand each entry of the response. +This section explains how the dexpool data is built and shared via APIs and [Kafka streams](/docs/streams/kafka-streaming-concepts/). It also explains how to understand each entry of the response. > **Note:** In GraphQL, DEXPools data is accessed through two schema cubes: > > - **`DEXPoolEvents`**: Provides pool event data (swaps, mints, burns, etc.) > - **`DEXPoolSlippages`**: Provides slippage and price impact data for different trade sizes - import VideoPlayer from "../../src/components/videoplayer.js"; @@ -125,18 +128,18 @@ Everything inside the "where" clause filters; it follows the `AND` condition by ## API Examples For blockchain-specific slippage API documentation, see: -- [Arbitrum Slippage API](https://docs.bitquery.io/docs/blockchain/Arbitrum/arbitrum-slippage-api/) -- [Base Slippage API](https://docs.bitquery.io/docs/blockchain/Base/base-slippage-api/) -- [BSC Slippage API](https://docs.bitquery.io/docs/blockchain/BSC/bsc-slippage-api/) -- [Matic Slippage API](https://docs.bitquery.io/docs/blockchain/Matic/matic-slippage-api/) +- [Arbitrum Slippage API](/docs/blockchain/Arbitrum/arbitrum-slippage-api/) +- [Base Slippage API](/docs/blockchain/Base/base-slippage-api/) +- [BSC Slippage API](/docs/blockchain/BSC/bsc-slippage-api/) +- [Matic Slippage API](/docs/blockchain/Matic/matic-slippage-api/) For blockchain-specific liquidity API documentation, see: -- [Arbitrum Liquidity API](https://docs.bitquery.io/docs/blockchain/Arbitrum/arbitrum-liquidity-api/) -- [Base Liquidity API](https://docs.bitquery.io/docs/blockchain/Base/base-liquidity-api/) -- [BSC Liquidity API](https://docs.bitquery.io/docs/blockchain/BSC/bsc-liquidity-api/) -- [Ethereum Liquidity API](https://docs.bitquery.io/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api/) -- [Matic Liquidity API](https://docs.bitquery.io/docs/blockchain/Matic/matic-liquidity-api/) +- [Arbitrum Liquidity API](/docs/blockchain/Arbitrum/arbitrum-liquidity-api/) +- [Base Liquidity API](/docs/blockchain/Base/base-liquidity-api/) +- [BSC Liquidity API](/docs/blockchain/BSC/bsc-liquidity-api/) +- [Ethereum Liquidity API](/docs/blockchain/Ethereum/dextrades/ethereum-liquidity-api/) +- [Matic Liquidity API](/docs/blockchain/Matic/matic-liquidity-api/) ## Advanced Use Cases and Processing Patterns diff --git a/docs/cubes/solana.md b/docs/cubes/solana.md index 7066a042..65057b90 100644 --- a/docs/cubes/solana.md +++ b/docs/cubes/solana.md @@ -1,10 +1,11 @@ --- sidebar_position: 2 +title: "Solana Builder Terms Explanation" +description: "Solana Builder Terms Explanation: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." --- - # Solana Builder Terms Explanation -> **Before you start**: Not sure when to use Transfers vs DEX Trades vs other data primitives? Read our [Mental Model guide](https://docs.bitquery.io/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. +> **Before you start**: Not sure when to use Transfers vs DEX Trades vs other data primitives? Read our [Mental Model guide](/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. ### Dataset Parameters diff --git a/docs/cubes/transaction-cube.md b/docs/cubes/transaction-cube.md index d18f8afa..78687a2b 100644 --- a/docs/cubes/transaction-cube.md +++ b/docs/cubes/transaction-cube.md @@ -1,3 +1,7 @@ +--- +title: "Transaction Cube" +description: "Transaction Cube: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance. Run it in the IDE, then ship in your app." +--- # Transaction Cube Transaction Cube provides comprehensive information about transactions, blocks, receipts, fees, transaction status, signatures, and more. You can check all the fields in [this query](https://ide.bitquery.io/transaction-cube-with-all-fields). diff --git a/docs/cubes/transfers-cube.md b/docs/cubes/transfers-cube.md index e615771d..d4e2319e 100644 --- a/docs/cubes/transfers-cube.md +++ b/docs/cubes/transfers-cube.md @@ -1,6 +1,10 @@ +--- +title: "Transfers Cube" +description: "Transfers Cube: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance. Keep queries fast with indexed filters." +--- # Transfer Cube -> **Before you start**: Not sure when to use Transfers vs Events vs Calls vs DexTrades? Read our [Mental Model guide](https://docs.bitquery.io/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. +> **Before you start**: Not sure when to use Transfers vs Events vs Calls vs DexTrades? Read our [Mental Model guide](/docs/start/mental-model-transfers-events-calls) to understand which primitive to use for your use case. The Transfer cube provides details on asset transfers, blocks, contract calls, fees, event logs, receipts, transaction details, and transaction status. diff --git a/docs/data-lake/extract-transfers.md b/docs/data-lake/extract-transfers.md index baf103e0..a96b6333 100644 --- a/docs/data-lake/extract-transfers.md +++ b/docs/data-lake/extract-transfers.md @@ -1,6 +1,6 @@ --- title: Extract Transfers from a Block -description: Code design for pulling native and ERC-20/ERC-721 token transfers out of a Bitquery Blockchain Data Lake block, using the published protobuf schema. +description: "Extract Transfers from a Block: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." keywords: - blockchain transfers - ERC-20 transfer parsing @@ -9,10 +9,9 @@ keywords: - token transfer decoder sidebar_position: 2 --- - # Extract Transfers from a Block -This page shows how to pull transfers out of a streamed block. It builds on the streaming and decoding steps from the [overview](./index.md), so it assumes you already have a decoded `BlockMessage`. +This page shows how to pull transfers out of a streamed block. It builds on the streaming and decoding steps from the [overview](./), so it assumes you already have a decoded `BlockMessage`. ## Where transfers live in a block diff --git a/docs/data-lake/index.md b/docs/data-lake/index.md index 49e22016..c9e372a2 100644 --- a/docs/data-lake/index.md +++ b/docs/data-lake/index.md @@ -1,6 +1,6 @@ --- -title: Blockchain Data Lake - Full Archive Streaming, Faster Than a Node -description: Bitquery's Blockchain Data Lake stores the complete chain archive, every block from genesis to tip, as structured protobuf files in SeaweedFS. Stream the full history over an S3 interface at 1–10 Gbps network bandwidth (depending on server), far faster than syncing or querying your own archive node. +title: "Blockchain Data Lake" +description: "Blockchain Data Lake: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance. Covers archive history and realtime data." keywords: - Blockchain data lake - Full archive blockchain data @@ -18,7 +18,6 @@ keywords: - Web3 data lake sidebar_position: 1 --- - # Blockchain Data Lake The Bitquery **Blockchain Data Lake** gives you the complete archive of a blockchain. It holds every block from **genesis to the current tip** as structured data that you can stream directly into your own systems. You get the full node dataset without running a node, so there is no syncing, no RPC rate limits, and no indexing infrastructure to operate. @@ -244,7 +243,7 @@ for tx in block.Transactions: ... ``` -This gives you full control. You decide how to turn raw logs and traces into transfers, swaps, or anything else, by decoding them against the relevant contract ABIs. For a worked example, see [Extract transfers from a block](./extract-transfers.md). +This gives you full control. You decide how to turn raw logs and traces into transfers, swaps, or anything else, by decoding them against the relevant contract ABIs. For a worked example, see [Extract transfers from a block](./extract-transfers/). ### Use Bitquery's protobuf files @@ -268,6 +267,6 @@ So you bring the block, our protobuf files describe it, and you parse out transa ## Related documentation -- [Data in Cloud](https://docs.bitquery.io/docs/cloud/) covers curated, ready-to-use Parquet data dumps for analytics and warehousing. -- [Kafka Streaming Concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) covers real-time blockchain data streams that use the same protobuf schema. +- [Data in Cloud](/docs/cloud/) covers curated, ready-to-use Parquet data dumps for analytics and warehousing. +- [Kafka Streaming Concepts](/docs/streams/kafka-streaming-concepts/) covers real-time blockchain data streams that use the same protobuf schema. - [streaming_protobuf](https://github.com/bitquery/streaming_protobuf) is the block schema. diff --git a/docs/evm/_category_.json b/docs/evm/_category_.json deleted file mode 100644 index c72dff91..00000000 --- a/docs/evm/_category_.json +++ /dev/null @@ -1,8 +0,0 @@ -{ - "label": "EVM-based Schema", - "position": 5, - "link": { - "type": "generated-index", - "description": "EVM-like blockchain schema as Ethereum, BSC, Polygon and many others" - } -} diff --git a/docs/evm/arguments.md b/docs/evm/arguments.md deleted file mode 100644 index 3f78768f..00000000 --- a/docs/evm/arguments.md +++ /dev/null @@ -1,205 +0,0 @@ ---- -title: "EVM Arguments and Returns API" ---- - - - - - - - - - - - - - - - - - - - - -Smart contract calls and events have arguments. In case the call or event signature is parsed against ABI, -the arguments are showing the values, types and names passed to call or event. - -In addition, returns shows the return values from the smart contract calls. - -Arguments and returns are represented by the same data structure. It is array, -containing entries for each argument value. In case when the data type of argument -is array or emedded structure, the argument will have separate object for every -value of array or structure. - -It means that all argument values are flattened. To represent all possible cases, the following -additional information is provided: - -- Index - sequential index of argument value inside an array or strucutre -- Name - name of the argument or the name of the element of structure -- Type - the type of the argument -- Path - the array of top-level elements where the argument value is used. Each element of path have Name, Index, Type - -As example, the following data means the array of size 2 of addresses: - -``` - { - "Index": 0, - "Name": "", - "Path": [ - { - "Index": 2, - "Name": "path", - "Type": "address[]" - } - ], - "Type": "address", - "Value": { - "__typename": "EVM_ABI_Address_Value_Arg", - "address": "0x6c812ab49f4b350b9d115e3f367302cd4fb58bbf" - } - }, - { - "Index": 1, - "Name": "", - "Path": [ - { - "Index": 2, - "Name": "path", - "Type": "address[]" - } - ], - "Type": "address", - "Value": { - "__typename": "EVM_ABI_Address_Value_Arg", - "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" - } - }, -``` - -meaning `['0x6c812ab49f4b350b9d115e3f367302cd4fb58bbf','0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2']` - -To query attribute values, use union as shown: - -```graphql -Arguments { - Index - Name - Type - Path { - Index - Name - Type - } - Value { - __typename - ... on EVM_ABI_Integer_Value_Arg { - integer - } - ... on EVM_ABI_String_Value_Arg { - string - } - ... on EVM_ABI_Address_Value_Arg { - address - } - ... on EVM_ABI_BigInt_Value_Arg { - bigInteger - } - ... on EVM_ABI_Bytes_Value_Arg { - hex - } - ... on EVM_ABI_Boolean_Value_Arg { - bool - } - } - } -``` - -Data types are mapped to this values by the following rules: - -1. string, addresses, boolean are mapped directly to corresponding types (EVM_ABI_String_Value_Arg,EVM_ABI_Address_Value_Arg,EVM_ABI_Boolean_Value_Arg) -2. bytes and byte array of any pre-defined size ( such as byte[24]) mapped to hex bytes (EVM_ABI_Bytes_Value_Arg) -3. integers of size int8,16,32 and uint8,16 are mapped to integer (EVM_ABI_Integer_Value_Arg) -4. all other integers mapped to big integer represented as string ( possible negative ) (EVM_ABI_BigInt_Value_Arg) - -## Filters on arguments - -Arguments and returns are arrays, and this enables to use filtering on them as described on -[filters](/docs/graphql/filters/#array-filter-types). - -For example, this query selects specific calls by applying filter to argument length -and to specific values of arguments. -Combining argument filters with signature filters on events and calls gives you the power -to analyse the arguments used in smart contracts in specific context. - -``` -{ - EVM { - Calls( - where: { - Arguments: { - length: {eq: 2} - includes: [ - { - Index: {eq: 0} - Name: {is: "recipient"} - Value: {Address: {is: "0xa7f6ebbd4cdb249a2b999b7543aeb1f80bda7969"}} - } - { - Name: {is: "amount"} - Value: {BigInteger: {ge: "1000000000"}} - } - ] - } - } - limit: {count: 10}) { - Arguments { - Index - Name - Type - Value { - ... on EVM_ABI_Integer_Value_Arg { - integer - } - ... on EVM_ABI_String_Value_Arg { - string - } - ... on EVM_ABI_Address_Value_Arg { - address - } - ... on EVM_ABI_BigInt_Value_Arg { - bigInteger - } - ... on EVM_ABI_Bytes_Value_Arg { - hex - } - ... on EVM_ABI_Boolean_Value_Arg { - bool - } - } - } - Call { - Signature { - Signature - } - } - } - } -} - -``` - -The value of argument filter must be defined depending on the expected argument type. -There are the following options: - -- BigInteger - for uint256/int256/int64/uint64 arguments -- Address - for addresses, 0x prefixed -- String - for strings -- Boolean - for boolean, just true/false -- UnsignedInteger - for uint8/16/32 -- SignedInteger - int8/16/32 -- Bytes - for bytes, 0x prefixed optional - -:::note -filters affect the whole query to calls / events, so you anyway can query all arguments, -not just which pass the filter. -::: diff --git a/docs/evm/balances.md b/docs/evm/balances.md deleted file mode 100644 index d80d322f..00000000 --- a/docs/evm/balances.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: "EVM Balance API" ---- - -# EVM Balance API - -The **Balances** API returns current and historical token balances for addresses on EVM chains. To return only non-zero balances, add `Amount(selectWhere: { gt: "0" })` on the `Balance` field (not in `where`). Use `dataset: combined` or `dataset: archive` as follows: - -| Dataset | When to use | -|---------|-------------| -| **`combined`** | Latest balances. Queries **realtime and archive** databases and merges results. | -| **`archive`** | Historical snapshots with `Block.Date`, and balances for **addresses not recently active**. | - -Full Ethereum examples: [Address Balance API](/docs/blockchain/Ethereum/balances/balance-api/). - -## Balance of an address - -```graphql -query { - EVM(network: eth, dataset: combined) { - Balances( - where: { - Balance: { - Address: { - is: "0x76147fd7891731e01f35cc18f87ae8e95bf06869" - } - } - } - ) { - Currency { - Symbol - SmartContract - } - Balance { - Amount(selectWhere: { gt: "0" }) - AmountInUSD - Address - } - } - } -} -``` - -### Examples on Ethereum - -- [Balance of an address](/docs/blockchain/Ethereum/balances/balance-api/#balance-of-an-address) -- [Balance on a specific date](/docs/blockchain/Ethereum/balances/balance-api/#balance-on-a-specific-date) -- [Balance for a specific token](/docs/blockchain/Ethereum/balances/balance-api/#balance-for-a-specific-token) -- [Balance history by date](/docs/blockchain/Ethereum/balances/balance-api/#balance-history-by-date) -- [Wallet balance for a specific token on a date](/docs/blockchain/Ethereum/balances/balance-api/#wallet-balance-for-a-specific-token-on-a-date) diff --git a/docs/evm/blocks.md b/docs/evm/blocks.md deleted file mode 100644 index e2f800e6..00000000 --- a/docs/evm/blocks.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: "EVM Blocks API" ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - -Blocks API provide details on blocks. - -You can use different [filters](docs/graphql/filters.mdx) to query data from different dimensions. You can find more examples [here](/docs/blockchain/Ethereum/blocks/blocks-api/) - -Let's see an example of Blocks API to get the latest 10 blocks on Ethereum blockchain. - -```graphql -{ - EVM(dataset: archive, network: eth) { - Blocks(limit: { count: 10 }, orderBy: { descending: Block_Number }) { - Block { - Time - Date - Number - Hash - } - } - } -} -``` - -You can see more example of Blocks api in [here](/docs/blockchain/Ethereum/blocks/blocks-api/). diff --git a/docs/evm/calls.md b/docs/evm/calls.md deleted file mode 100644 index 12bafe6f..00000000 --- a/docs/evm/calls.md +++ /dev/null @@ -1,152 +0,0 @@ ---- -title: "EVM Smart Contract Calls API" ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - -Calls API provides details about smart contract calls, arguments, callers, etc. - -This api gives detailed information about the smart contract calls, including raw data, and supports [Opcodes](https://github.com/crytic/evm-opcodes). - -The API allows different filters to query the Smart contract calls details from different dimensions. -You can find more examples [here](https://docs.bitquery.io/docs/blockchain/Ethereum/calls/smartcontract/) - -Here's a sample query to get started. - -```graphql -{ - EVM(dataset: combined, network: eth) { - Calls( - limit: { count: 1 } - where: { - Call: { - Signature: { Name: { is: "swap" } } - From: { is: "0x000000000000084e91743124a982076c59f10084" } - } - } - ) { - Call { - From - To - CallPath - CallerIndex - Create - Delegated - Depth - EnterIndex - Error - ExitIndex - Gas - GasUsed - Index - Input - InternalCalls - LogCount - Opcode { - Code - Name - } - Output - Reverted - SelfDestruct - Signature { - Abi - Name - Parsed - Signature - SignatureHash - SignatureType - } - Success - } - Arguments { - Type { - Name - Type - } - Value { - String - } - } - } - } -} -``` - -Calls contain the arguments and return values as arrays, refer to [arguments](/docs/evm/arguments) for data structure. - - -# New tokens created on EVM chain - -To get new token created on EVM chains such as Etheruem or BSC, please use [this query](https://ide.bitquery.io/Newly-Created-Tokens-on-BSC-network_4). -Change the network according to your requirements. - -```graphql -{ - EVM(network: bsc) { - Calls( - orderBy: {descending: Block_Time} - limit: {count: 10} - where: {Call: {Create: true}, Arguments: {length: {ne: 0}}, Receipt: {ContractAddress: {not: "0x0000000000000000000000000000000000000000"}}, TransactionStatus: {Success: true}} - ) { - Arguments { - Name - Value { - ... on EVM_ABI_Boolean_Value_Arg { - bool - } - ... on EVM_ABI_Bytes_Value_Arg { - hex - } - ... on EVM_ABI_BigInt_Value_Arg { - bigInteger - } - ... on EVM_ABI_Integer_Value_Arg { - integer - } - ... on EVM_ABI_String_Value_Arg { - string - } - ... on EVM_ABI_Address_Value_Arg { - address - } - } - } - Transaction { - Hash - } - Receipt { - ContractAddress - } - Block { - Time - } - } - } -} -```` - diff --git a/docs/evm/dextrades.md b/docs/evm/dextrades.md deleted file mode 100644 index 217639ed..00000000 --- a/docs/evm/dextrades.md +++ /dev/null @@ -1,244 +0,0 @@ ---- -title: DEX Trades API ---- - - - - - - - - - - - - - - - - - - - - -:::tip Need real-time data or anything from the last ~30 days? -For **real-time + last ~30 days**, use the [**Trading cube**](https://docs.bitquery.io/docs/trading/trading-data-overview) — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) gives you clean, MEV-filtered swaps with **USD price, market cap, and supply on every row** across **8 chains in one API (ETH, BSC, Solana, Base, Arbitrum, Tron, Optimism, Polygon)**. Use this page when you need **historical EVM data older than ~30 days** (with `dataset: combined` or `archive`), raw per-swap detail, or call / event context. -::: - -DEXTrades api gives trading-related data from different DEXs such as Uniswap, Pancakeswap, 0x, etc. - -API provides historical and real-time trades and pricing information for tokens. The API allows different filters to query the Smart contract calls details from different dimensions, such as from different DEXs, protocols, tokens, trades, pools, etc. -You can find more examples [here](/docs/blockchain/Ethereum/dextrades/get-trading-pairs-of-token/) - -## DEX Trades Cube - -Dex Trades represent every swap of tokens on decentralised exchange. Every trade has -two sides, represented by currencies ( tokens or native currency ), which are exchanged. -Buyer and seller side in some cases are selected related to the "maker" side of the trade if -the DEX is limit orders type. In case of automated trading ( uniswap, balancer and others) -the trade is related to the pool smart contract, executing the trade. - -Use DEX Trades Cube in case when you need to build query based on protocol or smart contracts, for example: - -- total count of trades by protocols or smart contracts or oter dimensions -- gas spending on trades -- dynamics in time of DEX usage - -## DEX Trades By Tokens - -DEX Trades By Tokens exposes trades relative to the token. So every trade is represented by 2 records - by every token -participating in trade. This allows to build queries by tokens which take into account all orders for token -(buy side and sell side). - -Use DEX Trades Cube in case when you need to build query based on token or pair of tokens, for example: - -- query every pair the token is involved -- price of trading the token -- open-high-low-close OHLC graph building ( see example below ) - -:::caution -DEX Trades By Tokens has twice as much records for dex trades. Always use at least one filter by token -to query correctly! -::: - -:::tip -Use interval argument for date/time to build OHLC graph by time interval -::: - -## Examples - -Here are the sample queries to get started: - -### OHLC API - -Query price OHLC data for token pairs using DEX Trades By Tokens - -```graphql -query MyQuery { - EVM(dataset: archive) { - DEXTradeByTokens( - orderBy: { descendingByField: "Block_datefield" } - where: { - Trade: { - Currency: { - SmartContract: { is: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" } - } - Side: { - Currency: { - SmartContract: { - is: "0xdac17f958d2ee523a2206206994597c13d831ec7" - } - } - } - Dex: { - SmartContract: { is: "0x4e68ccd3e89f51c3074ca5072bbac773960dfa36" } - } - PriceAsymmetry: { le: 0.1 } - } - } - limit: { count: 10 } - ) { - Block { - datefield: Date(interval: { in: days, count: 1 }) - } - volume: sum(of: Trade_Amount) - Trade { - high: Price(maximum: Trade_Price) - low: Price(minimum: Trade_Price) - open: Price(minimum: Block_Number) - close: Price(maximum: Block_Number) - Currency { - Name - } - Dex { - ProtocolName - SmartContract - } - Side { - Currency { - Name - SmartContract - } - } - } - count - } - } -} -``` - -:::note -we applied filter by tokens, used [interval](/docs/graphql/datetime) and actual numbers -calculated by aggregated [metrics ( max/min )](/docs/graphql/calculations) -::: - -```graphql -{ - EVM(dataset: archive, network: eth) { - buyside: DEXTrades( - limit: { count: 10 } - orderBy: { descending: Block_Time } - where: { - Trade: { - Buy: { - Currency: { - SmartContract: { - is: "0x5283d291dbcf85356a21ba090e6db59121208b44" - } - } - } - } - Block: { - Time: { since: "2023-03-03T01:00:00Z", till: "2023-03-05T05:15:23Z" } - } - } - ) { - Block { - Number - Time - } - Transaction { - From - To - Hash - } - Trade { - Buy { - Amount - Buyer - Currency { - Name - Symbol - SmartContract - } - Seller - Price - } - Sell { - Amount - Buyer - Currency { - Name - SmartContract - Symbol - } - Seller - Price - } - } - } - sellside: DEXTrades( - limit: { count: 10 } - orderBy: { descending: Block_Time } - where: { - Trade: { - Buy: { - Currency: { - SmartContract: { - is: "0x5283d291dbcf85356a21ba090e6db59121208b44" - } - } - } - } - Block: { - Time: { since: "2023-03-03T01:00:00Z", till: "2023-03-05T05:15:23Z" } - } - } - ) { - Block { - Number - Time - } - Transaction { - From - To - Hash - } - Trade { - Buy { - Amount - Buyer - Currency { - Name - Symbol - SmartContract - } - Seller - Price - } - Sell { - Amount - Buyer - Currency { - Name - SmartContract - Symbol - } - Seller - Price - } - } - } - } -} -``` diff --git a/docs/evm/events.md b/docs/evm/events.md deleted file mode 100644 index d3921b3f..00000000 --- a/docs/evm/events.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: "EVM Smart Contract Events & logs API" ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - -Smart contract events and logs are an important feature of Ethereum smart contracts that allow developers to track and record specific actions or data on the blockchain. -You can retrieve data on blockchain calls and logs from the blockchain network. You can find more examples [here](/docs/blockchain/Ethereum/events/events-api/) - -```graphql -query MyQuery { - EVM(dataset: combined, network: bsc) { - Events( - limit: { count: 10 } - orderBy: { descending: Block_Time } - where: { Block: { Date: { is: "2023-03-06" } } } - ) { - Call { - CallPath - From - GasUsed - To - Signature { - Name - Signature - } - } - Log { - EnterIndex - ExitIndex - Index - LogAfterCallIndex - SmartContract - Signature { - Name - Signature - } - } - } - } -} -``` - -The query includes the Call and Log objects, which are parts of the events. The Call object contains information about the function calls made in the event, including the path, sender address, gas used, receiver address, and the name and signature of the function. The Log object contains information about the event logs, including the enter and exit indexes, log index, log after call index, the smart contract address, and the name and signature of the event. - -Events contain the arguments as array, refer to [arguments](/docs/evm/arguments) diff --git a/docs/evm/miners.md b/docs/evm/miners.md deleted file mode 100644 index 25601947..00000000 --- a/docs/evm/miners.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: EVM Miner Rewards API ---- - - - - - - - - - - - - - - - - - - - - - -Miner Rewards are the incentives paid out to miners for validating transactions and creating new blocks on the blockchain. You can access Miner Rewards data using the Bitquery API. - -```graphql -query MyQuery { - EVM(dataset: combined, network: eth) { - MinerRewards(limit: {count: 10}, orderBy: {descending: Block_Time}) { - Reward { - BurntFees - Dynamic - Static - TxFees - Total - } - Block { - Time - } - } - } -} -``` - -**Data** -`MinerRewards`: Returns an array of the top 10 miner rewards on the Ethereum network. - -- `Reward`: Returns the details of the miner reward. - - - `BurntFees`: Returns the amount of fees that were burnt - - `Dynamic`: Returns the amount of dynamic fees. - - `Static`: Returns the amount of static fees. - - - `TxFees`: Returns the amount of transaction fees. - - `Total`: Returns the total amount of the miner reward. - -- `Block`: Returns the details of the block that the miner reward was received in. - - - `Time`: Returns the time that the block was created. diff --git a/docs/evm/token-holders.md b/docs/evm/token-holders.md deleted file mode 100644 index 111dede0..00000000 --- a/docs/evm/token-holders.md +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: "EVM Token Holders Cube" ---- - - - - - - - - - - - - - - - - - - - - - - - - - -# EVM Token Holders API - -The **Holders** API returns token holder data for ERC-20 tokens: top holders, holder counts, and balance thresholds. Non-zero balances use `Amount(selectWhere: { gt: "0" })` on the `Balance` field (not in `where`). Use `dataset: combined` or `dataset: archive` as follows: - -| Dataset | When to use | -|---------|-------------| -| **`combined`** | Latest holder count, top holders, and balances. Queries **realtime and archive** databases and merges results. | -| **`archive`** | Addresses not recently active (not in the realtime window). | - -Full Ethereum examples: [Token Holders API](/docs/blockchain/Ethereum/token-holders/token-holder-api). - -## Token holder count - -```graphql -query { - EVM(network: eth, dataset: combined) { - Holders( - where: { - Currency: { - SmartContract: { - is: "0x54D2252757e1672EEaD234D27B1270728fF90581" - } - } - } - ) { - uniq(of: Holder_Address) - } - } -} -``` - -### Filter parameters - -- `dataset: combined` — latest holder count, top holders, and activity -- `dataset: archive` — addresses not recently active -- `where.Currency.SmartContract` — token contract address (required) -- `where.Balance.LastChangeTime` — filter by last balance change (datetime, e.g. `till: "2026-05-01T00:00:00Z"`). The Holders cube does not support `Block.Date`. -- `where.Holder.Address` — filter to a specific wallet -- `Balance.Amount(selectWhere: { gt: "..." })` — non-zero balances when listing amounts -- `uniq(of: Holder_Address, if: { Balance: { Amount: { gt: "..." } } } })` — holder count above a threshold -- `limit`, `orderBy` — pagination and sorting (e.g. `descending: Balance_Amount`) - -### Return fields - -- `Holder.Address` — holder wallet address -- `Balance.Amount`, `Balance.AmountInUSD` — token balance (use `selectWhere` for non-zero) -- `Balance.UpdateCount`, `Balance.FirstChangeTime`, `Balance.LastChangeTime` — holder activity - -### Examples on Ethereum - -- [Top holders (current)](/docs/blockchain/Ethereum/token-holders/token-holder-api#top-holders-of-a-currency-current) -- [Token holder count](/docs/blockchain/Ethereum/token-holders/token-holder-api#token-holder-count-for-an-erc-20-token) -- [Holder count above a threshold](/docs/blockchain/Ethereum/token-holders/token-holder-api#holder-count-with-balance-above-a-threshold) -- [Track whale wallets](/docs/blockchain/Ethereum/token-holders/token-holder-api#track-whale-wallets-and-token-holdings) -- [Historical top holders](/docs/blockchain/Ethereum/token-holders/token-holder-api#historical-top-holders-by-date) -- [Holder count history](/docs/blockchain/Ethereum/token-holders/token-holder-api#token-holder-count-history-over-time) -- [Wallet token balance at a date](/docs/blockchain/Ethereum/token-holders/token-holder-api#wallet-balance-at-a-point-in-time) (via [Balances API](/docs/blockchain/Ethereum/balances/balance-api/#wallet-balance-for-a-specific-token-on-a-date)) -- [Holder activity](/docs/blockchain/Ethereum/token-holders/token-holder-api#token-holder-activity) — `UpdateCount`, `FirstChangeTime`, `LastChangeTime` diff --git a/docs/evm/top.md b/docs/evm/top.md deleted file mode 100644 index 87986f63..00000000 --- a/docs/evm/top.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Overview - -Bitquery APIs provide access to real-time and historical data from the Ethereum Virtual Machine (EVM) based blockchains through its EVM-based schema. The schema is designed to enable developers to query blockchain data through an API using GraphQL. - -The EVM-based schema contains different types of queries, such as block, transaction, event, miner rewards, and token transfers. These queries can be used to retrieve different types of blockchain data, such as block information, transaction details, events, and token transfers. - -Here's a list of different sections in this documentation: - - 1. [Blocks](/docs/evm/blocks) - 2. [Miner Rewards](/docs/evm/miners) - 3. [Uncle Blocks](/docs/evm/uncles) - 4. [Balances](/docs/evm/balances) - 5. [Token Holders](/docs/evm/token-holders) - 6. [Transfers](/docs/evm/transfers) - 7. [Transactions](/docs/evm/transactions) - 8. [Events](/docs/evm/events) - 9. [Dex Trades](/docs/evm/dextrades) - 10. [Calls](/docs/evm/calls) - diff --git a/docs/evm/transactions.md b/docs/evm/transactions.md deleted file mode 100644 index 9ed9517a..00000000 --- a/docs/evm/transactions.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Transactions API ---- - - - - - - - - - - - - - - - - - - - - -The Transactions API provides detailed information on transactions including call count, gas, hash, type, and sender and recipient addresses etc. Here's a sample query to get started. You can see more examples [here](/docs/blockchain/Ethereum/transactions/transaction-api/) - - - - query MyQuery \{ - EVM(dataset: realtime, network: bsc) \{ - Transactions( - limit: \{count: 10\} - orderBy: \{descending: Block_Time\} - where: \{Block: \{Date: \{after: "2023-02-05"\}\}} - ) \{ - Transaction \{ - CallCount - Gas - Hash - Type - To - From - } - Block \{ - Date - } - TransactionStatus \{ - Success - FaultError - EndError - } - } - } - } - -### Parameters: - -- `limit`: Limits the number of transactions returned in the query. In this case, it is set to 10. -- `orderBy`: Specifies the field to order the results by. In this case, it is ordered in descending order based on block time. -- `where`: Filters the results based on specific criteria. In this case, it returns transactions that occurred after February 5, 2023. - -### Returns: - -- `Transaction`: Contains information about the transaction, including call count, gas, hash, type, and sender and recipient addresses. -- `Block`: Contains information about the block that the transaction was included in, including the date of the block. -- `TransactionStatus`: Contains information about the transaction status, including whether it was successful, and if there were any errors. diff --git a/docs/evm/transfers.md b/docs/evm/transfers.md deleted file mode 100644 index 9e5e1e1d..00000000 --- a/docs/evm/transfers.md +++ /dev/null @@ -1,147 +0,0 @@ ---- -title: "EVM Token Transfers API" ---- - - - - - - - - - - - - - - - - - - - - -To retrieve data on token and currency transfers using Bitquery, users can utilize the platform's GraphQL API. The Bitquery API allows users to construct custom queries to retrieve data on a wide range of blockchain events and transactions, including token transfers. You can find more examples [here](/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api/) - -```graphql - Transfers(limit: {count: 10}, orderBy: {descending: Block_Time}) { - Transfer { - Amount - Currency { - Fungible - Name - ProtocolName - Symbol - } - Data - Id - Receiver - Sender - Success - Type - } - } -``` - -`Transfers`: The top level method that returns transfer information - -- `Transfer`: Returns information on the token transfer. - - - `Amount`: Returns the amount of tokens transferred. - - `Currency`: Returns information on the currency of the token transferred. - - - `Fungible`: Returns a Boolean value indicating whether the token is fungible. - - `Name`: Returns the name of the token. - - `ProtocolName`: Returns the name of the protocol on which the token is built. - - `Symbol`: Returns the symbol used to represent the token. - - - `Data`: Returns any additional data associated with the token transfer. - - `Id`: Returns the ID of the token transfer. - - `Receiver`: Returns the address of the token receiver. - - `Sender`: Returns the address of the token sender. - - `Success`: Returns a Boolean value indicating whether the token transfer was successful. - - `Type`: Returns the type of token transfer. e.g. call. - -## Deterministic Pagination for Backfilling Transfers - -When backfilling transfer data or building a historical index, you need **deterministic pagination** that guarantees no records are missed or duplicated. The key is to sort by a combination of fields that uniquely identify each transfer's position in the blockchain. - -**Try it live:** [Deterministic Transfer API](https://ide.bitquery.io/Reliable-transfer-api) - -```graphql -{ - EVM(dataset: combined, network: eth) { - Transfers( - where: { Transfer: { Success: true } } - orderBy: { - ascending: [ - Block_Number, - Transaction_Index, - Call_Index, - Log_Index, - Transfer_Index, - Transfer_Type - ] - } - limit: { count: 10, offset: 0 } - ) { - Block { - Time - Number - } - Transaction { - Hash - From - Index - } - Transfer { - Amount - AmountInUSD - Sender - Receiver - Index - Currency { - Symbol - Name - SmartContract - Decimals - Native - } - } - Call { - Index - } - Log { - LogAfterCallIndex - Index - } - Transfer { - Type - } - } - } -} -``` - -### Why This Ordering Works - -The `orderBy` uses a composite ascending sort across six fields that together uniquely position every transfer in the blockchain: - -| Field | Purpose | -|-------|---------| -| `Block_Number` | Orders by block height | -| `Transaction_Index` | Position of the transaction within the block | -| `Call_Index` | Position of the internal call within the transaction | -| `Log_Index` | Position of the event log within the call | -| `Transfer_Index` | Position of the transfer within the log | -| `Transfer_Type` | Differentiates transfer types at the same position | - -### How to Paginate - -Increment the `offset` by the `count` value on each request: - -- Page 1: `limit: { count: 10, offset: 0 }` -- Page 2: `limit: { count: 10, offset: 10 }` -- Page 3: `limit: { count: 10, offset: 20 }` - -This deterministic ordering ensures that every transfer appears exactly once across pages, making it safe for backfilling pipelines and historical data indexing. You can pull up to **25,000 records in a single request** by setting `count: 25000`. diff --git a/docs/evm/uncles.md b/docs/evm/uncles.md deleted file mode 100644 index 443d6ab8..00000000 --- a/docs/evm/uncles.md +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: "EVM Uncle Blocks API" ---- - - - - - - - - - - - - - - - - - - - - - -### What are Uncle Blocks? - -Uncle blocks, also known as "orphan blocks", are blocks on the blockchain that are not included in the main blockchain. Uncle blocks are still valid blocks, but they were not selected to be included in the main blockchain by the network consensus algorithm. - -Please note that after the September 2022 merge of PoS Ethereum, validators will be pre-selected to validate the blocks. Hence, there will be no uncle blocks created. - -### Why do Uncle Blocks occur? - -Uncle blocks occur due to network latency issues or network forks that can cause two or more miners to solve a block at the same time. Only one of these blocks can be included in the main blockchain, while the others become uncle blocks. - -### What is the significance of Uncle Blocks? - -Uncle blocks are significant because they can have an impact on the security and efficiency of the Ethereum blockchain. When uncle blocks are created, they reduce the rewards that miners receive for their work, and can also reduce the overall efficiency of the blockchain. - -### How can I access Uncle Blocks data? - -You can access Uncle Blocks data using our API. Here's an example GraphQL query to retrieve Uncle Blocks data: - -```graphql -query MyQuery { - EVM(dataset: archive, network: eth) { - Uncles(limit: { count: 10 }, orderBy: { descending: Uncle_Block_Time }) { - Block { - Time - } - Uncle { - Index - Block { - TxHash - Time - Number - ParentHash - Bloom - Date - } - } - } - } -} -``` - -- `Block`: Returns the details of the block that included the uncle block. - - - `Time`: Returns the time that the block was created. - -- `Uncle`: Returns the details of the uncle block. - - - `Index`: Returns the index of the uncle block. - - `Block`: Returns the details of the uncle block itself. - - - `TxHash`: Returns the hash of the uncle block's transaction. - - `Time`: Returns the time that the uncle block was created. - - `Number`: Returns the number of the uncle block. - - `ParentHash`: Returns the hash of the uncle block's parent block. - - `Bloom`: Returns the bloom filter of the uncle block. - - `Date`: Returns the date that the uncle block was created. diff --git a/docs/examples/_protocol-template.mdx b/docs/examples/_protocol-template.mdx index bd30c7fb..1bd4cc6a 100644 --- a/docs/examples/_protocol-template.mdx +++ b/docs/examples/_protocol-template.mdx @@ -1,9 +1,8 @@ --- title: "Protocol API page template" -description: "Template for protocol-specific API answer hubs — copy and customize for new DEX / launchpad pages." +description: "Protocol API page template: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance. See examples in the Bitquery IDE." draft: true --- - import FAQ from "@site/src/components/FAQ"; # {Protocol} API — Real-Time Trades, Prices & Liquidity @@ -48,7 +47,7 @@ Replace `ProtocolName` and root type (`Solana` / `EVM`) for your venue. ## Related docs - [Solana DEX trades](/docs/blockchain/Solana/solana-dextrades/) -- [Authorisation](/docs/authorisation/how-to-generate/) +- [Authorization](/docs/authorization/how-to-generate/) - [Kafka streaming](/docs/streams/kafka-streaming-concepts/) ` (no auth) | | **Deposits & withdrawals** | Polymarket Bridge API | Supported assets, deposit/withdrawal addresses, transaction status | - --- ## Related APIs | Need | API | | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Trades, prices, volume** | [Polymarket API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-api/) · [Prediction Trades API](https://docs.bitquery.io/docs/examples/prediction-market/prediction-trades-api/) | -| **Filter by market slug, condition ID, token** | [Polymarket Markets API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-markets-api/) | -| **Settlements & redemptions** | [Prediction Settlements API](https://docs.bitquery.io/docs/examples/prediction-market/prediction-settlements-api/) | -| **Market lifecycle & resolution** | [Prediction Market API](https://docs.bitquery.io/docs/examples/prediction-market/prediction-market-api/) | +| **Trades, prices, volume** | [Polymarket API](/docs/examples/polymarket-api/polymarket-api/) · [Prediction Trades API](/docs/examples/prediction-market/prediction-trades-api/) | +| **Filter by market slug, condition ID, token** | [Polymarket Markets API](/docs/examples/polymarket-api/polymarket-markets-api/) | +| **Settlements & redemptions** | [Prediction Settlements API](/docs/examples/prediction-market/prediction-settlements-api/) | +| **Market lifecycle & resolution** | [Prediction Market API](/docs/examples/prediction-market/prediction-market-api/) | | **On-chain contracts & events** | Main Polymarket Contract (on-chain) | --- diff --git a/docs/examples/polymarket-api/polymarket-wallet-realized-pnl.md b/docs/examples/polymarket-api/polymarket-wallet-realized-pnl.md index 113b540d..8785d1d3 100644 --- a/docs/examples/polymarket-api/polymarket-wallet-realized-pnl.md +++ b/docs/examples/polymarket-api/polymarket-wallet-realized-pnl.md @@ -1,6 +1,6 @@ --- title: "Polymarket Wallet Realized PnL & Win Rate (Pattern)" -description: "Use Bitquery PredictionTrades on Polygon to fetch a wallet’s Polymarket buys and sells in a time window, then aggregate by condition ID for realized PnL and win rate." +description: "Polymarket Wallet Realized PnL & Win Rate (Pattern): Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." keywords: - Polymarket PnL - Polymarket wallet analytics @@ -9,13 +9,10 @@ keywords: - PredictionTrades Polygon - Polymarket GraphQL --- - # Realized PnL & Win Rate for Polymarket Trader You can use Bitquery **`PredictionTrades`** on Polygon (`network: matic`) to pull a wallet’s **outcome buys** and **outcome sells** on Polymarket over a chosen window (for example the last **24 hours**). From that response, you can aggregate by **`ConditionId`**, calculate `realised PnL` per condition, and derive the total **realized PnL** and **win rate** for Polymarket trading. - - ## How is PnL and Win Rate calculated? - **Buys** (`IsOutcomeBuy: true`): collateral spent acquiring outcome tokens (tracked as **`CollateralAmountInUSD`** on the trade). @@ -169,7 +166,7 @@ END IF | Topic | Link | | ----- | ---- | -| PolyMarket APIs Intro | [Polymarket API](https://docs.bitquery.io/docs/examples/polymarket-api/) | -| Advanced Polymarket Analytics | [Advanced Polymarket Metrics](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-advanced-analytics-api/) | -| Prediction trades reference | [Prediction Trades API](https://docs.bitquery.io/docs/examples/prediction-market/prediction-trades-api/) | -| Sports Related PolyMarkets | [Polymarket Sports API](https://docs.bitquery.io/docs/examples/polymarket-api/polymarket-sports-api/) | +| PolyMarket APIs Intro | [Polymarket API](/docs/examples/polymarket-api/polymarket-api/) | +| Advanced Polymarket Analytics | [Advanced Polymarket Metrics](/docs/examples/polymarket-api/polymarket-advanced-analytics-api/) | +| Prediction trades reference | [Prediction Trades API](/docs/examples/prediction-market/prediction-trades-api/) | +| Sports Related PolyMarkets | [Polymarket Sports API](/docs/examples/polymarket-api/polymarket-sports-api/) | diff --git a/docs/examples/prediction-market/prediction-managements-api.md b/docs/examples/prediction-market/prediction-managements-api.md index 49c5d7ef..f0a0ee25 100644 --- a/docs/examples/prediction-market/prediction-managements-api.md +++ b/docs/examples/prediction-market/prediction-managements-api.md @@ -1,6 +1,6 @@ --- title: "Prediction Market Managements API" -description: "Query prediction market lifecycle: real-time streams and historical queries for market creation and resolution. Created and Resolved events on Polygon (Polymarket and more)." +description: "Prediction Market Managements API: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." keywords: - PredictionManagements - prediction market management API @@ -12,7 +12,6 @@ keywords: - outcome tokens - Bitquery GraphQL prediction --- - import VideoPlayer from "../../../src/components/videoplayer.js"; # Prediction Market Managements API @@ -575,5 +574,4 @@ query LatestMarketResolutions { } ``` - For trades on outcome tokens, see [Prediction Market Trades API](../prediction-trades-api). For settlements (split, merge, redemption), see [Prediction Market Settlements API](../prediction-settlements-api). diff --git a/docs/examples/prediction-market/prediction-market-api.md b/docs/examples/prediction-market/prediction-market-api.md index 95ced004..0dca86e7 100644 --- a/docs/examples/prediction-market/prediction-market-api.md +++ b/docs/examples/prediction-market/prediction-market-api.md @@ -1,6 +1,6 @@ --- title: "Prediction Market API" -description: "Universal prediction market API: query market lifecycle, trades, and settlements across chains. Polymarket and more; additional EVM chains coming soon." +description: "Prediction Market API: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance. Covers archive history and realtime data." keywords: - prediction market API - Polymarket API @@ -14,7 +14,6 @@ keywords: - market resolution - outcome tokens --- - import VideoPlayer from "../../../src/components/videoplayer.js"; # Prediction Market API @@ -35,7 +34,7 @@ Flow: **Management** (Created) → **Trades** (Buy/Sell) → **Settlement** (Spl This is a **universal** prediction market API: the same cubes and fields work across supported chains. Use `EVM(network: matic)` for Polygon today; more chains will be added over time. -For contract-level and event-based Polymarket data (e.g. OrderFilled, ConditionResolution), see the [Polymarket API](https://docs.bitquery.io/docs/examples/polymarket-api/) docs. +For contract-level and event-based Polymarket data (e.g. OrderFilled, ConditionResolution), see the [Polymarket API](/docs/examples/polymarket-api/polymarket-api/) docs. diff --git a/docs/examples/prediction-market/prediction-settlements-api.md b/docs/examples/prediction-market/prediction-settlements-api.md index c3dbd25c..79e5f3d6 100644 --- a/docs/examples/prediction-market/prediction-settlements-api.md +++ b/docs/examples/prediction-market/prediction-settlements-api.md @@ -1,6 +1,6 @@ --- title: "Prediction Market Settlements API" -description: "Query prediction market settlements: real-time streams, latest settlements, redemptions, whale activity, top winners, and top market questions. Split, merge, and redemption events on Polygon (Polymarket and more)." +description: "Prediction Market Settlements API: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." keywords: - PredictionSettlements - prediction market settlements API @@ -14,7 +14,6 @@ keywords: - prediction market analytics - Bitquery GraphQL prediction --- - import VideoPlayer from "../../../src/components/videoplayer.js"; # Prediction Market Settlements API @@ -399,7 +398,6 @@ query TopRedeemers { } ``` - --- ## Use cases diff --git a/docs/examples/prediction-market/prediction-trades-api.md b/docs/examples/prediction-market/prediction-trades-api.md index c3fb0996..b136df8f 100644 --- a/docs/examples/prediction-market/prediction-trades-api.md +++ b/docs/examples/prediction-market/prediction-trades-api.md @@ -1,6 +1,6 @@ --- title: "Prediction Market Trades API" -description: "Query prediction market trades: real-time streams, latest trades, trades by market or trader, volume by outcome, and current prices. Buy/sell outcome tokens on Polygon (Polymarket and more)." +description: "Prediction Market Trades API: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." keywords: - PredictionTrades - prediction market trades API @@ -13,7 +13,6 @@ keywords: - prediction market analytics - Bitquery GraphQL prediction --- - import VideoPlayer from "../../../src/components/videoplayer.js"; # Prediction Market Trades API @@ -491,5 +490,4 @@ query CurrentPricePerOutcome { } ``` - For market creation and resolution, see [PredictionManagements](../prediction-market-api#predictionmanagements). For settlements (split, merge, redemption), see [Prediction Market Settlements API](../prediction-settlements-api). diff --git a/docs/examples/x402/x402-data-apis.md b/docs/examples/x402/x402-data-apis.md index d97a7827..fc6714ef 100644 --- a/docs/examples/x402/x402-data-apis.md +++ b/docs/examples/x402/x402-data-apis.md @@ -1,6 +1,6 @@ --- -title: "x402 Data API" -description: "Complete guide to x402 API: Query x402 payment transactions, monitor server payments in real-time, and analyze payment analytics. Learn how to use GraphQL APIs to track x402 protocol payments, server activity, and user transactions across multiple blockchain networks." +title: "x402 Data APIs" +description: "X402 Data Apis: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance. Run it in the IDE, then ship in your app." keywords: - x402 API - x402 GraphQL API @@ -21,31 +21,13 @@ keywords: - smart contract payments - payment analytics API --- - - - - - - - - - - - - - - - - - - # x402 Data API Docs - How to Query x402 Payment Data Learn how to query x402 payment data using GraphQL APIs. This comprehensive guide shows you how to access payment transactions, monitor server activity in real-time, and analyze payment analytics across multiple blockchain networks. The examples in this guide use Base network, but x402 protocol supports multiple chains. ## What is x402 API? -The x402 API provides programmatic access to x402 protocol payment data through [GraphQL queries](https://docs.bitquery.io/docs/graphql/query). You can query payment transactions, track server activity, monitor real-time payments, and analyze payment analytics directly from the blockchain using [Bitquery's streaming data platform](https://docs.bitquery.io/docs/intro). +The x402 API provides programmatic access to x402 protocol payment data through [GraphQL queries](/docs/graphql/query). You can query payment transactions, track server activity, monitor real-time payments, and analyze payment analytics directly from the blockchain using [Bitquery's streaming data platform](/docs/intro). ## x402 Overview @@ -53,15 +35,15 @@ x402 is a decentralized payment protocol that enables pay-per-use API access on ## How x402 Works? -x402 operates on a three-party architecture consisting of clients (API consumers), servers (API providers), and facilitators (payment processors). When a client wants to use a paid API service, they initiate a payment transaction on the blockchain. The facilitator validates the payment and notifies the server, which then processes the API request. The server verifies the payment payload embedded in the request headers before delivering the service. This creates a trustless system where payments are verified on-chain before service delivery, ensuring both parties fulfill their obligations without requiring intermediaries. All payment transactions are recorded on the blockchain and can be queried using [GraphQL transfer queries](https://docs.bitquery.io/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api) for the respective network. +x402 operates on a three-party architecture consisting of clients (API consumers), servers (API providers), and facilitators (payment processors). When a client wants to use a paid API service, they initiate a payment transaction on the blockchain. The facilitator validates the payment and notifies the server, which then processes the API request. The server verifies the payment payload embedded in the request headers before delivering the service. This creates a trustless system where payments are verified on-chain before service delivery, ensuring both parties fulfill their obligations without requiring intermediaries. All payment transactions are recorded on the blockchain and can be queried using [GraphQL transfer queries](/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api) for the respective network. ## Various Actors in x402 The x402 ecosystem consists of three main actors: -1. **Clients**: Users or applications that consume paid API services. They initiate [payment transactions](https://docs.bitquery.io/docs/blockchain/Ethereum/transactions/transaction-api) and include payment payloads in their API requests. +1. **Clients**: Users or applications that consume paid API services. They initiate [payment transactions](/docs/blockchain/Ethereum/transactions/transaction-api) and include payment payloads in their API requests. -2. **Servers**: API providers who offer services for payment. They verify payment payloads and deliver services after confirming valid payments on-chain. Server addresses can be tracked using [transfer queries](https://docs.bitquery.io/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api). +2. **Servers**: API providers who offer services for payment. They verify payment payloads and deliver services after confirming valid payments on-chain. Server addresses can be tracked using [transfer queries](/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api). 3. **Facilitators**: Payment processors that validate transactions, monitor the blockchain for payments, and notify servers when valid payments are detected. They help bridge the gap between on-chain payments and off-chain service delivery. @@ -213,21 +195,21 @@ The payment payload typically contains: ### Verification Process -1. **Client Side**: The client initiates a [payment transaction](https://docs.bitquery.io/docs/blockchain/Ethereum/transactions/transaction-api) on the supported blockchain network, sending supported tokens (such as USDC) to the server's address. The client then encodes the payment details into a Base64 JSON payload. +1. **Client Side**: The client initiates a [payment transaction](/docs/blockchain/Ethereum/transactions/transaction-api) on the supported blockchain network, sending supported tokens (such as USDC) to the server's address. The client then encodes the payment details into a Base64 JSON payload. 2. **Server Side**: The server receives the API request with the `X-PAYMENT` header. It decodes the payload and verifies the payment by checking: - - The transaction exists on-chain (verifiable through [transaction queries](https://docs.bitquery.io/docs/blockchain/Ethereum/transactions/transaction-api)) + - The transaction exists on-chain (verifiable through [transaction queries](/docs/blockchain/Ethereum/transactions/transaction-api)) - The payment amount matches the required fee - The recipient address matches the server's address - The transaction is confirmed and not a double-spend -3. **Facilitator Role**: Facilitators monitor the blockchain for payment transactions using [real-time subscriptions](https://docs.bitquery.io/docs/subscriptions/). When they detect a valid payment to a registered server, they notify the server, enabling faster service delivery without waiting for full blockchain confirmation. +3. **Facilitator Role**: Facilitators monitor the blockchain for payment transactions using [real-time subscriptions](/docs/category/graphql-subscriptions/). When they detect a valid payment to a registered server, they notify the server, enabling faster service delivery without waiting for full blockchain confirmation. This architecture ensures that servers only deliver services after verifying valid on-chain payments, creating a trustless pay-per-use system. ## x402 Data API Queries -The following queries demonstrate how to query x402 payment data using [Bitquery's GraphQL API](https://docs.bitquery.io/docs/graphql/query). These queries help you monitor payments, track server activity, and analyze payment analytics. For more information on building queries, see our [GraphQL query guide](https://docs.bitquery.io/docs/graphql/query) and [filtering documentation](https://docs.bitquery.io/docs/graphql/filters). +The following queries demonstrate how to query x402 payment data using [Bitquery's GraphQL API](/docs/graphql/query). These queries help you monitor payments, track server activity, and analyze payment analytics. For more information on building queries, see our [GraphQL query guide](/docs/graphql/query) and [filtering documentation](/docs/graphql/filters). :::note Multi-Chain Support x402 protocol supports multiple blockchain networks. The examples below use Base network, but you can adapt these queries for other supported chains by changing the `network` parameter. @@ -274,11 +256,11 @@ query MyQuery { ### Query Explanation -- **`dataset: realtime`**: Queries the most recent blockchain data. Learn more about [dataset options](https://docs.bitquery.io/docs/graphql/dataset/options) -- **`network: base`**: Specifies the network (Base in this example). Change this to query other supported chains (e.g., `network: ethereum`, `network: bsc`). See [supported networks](https://docs.bitquery.io/docs/blockchain/introduction) -- **`Receiver: {in: [...]}`**: Filters transfers to the specific server address using [GraphQL filters](https://docs.bitquery.io/docs/graphql/filters) -- **`orderBy: {descending: Block_Number}`**: Returns the most recent payments first. See [sorting documentation](https://docs.bitquery.io/docs/graphql/sorting) -- **`limit: {count: 100}`**: Retrieves up to 100 payment transactions. Check [query limits](https://docs.bitquery.io/docs/graphql/limits) +- **`dataset: realtime`**: Queries the most recent blockchain data. Learn more about [dataset options](/docs/graphql/dataset/options) +- **`network: base`**: Specifies the network (Base in this example). Change this to query other supported chains (e.g., `network: ethereum`, `network: bsc`). See [supported networks](/docs/blockchain/introduction) +- **`Receiver: {in: [...]}`**: Filters transfers to the specific server address using [GraphQL filters](/docs/graphql/filters) +- **`orderBy: {descending: Block_Number}`**: Returns the most recent payments first. See [sorting documentation](/docs/graphql/sorting) +- **`limit: {count: 100}`**: Retrieves up to 100 payment transactions. Check [query limits](/docs/graphql/limits) ## Real-Time Payment Monitoring with GraphQL WebSockets @@ -311,10 +293,10 @@ subscription { ### Subscription Explanation -- **`subscription`**: Uses [GraphQL subscription](https://docs.bitquery.io/docs/subscriptions/subscription) for real-time updates +- **`subscription`**: Uses [GraphQL subscription](/docs/subscriptions/subscription) for real-time updates - **`EVM(network: base)`**: Monitors the specified network (Base in this example). Change the network parameter to monitor other supported chains - **`Transfers`**: Listens for new transfer events matching the filter -- The subscription will automatically push new payment transactions as they occur on-chain. Learn more about [real-time subscriptions](https://docs.bitquery.io/docs/subscriptions/) +- The subscription will automatically push new payment transactions as they occur on-chain. Learn more about [real-time subscriptions](/docs/category/graphql-subscriptions/) ## Payment Analytics for Specific x402 Server @@ -352,14 +334,14 @@ query MyQuery { ### Query Explanation -- **`dataset: combined`**: Queries both historical and real-time data. See [dataset options](https://docs.bitquery.io/docs/graphql/dataset/options) -- **`since_relative: {days_ago: 7}`**: Analyzes the last 7 days of payments using [datetime filters](https://docs.bitquery.io/docs/graphql/datetime) -- **`Currency: {SmartContract: {is: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}`**: Filters for USDC payments (this is the USDC contract address on Base; use the appropriate contract address for other networks). Learn about [token transfer queries](https://docs.bitquery.io/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api) -- **`sum(of: Transfer_Amount)`**: Calculates total payment volume using [GraphQL metrics](https://docs.bitquery.io/docs/graphql/metrics) +- **`dataset: combined`**: Queries both historical and real-time data. See [dataset options](/docs/graphql/dataset/options) +- **`since_relative: {days_ago: 7}`**: Analyzes the last 7 days of payments using [datetime filters](/docs/graphql/datetime) +- **`Currency: {SmartContract: {is: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}`**: Filters for USDC payments (this is the USDC contract address on Base; use the appropriate contract address for other networks). Learn about [token transfer queries](/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api) +- **`sum(of: Transfer_Amount)`**: Calculates total payment volume using [GraphQL metrics](/docs/graphql/metrics) - **`sum(of: Transfer_AmountInUSD)`**: Calculates total volume in USD - **`count(distinct: Transfer_Sender)`**: Counts unique users who made payments - **`count(distinct: Transaction_Hash)`**: Counts total payment transactions -- **`transactions24h`**: Conditional count for transactions in the last 24 hours using [conditional metrics](https://docs.bitquery.io/docs/graphql/metrics) +- **`transactions24h`**: Conditional count for transactions in the last 24 hours using [conditional metrics](/docs/graphql/metrics) ### Analytics Metrics Returned @@ -531,10 +513,10 @@ subscription { ### Subscription Explanation -- **`subscription`**: Uses [GraphQL subscription](https://docs.bitquery.io/docs/subscriptions/subscription) for real-time updates +- **`subscription`**: Uses [GraphQL subscription](/docs/subscriptions/subscription) for real-time updates - **`Solana`**: Monitors the Solana network - **`Transfers`**: Listens for new transfer events matching the filter -- The subscription will automatically push new payment transactions as they occur on-chain. Learn more about [real-time subscriptions](https://docs.bitquery.io/docs/subscriptions/) +- The subscription will automatically push new payment transactions as they occur on-chain. Learn more about [real-time subscriptions](/docs/category/graphql-subscriptions/) ## Payment Analytics for x402 Server on Solana @@ -583,18 +565,18 @@ You can run this query [here](https://ide.bitquery.io/Payment-analytics-related- ## Related Documentation -- [Blockchain Networks](https://docs.bitquery.io/docs/blockchain/introduction) - Overview of supported blockchain networks -- [Base Network Documentation](https://docs.bitquery.io/docs/blockchain/Base/) - Complete guide to querying Base blockchain data -- [Solana Network Documentation](https://docs.bitquery.io/docs/blockchain/Solana/) - Complete guide to querying Solana blockchain data -- [Ethereum Network Documentation](https://docs.bitquery.io/docs/blockchain/Ethereum/) - Query Ethereum blockchain data -- [BSC Network Documentation](https://docs.bitquery.io/docs/blockchain/BSC/) - Query BSC blockchain data -- [GraphQL Query Guide](https://docs.bitquery.io/docs/graphql/query) - Learn how to build GraphQL queries -- [Real-time Subscriptions](https://docs.bitquery.io/docs/subscriptions/) - Monitor blockchain data in real-time -- [Transfer API Documentation](https://docs.bitquery.io/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api) - Query ERC-20 token transfers -- [Solana Transfers](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers) - Query Solana token transfers -- [GraphQL Filters](https://docs.bitquery.io/docs/graphql/filters) - Advanced filtering techniques -- [GraphQL Metrics](https://docs.bitquery.io/docs/graphql/metrics) - Aggregation and calculation functions -- [Datetime Queries](https://docs.bitquery.io/docs/graphql/datetime) - Time-based filtering and analysis -- [Getting Started Guide](https://docs.bitquery.io/docs/start/first-query) - Build your first query -- [WebSocket Subscriptions](https://docs.bitquery.io/docs/subscriptions/websocket) - Real-time data streaming +- [Blockchain Networks](/docs/blockchain/introduction) - Overview of supported blockchain networks +- [Base Network Documentation](/docs/blockchain/Base/) - Complete guide to querying Base blockchain data +- [Solana Network Documentation](/docs/blockchain/Solana/) - Complete guide to querying Solana blockchain data +- [Ethereum Network Documentation](/docs/blockchain/Ethereum/) - Query Ethereum blockchain data +- [BSC Network Documentation](/docs/blockchain/BSC/) - Query BSC blockchain data +- [GraphQL Query Guide](/docs/graphql/query) - Learn how to build GraphQL queries +- [Real-time Subscriptions](/docs/category/graphql-subscriptions/) - Monitor blockchain data in real-time +- [Transfer API Documentation](/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api) - Query ERC-20 token transfers +- [Solana Transfers](/docs/blockchain/Solana/solana-transfers) - Query Solana token transfers +- [GraphQL Filters](/docs/graphql/filters) - Advanced filtering techniques +- [GraphQL Metrics](/docs/graphql/metrics) - Aggregation and calculation functions +- [Datetime Queries](/docs/graphql/datetime) - Time-based filtering and analysis +- [Getting Started Guide](/docs/start/first-query) - Build your first query +- [WebSocket Subscriptions](/docs/subscriptions/websockets/) - Real-time data streaming diff --git a/docs/glossary/EVM.md b/docs/glossary/EVM.md index fd4fcc5e..50a978b8 100644 --- a/docs/glossary/EVM.md +++ b/docs/glossary/EVM.md @@ -1,3 +1,7 @@ +--- +title: "EVM Builder Terms Explaination" +description: "EVM Builder Terms Explaination: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." +--- # EVM Builder Terms Explaination ### Dataset Parameters diff --git a/docs/glossary/solana.md b/docs/glossary/solana.md index 028a971c..9d554148 100644 --- a/docs/glossary/solana.md +++ b/docs/glossary/solana.md @@ -1,3 +1,7 @@ +--- +title: "Solana Builder Terms Explaination" +description: "Solana Builder Terms Explaination: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." +--- # Solana Builder Terms Explaination ### Dataset Parameters diff --git a/docs/graphql/calculations.md b/docs/graphql/calculations.md index c69a4046..88027792 100644 --- a/docs/graphql/calculations.md +++ b/docs/graphql/calculations.md @@ -1,7 +1,8 @@ --- sidebar_position: 6 +title: "GraphQL Calculations and Expressions" +description: "GraphQL Calculations and Expressions in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." --- - # Calculations Attributes ```maximum``` ```minimum``` ```where``` can be appended to an element in query. @@ -42,4 +43,4 @@ Use ```where``` with some always-true condition (say, ChainId equal 1) to get ** :::tip Use [Aliases](/docs/graphql/metrics/alias) to name the elements if needed -::: \ No newline at end of file +::: diff --git a/docs/graphql/capabilities/aggregated_metrics.md b/docs/graphql/capabilities/aggregated_metrics.md index 0482b230..7f38f7a9 100644 --- a/docs/graphql/capabilities/aggregated_metrics.md +++ b/docs/graphql/capabilities/aggregated_metrics.md @@ -1,7 +1,8 @@ --- sidebar_position: 3 +title: "Query Aggregated Metrics" +description: "Query Aggregated Metrics in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." --- - # Query Aggregated Metrics This is the most effective query. @@ -34,4 +35,4 @@ query { ``` ```maximum: Transfer_Amount``` calculates maximum amount of transfer in the scope of -defined dimensions, namely ```Date```. \ No newline at end of file +defined dimensions, namely ```Date```. diff --git a/docs/graphql/capabilities/array-intersect.md b/docs/graphql/capabilities/array-intersect.md index cbd6d5f0..21ca7f7b 100644 --- a/docs/graphql/capabilities/array-intersect.md +++ b/docs/graphql/capabilities/array-intersect.md @@ -1,7 +1,8 @@ --- sidebar_position: 6 +title: "Array Intersection" +description: "Array Intersection in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. See examples in the Bitquery IDE." --- - # Array Intersection The `array_intersect` feature is an advanced query format that generates an intersection of addresses from specified datasets. You can use the `where` clause to introduce filters that refine your results according to desired criteria. The output is a list of addresses that share a common link to the two datasets. @@ -80,5 +81,4 @@ This query will return a response in this format ; as an array consisting of ele } } - ``` diff --git a/docs/graphql/capabilities/expression.md b/docs/graphql/capabilities/expression.md index 35206c18..1e54c0b2 100644 --- a/docs/graphql/capabilities/expression.md +++ b/docs/graphql/capabilities/expression.md @@ -1,3 +1,7 @@ +--- +title: "GraphQL Expressions" +description: "Expression in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. Built for traders and analytics teams." +--- # Expressions ## What is a Calculate Expression? @@ -85,4 +89,4 @@ subscription { } } } -``` \ No newline at end of file +``` diff --git a/docs/graphql/capabilities/joins.md b/docs/graphql/capabilities/joins.md index 9fcccb6d..caa4ca9a 100644 --- a/docs/graphql/capabilities/joins.md +++ b/docs/graphql/capabilities/joins.md @@ -1,3 +1,7 @@ +--- +title: "GraphQL Joins" +description: "Joins in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. Includes filters and field selection tips." +--- # GraphQL Joins Starting March 2025, Bitquery APIs support joins on the v2 endpoint. @@ -219,4 +223,4 @@ query MyQuery { - The query finds all the balance update records for the particular token and a particular token pair address. - Then it sums up the amount from all `Balance Updates` to get the amount of tokens currently in the pool. - Then it checks the latest `DEX Trades` for the mentioned token. -- The `PriceInUSD` in joinDEXTradeByTokens shows the latest price of the token. \ No newline at end of file +- The `PriceInUSD` in joinDEXTradeByTokens shows the latest price of the token. diff --git a/docs/graphql/capabilities/json-filtering.md b/docs/graphql/capabilities/json-filtering.md index 8d96b046..a482048a 100644 --- a/docs/graphql/capabilities/json-filtering.md +++ b/docs/graphql/capabilities/json-filtering.md @@ -1,3 +1,7 @@ +--- +title: "Filtering JSON Arguments" +description: "Filtering JSON Arguments in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." +--- # Filtering JSON Arguments Starting October 2025, we support filtering of JSON arguments in Solana instructions. This feature allows you to query blockchain data based on the parsed argument values within program instructions. @@ -96,7 +100,6 @@ The following query demonstrates how to filter `setAuthority` method calls where - `Accounts` - Array of account addresses involved in the instruction - `Transaction.Signature` - The transaction signature - ## Filtering Options ### JSON Value Operators @@ -156,5 +159,3 @@ Arguments: { } ``` - - diff --git a/docs/graphql/capabilities/patterns.md b/docs/graphql/capabilities/patterns.md index 1779de84..723c16a4 100644 --- a/docs/graphql/capabilities/patterns.md +++ b/docs/graphql/capabilities/patterns.md @@ -1,12 +1,17 @@ --- +draft: true sidebar_position: 1 +title: "GraphQL Usage Patterns" +description: "Learn common Bitquery GraphQL patterns for facts, aggregates, subscriptions, and efficient query design across chains. See examples in the Bitquery IDE." --- - # Usage Patterns GraphQL is a language, and the schema is just a restriction how do you use this language. Applications may use the GraphQL in a variety of ways, and this section describes some common patterns. +See also: - +- [Aggregated metrics](/docs/graphql/capabilities/aggregated_metrics/) +- [Expression](/docs/graphql/capabilities/expression/) +- [Joins](/docs/graphql/capabilities/joins/) diff --git a/docs/graphql/capabilities/query_fact_records.md b/docs/graphql/capabilities/query_fact_records.md index 9f76b6b2..ee45e9ee 100644 --- a/docs/graphql/capabilities/query_fact_records.md +++ b/docs/graphql/capabilities/query_fact_records.md @@ -1,8 +1,8 @@ --- sidebar_position: 2 +title: "Query Fact Records in GraphQL" +description: "Query raw blockchain fact records with Bitquery GraphQL, including field selection, filters, limits, and result shapes. See examples in the Bitquery IDE." --- - - # Query Fact Records This is the simplest type of query. You just define the attributes which you need in the results, @@ -20,7 +20,6 @@ This type of query is useful in the following cases: [Query example ](https://graphql.bitquery.io/ide/Last-transactions-with-cost) to get the last transactions in the blockchain with the cost of them: - ```graphql query { EVM(dataset: realtime network: bsc) { @@ -37,4 +36,4 @@ query { } } } -``` \ No newline at end of file +``` diff --git a/docs/graphql/capabilities/relative-time.md b/docs/graphql/capabilities/relative-time.md index 379bba57..91acbf53 100644 --- a/docs/graphql/capabilities/relative-time.md +++ b/docs/graphql/capabilities/relative-time.md @@ -1,3 +1,7 @@ +--- +title: "Relative Time Filters" +description: "Relative Time Filters in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." +--- # Relative Time Filters Bitquery's GraphQL API now supports **relative time filtering**. This filtering option simplify querying time-dependent blockchain data without manually calculating or formatting exact UTC timestamps. @@ -47,7 +51,7 @@ The list of supported time units are given below. ### Last Hour Trades -The following examples uses the `after_relative` filter to get Solana DEX Trades for the last `1 hour`. You can checkout from the results that the oldest trades returned occured an hour ago(UTC Time). +The following example uses the `after_relative` filter to get Solana DEX Trades for the last `1 hour`. You can checkout from the results that the oldest trades returned occurred an hour ago(UTC Time). ```graphql { @@ -91,4 +95,4 @@ You can use multiple time units together as shown in the example below. } } } -``` \ No newline at end of file +``` diff --git a/docs/graphql/capabilities/subscription_aggregates.md b/docs/graphql/capabilities/subscription_aggregates.md index a09a6bf8..1a36b875 100644 --- a/docs/graphql/capabilities/subscription_aggregates.md +++ b/docs/graphql/capabilities/subscription_aggregates.md @@ -1,7 +1,8 @@ --- sidebar_position: 5 +title: "Subscription on Aggregated Metrics" +description: "Subscription on Aggregated Metrics in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." --- - # Subscription on Aggregated Metrics It is a subscription to the results of [Query Aggregated Metrics](/docs/graphql/capabilities/aggregated_metrics). @@ -16,4 +17,4 @@ but the update to the previously calculated aggregate. This subscription is appropriate when: 1. application is not capable to process raw stream of the data; -2. the new data is used to be displayed or used inside the application in an aggregated form. \ No newline at end of file +2. the new data is used to be displayed or used inside the application in an aggregated form. diff --git a/docs/graphql/capabilities/subscription_facts.md b/docs/graphql/capabilities/subscription_facts.md index edc4e05b..b3452b5d 100644 --- a/docs/graphql/capabilities/subscription_facts.md +++ b/docs/graphql/capabilities/subscription_facts.md @@ -1,7 +1,8 @@ --- sidebar_position: 4 +title: "Subscription on Facts" +description: "Subscription on Facts in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." --- - # Subscription on Facts It is a subscription to the results of [Query Fact Records](/docs/graphql/capabilities/query_fact_records). @@ -16,4 +17,4 @@ This subscription is appropriate when: 1. application is capable to process raw stream of the data; 2. minimum delay required between the data in the blockchain and the application; -3. notification is required on trigger, defined on some specific conditions. \ No newline at end of file +3. notification is required on trigger, defined on some specific conditions. diff --git a/docs/graphql/combined.md b/docs/graphql/combined.md index 17dbd8c3..1f35ac30 100644 --- a/docs/graphql/combined.md +++ b/docs/graphql/combined.md @@ -1,7 +1,8 @@ --- sidebar_position: 10 +title: "Combined Dataset in Bitquery GraphQL" +description: "Combined Dataset in Bitquery GraphQL in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." --- - # Combined Queries Several queries can be combined and return results in one request: @@ -36,4 +37,4 @@ Use [Aliases](/docs/graphql/metrics/alias) to name the elements if needed :::danger Subscriptions and queries can not be combined -::: \ No newline at end of file +::: diff --git a/docs/graphql/dataset/EAP.mdx b/docs/graphql/dataset/EAP.mdx index 8d5ba1fa..7581f0cf 100644 --- a/docs/graphql/dataset/EAP.mdx +++ b/docs/graphql/dataset/EAP.mdx @@ -1,3 +1,7 @@ +--- +title: "Early Access Program" +description: "Early Access Program in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. See examples in the Bitquery IDE." +--- import VideoPlayer from "../../../src/components/videoplayer.js"; # Early Access Program @@ -17,8 +21,8 @@ The Early Access Program (EAP) provided users with access to streaming data acro You can access v2 APIs through the Bitquery IDE interface. Navigate to [Bitquery IDE](https://ide.bitquery.io/) to get started. -You can find examples on [Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades.mdx) and Matic in our examples section. +You can find examples on [Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades/) and Matic in our examples section. ## How to Authorize Requests -APIs use OAuth token mechanism for authentication. Read more on how to generate a token [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +APIs use OAuth token mechanism for authentication. Read more on how to generate a token [here](/docs/authorization/how-to-generate/) diff --git a/docs/graphql/dataset/archive.md b/docs/graphql/dataset/archive.md index fa824194..12ccfa6f 100644 --- a/docs/graphql/dataset/archive.md +++ b/docs/graphql/dataset/archive.md @@ -1,7 +1,8 @@ --- sidebar_position: 5 +title: "GraphQL Archive Dataset" +description: "Query historical blockchain data with Bitquery’s archive dataset, including retention notes, limits, and GraphQL examples." --- - # Archive Database Archive database contains the data with the **delay from tens of minutes to several hours**, @@ -24,9 +25,8 @@ Archive Database features: ::: - Also Check [Combined](/docs/graphql/dataset/combined) and [RealTime](/docs/graphql/dataset/realtime) dataset. ## Does Bitquery have data for all historical blocks since genesis? {#does-bitquery-have-data-for-all-historical-blocks-since-genesis} -With the exception of Solana, Bitquery provides complete historical data (from genesis onward) for all supported blockchains. For Solana, full historical token transfers are available via the V1 API, while in V2, Bitquery offers price aggregates starting from 2024. \ No newline at end of file +With the exception of Solana, Bitquery provides complete historical data (from genesis onward) for all supported blockchains. For Solana, full historical token transfers are available via the V1 API, while in V2, Bitquery offers price aggregates starting from 2024. diff --git a/docs/graphql/dataset/combined.md b/docs/graphql/dataset/combined.md index 621744f3..63137018 100644 --- a/docs/graphql/dataset/combined.md +++ b/docs/graphql/dataset/combined.md @@ -1,8 +1,8 @@ --- sidebar_position: 6 +title: "Combined Database" +description: "Combined Database in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. See examples in the Bitquery IDE." --- - - # Combined Database When you query combined database, actually the query goes to the archive and real time databases separately @@ -20,7 +20,6 @@ Typically you should avoid using this type of query, as it is slower than real t and does not give full consistency of the data. ::: - Also Check [Archive](/docs/graphql/dataset/archive) and [RealTime](/docs/graphql/dataset/realtime) dataset. ## What is the difference between realtime, archive, and combined datasets? @@ -33,4 +32,4 @@ Also Check [Archive](/docs/graphql/dataset/archive) and [RealTime](/docs/graphql ## Why does dataset: combined return fewer fields than dataset: realtime on Solana? -On Solana, some projections (for example certain **`Trade.Side`** / account-level fields) are only populated in the **realtime** slice. **Combined** and **archive** historical aggregates may **omit** those columns, which triggers “columns not available” errors if you request them. Use fields documented for **archive/combined** (e.g. `DEXTradeByTokens` aggregates) or switch to **`dataset: realtime`** for debugging. See [Historical Solana aggregate data](/docs/blockchain/Solana/historical-aggregate-data/) and [Pump.fun combined-dataset note](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#why-does-my-pumpfun-query-return-columns-not-available-in-combined-dataset). \ No newline at end of file +On Solana, some projections (for example certain **`Trade.Side`** / account-level fields) are only populated in the **realtime** slice. **Combined** and **archive** historical aggregates may **omit** those columns, which triggers “columns not available” errors if you request them. Use fields documented for **archive/combined** (e.g. `DEXTradeByTokens` aggregates) or switch to **`dataset: realtime`** for debugging. See [Historical Solana aggregate data](/docs/blockchain/Solana/historical-aggregate-data/) and [Pump.fun combined-dataset note](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#why-does-my-pumpfun-query-return-columns-not-available-in-combined-dataset). diff --git a/docs/graphql/dataset/database.md b/docs/graphql/dataset/database.md index f33e2456..d4a74592 100644 --- a/docs/graphql/dataset/database.md +++ b/docs/graphql/dataset/database.md @@ -1,15 +1,14 @@ --- sidebar_position: 3 +title: "Database Selection" +description: "Database Selection in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. See examples in the Bitquery IDE." --- - - # Database Selection Dataset attribute on the query top level defines the database to query: ![Dataset option](/img/ide/dataset_option.png) - * ```realtime``` (default) is the real time database, containing the new blocks * ```archive``` is the finalized database, data from the first block to a recent time (from hours to minutes ago) * ```combined``` if you need to query both in one query diff --git a/docs/graphql/dataset/network.md b/docs/graphql/dataset/network.md index 62879601..7c13f10c 100644 --- a/docs/graphql/dataset/network.md +++ b/docs/graphql/dataset/network.md @@ -1,7 +1,8 @@ --- sidebar_position: 2 +title: "GraphQL Network Selection" +description: "Select the blockchain network in Bitquery GraphQL queries using the network attribute, with clear multi-chain examples. See examples in the Bitquery IDE." --- - # Network Network attribute is a selection of the blockchain: @@ -41,4 +42,3 @@ canto: 7700 aurora: 1313161554 ``` - diff --git a/docs/graphql/dataset/options.md b/docs/graphql/dataset/options.md index 26ee790b..f1a6d663 100644 --- a/docs/graphql/dataset/options.md +++ b/docs/graphql/dataset/options.md @@ -1,7 +1,8 @@ --- sidebar_position: 1 +title: "GraphQL Dataset Options" +description: "Configure Bitquery GraphQL dataset options for archive, realtime, and combined modes when querying blockchain history live." --- - # Options GraphQL interface hides the internal complexity of the datasets, @@ -17,12 +18,10 @@ Top level element of the query has 3 attributes, defining what is the source for 2. ```dataset``` - what type of the database to query 3. ```select_blocks``` - which blocks (branches or trunk only) to include in results - ![Dataset options](/img/ide/dataset_options.png) :::note -[subscription](/docs/subscriptions/subscription.md) has a different set of top level elements. +[subscription](/docs/subscriptions/subscription/) has a different set of top level elements. For example, the dataset for subscription is always real time and not controlled. ::: - diff --git a/docs/graphql/dataset/realtime.md b/docs/graphql/dataset/realtime.md index 8fdde181..92e28b05 100644 --- a/docs/graphql/dataset/realtime.md +++ b/docs/graphql/dataset/realtime.md @@ -1,7 +1,8 @@ --- sidebar_position: 4 +title: "Realtime Database" +description: "Realtime Database in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. See examples in the Bitquery IDE." --- - # Realtime Database Realtime is the default database (if you omit the attribute, then it is used). diff --git a/docs/graphql/dataset/select-blocks.md b/docs/graphql/dataset/select-blocks.md index 6cf3b9d0..140fe486 100644 --- a/docs/graphql/dataset/select-blocks.md +++ b/docs/graphql/dataset/select-blocks.md @@ -1,10 +1,10 @@ --- sidebar_position: 10 +title: "Blockchain Reorg Tree" +description: "Blockchain Reorg Tree in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." --- - # Blockchain Reorg Tree - Blocks in the blockchain form a tree (or directed acyclic graph DAG in general): ![Blockchain graph](/img/diagrams/tree.png) @@ -25,8 +25,6 @@ Branched block 102 however is included in real time database. ::: ## Select Blocks - - Select blocks attribute controls real time and combined database queries in terms of which block data to include in the result set. @@ -36,7 +34,6 @@ It has the following options: * ```tree``` all tree, combining trunk and branches * ```branches``` for only branched blocks (not on trunk) - :::tip You need ```tree``` and ```branches``` only in a very special case, when you need to analyze the reorganization tree of the blockchain. diff --git a/docs/graphql/datetime.md b/docs/graphql/datetime.md index f73c022d..cf833207 100644 --- a/docs/graphql/datetime.md +++ b/docs/graphql/datetime.md @@ -1,7 +1,8 @@ --- sidebar_position: 7 +title: "Date and Time Filters in GraphQL" +description: "Date and Time Filters in GraphQL in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." --- - # Date and Time ## Format @@ -35,4 +36,4 @@ To shift the starting point of an interval, use the `offset` parameter: Time(interval: {in: minutes count: 10 offset: 1}) ``` -This configuration will count intervals starting at 1, 11, 21, and so on in minutes. \ No newline at end of file +This configuration will count intervals starting at 1, 11, 21, and so on in minutes. diff --git a/docs/graphql/filters.mdx b/docs/graphql/filters.mdx index 1b572506..e444de14 100644 --- a/docs/graphql/filters.mdx +++ b/docs/graphql/filters.mdx @@ -1,7 +1,8 @@ --- sidebar_position: 3 +title: "GraphQL Query Filters" +description: "Filter Bitquery GraphQL blockchain results with where clauses, comparisons, and indexed fields to keep queries fast and precise." --- - # Filtering In most cases you do not need the full dataset, but just a portion, related to the diff --git a/docs/graphql/indexed-fields-reference.md b/docs/graphql/indexed-fields-reference.md index 6d9efd1e..9b2777e8 100644 --- a/docs/graphql/indexed-fields-reference.md +++ b/docs/graphql/indexed-fields-reference.md @@ -1,7 +1,7 @@ --- sidebar_position: 4 title: Indexed Fields Reference (where & orderBy) -description: Use indexed fields in where and orderBy for correct, fast queries. Reference of indexed fields per cube, dataset, and chain. +description: "Indexed Fields Reference (where & orderBy) in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." keywords: - indexed fields - where filter @@ -9,7 +9,6 @@ keywords: - query performance - cube indexes --- - # Indexed Fields Reference for `where` and `orderBy` Use **indexed fields** in your `where` filters and `orderBy` clauses. Filtering or sorting on non-indexed fields can lead to slow queries, timeouts. diff --git a/docs/graphql/limits.md b/docs/graphql/limits.md index ed3aee1b..d928333d 100644 --- a/docs/graphql/limits.md +++ b/docs/graphql/limits.md @@ -1,7 +1,8 @@ --- sidebar_position: 4 +title: "Bitquery GraphQL Query Limits" +description: "Bitquery GraphQL Query Limits in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." --- - # Limits Results are limited by using attributes ```limit``` and ```limitBy``` @@ -24,7 +25,6 @@ do not use ```offset``` for pagination of the result, unless you sure that the r modified or added between the queries and also have strong ordering ::: - ## limitBy ```limitBy``` limits the result size for every value of the supplied attribute @@ -55,4 +55,4 @@ The following query returns just top 2 blocks by transaction count, **per every :::tip ```limitBy``` is a good tool to do data sampling -::: \ No newline at end of file +::: diff --git a/docs/graphql/metrics/_category_.json b/docs/graphql/metrics/_category_.json index 91f28e58..24529e89 100644 --- a/docs/graphql/metrics/_category_.json +++ b/docs/graphql/metrics/_category_.json @@ -3,6 +3,7 @@ "position": 5, "link": { "type": "generated-index", - "description": "Metrics used to calculate statistics over the results grouped by dimensions" + "description": "Metrics used to calculate statistics over the results grouped by dimensions", + "slug": "/graphql/metrics" } } diff --git a/docs/graphql/metrics/alias.md b/docs/graphql/metrics/alias.md index a83eb585..b0955b2a 100644 --- a/docs/graphql/metrics/alias.md +++ b/docs/graphql/metrics/alias.md @@ -1,7 +1,8 @@ --- sidebar_position: 2 +title: "GraphQL Metric Aliases" +description: "Alias Bitquery GraphQL metrics to name aggregates, sort results cleanly, and return clearer API field names for apps. See examples in the Bitquery IDE." --- - # Aliases Aliases is a part of the GraphQL [standard](https://spec.graphql.org/draft/#sec-Field-Alias) diff --git a/docs/graphql/metrics/count.md b/docs/graphql/metrics/count.md index b1b3d563..23890936 100644 --- a/docs/graphql/metrics/count.md +++ b/docs/graphql/metrics/count.md @@ -1,13 +1,13 @@ --- sidebar_position: 6 +title: "GraphQL Count Metric" +description: "Use Bitquery’s count metric in GraphQL to aggregate blockchain events, trades, transfers, and other on-chain activity. See examples in the Bitquery IDE." --- - # Count ```count``` element in the query returns the total count of elements **in each set of dimensions**. This query will count blocks by every date: - ```graphql { EVM (dataset: archive){ @@ -21,5 +21,3 @@ This query will count blocks by every date: } ``` - - diff --git a/docs/graphql/metrics/distinct.md b/docs/graphql/metrics/distinct.md index 2ecc1a7a..b11fcf1e 100644 --- a/docs/graphql/metrics/distinct.md +++ b/docs/graphql/metrics/distinct.md @@ -1,13 +1,13 @@ --- sidebar_position: 6 +title: "GraphQL Distinct Metric" +description: "Distinct in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. Keep queries fast with indexed filters." --- - # Count Distinct ```count``` with ```distinct``` attribute calculates the unique values **in each set of dimensions**. This query will count miners (unique coinbase) by every date: - ```graphql { EVM (dataset: archive){ @@ -21,5 +21,3 @@ This query will count miners (unique coinbase) by every date: } ``` - - diff --git a/docs/graphql/metrics/if.md b/docs/graphql/metrics/if.md index 0324db0a..33bf84f5 100644 --- a/docs/graphql/metrics/if.md +++ b/docs/graphql/metrics/if.md @@ -1,7 +1,8 @@ --- sidebar_position: 4 +title: "Conditional Metrics" +description: "Conditional Metrics in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. See examples in the Bitquery IDE." --- - # Conditional Metrics Metrics have ```if``` attribute to define the condition for metric execution. @@ -21,5 +22,3 @@ count(distinct: Block_Number if: {Block: {GasUsed: {gt: "0"}}}) Use [Aliases](/docs/graphql/metrics/alias) to name these metrics ::: - - diff --git a/docs/graphql/metrics/metrics.md b/docs/graphql/metrics/metrics.md index d2abcccf..b7040350 100644 --- a/docs/graphql/metrics/metrics.md +++ b/docs/graphql/metrics/metrics.md @@ -1,7 +1,10 @@ --- sidebar_position: 1 +title: "GraphQL Metrics Overview" +description: "Metrics in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. Built for traders and analytics teams." +# Keep explicit path so this does not collide with the Metrics category hub slug. +slug: /graphql/metrics/metrics --- - # Using Metrics Use metrics if you want to: @@ -10,16 +13,14 @@ Use metrics if you want to: * aggregate the results in a smaller set Adding metrics make the query aggregate query, and it will return -results, grouped by dimensions. Look [Query Aggregated Metrics](../capabilities/aggregated_metrics.md) +results, grouped by dimensions. Look [Query Aggregated Metrics](/docs/graphql/capabilities/aggregated_metrics/) for details. :::tip -Consider using metrics in every query to the [archive database](../dataset/archive.md) +Consider using metrics in every query to the [archive database](/docs/graphql/dataset/archive/) ::: :::note -Metrics can be also used in subscriptions, refer to [Subscription on Aggregated Metrics](../capabilities/subscription_aggregates.md) for details. +Metrics can be also used in subscriptions, refer to [Subscription on Aggregated Metrics](/docs/graphql/capabilities/subscription_aggregates/) for details. ::: - - diff --git a/docs/graphql/metrics/priceAsymmetry.md b/docs/graphql/metrics/priceAsymmetry.md index 4163b93b..977a6e9a 100644 --- a/docs/graphql/metrics/priceAsymmetry.md +++ b/docs/graphql/metrics/priceAsymmetry.md @@ -1,3 +1,7 @@ +--- +title: "GraphQL Price Asymmetry Metric" +description: "Price Asymmetry in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. Keep queries fast with indexed filters." +--- # Price Asymmetry In this section, we will see how to use the `PriceAsymmetry` metric to filter results based on Price. @@ -75,5 +79,4 @@ subscription { } } - ``` diff --git a/docs/graphql/metrics/quantile.md b/docs/graphql/metrics/quantile.md index f602c85d..cef48c69 100644 --- a/docs/graphql/metrics/quantile.md +++ b/docs/graphql/metrics/quantile.md @@ -1,3 +1,7 @@ +--- +title: "GraphQL Quantile Metric" +description: "Quantile in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. Scale further with Kafka or gRPC streams." +--- # Quantile Quantiles are useful in understanding the distribution of numerical data by dividing it into intervals. diff --git a/docs/graphql/metrics/selectWhere.md b/docs/graphql/metrics/selectWhere.md index f0305bbb..4b129389 100644 --- a/docs/graphql/metrics/selectWhere.md +++ b/docs/graphql/metrics/selectWhere.md @@ -1,7 +1,8 @@ --- sidebar_position: 5 +title: "Select Rows by GraphQL Metric" +description: "Select By Metric in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. Keep queries fast with indexed filters." --- - # Select By Metric Metric value can be used to filter out the result by ```selectIf``` attribute to @@ -17,5 +18,3 @@ sum(of: BalanceUpdate_Amount selectWhere: {gt: "0"}) You can combine this attribute with other attributes, including conditions in ```if``` ::: - - diff --git a/docs/graphql/metrics/statistics.md b/docs/graphql/metrics/statistics.md index c5b3293f..27f65465 100644 --- a/docs/graphql/metrics/statistics.md +++ b/docs/graphql/metrics/statistics.md @@ -1,7 +1,8 @@ --- sidebar_position: 8 +title: "GraphQL Statistics Metrics" +description: "Statistics in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams. Scale further with Kafka or gRPC streams." --- - # Statistics ## Over One Variable @@ -23,7 +24,6 @@ For example to calculate average reward: average(of: Reward_Total) ``` - ## Over Two Variables Some statistics require 2 variables. diff --git a/docs/graphql/metrics/sum.md b/docs/graphql/metrics/sum.md index d20b4656..ecc1e29d 100644 --- a/docs/graphql/metrics/sum.md +++ b/docs/graphql/metrics/sum.md @@ -1,7 +1,8 @@ --- sidebar_position: 7 +title: "GraphQL Sum Metric" +description: "Sum trade amounts and transfer volumes in Bitquery GraphQL aggregates to power clear blockchain analytics dashboards. See examples in the Bitquery IDE." --- - # Sum ```sum``` element in the query returns the sum of elements **in each set of dimensions**. diff --git a/docs/graphql/metrics/uniq.md b/docs/graphql/metrics/uniq.md index 8482fb18..dfff788e 100644 --- a/docs/graphql/metrics/uniq.md +++ b/docs/graphql/metrics/uniq.md @@ -1,7 +1,8 @@ --- sidebar_position: 9 +title: "GraphQL Uniq Metric" +description: "Count unique addresses, tokens, or traders with Bitquery’s uniq metric inside GraphQL aggregate blockchain queries. Keep queries fast with indexed filters." --- - # Uniq The `uniq` function is used to estimate the count of unique values in a dataset. It's particularly useful for analyzing large datasets where an exact count may not be necessary or where performance is a concern. Below is an example query using the `uniq` function within the context of EVM TokenHolders API to get the number of unique token holders for a specific token on a given date. @@ -23,7 +24,6 @@ The `uniq` function is used to estimate the count of unique values in a dataset. } } - ``` ### Result diff --git a/docs/graphql/optimizing-graphql-queries.md b/docs/graphql/optimizing-graphql-queries.md index 46368ccf..6ab8693e 100644 --- a/docs/graphql/optimizing-graphql-queries.md +++ b/docs/graphql/optimizing-graphql-queries.md @@ -1,7 +1,8 @@ --- sidebar_position: 9 +title: "Optimize Bitquery GraphQL Queries" +description: "Optimize Bitquery GraphQL Queries in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." --- - # GraphQL query optimization for APIs GraphQL is an open-source query language for APIs. It allows clients to define the required data structure, and the server responds with only that data. This allows for more efficient and flexible communication between the client and server, as well as enabling better performance and easier development of APIs. @@ -10,8 +11,6 @@ GraphQL query optimization is a crucial aspect of utilizing V2 APIs to their ful In this section, we will see how to optimize your V2 API queries. - - ### Understanding Datasets Choosing the right dataset is critical for both correctness and performance. We offer three datasets with different guarantees and latency characteristics: @@ -37,7 +36,7 @@ EVM(dataset: combined, network: bsc) { BalanceUpdates(limit: { count: 1000 }) { ### Understanding limits in GraphQL -In V2 APIs, it's crucial to note the implicit default limit applied when a specific limit isn't explicitly defined within a query. [By default, this limit restricts the number of records returned to 10,000](https://docs.bitquery.io/docs/start/errors/#limits). This safeguard is in place to prevent excessive resource consumption, ensuring the efficient processing of queries. +In V2 APIs, it's crucial to note the implicit default limit applied when a specific limit isn't explicitly defined within a query. [By default, this limit restricts the number of records returned to 10,000](/docs/start/errors/#limits). This safeguard is in place to prevent excessive resource consumption, ensuring the efficient processing of queries. However, to tailor data retrieval according to specific needs, V2 APIs provide the flexibility to set custom limits using the 'limit' parameter. @@ -147,8 +146,7 @@ Below is an example query that retrieves information about limitBy. For each cal In each table, certain columns are used as indexes, you can use those columns to sort in `orderby` field to improve time to response. -A detailed list is available in this [Indexes](https://docs.bitquery.io/docs/graphql/indexed-fields-reference/) page. - +A detailed list is available in this [Indexes](/docs/graphql/indexed-fields-reference/) page. ### Sorting Queries in GraphQL @@ -209,7 +207,7 @@ Metric-based sorting is a powerful feature in GraphQL that allows you to sort da } ``` -In the above example, we use the SUM metric to sort the responses. We give an [alias](https://docs.bitquery.io/docs/graphql/metrics/alias/) to the sum field (Balance) and sort the responses from highest to lowest sum. +In the above example, we use the SUM metric to sort the responses. We give an [alias](/docs/graphql/metrics/alias/) to the sum field (Balance) and sort the responses from highest to lowest sum. ### Filtering data in GraphQL queries diff --git a/docs/graphql/postman.md b/docs/graphql/postman.md index ab510921..e3b3f4b8 100644 --- a/docs/graphql/postman.md +++ b/docs/graphql/postman.md @@ -1,3 +1,7 @@ +--- +title: "Bitquery GraphQL in Postman" +description: "Bitquery GraphQL in Postman in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." +--- # Accessing Queries on Postman You can run the queries and subscriptions on Postman as well. Below is the link to the collection: @@ -6,9 +10,7 @@ You can run the queries and subscriptions on Postman as well. Below is the link ![](/img/postman.png) -You can find examples for all chains in folders. Remember that token must be passed differently for a `query` vs a `subscription`. You can read more about it [here](https://docs.bitquery.io/docs/authorisation/how-to-use/) +You can find examples for all chains in folders. Remember that token must be passed differently for a `query` vs a `subscription`. You can read more about it [here](/docs/authorization/how-to-use/) >Remember that a websocket can be opened only on desktop version of Postman - - diff --git a/docs/graphql/query.md b/docs/graphql/query.md index 5225ac17..420f41c9 100644 --- a/docs/graphql/query.md +++ b/docs/graphql/query.md @@ -1,20 +1,9 @@ --- title: "GraphQL Query Principles - Bitquery API Schema & Data" -description: "Learn how to query blockchain data with GraphQL. Schema definition, query vs subscription, dataset options, and Bitquery API structure." +description: "GraphQL Query Principles - Bitquery API Schema & Data in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." sidebar_position: 0 keywords: ["GraphQL query", "Bitquery GraphQL", "blockchain GraphQL", "Bitquery schema", "GraphQL API"] --- - - - - - - - - - - - # Query Principles You query the data using [GraphQL](https://graphql.org/) language. Basically it @@ -35,7 +24,7 @@ see it full. You only need a portion of it related to your needs typically. Query is used to query the data. When you need to get updated results, you must query the endpoint again with the same or another query. -Subscription is used to get data updates. You define a [subscription](/docs/subscriptions/subscription.md), +Subscription is used to get data updates. You define a [subscription](/docs/subscriptions/subscription/), and after the new data appear, it will be delivered to you without any actions from your side. This defines the cases, when to use one or another: @@ -43,8 +32,7 @@ This defines the cases, when to use one or another: * use queries when you need data once, or the data not likely changed during its usage period * use subscriptions for the "live" data, or when data may be changed while using it - -Good news, that queries and [subscriptions](/docs/subscriptions/subscription.md) use identical schemas, except some attributes of the top +Good news, that queries and [subscriptions](/docs/subscriptions/subscription/) use identical schemas, except some attributes of the top element, to define the [dataset](/docs/graphql/dataset/options) usage. It allows your applications to switch between pull and push modes of operation with a minimal changes of the code and queries. @@ -54,7 +42,7 @@ Compare the code in [the first query](/docs/start/first-query) and This section describes principles that applies to subscriptions as well as to queries. We will show examples for queries, but remember that they applied to -[subscriptions](/docs/subscriptions/subscription.md) as well. +[subscriptions](/docs/subscriptions/subscription/) as well. ## Default filters (GraphQL v2) @@ -69,7 +57,7 @@ By default, **only successful data** is included in results. GraphQL v2 applies To get failed or non-default data, add an explicit filter. For example, to query **failed DEX trades**, you must explicitly filter for them (e.g. [Failed trades example](https://ide.bitquery.io/Failed-trades)). -For default **limits** (query and subscription), see [Limits](/docs/graphql/limits.md) and [Subscription default parameters](/docs/subscriptions/subscription.md#default-parameters-graphql-v2). +For default **limits** (query and subscription), see [Limits](/docs/graphql/limits/) and [Subscription default parameters](/docs/subscriptions/subscription/#default-parameters-graphql-v2). ## Query Elements @@ -106,7 +94,6 @@ Refer to the [dataset](/docs/graphql/dataset/options) documentation for possible By selecting the top element ``` EVM ``` we completely define what we can query below this element. Apparently, Bitcoin and Ethereum have different schema and data, so we can not query them exactly the same way. - ### Cube Element ```Blocks(limit: {count: 10})``` is what we call "Cube", particulary because we @@ -114,7 +101,6 @@ use [OLAP](https://wikipedia.org/wiki/OLAP) methodology, applying [metrics](/docs/graphql/metrics). Cube defines what kind of facts we want to query, in this case we interested in blocks. Cubes are generally different for different types of blockchains. - ### Dimension Element ```graphql @@ -146,8 +132,6 @@ block **date** __AND__ by transaction **hash**: } ``` - - ### Metric Element ```count``` is a [metric](/docs/graphql/metrics). It is optional, defines "what we want to measure". @@ -175,8 +159,6 @@ Block { Refer to the [metric](/docs/graphql/metrics/) tutorial for more details how you can use them. - - ### Attributes ```limit: {count: 10}``` is an attribute, defining [limit](/docs/graphql/limits) on the data result size. @@ -188,7 +170,6 @@ There are several types of attributes, described in the sections: * [filters](/docs/graphql/filters) * [calculations](/docs/graphql/calculations) - ### Correctness To be correctly executed, the query must conform with the following requirements: @@ -201,4 +182,4 @@ If query can not execute, the result contains the ```errors``` in the results This screen shows the highlighted error in the query and the resulting response: -![IDE query error](/img/ide/query_error.png) \ No newline at end of file +![IDE query error](/img/ide/query_error.png) diff --git a/docs/graphql/sorting.md b/docs/graphql/sorting.md index 7f181eca..ea1931ea 100644 --- a/docs/graphql/sorting.md +++ b/docs/graphql/sorting.md @@ -1,7 +1,8 @@ --- sidebar_position: 3 +title: "Sorting Results in Bitquery GraphQL" +description: "Sorting Results in Bitquery GraphQL in Bitquery GraphQL with clear syntax, examples, and tips for fast blockchain queries and streams." --- - # Sorting Ordering can be applied to the results of the query, sorting the results in a way you define. @@ -28,7 +29,6 @@ If multiple sorting conditions are used, they applied in the order you define th First results will be sorted by Transaction_Value and after that by Block_Number. - Another way to sort on multiple condition is following ``` @@ -56,8 +56,6 @@ Another way to sort on multiple condition is following } ``` - - :::note this is not the same as: @@ -97,9 +95,6 @@ The example below shows how to sort transfers by their index within a block in a } } - - - ``` `orderBy: {ascendingByField: "Transaction_Index", descending: "Block_Time"}` sorts the results first by the transaction index within a block in ascending order, ensuring that transactions are listed in the order they were executed. Secondly, it sorts by block time in descending order, prioritizing newer blocks. @@ -160,4 +155,4 @@ This multi-level ordering creates a stable, deterministic way to get the most re In this example, the query returns exactly one result (the most recent trade), sorted by block time, transaction index, instruction index, and trade index—all in descending order to ensure true "latest" ordering. ## What does the desc option do in a Bitquery query? -**API V2** uses **`orderBy: { descending: … }`** or **`ascending`**, not a standalone **`desc`** option on the root query. **API V1** examples often used **`options: { desc: [ ... ], limit, offset }`**. For migration and side‑by‑side examples, see [Migrate Bitquery API V1 to V2](https://docs.bitquery.io/docs/API-Blog/migrate-v1-v2/). +**API V2** uses **`orderBy: { descending: … }`** or **`ascending`**, not a standalone **`desc`** option on the root query. **API V1** examples often used **`options: { desc: [ ... ], limit, offset }`**. For migration and side‑by‑side examples, see [Migrate Bitquery API V1 to V2](/docs/API-Blog/migrate-v1-v2/). diff --git a/docs/grpc/solana/authorisation.md b/docs/grpc/solana/authorization.md similarity index 93% rename from docs/grpc/solana/authorisation.md rename to docs/grpc/solana/authorization.md index 9cda99f1..d07b51b8 100644 --- a/docs/grpc/solana/authorisation.md +++ b/docs/grpc/solana/authorization.md @@ -1,12 +1,11 @@ --- title: "Solana gRPC Authentication - CoreCast API Token" -description: "Authenticate Bitquery Solana gRPC streams (CoreCast). Configure API token for corecast.bitquery.io. Metadata, config.yaml, 401 debug." +description: "Solana gRPC Authentication - CoreCast API Token for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." keywords: ["Solana gRPC auth", "CoreCast authentication", "grpc solana token", "bitquery api token"] --- - # Authentication -To access Bitquery's Solana gRPC streams (CoreCast), you must authenticate every stream using an **[authorization token](https://account.bitquery.io/user/api_v2/access_tokens)**. This token is provided in your configuration file and automatically added to the gRPC metadata before starting a stream. Check the [documentation](https://docs.bitquery.io/docs/authorisation/how-to-generate/) to create a new token. +To access Bitquery's Solana gRPC streams (CoreCast), you must authenticate every stream using an **[authorization token](https://account.bitquery.io/user/api_v2/access_tokens)**. This token is provided in your configuration file and automatically added to the gRPC metadata before starting a stream. Check the [documentation](/docs/authorization/how-to-generate/) to create a new token. --- diff --git a/docs/grpc/solana/best_practices.md b/docs/grpc/solana/best_practices.md index 2e366659..b499116d 100644 --- a/docs/grpc/solana/best_practices.md +++ b/docs/grpc/solana/best_practices.md @@ -1,3 +1,7 @@ +--- +title: "Best Practices for Solana gRPC Streams" +description: "Best Practices for Solana gRPC Streams for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." +--- # Best Practices for Solana gRPC Streams When building applications with Bitquery's Solana gRPC streams, follow these best practices to ensure your application is reliable, efficient, and handles data effectively. This guide covers filtering, connection management, error handling, and monitoring. diff --git a/docs/grpc/solana/errors.md b/docs/grpc/solana/errors.md index 2125eb05..39c8af8c 100644 --- a/docs/grpc/solana/errors.md +++ b/docs/grpc/solana/errors.md @@ -1,3 +1,7 @@ +--- +title: "Solana gRPC Errors" +description: "Errors for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples. Run it in the IDE, then ship in your app." +--- # Error Handling When working with gRPC streams for Solana CoreCast, you may encounter errors. This page documents common error types, their causes, and how to debug them. @@ -33,7 +37,7 @@ When working with gRPC streams for Solana CoreCast, you may encounter errors. Th insecure: false ``` * Check for trailing spaces or missing quotes. -* [Generate](https://docs.bitquery.io/docs/authorisation/how-to-generate/) a new token if expired. +* [Generate](/docs/authorization/how-to-generate/) a new token if expired. --- @@ -54,9 +58,9 @@ stream: ### Supported Stream Types -* [`dex_trades`](https://docs.bitquery.io/docs/grpc/solana/topics/dextrades/) -* [`transactions`](https://docs.bitquery.io/docs/grpc/solana/topics/transactions/) -* [`balances`](https://docs.bitquery.io/docs/grpc/solana/topics/balance/) +* [`dex_trades`](/docs/grpc/solana/topics/dextrades/) +* [`transactions`](/docs/grpc/solana/topics/transactions/) +* [`balances`](/docs/grpc/solana/topics/balance/) ### How to Fix @@ -94,4 +98,4 @@ This will log the full error object, its details, the numeric error code, and th * Always log `error.code` and `error.details`. * Use retries with exponential backoff for network issues. * Validate stream type and filters before starting. -* Rotate tokens regularly and handle token expiry gracefully. \ No newline at end of file +* Rotate tokens regularly and handle token expiry gracefully. diff --git a/docs/grpc/solana/examples/grpc-copy-trading-bot.md b/docs/grpc/solana/examples/grpc-copy-trading-bot.md index a7ac9586..989140bd 100644 --- a/docs/grpc/solana/examples/grpc-copy-trading-bot.md +++ b/docs/grpc/solana/examples/grpc-copy-trading-bot.md @@ -1,12 +1,11 @@ --- title: "Solana Copy Trading Bot with gRPC Streams" -description: "Build a copy trading bot using CoreCast gRPC and Jupiter API. Real-time DEX trade streaming on Solana." +description: "Solana Copy Trading Bot with gRPC Streams for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." keywords: ["solana grpc", "grpc solana", "copy trading", "CoreCast", "Solana trading bot"] --- - # Building Solana Copy Trading Bot with gRPC Streams -A comprehensive guide to building a **high-performance Solana trading bot** that leverages **gRPC streams** for real-time copy trading using [Bitquery CoreCast](https://docs.bitquery.io/docs/grpc/solana/introduction/). +A comprehensive guide to building a **high-performance Solana trading bot** that leverages **gRPC streams** for real-time copy trading using [Bitquery CoreCast](/docs/grpc/solana/introduction/). ## Table of Contents @@ -25,7 +24,7 @@ A comprehensive guide to building a **high-performance Solana trading bot** that The final result of this project would appear as the one given below. -![Copy Bot Demo](../../../../static/img/copy-bot-solana.gif) + ## Architecture Overview @@ -65,13 +64,13 @@ This **Solana trading bot** implements a streaming architecture for **copy tradi └─────────────────────┘ ``` -Learn more about [Bitquery CoreCast architecture](https://docs.bitquery.io/docs/grpc/solana/introduction/). +Learn more about [Bitquery CoreCast architecture](/docs/grpc/solana/introduction/). --- ## Bitquery CoreCast Integration -[Bitquery CoreCast](https://docs.bitquery.io/docs/grpc/solana/introduction/) provides real-time blockchain data streaming via gRPC for **Solana trading bots**. +[Bitquery CoreCast](/docs/grpc/solana/introduction/) provides real-time blockchain data streaming via gRPC for **Solana trading bots**. ```javascript // index.js - Loading Protocol Buffers @@ -104,11 +103,11 @@ function initializeClient() { } ``` -Refer to [this document](https://docs.bitquery.io/docs/grpc/solana/authorisation/) for any issues related to authorisation. +Refer to [this document](/docs/grpc/solana/authorization/) for any issues related to authorization. ### Creating the Stream -Multiple [Solana stream topics](https://docs.bitquery.io/docs/category/topics/) are available: +Multiple [Solana stream topics](/docs/category/topics/) are available: ```javascript // index.js - Stream Creation @@ -306,16 +305,16 @@ stream: ``` **Available Stream Types:** -- `dex_trades` - [DEX trades](https://docs.bitquery.io/docs/grpc/solana/topics/dextrades/) -- `dex_orders` - [Order book data](https://docs.bitquery.io/docs/grpc/solana/topics/dexorder/) -- `dex_pools` - [Pool liquidity events](https://docs.bitquery.io/docs/grpc/solana/topics/dexpools/) -- `transactions` - [All transactions](https://docs.bitquery.io/docs/grpc/solana/topics/transactions/) -- `transfers` - [Token transfers](https://docs.bitquery.io/docs/grpc/solana/topics/transfer/) -- `balances` - [Balance updates](https://docs.bitquery.io/docs/grpc/solana/topics/balance/) +- `dex_trades` - [DEX trades](/docs/grpc/solana/topics/dextrades/) +- `dex_orders` - [Order book data](/docs/grpc/solana/topics/dexorder/) +- `dex_pools` - [Pool liquidity events](/docs/grpc/solana/topics/dexpools/) +- `transactions` - [All transactions](/docs/grpc/solana/topics/transactions/) +- `transfers` - [Token transfers](/docs/grpc/solana/topics/transfer/) +- `balances` - [Balance updates](/docs/grpc/solana/topics/balance/) ### Filters -Use [filtering options](https://docs.bitquery.io/docs/grpc/solana/filters/?utm_source=github&utm_medium=docs&utm_campaign=grpc_copytrading) to target specific trades: +Use [filtering options](/docs/grpc/solana/topics/dextrades/#filtering-options) to target specific trades: ```yaml # config.yaml @@ -414,11 +413,11 @@ amountInRaw: (buyAmount / 100).toString() // 1% of original ### Bitquery Documentation -- [CoreCast Introduction](https://docs.bitquery.io/docs/grpc/solana/introduction) -- [Authentication Guidelines](https://docs.bitquery.io/docs/grpc/solana/authorisation/) -- [Best Practises for gRPC streams](https://docs.bitquery.io/docs/grpc/solana/best_practices/) -- [Other Examples](https://docs.bitquery.io/docs/category/examples/) -- [Error Handling](https://docs.bitquery.io/docs/grpc/solana/errors/) +- [CoreCast Introduction](/docs/grpc/solana/introduction) +- [Authentication Guidelines](/docs/grpc/solana/authorization/) +- [Best Practices for gRPC streams](/docs/grpc/solana/best_practices/) +- [Other Examples](/docs/category/examples/) +- [Error Handling](/docs/grpc/solana/errors/) ### External APIs diff --git a/docs/grpc/solana/examples/letsbonk-grpc-streams.md b/docs/grpc/solana/examples/letsbonk-grpc-streams.md index 23b4d57e..2e28a0b5 100644 --- a/docs/grpc/solana/examples/letsbonk-grpc-streams.md +++ b/docs/grpc/solana/examples/letsbonk-grpc-streams.md @@ -1,9 +1,8 @@ --- title: "LetsBonk.fun gRPC Streams - Real-time DEX Trades" -description: "Stream LetsBonk.fun DEX trades via CoreCast gRPC. Raydium LaunchLab memecoin launchpad." +description: "LetsBonk.fun gRPC Streams - Real-time DEX Trades for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." keywords: ["solana grpc", "grpc solana", "LetsBonk gRPC", "CoreCast", "Raydium LaunchLab"] --- - # LetsBonk.fun gRPC Streams Real-time streaming of LetsBonk.fun DEX trades, orders, and transactions via CoreCast gRPC API. diff --git a/docs/grpc/solana/examples/pump-fun-grpc-streams.md b/docs/grpc/solana/examples/pump-fun-grpc-streams.md index f7e78499..629bf6a8 100644 --- a/docs/grpc/solana/examples/pump-fun-grpc-streams.md +++ b/docs/grpc/solana/examples/pump-fun-grpc-streams.md @@ -1,9 +1,8 @@ --- title: "Pump.fun gRPC Streams - Real-time DEX Trades" -description: "Stream Pump.fun DEX trades, orders, and transactions via CoreCast gRPC. Node.js example with filtering." +description: "Pump.fun gRPC Streams - Real-time DEX Trades for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." keywords: ["solana grpc", "grpc solana", "Pump.fun gRPC", "CoreCast", "Pump.fun stream"] --- - # Pump.fun gRPC Streams Real-time streaming of Pump.fun DEX trades, orders, and transactions via CoreCast gRPC API. diff --git a/docs/grpc/solana/introduction.md b/docs/grpc/solana/introduction.md index 79967db7..d184b029 100644 --- a/docs/grpc/solana/introduction.md +++ b/docs/grpc/solana/introduction.md @@ -1,16 +1,15 @@ --- -title: "Solana gRPC Streams - CoreCast Real-Time DEX, Transfers, Transactions" -description: "grpc solana, solana grpc: Bitquery CoreCast streams for real-time DEX trades, transfers, transactions. Low-latency protobuf. Pump.fun, Raydium, Orca." +title: "Solana gRPC Introduction" +description: "Introduction for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples. See examples in the Bitquery IDE." keywords: ["grpc solana", "solana grpc", "CoreCast", "Solana gRPC stream", "Solana real-time data"] --- - # CoreCast - Smart Solana gRPC Streams ## What is Bitquery gRPC for Solana and how is it different from RPC? {#what-is-bitquery-grpc-for-solana-and-how-is-it-different-from-rpc} **Bitquery gRPC for Solana** is **CoreCast** (Smart gRPC Streams): a managed feed of **indexed, decoded** Solana activity delivered as **Protobuf** over gRPC to `corecast.bitquery.io`. You subscribe by **topic** (for example `dex_trades`, `transfers`, `transactions`) with **server-side filters** (addresses, mints, programs, thresholds), so you receive structured events not raw ledger blobs. -**Solana RPC** (JSON-RPC from a validator or provider) is the chain’s **low-level API**: `getTransaction`, `getAccountInfo`, `getBlock`, simulation, and base64 logs. You typically **poll or subscribe** per method, **decode instructions and layouts yourself**, and stitch together DEX or token context. CoreCast is optimized for **low-latency, filtered market data**; RPC is for **generic chain access** and tooling that already expects JSON-RPC. For GraphQL + WebSocket on the same indexed data, see [real-time subscriptions](https://docs.bitquery.io/docs/subscriptions/websockets/) and the [streaming overview](https://docs.bitquery.io/docs/streams/). +**Solana RPC** (JSON-RPC from a validator or provider) is the chain’s **low-level API**: `getTransaction`, `getAccountInfo`, `getBlock`, simulation, and base64 logs. You typically **poll or subscribe** per method, **decode instructions and layouts yourself**, and stitch together DEX or token context. CoreCast is optimized for **low-latency, filtered market data**; RPC is for **generic chain access** and tooling that already expects JSON-RPC. For GraphQL + WebSocket on the same indexed data, see [real-time subscriptions](/docs/subscriptions/websockets/) and the [streaming overview](/docs/streams/). ### What are Smart gRPC Streams? @@ -25,12 +24,12 @@ Bitquery Smart gRPC Streams provide low-latency, context-aware, topic-wise event Bitquery exposes multiple topics so you subscribe only to what you need: -- **[transactions](https://docs.bitquery.io/docs/grpc/solana/topics/transactions)**: Finalized transactions with instructions, logs, and status. +- **[transactions](/docs/grpc/solana/topics/transactions)**: Finalized transactions with instructions, logs, and status. - **transfers**: All token transfers with token context. -- **[dex_trades](https://docs.bitquery.io/docs/grpc/solana/topics/dextrades)**: DEX trade/swaps across supported protocols. +- **[dex_trades](/docs/grpc/solana/topics/dextrades)**: DEX trade/swaps across supported protocols. - **dex_orders**: Order lifecycle updates where applicable. - **dex_pools**: Pool creation/updates and liquidity changes. -- **[balances](https://docs.bitquery.io/docs/grpc/solana/topics/balance)**: Balance updates for tracked accounts and mints. +- **[balances](/docs/grpc/solana/topics/balance)**: Balance updates for tracked accounts and mints. Each topic supports context-aware filters and consistent identifiers for easy correlation across streams. @@ -87,8 +86,8 @@ The schema need not be downloaded, we have it as packages for install in NPM and ## Is Solana gRPC (CoreCast) streaming included on the free plan? {#is-solana-grpc-corecast-streaming-included-on-the-free-plan} -CoreCast uses the same **V2 API tokens** as the GraphQL IDE ([create a token](https://account.bitquery.io/user/api_v2/access_tokens); see [authentication](/docs/grpc/solana/authorisation/)). Whether **Solana gRPC streaming** is enabled for your workspace, and how it relates to the Developer (free) tier or points, depends on your **plan and account entitlements**—it is not guaranteed to be unlimited or identical to self-serve GraphQL limits. Check [pricing](https://bitquery.io/pricing) and [Points](/docs/ide/points/); if you need access or a trial, use [Account → Billing](https://account.bitquery.io/user/billing) or contact [sales@bitquery.io](mailto:sales@bitquery.io). +CoreCast uses the same **V2 API tokens** as the GraphQL IDE ([create a token](https://account.bitquery.io/user/api_v2/access_tokens); see [authentication](/docs/grpc/solana/authorization/)). Whether **Solana gRPC streaming** is enabled for your workspace, and how it relates to the Developer (free) tier or points, depends on your **plan and account entitlements**—it is not guaranteed to be unlimited or identical to self-serve GraphQL limits. Check [pricing](https://bitquery.io/pricing) and [Points](/docs/ide/points/); if you need access or a trial, use [Account → Billing](https://account.bitquery.io/user/billing) or contact [sales@bitquery.io](mailto:sales@bitquery.io). ## Does Bitquery support gRPC for chains other than Solana? {#does-bitquery-support-grpc-for-chains-other-than-solana} -At present, Bitquery provides gRPC streaming exclusively for Solana. However, the platform is architected to support gRPC on other blockchains as well. If you require gRPC streaming for a blockchain outside of Solana, please reach out to the Bitquery sales team at sales@bitquery.io to explore custom solutions. \ No newline at end of file +At present, Bitquery provides gRPC streaming exclusively for Solana. However, the platform is architected to support gRPC on other blockchains as well. If you require gRPC streaming for a blockchain outside of Solana, please reach out to the Bitquery sales team at sales@bitquery.io to explore custom solutions. diff --git a/docs/grpc/solana/live-reload.md b/docs/grpc/solana/live-reload.md index 3cf12ef3..1f0ebfab 100644 --- a/docs/grpc/solana/live-reload.md +++ b/docs/grpc/solana/live-reload.md @@ -1,3 +1,7 @@ +--- +title: "Live Reload Configuration for gRPC Streams" +description: "Live Reload Configuration for gRPC Streams for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." +--- # Live Reload Configuration for gRPC Streams Live reload enables dynamic configuration changes without you having to restart your application. This feature automatically detects changes to your `config.yaml` file and restarts the stream with the new settings. @@ -318,9 +322,9 @@ You can switch between these stream types using live reload: - **`balances`**: Balance updates for accounts For detailed information on each stream type, see: -- [DEX Trades](https://docs.bitquery.io/docs/grpc/solana/topics/dextrades) -- [Transactions](https://docs.bitquery.io/docs/grpc/solana/topics/transactions) -- [Balances](https://docs.bitquery.io/docs/grpc/solana/topics/balance) +- [DEX Trades](/docs/grpc/solana/topics/dextrades) +- [Transactions](/docs/grpc/solana/topics/transactions) +- [Balances](/docs/grpc/solana/topics/balance) ## Available Filters @@ -406,7 +410,6 @@ The `isReloading` flag prevents error spam during normal reload operations. 4. **Monitor reload events**: Log when reloads happen to track configuration changes 5. **Handle edge cases**: Ensure your application handles the brief disconnection during reload - ### Environment Variables For sensitive data like API tokens, use environment variables: @@ -439,13 +442,12 @@ When live reload is active, you'll see these messages: Stream connected and listening for data... ``` - ## Related Documentation -- [Introduction to gRPC Streams](https://docs.bitquery.io/docs/grpc/solana/introduction) -- [Best Practices](https://docs.bitquery.io/docs/grpc/solana/best_practices) -- [Authorization](https://docs.bitquery.io/docs/grpc/solana/authorisation) -- [Error Handling](https://docs.bitquery.io/docs/grpc/solana/errors) +- [Introduction to gRPC Streams](/docs/grpc/solana/introduction) +- [Best Practices](/docs/grpc/solana/best_practices) +- [Authorization](/docs/grpc/solana/authorization) +- [Error Handling](/docs/grpc/solana/errors) ## Troubleshooting @@ -480,7 +482,7 @@ If you experience memory issues with live reload: Now that you understand live reload, explore: -- [Stream Topics](https://docs.bitquery.io/docs/grpc/solana/topics/dextrades) - Different types of streams available -- [Best Practices](https://docs.bitquery.io/docs/grpc/solana/best_practices) - Production-ready patterns -- [Examples](https://docs.bitquery.io/docs/grpc/solana/examples/pump-fun-grpc-streams) - Real-world use cases +- [Stream Topics](/docs/grpc/solana/topics/dextrades) - Different types of streams available +- [Best Practices](/docs/grpc/solana/best_practices) - Production-ready patterns +- [Examples](/docs/grpc/solana/examples/pump-fun-grpc-streams) - Real-world use cases diff --git a/docs/grpc/solana/topics/balance.md b/docs/grpc/solana/topics/balance.md index 1757cc3d..19b6dbd9 100644 --- a/docs/grpc/solana/topics/balance.md +++ b/docs/grpc/solana/topics/balance.md @@ -1,9 +1,8 @@ --- title: "Solana Balance Updates - gRPC Stream (CoreCast)" -description: "Real-time balance updates via Solana gRPC. Filter by address, token. Protobuf." +description: "Solana Balance Updates - gRPC Stream (CoreCast) for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." keywords: ["solana grpc", "grpc solana", "CoreCast", "Solana balance stream"] --- - # Solana Balance Updates gRPC Stream The `balance` gRPC Stream provides real-time balance update data for Solana accounts and token accounts. @@ -14,7 +13,6 @@ The `balance` gRPC Stream provides real-time balance update data for Solana acco Subscribe to live balance changes for accounts and token accounts. Each event includes pre/post balances, currency details, and account context. Data is in **protobuf format** — use `bitquery-corecast-proto` to parse. - ## Configuration To subscribe to balance updates, configure your stream as follows: @@ -114,7 +112,7 @@ This package includes all necessary protobuf definitions without requiring manua ## Related -- [CoreCast Introduction](https://docs.bitquery.io/docs/grpc/solana/introduction/) — Topics and concepts -- [Transfers gRPC](https://docs.bitquery.io/docs/grpc/solana/topics/transfer/) — Token transfers -- [Solana Balance Updates (GraphQL)](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates/) — WebSocket subscriptions -- [Authorization](https://docs.bitquery.io/docs/grpc/solana/authorisation/) — Token setup +- [CoreCast Introduction](/docs/grpc/solana/introduction/) — Topics and concepts +- [Transfers gRPC](/docs/grpc/solana/topics/transfer/) — Token transfers +- [Solana Balance Updates (GraphQL)](/docs/blockchain/Solana/solana-balance-updates/) — WebSocket subscriptions +- [Authorization](/docs/grpc/solana/authorization/) — Token setup diff --git a/docs/grpc/solana/topics/dexorder.md b/docs/grpc/solana/topics/dexorder.md index 38ff0c42..494b6045 100644 --- a/docs/grpc/solana/topics/dexorder.md +++ b/docs/grpc/solana/topics/dexorder.md @@ -1,9 +1,8 @@ --- title: "Solana DEX Orders - gRPC Stream (CoreCast)" -description: "Real-time DEX order book data via Solana gRPC. OpenBook, Serum. Filter by program, pool, token." +description: "Solana DEX Orders - gRPC Stream (CoreCast) for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." keywords: ["solana grpc", "grpc solana", "CoreCast", "Solana DEX orders", "order book"] --- - # Solana DEX Orders gRPC Stream The `dex_orders` gRPC Stream provides real-time DEX order placement and execution data across supported Solana protocols. @@ -153,7 +152,6 @@ Available filters: - **token**: Filter by token mint address (e.g., WSOL, USDC) - **trader**: Filter by trader's wallet address - ## Order Data Fields - **OrderId**: Unique identifier for the order @@ -190,8 +188,8 @@ This package includes all necessary protobuf definitions without requiring manua ## Related -- [CoreCast Introduction](https://docs.bitquery.io/docs/grpc/solana/introduction/) — Topics and concepts -- [DEX Trades gRPC](https://docs.bitquery.io/docs/grpc/solana/topics/dextrades/) — DEX swap stream -- [Copy Trading Bot](https://docs.bitquery.io/docs/grpc/solana/examples/grpc-copy-trading-bot/) — Uses dex_orders -- [Authorization](https://docs.bitquery.io/docs/grpc/solana/authorisation/) — Token setup +- [CoreCast Introduction](/docs/grpc/solana/introduction/) — Topics and concepts +- [DEX Trades gRPC](/docs/grpc/solana/topics/dextrades/) — DEX swap stream +- [Copy Trading Bot](/docs/grpc/solana/examples/grpc-copy-trading-bot/) — Uses dex_orders +- [Authorization](/docs/grpc/solana/authorization/) — Token setup diff --git a/docs/grpc/solana/topics/dexpools.md b/docs/grpc/solana/topics/dexpools.md index 4edd9f34..5553c26a 100644 --- a/docs/grpc/solana/topics/dexpools.md +++ b/docs/grpc/solana/topics/dexpools.md @@ -1,9 +1,8 @@ --- title: "Solana DEX Pools - gRPC Stream (CoreCast)" -description: "Real-time DEX pool liquidity events via Solana gRPC. Add/remove liquidity, swaps. Protobuf." +description: "Solana DEX Pools - gRPC Stream (CoreCast) for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." keywords: ["solana grpc", "grpc solana", "CoreCast", "Solana DEX pools", "liquidity"] --- - # Solana DEX Pools gRPC Stream The `dex_pools` gRPC Stream provides real-time DEX pool liquidity and balance change data across supported Solana protocols. @@ -14,7 +13,6 @@ The `dex_pools` gRPC Stream provides real-time DEX pool liquidity and balance ch Subscribe to live DEX pool events: liquidity adds, removes, swaps, and pool creation. Each event includes base/quote changes, market info, and balance updates. Data is in **protobuf format** — use `bitquery-corecast-proto` to parse. - ## Configuration To subscribe to DEX pool events, configure your stream as follows: @@ -175,7 +173,7 @@ This package includes all necessary protobuf definitions without requiring manua ## Related -- [CoreCast Introduction](https://docs.bitquery.io/docs/grpc/solana/introduction/) — Topics and concepts -- [DEX Trades gRPC](https://docs.bitquery.io/docs/grpc/solana/topics/dextrades/) — DEX swap stream -- [Pump.fun gRPC Example](https://docs.bitquery.io/docs/grpc/solana/examples/pump-fun-grpc-streams/) — Uses dex_pools -- [Authorization](https://docs.bitquery.io/docs/grpc/solana/authorisation/) — Token setup +- [CoreCast Introduction](/docs/grpc/solana/introduction/) — Topics and concepts +- [DEX Trades gRPC](/docs/grpc/solana/topics/dextrades/) — DEX swap stream +- [Pump.fun gRPC Example](/docs/grpc/solana/examples/pump-fun-grpc-streams/) — Uses dex_pools +- [Authorization](/docs/grpc/solana/authorization/) — Token setup diff --git a/docs/grpc/solana/topics/dextrades.md b/docs/grpc/solana/topics/dextrades.md index 60c6bd6f..262f12b8 100644 --- a/docs/grpc/solana/topics/dextrades.md +++ b/docs/grpc/solana/topics/dextrades.md @@ -1,9 +1,8 @@ --- title: "Solana DEX Trades - gRPC Stream (CoreCast)" -description: "Real-time DEX trade data via Solana gRPC. Pump.fun, Raydium, Orca. Protobuf, filter by program, pool, token, trader." +description: "Solana DEX Trades - gRPC Stream (CoreCast) for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." keywords: ["solana grpc", "grpc solana", "CoreCast", "Solana DEX stream", "dex trades"] --- - # Solana DEX Trades gRPC Stream The `dex_trades` gRPC Stream provides real-time DEX trade/swap data across supported Solana protocols (Pump.fun, Raydium, Orca, Jupiter, and more). @@ -18,7 +17,6 @@ Subscribe to live DEX swaps with context-aware filtering. Each event includes tr At least one filter per subscription. See [Filtering Options](#filtering-options). ::: - ## Configuration To subscribe to DEX trades, configure your stream as follows: @@ -157,8 +155,8 @@ This package includes all necessary protobuf definitions without requiring manua ## Related -- [CoreCast Introduction](https://docs.bitquery.io/docs/grpc/solana/introduction/) — Topics and concepts -- [Pump.fun gRPC Example](https://docs.bitquery.io/docs/grpc/solana/examples/pump-fun-grpc-streams/) — Full Pump.fun app -- [Copy Trading Bot](https://docs.bitquery.io/docs/grpc/solana/examples/grpc-copy-trading-bot/) — Solana copy trading -- [Solana DEX Trades (GraphQL)](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades) — WebSocket subscriptions -- [Authorization](https://docs.bitquery.io/docs/grpc/solana/authorisation/) — Token setup +- [CoreCast Introduction](/docs/grpc/solana/introduction/) — Topics and concepts +- [Pump.fun gRPC Example](/docs/grpc/solana/examples/pump-fun-grpc-streams/) — Full Pump.fun app +- [Copy Trading Bot](/docs/grpc/solana/examples/grpc-copy-trading-bot/) — Solana copy trading +- [Solana DEX Trades (GraphQL)](/docs/blockchain/Solana/solana-dextrades) — WebSocket subscriptions +- [Authorization](/docs/grpc/solana/authorization/) — Token setup diff --git a/docs/grpc/solana/topics/transactions.md b/docs/grpc/solana/topics/transactions.md index 3f6cc7b3..18d6f5cf 100644 --- a/docs/grpc/solana/topics/transactions.md +++ b/docs/grpc/solana/topics/transactions.md @@ -1,9 +1,8 @@ --- title: "Solana Transactions - gRPC Stream (CoreCast)" -description: "Real-time Solana transactions via gRPC. Filter by program, signer. Parsed instructions, protobuf." +description: "Solana Transactions - gRPC Stream (CoreCast) for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." keywords: ["solana grpc", "grpc solana", "CoreCast", "Solana transactions stream"] --- - # Solana Transactions gRPC Stream The `transactions` gRPC Stream provides real-time transaction data across the Solana blockchain. @@ -149,6 +148,6 @@ This package includes all necessary protobuf definitions without requiring manua ## Related -- [CoreCast Introduction](https://docs.bitquery.io/docs/grpc/solana/introduction/) — Topics and concepts -- [DEX Trades gRPC](https://docs.bitquery.io/docs/grpc/solana/topics/dextrades/) — DEX swap stream -- [Authorization](https://docs.bitquery.io/docs/grpc/solana/authorisation/) — Token setup +- [CoreCast Introduction](/docs/grpc/solana/introduction/) — Topics and concepts +- [DEX Trades gRPC](/docs/grpc/solana/topics/dextrades/) — DEX swap stream +- [Authorization](/docs/grpc/solana/authorization/) — Token setup diff --git a/docs/grpc/solana/topics/transfer.md b/docs/grpc/solana/topics/transfer.md index 95fa2d28..8469af5b 100644 --- a/docs/grpc/solana/topics/transfer.md +++ b/docs/grpc/solana/topics/transfer.md @@ -1,9 +1,8 @@ --- title: "Solana Transfers - gRPC Stream (CoreCast)" -description: "Real-time token and SOL transfers via Solana gRPC. Filter by sender, receiver, token. Protobuf." +description: "Solana Transfers - gRPC Stream (CoreCast) for Bitquery Solana gRPC (CoreCast), covering setup, filters, reliability, and stream examples." keywords: ["solana grpc", "grpc solana", "CoreCast", "Solana transfers stream"] --- - # Solana Transfers gRPC Stream The `transfers` gRPC Stream provides real-time token and SOL transfer data across the Solana blockchain. @@ -132,7 +131,6 @@ Here's an example of the data structure you'll receive: } ``` - ## Filtering Options The filter options are defined in the `request.proto` file. You can filter transfers using the following filters: @@ -168,7 +166,6 @@ The transfers stream captures various transfer-related events: - **Currency**: Token information including mint address and decimals - **InstructionIndex**: The position of the transfer instruction in the transaction - ## Schema Reference - **Protobuf Schema**: [dex_block_message.proto](https://github.com/bitquery/streaming_protobuf/blob/main/solana/dex_block_message.proto) @@ -194,7 +191,7 @@ This package includes all necessary protobuf definitions without requiring manua ## Related -- [CoreCast Introduction](https://docs.bitquery.io/docs/grpc/solana/introduction/) — Topics and concepts -- [DEX Trades gRPC](https://docs.bitquery.io/docs/grpc/solana/topics/dextrades/) — DEX swap stream -- [Solana Transfers (GraphQL)](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers/) — WebSocket subscriptions -- [Authorization](https://docs.bitquery.io/docs/grpc/solana/authorisation/) — Token setup +- [CoreCast Introduction](/docs/grpc/solana/introduction/) — Topics and concepts +- [DEX Trades gRPC](/docs/grpc/solana/topics/dextrades/) — DEX swap stream +- [Solana Transfers (GraphQL)](/docs/blockchain/Solana/solana-transfers/) — WebSocket subscriptions +- [Authorization](/docs/grpc/solana/authorization/) — Token setup diff --git a/docs/ide/account.md b/docs/ide/account.md index 0283fb37..10c387a4 100644 --- a/docs/ide/account.md +++ b/docs/ide/account.md @@ -1,7 +1,8 @@ --- sidebar_position: 11 +title: "Bitquery IDE Account Settings" +description: "Bitquery IDE Account Settings in Bitquery docs with practical setup steps, examples, and guidance for secure API access." --- - # Manage Account After you sign in at [account.bitquery.io](https://account.bitquery.io/), the first screen is the **Dashboard** ([`/user/dashboard`](https://account.bitquery.io/user/dashboard)). It summarizes your plan, usage, profile, tokens, shortcuts to apps (including the GraphQL **IDE**), and support links. diff --git a/docs/ide/code.md b/docs/ide/code.md index 892da0c2..4f21b356 100644 --- a/docs/ide/code.md +++ b/docs/ide/code.md @@ -1,15 +1,14 @@ --- sidebar_position: 4 +title: "Export GraphQL Code from the IDE" +description: "Export GraphQL Code from the IDE in Bitquery docs with practical setup steps, examples, and guidance for secure API access." --- - # Export Code The IDE will allow you to get the code in the language of your choice, so you can test your queries quickly. To do this you must go to the top right side of the screen ![Export code](/img/ide/Code_export.png) - - To use the Export Code feature, follow the steps below: 1. Write your query in the IDE as you normally would. diff --git a/docs/ide/paid.md b/docs/ide/paid.md index 33b7571d..756b10f2 100644 --- a/docs/ide/paid.md +++ b/docs/ide/paid.md @@ -1,7 +1,8 @@ --- sidebar_position: 12 +title: "Bitquery IDE Paid Plans" +description: "Bitquery IDE Paid Plans in Bitquery docs with practical setup steps, examples, and guidance for secure API access. Keep queries fast with indexed filters." --- - # Upgrade to Bitquery Paid Plan You are now in full control of your plan. You can upgrade yourself from your account — no sales call required — or contact sales for custom/Enterprise volumes. diff --git a/docs/ide/points.md b/docs/ide/points.md index 5770a5ad..6d044cdc 100644 --- a/docs/ide/points.md +++ b/docs/ide/points.md @@ -1,7 +1,8 @@ --- sidebar_position: 11 +title: "Bitquery IDE Points and Usage" +description: "Bitquery IDE Points and Usage in Bitquery docs with practical setup steps, examples, and guidance for secure API access." --- - # Points Bitquery indexes more than 1 Petabyte of structured blockchain data and exposes it through a single GraphQL interface. Using one endpoint, you can get a chain’s latest block height, follow money trails, pull DEX trades across supported blockchains, and more. diff --git a/docs/ide/private.md b/docs/ide/private.md index 151cd3b7..648489fb 100644 --- a/docs/ide/private.md +++ b/docs/ide/private.md @@ -1,8 +1,9 @@ --- sidebar_position: 6 +title: "Private Queries in Bitquery IDE" +description: "Private Queries in Bitquery IDE in Bitquery docs with practical setup steps, examples, and guidance for secure API access." --- - # Save Query Privately In the IDE you can save your queries privately, so that only you will be able to see that query. To do this you will have to select the `Private` checkbox and then click the `Save` button. -![IDE Query Save Private](/img/ide/query_save_private.png) \ No newline at end of file +![IDE Query Save Private](/img/ide/query_save_private.png) diff --git a/docs/ide/query.md b/docs/ide/query.md index 8455b117..abf729a9 100644 --- a/docs/ide/query.md +++ b/docs/ide/query.md @@ -1,7 +1,8 @@ --- sidebar_position: 3 +title: "Run Queries in Bitquery IDE" +description: "Run Queries in Bitquery IDE in Bitquery docs with practical setup steps, examples, and guidance for secure API access. See examples in the Bitquery IDE." --- - # Create Query Creating a query in IDE is very easy, on the left you can see the endpoint schema, which will help you to create a query quickly and easily. @@ -12,4 +13,4 @@ You can go to the following entries to learn more: - [Share Query](/docs/ide/share) - [Save Query Privately](/docs/ide/private) -- [Search Queries](/docs/ide/search) \ No newline at end of file +- [Search Queries](/docs/ide/search) diff --git a/docs/ide/search.md b/docs/ide/search.md index 593f5c60..95805257 100644 --- a/docs/ide/search.md +++ b/docs/ide/search.md @@ -1,9 +1,10 @@ --- sidebar_position: 7 +title: "Search Queries in Bitquery IDE" +description: "Search Queries in Bitquery IDE in Bitquery docs with practical setup steps, examples, and guidance for secure API access." --- - # Search Queries You will be able to search among the queries shared by users (as well as among your own queries), to do this you must go to the top left corner, see: -![IDE Query Search](/img/ide/query_search.png) \ No newline at end of file +![IDE Query Search](/img/ide/query_search.png) diff --git a/docs/ide/share.md b/docs/ide/share.md index 6e71c110..3f5cd134 100644 --- a/docs/ide/share.md +++ b/docs/ide/share.md @@ -1,7 +1,8 @@ --- sidebar_position: 4 +title: "Share Bitquery IDE Queries" +description: "Share Bitquery IDE Queries in Bitquery docs with practical setup steps, examples, and guidance for secure API access. See examples in the Bitquery IDE." --- - # Share Query In the IDE you can share your queries, this way you can allow other people to see and use your query. To do this you will have to select the `Shared to everyone` checkbox and then press the `Save` button. @@ -10,4 +11,4 @@ In the IDE you can share your queries, this way you can allow other people to se :::tip Tags are very useful to organize queries, this way it is easier to find them, try to use them! -::: \ No newline at end of file +::: diff --git a/docs/ide/team.md b/docs/ide/team.md index c50340cc..203ec21f 100644 --- a/docs/ide/team.md +++ b/docs/ide/team.md @@ -1,7 +1,8 @@ --- sidebar_position: 7 +title: "Bitquery IDE Teams" +description: "Bitquery IDE Teams in Bitquery docs with practical setup steps, examples, and guidance for secure API access. Built for traders and analytics teams." --- - # Develop in Team Bitquery IDE is built for Teams. You can invite team members and share the same billing account. @@ -14,10 +15,10 @@ To invite your team, use the dropdown menu in our IDE. ![IDE Query Share](/img/ide/invite_new_member.png) -You can view your team from your [account dashboard](account.md): sign in at [account.bitquery.io](https://account.bitquery.io/), then use the **Authorization** menu in the top bar (or the equivalent entry under account settings). +You can view your team from your [account dashboard](/docs/ide/account/): sign in at [account.bitquery.io](https://account.bitquery.io/), then use the **Authorization** menu in the top bar (or the equivalent entry under account settings). ![IDE Query Share](/img/ide/view_team.png) You can also check your team member's points consumption and, if needed also, remove them from the Team window. -![IDE Query Share](/img/ide/points_consumption.png) \ No newline at end of file +![IDE Query Share](/img/ide/points_consumption.png) diff --git a/docs/ide/variables.md b/docs/ide/variables.md index 7d0beb10..2afa332f 100644 --- a/docs/ide/variables.md +++ b/docs/ide/variables.md @@ -1,7 +1,8 @@ --- sidebar_position: 3 +title: "GraphQL Variables in Bitquery IDE" +description: "GraphQL Variables in Bitquery IDE in Bitquery docs with practical setup steps, examples, and guidance for secure API access." --- - # Use Variables When creating a query you can pass parameters to it, this way you can create a more **organized**, **readable** and **maintainable** code. @@ -11,7 +12,6 @@ In the IDE there are two boxes that allow you to insert code, the first one is f > You can obtain the code through this link [Transaction Detail EVM | BSC](https://graphql.bitquery.io/ide/Transaction-Detail-EVM--BSC) - ## Variable types When we are going to pass the variables we have to define what type they are, some of them are: @@ -25,4 +25,4 @@ When we are going to pass the variables we have to define what type they are, so :::tip You can make the variable required by adding an exclamation mark (`!`) at the end, if the variable is not defined, it will be counted as `null`. -::: \ No newline at end of file +::: diff --git a/docs/intro.md b/docs/intro.md index 371e5c64..88a749a4 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -1,14 +1,12 @@ --- sidebar_position: 1 title: "Bitquery API Documentation - Blockchain Data Platform" -description: "Access historical and real-time blockchain data via GraphQL, WebSocket, and Kafka. Query Ethereum, Solana, BSC, Polygon, and 40+ chains. Free tier available." +description: "Bitquery API Documentation - Blockchain Data Platform: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance." --- - # Overview Bitquery 's infrastructure provides you access to historical and real-time blockchain data through various interfaces such as GraphQL APIs. - ## GraphQL Query API Get started with our APIs in a minute by building **[your first query](/docs/start/first-query)**. @@ -68,13 +66,10 @@ to the parsed protocols as DEX (decentralized exchanges) or NFT (non-fungible to ![AWS S3 bucket](/img/aws/s3_bucket.png) - - ## SQL Like Interface We also provide SQL like interface on our Enterprise plan, if you want to explore that, please send us email at [hello@bitquery.io](mailto:hello@bitquery.io) - ## Bitquery Support Channels We highly encourage you to dig into our docs first; however, you can contact us on the following platforms if you still have any queries. diff --git a/docs/mcp/Tracing/overview.md b/docs/mcp/Tracing/overview.md index 9233e5c1..7055fad2 100644 --- a/docs/mcp/Tracing/overview.md +++ b/docs/mcp/Tracing/overview.md @@ -1,6 +1,6 @@ --- title: Tracing MCP - What You Can Do With It -description: Bitquery MCP use cases - AML compliance, law enforcement, forensic investigations, money laundering detection, sanctions screening, and regulatory reporting. +description: "Tracing MCP - What You Can Do With It with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." keywords: - Bitquery MCP use cases - blockchain forensics @@ -11,13 +11,10 @@ keywords: - mcp.bitquery.io sidebar_label: Overview --- - # Tracing MCP - What You Can Do With It These are the patterns we see most often when teams plug the [Bitquery MCP server](https://mcp.bitquery.io) into Claude, Cursor, ChatGPT, or Claude Code. **You don't write SQL** - you ask in plain English, the agent does the rest. Each pattern below shows the kind of question that works and what comes back. -For end-to-end worked answers - including live transaction data and fund flow analysis - see the [examples section](https://docs.bitquery.io/docs/mcp/tracing/examples/). - --- ## 1. AML/KYC Risk Scoring @@ -26,64 +23,48 @@ For end-to-end worked answers - including live transaction data and fund flow an Score an incoming deposit or withdrawal using wallet age, transaction patterns, mixing signals, and known-entity labels. The agent returns a risk score (0-100) and flags suspicious patterns automatically. -**See it live:** [AML Risk Scoring Example](https://docs.bitquery.io/docs/mcp/tracing/examples/#example-1-trace-a-single-payment). - ## 2. Payment Tracing (Source to Destination) > _"Trace $500K USDT from Binance hot wallet 0x1234... to wallet 0x5678.... Show every hop, intermediate wallets, timing, and the final destination."_ Trace the full path of a single payment from source to final destination across one or more hops. The agent maps every intermediate wallet, any DEX swaps or bridge activity, and identifies if funds reached a CEX or high-risk address. -**See it live:** [Trace a Single Payment](https://docs.bitquery.io/docs/mcp/tracing/examples/#example-1-trace-a-single-payment). - ## 3. Phishing and Fraud Investigation > _"A user was phished on March 15 and 2 ETH were stolen from wallet 0xvictim. The attacker transferred to 0xattacker. Trace where that 2 ETH went. Show all hops, DEX swaps, bridges, and final deposits."_ Map the spread of stolen funds from a phishing attack or scam across wallets, DEXs, and chains. Identify if funds were consolidated, swapped, or deposited to an exchange, and cluster related attacker wallets. -**See it live:** [Investigate a Phishing Wallet](https://docs.bitquery.io/docs/mcp/tracing/examples/#example-2-investigate-a-phishing-wallet). - ## 4. Wallet Clustering for Compliance > _"Wallet 0x123... received funds from multiple sources. Identify all wallets that have sent to or received from this address, and cluster them by likely control."_ Identify related wallets using common-input-output heuristics, behavioral patterns, and timing analysis. The agent clusters wallets likely controlled by the same entity - useful for detecting account farming and money laundering rings. -**See it live:** [CEX Deposit Cluster Analysis](https://docs.bitquery.io/docs/mcp/tracing/examples/#example-6-cex-deposit-cluster-analysis). - ## 5. Stablecoin Movement Monitoring > _"Show me all USDT movements from Tron to Ethereum in the last 24 hours. Flag transactions over $5M, any bridge activity, and final destinations."_ Real-time or historical tracking of USDC, USDT, BUSD, and other stablecoins across chains and wallets. Useful for treasury monitoring, flow analysis, and detecting unusual liquidity movement patterns. -**See it live:** [Track Stablecoin Movement](https://docs.bitquery.io/docs/mcp/tracing/examples/#example-3-track-stablecoin-movement). - ## 6. Money Laundering Pattern Detection > _"Analyze wallet 0x... for layering patterns. Check for rapid mixing, frequent DEX swaps, cross-chain bridging, and rapid consolidation. Score likelihood of layering."_ Identify common money laundering stages (placement, layering, integration) in fund flow patterns. The agent scores layering likelihood based on rapid mixing, frequent swaps, bridge activity, and consolidation velocity. -**See it live:** [Identify Layering Patterns](https://docs.bitquery.io/docs/mcp/tracing/examples/#example-4-identify-layering-patterns). - ## 7. Cross-Chain Bridge Activity > _"Trace 1000 USDC from Ethereum through any bridge to Solana, then back to Ethereum. Show all bridges used, timing, and final destination."_ Track when and where assets move across chain bridges (Wormhole, Stargate, LayerZero, etc.). Identify bridge concentration risk and detect round-tripping patterns that may indicate arbitrage or evasion. -**See it live:** [Multi-Chain Fund Flow](https://docs.bitquery.io/docs/mcp/tracing/examples/#example-5-multi-chain-fund-flow). - ## 8. CEX Deposit Clustering > _"Four wallets all deposited to Binance hot wallet within the same hour. Are these wallets related? Analyze creation dates, sources, and transaction patterns."_ Identify related wallets by finding addresses that all deposit to the same exchange hot wallets. The agent analyzes wallet age, common sources, interaction history, and synchronized deposits to score likelihood of same controller. -**See it live:** [CEX Deposit Cluster Analysis](https://docs.bitquery.io/docs/mcp/tracing/examples/#example-6-cex-deposit-cluster-analysis). - ## 9. Sanctions and OFAC Compliance > _"Screen wallet 0x... against OFAC SDN list, FATF guidance, and known DeFi hack wallets. Flag any matches, sanctioned entity references, or high-risk signals."_ @@ -147,8 +128,8 @@ The MCP only allows reads. The agent **cannot** delete, insert, drop, or modify | Need | Best fit | | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | Conversational forensic analysis, ad-hoc investigations, agent loops | **MCP** (this server) | -| Compliance backend, subscription monitoring, mempool data | [**GraphQL API**](https://docs.bitquery.io/docs/graphql/coinpath/) and [WebSocket subscriptions](https://docs.bitquery.io/docs/subscriptions/websockets) | -| Lowest-latency, highest-throughput streaming for real-time investigations | [**Kafka streams**](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts) and [**gRPC streams**](https://docs.bitquery.io/docs/grpc/introduction) | -| Transaction forensics, entity matching, AML risk scoring APIs | [**Coinpath API**](https://docs.bitquery.io/docs/graphql/coinpath/) (GraphQL-based) | +| Compliance backend, subscription monitoring, mempool data | [**GraphQL API**](/docs/graphql/query/) and [WebSocket subscriptions](/docs/subscriptions/websockets/) | +| Lowest-latency, highest-throughput streaming for real-time investigations | [**Kafka streams**](/docs/streams/kafka-streaming-concepts/) and [**gRPC streams**](/docs/grpc/solana/introduction/) | +| Transaction forensics, entity matching, AML risk scoring APIs | [**Coinpath API**](/docs/blockchain/Bitcoin/bitcoin-coinpath-api/) (GraphQL-based) | The MCP and the GraphQL API read the **same dataset**, so anything you discover via MCP is reproducible in GraphQL or your production compliance stream. diff --git a/docs/mcp/build-a-trading-agent.mdx b/docs/mcp/build-a-trading-agent.mdx index aba6bd88..6782ce1a 100644 --- a/docs/mcp/build-a-trading-agent.mdx +++ b/docs/mcp/build-a-trading-agent.mdx @@ -1,8 +1,7 @@ --- title: "Build a Trading Agent with Bitquery MCP" -description: "End-to-end recipe: connect an AI agent to Bitquery MCP, discover tokens, stream trades, and monitor wallets across chains." +description: "Build a Trading Agent with Bitquery MCP with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." --- - import FAQ from "@site/src/components/FAQ"; # Build a Trading Agent with Bitquery MCP diff --git a/docs/mcp/claude-desktop.mdx b/docs/mcp/claude-desktop.mdx index 40eea73c..4f90cdf7 100644 --- a/docs/mcp/claude-desktop.mdx +++ b/docs/mcp/claude-desktop.mdx @@ -1,8 +1,7 @@ --- title: "Use Bitquery MCP in Claude Desktop" -description: "Connect Claude Desktop to Bitquery's MCP server for on-chain DEX trades, OHLC, market cap, and wallet data in plain English." +description: "Use Bitquery MCP in Claude Desktop with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." --- - import FAQ from "@site/src/components/FAQ"; # Use Bitquery MCP in Claude Desktop diff --git a/docs/mcp/cursor.mdx b/docs/mcp/cursor.mdx index adb54567..3d1cf0db 100644 --- a/docs/mcp/cursor.mdx +++ b/docs/mcp/cursor.mdx @@ -1,8 +1,7 @@ --- title: "Use Bitquery MCP in Cursor" -description: "Add Bitquery's MCP server to Cursor for AI-assisted DEX trade queries, OHLC charts, and wallet analytics across 8+ chains." +description: "Use Bitquery MCP in Cursor with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." --- - import FAQ from "@site/src/components/FAQ"; # Use Bitquery MCP in Cursor diff --git a/docs/mcp/mcp-server.mdx b/docs/mcp/mcp-server.mdx index 96ef3e11..1ec96a31 100644 --- a/docs/mcp/mcp-server.mdx +++ b/docs/mcp/mcp-server.mdx @@ -1,6 +1,7 @@ --- -title: "Bitquery MCP Server — Blockchain Data for AI Agents" -description: "Connect Claude, Cursor, ChatGPT to Bitquery's MCP server. Query DEX trades, transfers, OHLC, market cap & wallet data to trace the origin of funds across Solana, Ethereum, BSC, Base in plain English." +title: "Bitquery MCP Server for AI Agents" +description: "Connect Claude, Cursor, or ChatGPT to Bitquery MCP to query DEX trades, OHLC prices, and wallet analytics in plain English." +image: "/img/mcp/charts/wsol-24h-candles.svg" keywords: - Bitquery MCP - Model Context Protocol blockchain @@ -16,55 +17,11 @@ keywords: - blockchain data for AI agents - crypto trading MCP server --- - import FAQ from "@site/src/components/FAQ"; - - - - - - - - - - - - - - - - # Bitquery MCP Server — Blockchain Data for AI Agents -Connect [`https://mcp.bitquery.io`](https://mcp.bitquery.io) to Claude, Cursor, ChatGPT, Claude Code, or any other [MCP](https://modelcontextprotocol.io/)-compatible client and ask Bitquery's blockchain dataset anything in plain English. Get outlier-filtered DEX trades, transfers, OHLC candles, market cap, and wallet history across Solana, Ethereum, BSC, Base, Arbitrum, Optimism, Polygon, and Tron. Trace the origin of funds, track cross-chain movements, and investigate wallet clusters. +Connect [`https://mcp.bitquery.io`](https://mcp.bitquery.io) to Claude, Cursor, ChatGPT, Claude Code, or any other [MCP](https://modelcontextprotocol.io/)-compatible client and ask Bitquery's blockchain dataset anything in plain English. Get outlier-filtered DEX trades, transfers, OHLC candles, market cap, and wallet history across Solana, Ethereum, BSC, Base, Arbitrum, Optimism, Polygon, Tron, and Robinhood. Trace the origin of funds, track cross-chain movements, and investigate wallet clusters. | | | | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | @@ -227,7 +184,7 @@ OAuth tokens are cached for ~30 days and refreshed automatically — you'll rare ## Authentication via query token (less secure) -An alternative to OAuth is available on MCP, similar to passing a token in the URL for streaming WebSockets — see [Authenticating WebSockets](/docs/authorisation/websocket/). +An alternative to OAuth is available on MCP, similar to passing a token in the URL for streaming WebSockets — see [Authenticating WebSockets](/docs/authorization/websocket/). Append your access token to the server URL as a `token` query parameter, for example: @@ -237,13 +194,13 @@ If your client uses the `/mcp` path (for example with `mcp-remote`), add the que `https://mcp.bitquery.io/mcp?token=ory_...` -Generate tokens from your [Bitquery account](https://account.bitquery.io/user/api_v2/access_tokens) — same process as in [How to generate API credentials](/docs/authorisation/how-to-generate/). +Generate tokens from your [Bitquery account](https://account.bitquery.io/user/api_v2/access_tokens) — same process as in [How to generate API credentials](/docs/authorization/how-to-generate/). This method is **less secure** than the OAuth flow (the token can appear in logs, process lists, and shell history), but it is often a better fit when: - you run a **fully autonomous agent** with no human in the loop to complete browser sign-in; - you **install Claude Code (or another MCP client) on a server** where interactive OAuth is awkward; or -- the **default ~7 day token TTL** (or OAuth refresh behaviour) is not enough and you need long-lived, explicitly managed credentials. +- the **default ~7 day token TTL** (or OAuth refresh behavior) is not enough and you need long-lived, explicitly managed credentials. Prefer OAuth in interactive environments when you can. @@ -309,5 +266,5 @@ See the [worked examples](/docs/mcp/trading/examples/) for end-to-end versions o - [Traders API](/docs/trading/crypto-trades-api/traders-api/) — wallet-centric trade analytics. - [Price index algorithm](/docs/trading/crypto-price-api/price-index-algorithm/) — how Bitquery's outlier filter and ranking are computed. - [How to filter anomaly prices](/docs/usecases/how-to-filter-anomaly-prices/) — practical guide to Bitquery's outlier ranking. -- [How to generate Bitquery API credentials](/docs/authorisation/how-to-generate/) — for non-MCP clients. +- [How to generate Bitquery API credentials](/docs/authorization/how-to-generate/) — for non-MCP clients. - [Bitquery Account](https://account.bitquery.io/) — sign up / manage plan. diff --git a/docs/mcp/trading/examples/cross-chain-snapshot.md b/docs/mcp/trading/examples/cross-chain-snapshot.md index f1001a8e..089e8824 100644 --- a/docs/mcp/trading/examples/cross-chain-snapshot.md +++ b/docs/mcp/trading/examples/cross-chain-snapshot.md @@ -1,6 +1,7 @@ --- title: "Example: Cross-Chain DEX Volume Snapshot" -description: "Use the Bitquery MCP to compare 24h DEX volume, trades & unique traders across Solana, Ethereum, BSC, Base, Arbitrum, Optimism, Polygon & Tron in one query." +description: "Example: Cross-Chain DEX Volume Snapshot with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." +image: "/img/mcp/charts/cross-chain-volume.svg" keywords: - cross-chain DEX volume - chain comparison MCP @@ -10,23 +11,6 @@ keywords: - Solana vs Ethereum volume sidebar_label: "Cross-Chain DEX Snapshot" --- - - - - - - - - - - - - - - - - - # Cross-Chain DEX Volume Snapshot > **The trader question:** *"Where is the action right now? Which chain is the most liquid, the most active, and has the most distinct traders?"* diff --git a/docs/mcp/trading/examples/index.md b/docs/mcp/trading/examples/index.md index 7d7b0e40..e72b0909 100644 --- a/docs/mcp/trading/examples/index.md +++ b/docs/mcp/trading/examples/index.md @@ -1,6 +1,7 @@ --- title: "Trading MCP Examples — Real Data, Real Charts" -description: "6 worked examples of how traders use the Bitquery MCP: token discovery, cross-chain snapshot, OHLC, DEX share, launchpad pulse & whale-wallet analysis." +description: "Trading MCP Examples — Real Data, Real Charts with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." +image: "/img/mcp/charts/top-tokens-solana-24h.svg" keywords: - Bitquery MCP examples - trading MCP demo @@ -10,23 +11,6 @@ keywords: - DEX trading dashboard AI sidebar_label: "Examples" --- - - - - - - - - - - - - - - - - - # Trading MCP Examples Six worked examples of what your AI agent can do once the [Bitquery MCP server](/docs/mcp/mcp-server/) is connected. Each page is **self-contained** and includes: @@ -41,7 +25,7 @@ Six worked examples of what your AI agent can do once the [Bitquery MCP server]( | # | Example | What it shows | |---|---|---| | 1 | [**Hottest Solana Tokens**](/docs/mcp/trading/examples/top-tokens-discovery/) | Top 10 Solana tokens by clean 24h USD volume — your morning watchlist. | -| 2 | [**Cross-Chain DEX Snapshot**](/docs/mcp/trading/examples/cross-chain-snapshot/) | 24h USD volume, trade count, and unique traders for all 8 chains in one query. | +| 2 | [**Cross-Chain DEX Snapshot**](/docs/mcp/trading/examples/cross-chain-snapshot/) | 24h USD volume, trade count, and unique traders for all 9 chains in one query. | | 3 | [**Build an OHLC Candle Chart**](/docs/mcp/trading/examples/token-ohlc-chart/) | 24h hourly candlesticks for any token on any chain, ready for TradingView. | | 4 | [**Solana DEX Market Share Battle**](/docs/mcp/trading/examples/solana-dex-market-share/) | Meteora vs Pumpswap vs Raydium vs Orca and the long tail. | | 5 | [**Pump.fun Launch Pulse**](/docs/mcp/trading/examples/pumpfun-launch-pulse/) | New tokens launched per hour — diurnal patterns and meta cooldowns. | diff --git a/docs/mcp/trading/examples/pumpfun-launch-pulse.md b/docs/mcp/trading/examples/pumpfun-launch-pulse.md index 4e83c68a..5333392b 100644 --- a/docs/mcp/trading/examples/pumpfun-launch-pulse.md +++ b/docs/mcp/trading/examples/pumpfun-launch-pulse.md @@ -1,6 +1,7 @@ --- title: "Example: Pump.fun Launch Pulse — Tokens Launched per Hour" -description: "Use the Bitquery MCP to track new Pump.fun token launches hour by hour. Spot launchpad waves, fade exhaustion & quantify the meta of the moment." +description: "Example: Pump.fun Launch Pulse — Tokens Launched per Hour with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." +image: "/img/mcp/charts/pumpfun-launches-hourly.svg" keywords: - Pump.fun launches per hour - new memecoin tracker @@ -11,23 +12,6 @@ keywords: - Bitquery MCP example sidebar_label: "Pump.fun Launch Pulse" --- - - - - - - - - - - - - - - - - - # Pump.fun Launch Pulse — New Tokens per Hour > **The trader question:** *"Is launchpad activity heating up or cooling down? When are people actually deploying tokens?"* diff --git a/docs/mcp/trading/examples/solana-dex-market-share.md b/docs/mcp/trading/examples/solana-dex-market-share.md index 85ac0b17..86144f90 100644 --- a/docs/mcp/trading/examples/solana-dex-market-share.md +++ b/docs/mcp/trading/examples/solana-dex-market-share.md @@ -1,6 +1,7 @@ --- -title: "Example: Solana DEX Market Share — Meteora vs Pumpswap vs Raydium" -description: "Use the Bitquery MCP to break down Solana DEX volume by protocol family — Meteora, Pumpswap, Raydium, Orca and the long tail. Real 24h numbers." +title: "Example: Solana DEX Market Share" +description: "Example: Solana DEX Market Share with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." +image: "/img/mcp/charts/solana-dex-share.svg" keywords: - Solana DEX market share - Meteora vs Pumpswap @@ -11,23 +12,6 @@ keywords: - Orca Whirlpool volume sidebar_label: "Solana DEX Market Share" --- - - - - - - - - - - - - - - - - - # Solana DEX Market Share Battle > **The trader question:** *"Which Solana DEX is winning today's volume? Where is liquidity actually flowing?"* diff --git a/docs/mcp/trading/examples/token-ohlc-chart.md b/docs/mcp/trading/examples/token-ohlc-chart.md index e5e89023..45a8b783 100644 --- a/docs/mcp/trading/examples/token-ohlc-chart.md +++ b/docs/mcp/trading/examples/token-ohlc-chart.md @@ -1,6 +1,7 @@ --- title: "Example: Build an OHLC Candle Chart for Any Token" -description: "Use the Bitquery MCP to pull real-time hourly OHLC + volume for any token on any supported chain — feed it into TradingView or your bot." +description: "Example: Build an OHLC Candle Chart for Any Token with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." +image: "/img/mcp/charts/wsol-24h-candles.svg" keywords: - OHLC chart MCP - candlestick chart Solana @@ -11,23 +12,6 @@ keywords: - Bitquery MCP example sidebar_label: "OHLC Candle Chart" --- - - - - - - - - - - - - - - - - - # Build an OHLC Candle Chart for Any Token > **The trader question:** *"Give me the last 24 hours of price action for WSOL so I can eyeball the trend."* diff --git a/docs/mcp/trading/examples/top-tokens-discovery.md b/docs/mcp/trading/examples/top-tokens-discovery.md index 40bae7dd..25a5ad9d 100644 --- a/docs/mcp/trading/examples/top-tokens-discovery.md +++ b/docs/mcp/trading/examples/top-tokens-discovery.md @@ -1,6 +1,7 @@ --- title: "Example: Find the Hottest Solana Tokens of the Day" -description: "Use the Bitquery MCP to surface today's top-traded Solana tokens with built-in outlier filtering — for watchlist building & momentum trading." +description: "Example: Find the Hottest Solana Tokens of the Day with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." +image: "/img/mcp/charts/top-tokens-solana-24h.svg" keywords: - top Solana tokens - hot tokens MCP @@ -11,23 +12,6 @@ keywords: - trending crypto AI sidebar_label: "Hottest Solana Tokens" --- - - - - - - - - - - - - - - - - - # Find the Hottest Solana Tokens of the Day > **The trader question:** *"What are the most-traded Solana tokens right now — without the wash-trading noise?"* diff --git a/docs/mcp/trading/examples/whale-wallet-decode.md b/docs/mcp/trading/examples/whale-wallet-decode.md index a46e07a4..79b4d903 100644 --- a/docs/mcp/trading/examples/whale-wallet-decode.md +++ b/docs/mcp/trading/examples/whale-wallet-decode.md @@ -1,6 +1,7 @@ --- title: "Example: Decode a Whale Wallet's 24h Activity" -description: "Use the Bitquery MCP to break down any wallet's 24h DEX trading: tokens touched, buy vs sell volume, and behavioural signature in one query." +description: "Example: Decode a Whale Wallet's 24h Activity with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." +image: "/img/mcp/charts/whale-portfolio.svg" keywords: - whale wallet tracker - trader analytics MCP @@ -11,23 +12,6 @@ keywords: - Bitquery MCP example sidebar_label: "Decode a Whale Wallet" --- - - - - - - - - - - - - - - - - - # Decode a Whale Wallet's 24h Activity > **The trader question:** *"Who is `MfDuWeqS…` and what are they doing? Are they accumulating, distributing, or making markets?"* diff --git a/docs/mcp/trading/overview.md b/docs/mcp/trading/overview.md index 83de4c18..7b8e4aed 100644 --- a/docs/mcp/trading/overview.md +++ b/docs/mcp/trading/overview.md @@ -1,6 +1,7 @@ --- title: "Trading Data on the Bitquery MCP — Overview" -description: "What trading data the Bitquery MCP exposes: chains, DEX protocols, granularity & outlier filtering across Solana, Ethereum, BSC, Base, Arbitrum & more." +description: "Trading Data on the Bitquery MCP — Overview with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." +image: "/img/mcp/charts/cross-chain-volume.svg" keywords: - Bitquery MCP trading data - DEX trades MCP @@ -11,23 +12,6 @@ keywords: - blockchain data AI agent - DEX OHLC AI --- - - - - - - - - - - - - - - - - - # Trading Data on the Bitquery MCP The [Bitquery MCP server](/docs/mcp/mcp-server/) plugs your AI agent directly into Bitquery's **trading dataset** — the same data that powers the [Crypto Trades API](/docs/trading/crypto-trades-api/trades-api/), [Crypto Price API](/docs/trading/crypto-price-api/introduction/), [TradingView feeds](/docs/usecases/tradingview-subscription-realtime/getting-started/), and our GraphQL endpoints. diff --git a/docs/mcp/trading/use-cases.md b/docs/mcp/trading/use-cases.md index f452d4d3..86e19b3b 100644 --- a/docs/mcp/trading/use-cases.md +++ b/docs/mcp/trading/use-cases.md @@ -1,6 +1,7 @@ --- title: "Trading MCP — What You Can Do With It" -description: "Bitquery MCP use cases: token discovery, trader PnL, OHLC, market cap, wash-trade filtering, launchpad pulse, sniping research, slippage & AI-agent analysis." +description: "Trading MCP — What You Can Do With It with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." +image: "/img/mcp/charts/wsol-24h-candles.svg" keywords: - Bitquery MCP use cases - trading AI agent @@ -13,23 +14,6 @@ keywords: - mcp.bitquery.io sidebar_label: "Use Cases" --- - - - - - - - - - - - - - - - - - # Trading MCP — What You Can Do With It These are the patterns we see most often when teams plug the [Bitquery MCP server](/docs/mcp/mcp-server/) into Claude, Cursor, ChatGPT, or Claude Code. **You don't write SQL** — you ask in plain English, the agent does the rest. Each pattern below shows the kind of question that works and what comes back. diff --git a/docs/mcp/windsurf.mdx b/docs/mcp/windsurf.mdx index 5c65371d..591dfa17 100644 --- a/docs/mcp/windsurf.mdx +++ b/docs/mcp/windsurf.mdx @@ -1,8 +1,7 @@ --- title: "Use Bitquery MCP in Windsurf" -description: "Connect Windsurf to Bitquery's MCP server for blockchain DEX data, OHLC, and wallet queries in your AI coding workflow." +description: "Use Bitquery MCP in Windsurf with Bitquery MCP for AI tools like Claude and Cursor to analyze on-chain data in plain English." --- - import FAQ from "@site/src/components/FAQ"; # Use Bitquery MCP in Windsurf diff --git a/docs/schema/evm/arguments.md b/docs/schema/evm/arguments.md index 3f78768f..85b666b7 100644 --- a/docs/schema/evm/arguments.md +++ b/docs/schema/evm/arguments.md @@ -1,26 +1,7 @@ --- title: "EVM Arguments and Returns API" +description: "EVM Arguments and Returns API: Bitquery EVM GraphQL schema reference with fields, filters, relationships, and query patterns." --- - - - - - - - - - - - - - - - - - - - - Smart contract calls and events have arguments. In case the call or event signature is parsed against ABI, the arguments are showing the values, types and names passed to call or event. @@ -129,7 +110,7 @@ Arguments and returns are arrays, and this enables to use filtering on them as d For example, this query selects specific calls by applying filter to argument length and to specific values of arguments. Combining argument filters with signature filters on events and calls gives you the power -to analyse the arguments used in smart contracts in specific context. +to analyze the arguments used in smart contracts in specific context. ``` { diff --git a/docs/schema/evm/balances.md b/docs/schema/evm/balances.md index d80d322f..9c36f2c7 100644 --- a/docs/schema/evm/balances.md +++ b/docs/schema/evm/balances.md @@ -1,7 +1,7 @@ --- -title: "EVM Balance API" +title: "EVM Balance Schema API" +description: "EVM Balance API: Bitquery EVM GraphQL schema reference with fields, filters, relationships, and query patterns. See examples in the Bitquery IDE." --- - # EVM Balance API The **Balances** API returns current and historical token balances for addresses on EVM chains. To return only non-zero balances, add `Amount(selectWhere: { gt: "0" })` on the `Balance` field (not in `where`). Use `dataset: combined` or `dataset: archive` as follows: diff --git a/docs/schema/evm/blocks.md b/docs/schema/evm/blocks.md index e2f800e6..c1caa545 100644 --- a/docs/schema/evm/blocks.md +++ b/docs/schema/evm/blocks.md @@ -1,36 +1,10 @@ --- -title: "EVM Blocks API" +title: "EVM Blocks Schema" +description: "Blocks: Bitquery EVM GraphQL schema reference with fields, filters, relationships, and query patterns. Copy GraphQL snippets for production apps." --- - - - - - - - - - - - - - - - - - - - - - - - - - - - Blocks API provide details on blocks. -You can use different [filters](docs/graphql/filters.mdx) to query data from different dimensions. You can find more examples [here](/docs/blockchain/Ethereum/blocks/blocks-api/) +You can use different [filters](/docs/graphql/filters/) to query data from different dimensions. You can find more examples [here](/docs/blockchain/Ethereum/blocks/blocks-api/) Let's see an example of Blocks API to get the latest 10 blocks on Ethereum blockchain. diff --git a/docs/schema/evm/calls.md b/docs/schema/evm/calls.md index 59047f8a..0546bc87 100644 --- a/docs/schema/evm/calls.md +++ b/docs/schema/evm/calls.md @@ -1,33 +1,7 @@ --- title: "EVM Smart Contract Calls API" +description: "EVM Smart Contract Calls API: Bitquery EVM GraphQL schema reference with fields, filters, relationships, and query patterns." --- - - - - - - - - - - - - - - - - - - - - - - - - - - - Calls API provides details about smart contract calls, arguments, callers, etc. This api gives detailed information about the smart contract calls, including raw data, and supports [Opcodes](https://github.com/crytic/evm-opcodes). diff --git a/docs/schema/evm/dextrades.md b/docs/schema/evm/dextrades.md index ddf04824..a0926e29 100644 --- a/docs/schema/evm/dextrades.md +++ b/docs/schema/evm/dextrades.md @@ -1,33 +1,12 @@ --- -title: DEX Trades API +title: "EVM DEX Trades Schema" +description: "Explore the EVM DEX Trades schema in Bitquery GraphQL, including trade fields, joins, filters, and example queries for swap analytics." --- - - - - - - - - - - - - - - - - - - - - - DEXTrades api gives trading-related data from different DEXs such as Uniswap, Pancakeswap, 0x, etc. API provides historical and real-time trades and pricing information for tokens. The API allows different filters to query the Smart contract calls details from different dimensions, such as from different DEXs, protocols, tokens, trades, pools, etc. You can find more examples [here](/docs/blockchain/Ethereum/dextrades/get-trading-pairs-of-token/) - ## DEX Trades Cube Dex Trades represent every swap of tokens on decentralised exchange. Every trade has @@ -73,7 +52,6 @@ Query price OHLC data for token pairs using DEX Trades By Tokens ```graphql - query MyQuery { EVM(dataset: archive) { DEXTradeByTokens( @@ -112,7 +90,6 @@ query MyQuery { } } - ``` :::note @@ -120,7 +97,6 @@ we applied filter by tokens, used [interval](/docs/graphql/datetime) and actual calculated by aggregated [metrics ( max/min )](/docs/graphql/calculations) ::: - ```graphql { EVM(dataset: archive, network: eth) { diff --git a/docs/schema/evm/events.md b/docs/schema/evm/events.md index 8b2208d6..5c8d81f5 100644 --- a/docs/schema/evm/events.md +++ b/docs/schema/evm/events.md @@ -1,33 +1,7 @@ --- title: "EVM Smart Contract Events & logs API" +description: "EVM Smart Contract Events & logs API: Bitquery EVM GraphQL schema reference with fields, filters, relationships, and query patterns." --- - - - - - - - - - - - - - - - - - - - - - - - - - - - Smart contract events and logs are an important feature of Ethereum smart contracts that allow developers to track and record specific actions or data on the blockchain. You can retrieve data on blockchain calls and logs from the blockchain network. You can find more examples [here](/docs/blockchain/Ethereum/events/events-api/) diff --git a/docs/schema/evm/miners.md b/docs/schema/evm/miners.md index 25601947..1d1ef7b2 100644 --- a/docs/schema/evm/miners.md +++ b/docs/schema/evm/miners.md @@ -1,27 +1,7 @@ --- title: EVM Miner Rewards API +description: "EVM Miner Rewards API: Bitquery EVM GraphQL schema reference with fields, filters, relationships, and query patterns. See examples in the Bitquery IDE." --- - - - - - - - - - - - - - - - - - - - - - Miner Rewards are the incentives paid out to miners for validating transactions and creating new blocks on the blockchain. You can access Miner Rewards data using the Bitquery API. ```graphql diff --git a/docs/schema/evm/token-holders.md b/docs/schema/evm/token-holders.md index df3136a2..ef85abfc 100644 --- a/docs/schema/evm/token-holders.md +++ b/docs/schema/evm/token-holders.md @@ -1,31 +1,7 @@ --- title: "EVM Token Holders API" +description: "EVM Token Holders API: Bitquery EVM GraphQL schema reference with fields, filters, relationships, and query patterns. See examples in the Bitquery IDE." --- - - - - - - - - - - - - - - - - - - - - - - - - - # EVM Token Holders API The **Holders** API returns token holder data for ERC-20 tokens: top holders, holder counts, and balance thresholds. Non-zero balances use `Amount(selectWhere: { gt: "0" })` on the `Balance` field (not in `where`). Use `dataset: combined` or `dataset: archive` as follows: diff --git a/docs/schema/evm/top.md b/docs/schema/evm/top.md index 9b050aa7..c452b5b0 100644 --- a/docs/schema/evm/top.md +++ b/docs/schema/evm/top.md @@ -1,7 +1,8 @@ --- sidebar_position: 1 +title: "EVM Schema Overview" +description: "Explore Bitquery’s EVM GraphQL schema cubes for blocks, transactions, transfers, events, calls, and DEX trade analytics." --- - # Overview Bitquery APIs provide access to real-time and historical data from the Ethereum Virtual Machine (EVM) based blockchains through its EVM-based schema. The schema is designed to enable developers to query blockchain data through an API using GraphQL. diff --git a/docs/schema/evm/transactions.md b/docs/schema/evm/transactions.md index 9ed9517a..704ec837 100644 --- a/docs/schema/evm/transactions.md +++ b/docs/schema/evm/transactions.md @@ -1,30 +1,9 @@ --- -title: Transactions API +title: "EVM Transactions Schema API" +description: "Transactions API: Bitquery EVM GraphQL schema reference with fields, filters, relationships, and query patterns. Scale further with Kafka or gRPC streams." --- - - - - - - - - - - - - - - - - - - - - The Transactions API provides detailed information on transactions including call count, gas, hash, type, and sender and recipient addresses etc. Here's a sample query to get started. You can see more examples [here](/docs/blockchain/Ethereum/transactions/transaction-api/) - - query MyQuery \{ EVM(dataset: realtime, network: bsc) \{ Transactions( diff --git a/docs/schema/evm/transfers.md b/docs/schema/evm/transfers.md index 87b9e54e..6502da68 100644 --- a/docs/schema/evm/transfers.md +++ b/docs/schema/evm/transfers.md @@ -1,26 +1,7 @@ --- title: "EVM Token Transfers API" +description: "EVM Token Transfers API: Bitquery EVM GraphQL schema reference with fields, filters, relationships, and query patterns. See examples in the Bitquery IDE." --- - - - - - - - - - - - - - - - - - - - - To retrieve data on token and currency transfers using Bitquery, users can utilize the platform's GraphQL API. The Bitquery API allows users to construct custom queries to retrieve data on a wide range of blockchain events and transactions, including token transfers. You can find more examples [here](/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api/) ```graphql diff --git a/docs/schema/evm/uncles.md b/docs/schema/evm/uncles.md index 443d6ab8..b976fec4 100644 --- a/docs/schema/evm/uncles.md +++ b/docs/schema/evm/uncles.md @@ -1,27 +1,7 @@ --- title: "EVM Uncle Blocks API" +description: "EVM Uncle Blocks API: Bitquery EVM GraphQL schema reference with fields, filters, relationships, and query patterns. See examples in the Bitquery IDE." --- - - - - - - - - - - - - - - - - - - - - - ### What are Uncle Blocks? Uncle blocks, also known as "orphan blocks", are blocks on the blockchain that are not included in the main blockchain. Uncle blocks are still valid blocks, but they were not selected to be included in the main blockchain by the network consensus algorithm. diff --git a/docs/schema/schema-intro.md b/docs/schema/schema-intro.md index 6a25f2fe..df282564 100644 --- a/docs/schema/schema-intro.md +++ b/docs/schema/schema-intro.md @@ -1,7 +1,8 @@ --- sidebar_position: 10 +title: "API Schema Overview" +description: "API Schema Overview: Bitquery EVM GraphQL schema reference with fields, filters, relationships, and query patterns. Great for bots, dashboards, and alerts." --- - # API Schema Overview -In this section, we will explore the schema for both EVM and non-EVM chains. For a detailed understanding of each cube, such as Transfer, DEXTrade, and others, please refer to the [Cubes section](https://docs.bitquery.io/docs/category/cubes/). +In this section, we will explore the schema for both EVM and non-EVM chains. For a detailed understanding of each cube, such as Transfer, DEXTrade, and others, please refer to the [Cubes section](/docs/category/understanding-cubes/). diff --git a/docs/stablecoin-APIs/stablecoin-balance-api.md b/docs/stablecoin-APIs/stablecoin-balance-api.md index 47abab7b..2333088d 100644 --- a/docs/stablecoin-APIs/stablecoin-balance-api.md +++ b/docs/stablecoin-APIs/stablecoin-balance-api.md @@ -1,3 +1,7 @@ +--- +title: "Stablecoin Balance API" +description: "Stablecoin Balance API using Bitquery stablecoin APIs for prices, transfers, payments, and cross-chain monitoring workflows." +--- # Stablecoin Balance API The Stablecoin API by Bitquery provides you the comprehensive set of APIs which can provide you realtime transfers, realtime trades, realtime price, holder distribution of stablecoins across chains with a single API call. @@ -83,9 +87,9 @@ query MyQuery { ``` -More examples on balance and balance updates on EVM chains can be found [here](https://docs.bitquery.io/docs/examples/balances/balance-api/) +More examples on balance and balance updates on EVM chains can be found [here](/docs/blockchain/Ethereum/balances/balance-api/) -Token holder API examples can be found [here](https://docs.bitquery.io/docs/examples/token-holders/token-holder-api/) +Token holder API examples can be found [here](/docs/blockchain/Ethereum/token-holders/token-holder-api/) ## Get Top 100 Holders of a Particular Stablecoin diff --git a/docs/stablecoin-APIs/stablecoin-payments-api.md b/docs/stablecoin-APIs/stablecoin-payments-api.md index 963f23d7..20bcf768 100644 --- a/docs/stablecoin-APIs/stablecoin-payments-api.md +++ b/docs/stablecoin-APIs/stablecoin-payments-api.md @@ -1,6 +1,6 @@ --- title: "Stablecoin Payments API" -description: "Comprehensive guide to Bitquery Stablecoin Payments API with real-time transfers, compliance checks, and multi-chain analytics." +description: "Stablecoin Payments API using Bitquery stablecoin APIs for prices, transfers, payments, and cross-chain monitoring workflows." keywords: [ "Stablecoin Payments API", @@ -12,10 +12,9 @@ keywords: "Bitquery API", ] --- - # Stablecoin Payments API -Bitquery's Stablecoin Payments API exposes real-time and historical payment flows for USDT, USDC, FDUSD, EURC, DAI, TUSD, USDS, USD1, USDD and other major stablecoins across Solana, Ethereum, Tron, BSC, Base, Arbitrum, Polygon and more — through a single GraphQL endpoint. This page focuses on payment-oriented use cases (incoming/outgoing transfers, merchant detection, address monitoring, AML/compliance). For related capabilities, see the [Stablecoin Transfers API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-transfers-api), [Stablecoin Balance API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-balance-api), [Stablecoin Trades API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-trades-api), [Stablecoin Reserve API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-reserve-api) and [Stablecoin Price API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-price-api). +Bitquery's Stablecoin Payments API exposes real-time and historical payment flows for USDT, USDC, FDUSD, EURC, DAI, TUSD, USDS, USD1, USDD and other major stablecoins across Solana, Ethereum, Tron, BSC, Base, Arbitrum, Polygon and more — through a single GraphQL endpoint. This page focuses on payment-oriented use cases (incoming/outgoing transfers, merchant detection, address monitoring, AML/compliance). For related capabilities, see the [Stablecoin Transfers API](/docs/stablecoin-APIs/stablecoin-transfers-api), [Stablecoin Balance API](/docs/stablecoin-APIs/stablecoin-balance-api), [Stablecoin Trades API](/docs/stablecoin-APIs/stablecoin-trades-api), [Stablecoin Reserve API](/docs/stablecoin-APIs/stablecoin-reserve-api) and [Stablecoin Price API](/docs/stablecoin-APIs/stablecoin-price-api). All examples below are runnable in the [Bitquery IDE](https://ide.bitquery.io). Streams are delivered over WebSocket / Kafka subscriptions; historical queries use the same schema over HTTP. For pre-built stablecoin dashboards (top tokens, flows, market activity), browse the [DEXrabbit Stablecoins dashboard](https://dexrabbit.bitquery.io/categories/stablecoins). @@ -152,7 +151,7 @@ subscription { } ``` -For the equivalent on Solana, see the [Stablecoin Transfers API → Stablecoin received and sent by an address](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-transfers-api#stablecoin-recieved-and-sent-by-an-address). +For the equivalent on Solana, see the [Stablecoin Transfers API → Stablecoin received and sent by an address](/docs/stablecoin-APIs/stablecoin-transfers-api#stablecoin-recieved-and-sent-by-an-address). ### 5. Stablecoin Payments For a Specific Address (BSC) @@ -233,7 +232,7 @@ subscription { } ``` -For the full transfer schema (mint/burn detection, `Type`, dataset selection), see the [Stablecoin Transfers API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-transfers-api). +For the full transfer schema (mint/burn detection, `Type`, dataset selection), see the [Stablecoin Transfers API](/docs/stablecoin-APIs/stablecoin-transfers-api). ## Compliance & Risk Checks @@ -273,11 +272,11 @@ For **AML/KYC and risk monitoring**, you can analyze a payment counterparty's fu } ``` -To verify the live balance of a payer/payee on any chain, see the [Stablecoin Balance API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-balance-api) (Solana, Ethereum and Tron examples included). +To verify the live balance of a payer/payee on any chain, see the [Stablecoin Balance API](/docs/stablecoin-APIs/stablecoin-balance-api) (Solana, Ethereum and Tron examples included). ### Confirming the Sender's Solvency Before Settlement -Before releasing goods or off-ramping a stablecoin payment, you may want to verify the sender actually held the asset at the moment of transfer. Use the [Stablecoin Balance API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-balance-api#stablecoin-balance-of-an-address) to fetch a wallet's current stablecoin balance per chain. For supply-side checks (e.g. confirming an issuer mint backed an inbound payment), use the [Stablecoin Reserve API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-reserve-api). +Before releasing goods or off-ramping a stablecoin payment, you may want to verify the sender actually held the asset at the moment of transfer. Use the [Stablecoin Balance API](/docs/stablecoin-APIs/stablecoin-balance-api#stablecoin-balance-of-an-address) to fetch a wallet's current stablecoin balance per chain. For supply-side checks (e.g. confirming an issuer mint backed an inbound payment), use the [Stablecoin Reserve API](/docs/stablecoin-APIs/stablecoin-reserve-api). ## Payment Analytics @@ -337,7 +336,7 @@ Identify addresses that **last received USDT** on a specific date — useful for ### 3. Top Stablecoin Holders -Find **top holders of USDT on Ethereum**, including inflows, outflows, and full activity history. The [Stablecoin Balance API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-balance-api#get-top-100-holders-of-a-particular-stablecoin) covers the same pattern on Solana. +Find **top holders of USDT on Ethereum**, including inflows, outflows, and full activity history. The [Stablecoin Balance API](/docs/stablecoin-APIs/stablecoin-balance-api#get-top-100-holders-of-a-particular-stablecoin) covers the same pattern on Solana. 🔗 [Query Example](https://ide.bitquery.io/Top-holders-of-usdt-on-specific-date) @@ -372,17 +371,17 @@ Find **top holders of USDT on Ethereum**, including inflows, outflows, and full ## Pricing Stablecoin Payments Accurately -For high-value or cross-border payments, even a 20–50 bps deviation from the peg materially changes settlement value. Use the [Stablecoin Price API](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-price-api) to: +For high-value or cross-border payments, even a 20–50 bps deviation from the peg materially changes settlement value. Use the [Stablecoin Price API](/docs/stablecoin-APIs/stablecoin-price-api) to: -- [Stream the latest price](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-price-api#stream-latest-stablecoin-price) of USDT/USDC/DAI/USDS at 1-second intervals. -- [Compare prices across chains](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-price-api#check-arbitrage-of-a-stablecoin-across-chains) to mark the payment to its true on-chain rate. -- [Monitor peg health per DEX/market](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-price-api#stablecoin-peg-health-api) to catch a depeg before it hits your treasury. +- [Stream the latest price](/docs/stablecoin-APIs/stablecoin-price-api#stream-latest-stablecoin-price) of USDT/USDC/DAI/USDS at 1-second intervals. +- [Compare prices across chains](/docs/stablecoin-APIs/stablecoin-price-api#check-arbitrage-of-a-stablecoin-across-chains) to mark the payment to its true on-chain rate. +- [Monitor peg health per DEX/market](/docs/stablecoin-APIs/stablecoin-price-api#stablecoin-peg-health-api) to catch a depeg before it hits your treasury. -For depeg detection at the trade level (alerting when any trade prints outside `0.95–1.05`), see the [Stablecoin Trades API → Depeg tracking streams](https://docs.bitquery.io/docs/stablecoin-APIs/stablecoin-trades-api#stablecoin-depeg-tracking-stream-for-evm). +For depeg detection at the trade level (alerting when any trade prints outside `0.95–1.05`), see the [Stablecoin Trades API → Depeg tracking streams](/docs/stablecoin-APIs/stablecoin-trades-api#stablecoin-depeg-tracking-stream-for-evm). ## Asset-Specific Guides -For deep-dives on a single asset (price + payments + trades + reserves + balances curated together), see [USDT API](https://docs.bitquery.io/docs/stablecoin-APIs/usdt-api). +For deep-dives on a single asset (price + payments + trades + reserves + balances curated together), see [USDT API](/docs/stablecoin-APIs/usdt-api). ## Why Use Bitquery for Stablecoin Payments? diff --git a/docs/stablecoin-APIs/stablecoin-price-api.md b/docs/stablecoin-APIs/stablecoin-price-api.md index 9b9d56d4..f92d33df 100644 --- a/docs/stablecoin-APIs/stablecoin-price-api.md +++ b/docs/stablecoin-APIs/stablecoin-price-api.md @@ -1,3 +1,7 @@ +--- +title: "Stablecoin Price API" +description: "Stablecoin Price API using Bitquery stablecoin APIs for prices, transfers, payments, and cross-chain monitoring workflows." +--- # Stablecoin Price API While stablecoins are designed to maintain a stable value (typically pegged to USD, EUR, or other assets), they can deviate slightly from their target price (e.g., $0.998 or $1.02 for USD-pegged stablecoins). For developers, traders, and businesses processing large volumes of stablecoin payments, even these small deviations can translate to significant financial impact at scale. @@ -6,7 +10,7 @@ Bitquery's Stablecoin API provides comprehensive real-time data including transf Track minute price changes, fetch blended average prices, and identify arbitrage opportunities across different platforms with precision and ease. -This is built on the extensive [Crypto Price APIs](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) +This is built on the extensive [Crypto Price APIs](/docs/trading/crypto-price-api/introduction/) Need help implementing stablecoin price APIs? Contact our support team or join our community discussion on [@Bloxy_info](https://t.me/bloxy_info). @@ -200,7 +204,6 @@ This query compares USDT prices across different blockchain networks in real-tim } } - ``` ## Stablecoin Peg Health API diff --git a/docs/stablecoin-APIs/stablecoin-reserve-api.md b/docs/stablecoin-APIs/stablecoin-reserve-api.md index 46cc47a4..e475c1c2 100644 --- a/docs/stablecoin-APIs/stablecoin-reserve-api.md +++ b/docs/stablecoin-APIs/stablecoin-reserve-api.md @@ -1,3 +1,7 @@ +--- +title: "Stablecoin Reserve API" +description: "Stablecoin Reserve API using Bitquery stablecoin APIs for prices, transfers, payments, and cross-chain monitoring workflows." +--- # Stablecoin Reserve API The Stablecoin API by Bitquery provides you the comprehensive set of APIs which can provide you realtime reserves data, realtime transfers, realtime trades, realtime price, holder distribution of stablecoins across chains with a single API call. diff --git a/docs/stablecoin-APIs/stablecoin-trades-api.md b/docs/stablecoin-APIs/stablecoin-trades-api.md index e1a92314..76e7a506 100644 --- a/docs/stablecoin-APIs/stablecoin-trades-api.md +++ b/docs/stablecoin-APIs/stablecoin-trades-api.md @@ -1,3 +1,7 @@ +--- +title: "Stablecoin Trades API" +description: "Stablecoin Trades API using Bitquery stablecoin APIs for prices, transfers, payments, and cross-chain monitoring workflows." +--- # Stablecoin Trades API The Stablecoin API by Bitquery provides you the comprehensive set of APIs which can provide you realtime transfers, realtime trades, realtime price, holder distribution of stablecoins across chains with a single API call. diff --git a/docs/stablecoin-APIs/stablecoin-transfers-api.md b/docs/stablecoin-APIs/stablecoin-transfers-api.md index b5d55994..5f1df3e8 100644 --- a/docs/stablecoin-APIs/stablecoin-transfers-api.md +++ b/docs/stablecoin-APIs/stablecoin-transfers-api.md @@ -1,3 +1,7 @@ +--- +title: "Stablecoin Transfers API" +description: "Stablecoin Transfers API using Bitquery stablecoin APIs for prices, transfers, payments, and cross-chain monitoring workflows." +--- # Stablecoin Transfers API The Stablecoin API by Bitquery provides you the comprehensive set of APIs which can provide you realtime transfers, realtime trades, realtime price, holder distribution of stablecoins across chains with a single API call. diff --git a/docs/stablecoin-APIs/usdt-api.md b/docs/stablecoin-APIs/usdt-api.md index 4c93206e..8a03eecb 100644 --- a/docs/stablecoin-APIs/usdt-api.md +++ b/docs/stablecoin-APIs/usdt-api.md @@ -1,6 +1,6 @@ --- -title: "USDT API" -description: "Comprehensive guide to Bitquery USDT API with real-time transfers, compliance checks, and multi-chain analytics." +title: "USDT Stablecoin API" +description: "Query USDT transfers, balances, and supply activity with Bitquery stablecoin APIs using GraphQL examples across major blockchains." keywords: [ "USDT Payments API", @@ -16,7 +16,6 @@ keywords: "Bitquery API", ] --- - # USDT API USDT (Tether) powers a large share of on-chain value transfer, payments, and trading across multiple blockchains. This page curates the most useful USDT APIs—covering price, payments (transfers), trades, reserves, and balances—along with live streams you can use in production. diff --git a/docs/start/embed.md b/docs/start/embed.md index a953b31a..6d94b578 100644 --- a/docs/start/embed.md +++ b/docs/start/embed.md @@ -1,3 +1,7 @@ +--- +title: "Embed Bitquery Queries in Your App" +description: "Embed Bitquery Queries in Your App: practical Bitquery setup guidance with examples for authentication, endpoints, and first queries." +--- # Use it in Your Application You can integrate both queries and subscriptions in your application on any programming language and framework. @@ -5,17 +9,15 @@ First you create a query or subscription in [IDE](/docs/start/first-query/), and and some client code in your application. The client code depends on the programming language and set of libraries you prefer to use, try search google on "graphql YOUR-LANGUAGE library" keyword to start with. - [IDE](/docs/start/first-query/) provides an example code templates to your queries on some programming languages. After you created the query, press the `````` button located to the right from the endpoint URL entry field. You will see the code snippet and the selection of languages and libraries to use: - ![IDE code snippets](/img/ide/code_snippets.png) Select your programming language and run the code in your application. -Note that you have to use your [OAuth key](/docs/authorisation/how-to-generate.md). [IDE](/docs/start/first-query/) automatically +Note that you have to use your [OAuth key](/docs/authorization/how-to-generate/). [IDE](/docs/start/first-query/) automatically substituted it for you in the code, but in production environment you may need to change it -to another one, potentially with the [paid plan](/docs/ide/paid). \ No newline at end of file +to another one, potentially with the [paid plan](/docs/ide/paid). diff --git a/docs/start/endpoints.md b/docs/start/endpoints.md index aea594c1..0d6ba433 100644 --- a/docs/start/endpoints.md +++ b/docs/start/endpoints.md @@ -1,3 +1,7 @@ +--- +title: "Bitquery API Endpoints and Regions" +description: "Find Bitquery GraphQL, streaming, and regional API endpoints with base URLs, auth notes, and which service to use for each workload." +--- # Endpoints and Regions Bitquery provides multiple regional endpoints to optimize latency and performance. Choose the endpoint closest to your geographic location for the best experience. @@ -90,6 +94,6 @@ The following chains are available via the United States regional endpoint: ## Next Steps -- Learn about [API authentication](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +- Learn about [API authentication](/docs/authorization/how-to-generate/) - Explore the [GraphQL IDE](https://ide.bitquery.io/) -- Check [API examples](https://docs.bitquery.io/docs/blockchain/introduction/) +- Check [API examples](/docs/blockchain/introduction/) diff --git a/docs/start/errors.md b/docs/start/errors.md index 8111313d..7f82f026 100644 --- a/docs/start/errors.md +++ b/docs/start/errors.md @@ -1,10 +1,14 @@ +--- +title: "Bitquery API Common Errors" +description: "Bitquery API Common Errors: practical Bitquery setup guidance with examples for authentication, endpoints, and first queries." +--- # Common Errors and What to Do This section will guide you through the interpretation of common error messages encountered within Bitquery APIs. It will help you decide when to escalate issues by filing a ticket at [Bitquery Support](https://support.bitquery.io/). ## Why am I getting a 403 Forbidden error when making a GraphQL request in Python? {#why-am-i-getting-a-403-forbidden-error-when-making-a-graphql-request-in-python} -For **API v2**, Bitquery expects a valid **OAuth token** on the right host: send `Authorization: Bearer ` to **`https://streaming.bitquery.io/graphql`** (see [how to use a token](/docs/authorisation/how-to-use/)). A **403** often means the gateway rejected the request—wrong URL, missing/expired token, or headers not passed exactly as in the Python example. For **legacy v1** (`graphql.bitquery.io`), check **IP allowlists and referrers** in your [account dashboard](/docs/ide/account/). If it still fails, open a ticket with the response body and request URL (redact secrets). +For **API v2**, Bitquery expects a valid **OAuth token** on the right host: send `Authorization: Bearer ` to **`https://streaming.bitquery.io/graphql`** (see [how to use a token](/docs/authorization/how-to-use/)). A **403** often means the gateway rejected the request—wrong URL, missing/expired token, or headers not passed exactly as in the Python example. For **legacy v1** (`graphql.bitquery.io`), check **IP allowlists and referrers** in your [account dashboard](/docs/ide/account/). If it still fails, open a ticket with the response body and request URL (redact secrets). ### ClickHouse Error: 400 Bad Request @@ -20,7 +24,7 @@ This error typically arises due to incorrect query construction involving limits #### Resolution Steps: -- **Review Query Parameters:** Ensure that the query adheres to the specified limits, sorting criteria, and filters as required in a standard [query](/docs/start/first-query.md). +- **Review Query Parameters:** Ensure that the query adheres to the specified limits, sorting criteria, and filters as required in a standard [query](/docs/start/first-query/). - **Validate Syntax:** Double-check the syntax of the query to identify any mistakes or discrepancies. - **Consult Documentation:** Refer to Bitquery documentation for similar examples. - **Escalation:** If the issue persists or requires further assistance, consider filing a detailed ticket on [Bitquery Support](https://support.bitquery.io/) for help and resolution. diff --git a/docs/start/first-query.md b/docs/start/first-query.md index 553e02fe..79018d48 100644 --- a/docs/start/first-query.md +++ b/docs/start/first-query.md @@ -1,7 +1,8 @@ --- sidebar_position: 1 +title: "Your First Bitquery GraphQL Query" +description: "Run your first Bitquery GraphQL query in minutes with IDE setup, authentication basics, and a simple starter example you can reuse." --- - # Your First Query Create and run your first query on Bitquery IDE by visiting [https://graphql.bitquery.io/ide](https://graphql.bitquery.io/ide). @@ -77,6 +78,6 @@ For example, Now that you've created your first query, learn which data primitives to use: -- **[Mental Model: Transfers, Events, Calls, and DexTrades](https://docs.bitquery.io/docs/start/mental-model-transfers-events-calls)** - Understand when to use Transfers, Events, Calls, or DexTrades for your queries -- **[Starter Queries](https://docs.bitquery.io/docs/start/starter-queries)** - Try pre-built queries for common use cases -- **[Learning Path](https://docs.bitquery.io/docs/start/learning-path)** - Follow a structured path from beginner to advanced +- **[Mental Model: Transfers, Events, Calls, and DexTrades](/docs/start/mental-model-transfers-events-calls)** - Understand when to use Transfers, Events, Calls, or DexTrades for your queries +- **[Starter Queries](/docs/start/starter-queries)** - Try pre-built queries for common use cases +- **[Learning Path](/docs/start/learning-path)** - Follow a structured path from beginner to advanced diff --git a/docs/start/getting-updates.md b/docs/start/getting-updates.md index 4a22cb5c..1d096e79 100644 --- a/docs/start/getting-updates.md +++ b/docs/start/getting-updates.md @@ -1,7 +1,8 @@ --- sidebar_position: 2 +title: "Subscribe to Real-Time Blockchain Data" +description: "Subscribe to Real-Time Blockchain Data: practical Bitquery setup guidance with examples for authentication, endpoints, and first queries." --- - # Subscribing to Real-Time Data After you have created and successfully run [your first query](/docs/start/first-query), it is time to @@ -26,16 +27,15 @@ The run button now again becomes green. But now, when you press it, you will not immediately get results, as it will wait for a new block to be formed. In the BSC network, blocks typically come in 3-4 seconds. Hence, you will see this sequence after some time on the result panel: -![IDE subscription execution](/img/ide/ide_subscription.gif) + > Query used: [Real Time Blocks Subscription | BSC](https://graphql.bitquery.io/ide/Real-Time-Blocks-Subscription--BSC) To stop updates, press the run button again. - :::caution Resources usage Please note that as long as data is being received, the box on the right will continue to populate, which has no text limit, so make sure you don't waste your resources! ::: -Read more about subscriptions and creating websockets [here](/docs/subscriptions/subscription.md) \ No newline at end of file +Read more about subscriptions and creating websockets [here](/docs/subscriptions/subscription/) diff --git a/docs/start/learning-path.md b/docs/start/learning-path.md index 862bb865..1bf0cac4 100644 --- a/docs/start/learning-path.md +++ b/docs/start/learning-path.md @@ -1,56 +1,57 @@ --- sidebar_position: 2 +title: "Bitquery Learning Path" +description: "Follow a guided Bitquery learning path from your first GraphQL query through streaming, cubes, and production-ready apps." --- - # Learning Path: From Beginner to Advanced This guide provides a structured path to learn Bitquery APIs progressively, from basic concepts to advanced implementations. ## Quick Start (5 minutes) -1. **[Your First Query](https://docs.bitquery.io/docs/start/first-query)** - Create and run your first GraphQL query -2. **[IDE Basics](https://docs.bitquery.io/docs/ide/query)** - Learn to use the Bitquery IDE effectively -3. **[Starter Queries](https://docs.bitquery.io/docs/start/starter-queries)** - Try pre-built queries for common use cases +1. **[Your First Query](/docs/start/first-query)** - Create and run your first GraphQL query +2. **[IDE Basics](/docs/ide/query)** - Learn to use the Bitquery IDE effectively +3. **[Starter Queries](/docs/start/starter-queries)** - Try pre-built queries for common use cases ## Foundation (30 minutes) -1. **[Mental Model: Transfers, Events, Calls, and DexTrades](https://docs.bitquery.io/docs/start/mental-model-transfers-events-calls)** - Understand when to use each data primitive -2. **[Understanding Datasets](https://docs.bitquery.io/docs/graphql/dataset/archive)** - Learn about archive, real-time, and combined datasets -3. **[Basic GraphQL Concepts](https://docs.bitquery.io/docs/graphql/introduction)** - Understand query structure and syntax -4. **[Authorization](https://docs.bitquery.io/docs/authorisation/how-to-generate)** - Set up your access outside our IDE +1. **[Mental Model: Transfers, Events, Calls, and DexTrades](/docs/start/mental-model-transfers-events-calls)** - Understand when to use each data primitive +2. **[Understanding Datasets](/docs/graphql/dataset/archive)** - Learn about archive, real-time, and combined datasets +3. **[Basic GraphQL Concepts](/docs/graphql/query/)** - Understand query structure and syntax +4. **[Authorization](/docs/authorization/how-to-generate)** - Set up your access outside our IDE ## Intermediate (1-2 hours) -1. **[Building Complex Queries](https://docs.bitquery.io/docs/graphql/query)** - Learn advanced query techniques -2. **[Real-time Subscriptions](https://docs.bitquery.io/docs/start/starter-subscriptions)** - Set up live data streams -3. **[Error Handling](https://docs.bitquery.io/docs/start/errors)** - Understand and fix common issues +1. **[Building Complex Queries](/docs/graphql/query)** - Learn advanced query techniques +2. **[Real-time Subscriptions](/docs/start/starter-subscriptions)** - Set up live data streams +3. **[Error Handling](/docs/start/errors)** - Understand and fix common issues ## Advanced (2-4 hours) -1. **[Platform-Specific APIs](https://docs.bitquery.io/docs/blockchain/Solana/)** - Deep dive into Solana, Ethereum, etc. -2. **[Integration Examples](https://docs.bitquery.io/docs/usecases/)** - Real-world application examples -3. **[Performance Optimization](https://docs.bitquery.io/docs/graphql/performance)** - Optimize your queries for production -4. **[Contributing](https://docs.bitquery.io/docs/contribution-guidelines)** - Help improve the documentation +1. **[Platform-Specific APIs](/docs/blockchain/Solana/)** - Deep dive into Solana, Ethereum, etc. +2. **[Integration Examples](/docs/category/how-to-guides/)** - Real-world application examples +3. **[Performance Optimization](/docs/graphql/optimizing-graphql-queries/)** - Optimize your queries for production +4. **[Contributing](/docs/contribution-guidelines)** - Help improve the documentation ## Choose Your Path ### For Traders -- Start with **[Crypto Price APIs](https://docs.bitquery.io/docs/start/starter-queries#crypto-price-apis)** -- Learn **[Real-time Price Streams](https://docs.bitquery.io/docs/start/starter-subscriptions)** -- Explore **[DEX Trading APIs](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades)** +- Start with **[Crypto Price APIs](/docs/start/starter-queries#crypto-price-change-api)** +- Learn **[Real-time Price Streams](/docs/start/starter-subscriptions)** +- Explore **[DEX Trading APIs](/docs/blockchain/Solana/solana-dextrades)** ### For Developers -- Begin with **[Your First Query](https://docs.bitquery.io/docs/start/first-query)** -- Master **[GraphQL Basics](https://docs.bitquery.io/docs/graphql/introduction)** -- Build **[Custom Applications](https://docs.bitquery.io/docs/usecases/)** +- Begin with **[Your First Query](/docs/start/first-query)** +- Master **[GraphQL Basics](/docs/graphql/query/)** +- Build **[Custom Applications](/docs/category/how-to-guides/)** ### For Analysts -- Start with **[Historical Data](https://docs.bitquery.io/docs/graphql/dataset/archive)** -- Learn **[Aggregation Queries](https://docs.bitquery.io/docs/graphql/aggregation)** -- Explore **[Analytics Examples](https://docs.bitquery.io/docs/examples/)** +- Start with **[Historical Data](/docs/graphql/dataset/archive)** +- Learn **[Aggregation Queries](/docs/graphql/capabilities/aggregated_metrics/)** +- Explore **[Analytics Examples](/docs/category/how-to-guides/)** ## Getting Help diff --git a/docs/start/mempool.md b/docs/start/mempool.md index 8006e111..42fd10ab 100644 --- a/docs/start/mempool.md +++ b/docs/start/mempool.md @@ -1,7 +1,8 @@ --- sidebar_position: 5 +title: "Mempool Data API Overview" +description: "Use Bitquery mempool APIs to watch pending transactions before confirmation across supported chains with GraphQL queries and streams." --- - # Getting Mempool Data In the previous section, we saw how to write a subscription query. Now, let's examine the process of obtaining mempool data. diff --git a/docs/start/mental-model-transfers-events-calls.md b/docs/start/mental-model-transfers-events-calls.md index 1f94c645..9d9b9a89 100644 --- a/docs/start/mental-model-transfers-events-calls.md +++ b/docs/start/mental-model-transfers-events-calls.md @@ -1,3 +1,7 @@ +--- +title: "Transfers vs Events vs Calls vs DexTrades" +description: "Transfers vs Events vs Calls vs DexTrades: practical Bitquery setup guidance with examples for authentication, endpoints, and first queries." +--- # Mental Model: Transfers, Events, Calls, and DexTrades Understanding when to use **Transfers**, **Events**, **Calls**, or **DexTrades** is one of the decisions you'll make when querying blockchain data. This guide explains the conceptual differences and helps you choose the right primitive for your use case. @@ -8,7 +12,7 @@ Understanding when to use **Transfers**, **Events**, **Calls**, or **DexTrades** Before writing a query, ask yourself: -1. **Do I need DEX swap/trade data or aggregated price/OHLC data?** → For **real-time + the last ~30 days**, use the curated **`Trading`** cube — [`Trading.Trades`](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api) for swap-level rows or [`Trading.Tokens` / `Pairs` / `Currencies`](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction) for pre-aggregated OHLC. For **historical** data older than ~30 days, use chain-level **`DexTrades`** / **`DexTradesByTokens`**. See the [**Trading Data Overview**](https://docs.bitquery.io/docs/trading/trading-data-overview) for the full decision matrix. +1. **Do I need DEX swap/trade data or aggregated price/OHLC data?** → For **real-time + the last ~30 days**, use the curated **`Trading`** cube — [`Trading.Trades`](/docs/trading/crypto-trades-api/trades-api) for swap-level rows or [`Trading.Tokens` / `Pairs` / `Currencies`](/docs/trading/crypto-price-api/introduction) for pre-aggregated OHLC. For **historical** data older than ~30 days, use chain-level **`DexTrades`** / **`DexTradesByTokens`**. See the [**Trading Data Overview**](/docs/trading/trading-data-overview) for the full decision matrix. 2. **Do I need token movements?** → Consider `Transfers` or `Calls` 3. **Do I need smart contract state changes?** → Consider `Events` 4. **Do I need function execution details?** → Consider `Calls` @@ -177,7 +181,7 @@ EVM { **Trading vs DexTrades:** Use **Trading** when you need **aggregated price/OHLC/volume** for charting or feeds. Use **DexTrades** when you need **individual swaps**, protocol/pool breakdown, or trade-level fields (buyer, seller, tx, block). -Docs: [Crypto Price API (Trading)](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction), [Tokens / Currencies / Pairs](https://docs.bitquery.io/docs/trading/crypto-price-api/tokens), [OHLC & candles](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api). +Docs: [Crypto Price API (Trading)](/docs/trading/crypto-price-api/introduction), [Tokens / Currencies / Pairs](/docs/trading/crypto-price-api/tokens), [OHLC & candles](/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api). --- @@ -204,16 +208,16 @@ Use the root `EVM(network: eth | bsc | base | ...)` in your query. Solana does **not** have EVM-style **Events** or **Calls**; use **Instructions** and **Logs** (inside Instructions) for program activity. -Docs: [Solana Builder Terms](https://docs.bitquery.io/docs/cubes/solana), [Solana DEX Trades](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades), [Solana Transfers](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers), [Solana Instructions](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions), [Solana Balance Updates](https://docs.bitquery.io/docs/blockchain/Solana/solana-balance-updates). +Docs: [Solana Builder Terms](/docs/cubes/solana), [Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades), [Solana Transfers](/docs/blockchain/Solana/solana-transfers), [Solana Instructions](/docs/blockchain/Solana/solana-instructions), [Solana Balance Updates](/docs/blockchain/Solana/solana-balance-updates). ### Tron - **Transfers** – TRC-20 and native TRX movements. Same idea as EVM Transfers; use `Tron { Transfers(...) }`. - **DEXTrades** – DEX swap data (e.g. SunSwap). Same idea as EVM; use `Tron { DEXTrades(...) }`. -Tron’s model is close to EVM (TVM); Transfers and DEXTrades map directly. For logs and contract calls, see the [Tron API docs](https://docs.bitquery.io/docs/blockchain/Tron/). +Tron’s model is close to EVM (TVM); Transfers and DEXTrades map directly. For logs and contract calls, see the [Tron API docs](/docs/blockchain/Tron/). -Docs: [Tron API](https://docs.bitquery.io/docs/blockchain/Tron/), [Tron DEX Trades](https://docs.bitquery.io/docs/blockchain/Tron/tron-dextrades), [Tron Transfers](https://docs.bitquery.io/docs/blockchain/Tron/tron-transfers). +Docs: [Tron API](/docs/blockchain/Tron/), [Tron DEX Trades](/docs/blockchain/Tron/tron-dextrades), [Tron Transfers](/docs/blockchain/Tron/tron-transfers). ### Quick mapping @@ -437,7 +441,7 @@ Bitquery exposes **on-chain** activity (transfers, trades, calls)—not centrali Now that you understand the mental model: **Price / OHLC / charting (all chains):** -1. **[Crypto Price API (Trading)](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction)** - Pre-aggregated OHLC, SMA, volume; Tokens, Currencies, Pairs cubes +1. **[Crypto Price API (Trading)](/docs/trading/crypto-price-api/introduction)** - Pre-aggregated OHLC, SMA, volume; Tokens, Currencies, Pairs cubes **EVM (Ethereum, BSC, Base, etc.):** 2. **[Explore Transfers API](/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api)** - Learn Transfers in detail @@ -448,15 +452,15 @@ Now that you understand the mental model: 7. **[Ethereum DEX API](/docs/blockchain/Ethereum/dextrades/dex-api)** - DEX trading examples **Solana:** -8. **[Solana Builder Terms](https://docs.bitquery.io/docs/cubes/solana)** - Transfers, DEXTrades, Instructions, BalanceUpdates, DEXOrders -9. **[Solana DEX Trades](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades)** - DEX swap data -10. **[Solana Transfers](https://docs.bitquery.io/docs/blockchain/Solana/solana-transfers)** - Token movements -11. **[Solana Instructions](https://docs.bitquery.io/docs/blockchain/Solana/solana-instructions)** - Program execution (Calls-like) +8. **[Solana Builder Terms](/docs/cubes/solana)** - Transfers, DEXTrades, Instructions, BalanceUpdates, DEXOrders +9. **[Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades)** - DEX swap data +10. **[Solana Transfers](/docs/blockchain/Solana/solana-transfers)** - Token movements +11. **[Solana Instructions](/docs/blockchain/Solana/solana-instructions)** - Program execution (Calls-like) **Tron:** -12. **[Tron API](https://docs.bitquery.io/docs/blockchain/Tron/)** - Overview -13. **[Tron DEX Trades](https://docs.bitquery.io/docs/blockchain/Tron/tron-dextrades)** - DEX swap data -14. **[Tron Transfers](https://docs.bitquery.io/docs/blockchain/Tron/tron-transfers)** - Token movements +12. **[Tron API](/docs/blockchain/Tron/)** - Overview +13. **[Tron DEX Trades](/docs/blockchain/Tron/tron-dextrades)** - DEX swap data +14. **[Tron Transfers](/docs/blockchain/Tron/tron-transfers)** - Token movements **General:** 15. **[Try Starter Queries](/docs/start/starter-queries)** - See real examples diff --git a/docs/start/starter-queries.md b/docs/start/starter-queries.md index c71c5fe1..547eb19f 100644 --- a/docs/start/starter-queries.md +++ b/docs/start/starter-queries.md @@ -1,6 +1,6 @@ --- title: "Starter Queries - Bitquery API Examples by Chain" -description: "Curated Bitquery starter queries for Ethereum, Solana, BSC, Polymarket, Bitcoin, and more. Cross-chain price API, OHLC, DEX trades, and blockchain examples." +description: "Starter Queries - Bitquery API Examples by Chain: practical Bitquery setup guidance with examples for authentication, endpoints, and first queries." keywords: [ "Bitquery starter queries", @@ -10,18 +10,6 @@ keywords: "Bitquery IDE", ] --- - - - - - - - - - - - - # Starter Queries Below is a set of queries that are curated for you to get started with Bitquery. @@ -1189,7 +1177,7 @@ This API returns all incoming and outgoing transactions for a specific Bitcoin w #### Latest Bitcoin Price -You can stream Bitcoin price at 1-second interval using the [Crypto Price APIs](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/). +You can stream Bitcoin price at 1-second interval using the [Crypto Price APIs](/docs/trading/crypto-price-api/introduction/). ▶️ [Bitcoin Price Stream](https://ide.bitquery.io/Stream-Bitcoin-Price-Across-Chains) diff --git a/docs/start/starter-subscriptions.md b/docs/start/starter-subscriptions.md index 5839556e..325ec775 100644 --- a/docs/start/starter-subscriptions.md +++ b/docs/start/starter-subscriptions.md @@ -1,3 +1,7 @@ +--- +title: "Starter GraphQL Subscriptions" +description: "Starter GraphQL Subscriptions: practical Bitquery setup guidance with examples for authentication, endpoints, and first queries." +--- # Starter Subscriptions Below is a set of subscriptions that are curated for you to get started with Bitquery. @@ -65,7 +69,6 @@ Subscribe only to Resolved events. Winning outcome is in Prediction.Outcome; tok Subscribe to live Split, Merge, and Redemption events as they occur on Polygon. ▶️ [Real-Time Prediction Market Settlements Stream](https://ide.bitquery.io/realtime-predicion-market-settlements-stream) - ## Ethereum ### Balance APIs @@ -668,8 +671,6 @@ Monitor NFT transfers for a specific collection across all transactions. This he ▶️ [Track Specific NFT Balance Changes](https://ide.bitquery.io/Track-specific-NFTs-Balance-Changes) - - ## x402 Streams ### Base @@ -692,5 +693,5 @@ Real-time subscription to monitor payments to a specific x402 server on Solana n You will find more detailed information on streams and subscriptions in the relevant sections. -- [Understanding Subscription](https://docs.bitquery.io/docs/subscriptions/subscription/) -- [Streaming via Websocket](https://docs.bitquery.io/docs/subscriptions/examples/) +- [Understanding Subscription](/docs/subscriptions/subscription/) +- [Streaming via Websocket](/docs/subscriptions/examples/) diff --git a/docs/streams/index.md b/docs/streams/index.md index 37e723dd..cc00ec85 100644 --- a/docs/streams/index.md +++ b/docs/streams/index.md @@ -1,9 +1,8 @@ --- -title: Real-time Blockchain Data Streaming API -description: Access real-time cryptocurrency and DeFi data with Bitquery's streaming APIs. Choose from WebSocket, Kafka, or gRPC streams for trading bots, DEX monitoring, and blockchain analytics. +title: "Real-Time Blockchain Data Streaming" +description: "Compare Bitquery WebSocket, Kafka, and gRPC streams for latency, filtering, reliability, and crypto trading use cases. See examples in the Bitquery IDE." keywords: [real-time blockchain data, cryptocurrency data API, DeFi data streams, trading data feeds, blockchain WebSocket API, Kafka blockchain streams, gRPC blockchain data, crypto market data, DEX trading data, blockchain analytics API] --- - import FAQ from "@site/src/components/FAQ"; # Real-time Blockchain Data Streaming API | Bitquery Platform @@ -14,16 +13,16 @@ Bitquery provides powerful **real-time blockchain data streaming** capabilities | Technology | Latency | Best For | Learn More | |------------|---------|----------|------------| -| **[WebSocket](#websocket-graphql-subscriptions)** | ~1 second | Beginners, Web Apps, Complex Filtering | [WebSocket Docs](https://docs.bitquery.io/docs/subscriptions/websockets/) | -| **[Kafka](#kafka-streams)** | < 500ms | Enterprise, High-Volume, Trading Bots | [Kafka Concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) | -| **[CoreCast](#corecast-grpc-streams)** | < 100ms | Solana, Ultra-Low Latency, MEV | [gRPC Docs](https://docs.bitquery.io/docs/grpc/solana/introduction/) | +| **[WebSocket](#websocket-graphql-subscriptions)** | ~1 second | Beginners, Web Apps, Complex Filtering | [WebSocket Docs](/docs/subscriptions/websockets/) | +| **[Kafka](#kafka-streams)** | < 500ms | Enterprise, High-Volume, Trading Bots | [Kafka Concepts](/docs/streams/kafka-streaming-concepts/) | +| **[CoreCast](#corecast-grpc-streams)** | < 100ms | Solana, Ultra-Low Latency, MEV | [gRPC Docs](/docs/grpc/solana/introduction/) | ## Blockchain Data Streaming Technologies Overview ### Real-time GraphQL Subscriptions (WebSocket API) {#websocket-graphql-subscriptions} **Multichain Support** | **Live Data** | **Beginner-friendly** -Our **WebSocket-based GraphQL subscriptions** provide **real-time cryptocurrency data** with very high filtering and formatting capabilities. You can filter by wallet addresses, token contracts, transaction amounts, USD values, and much more directly in your queries. Perfect for **crypto trading applications**, **[DeFi dashboards](https://docs.bitquery.io/docs/usecases/crypto-dashboard/)**, and **blockchain analytics platforms**. +Our **WebSocket-based GraphQL subscriptions** provide **real-time cryptocurrency data** with very high filtering and formatting capabilities. You can filter by wallet addresses, token contracts, transaction amounts, USD values, and much more directly in your queries. Perfect for **crypto trading applications**, **[DeFi dashboards](/docs/usecases/crypto-dashboard/)**, and **blockchain analytics platforms**. - **Endpoint**: `wss://streaming.bitquery.io/graphql` - **Protocols**: `graphql-transport-ws`, `graphql-ws` @@ -38,7 +37,7 @@ High-performance, **low-latency blockchain data streaming** for mission-critical - **Endpoints**: `rpk0.bitquery.io:9092`, `rpk1.bitquery.io:9092`, `rpk2.bitquery.io:9092` - **Protocol**: Apache Kafka with SASL authentication - **Latency**: < 500ms (sub-second) -- **Use Cases**: **[Cryptocurrency trading bots](https://docs.bitquery.io/docs/streams/sniper-trade-using-bitquery-kafka-stream/)**, **real-time DeFi applications**, **MEV bot development**, **high-frequency blockchain monitoring** +- **Use Cases**: **[Cryptocurrency trading bots](/docs/streams/sniper-trade-using-bitquery-kafka-stream/)**, **real-time DeFi applications**, **MEV bot development**, **high-frequency blockchain monitoring** ### Ultra-fast gRPC Streams (CoreCast) {#corecast-grpc-streams} **Solana Blockchain** | **Sub-100ms latency** | **Smart filtering** @@ -61,7 +60,7 @@ Our newest **ultra-low latency streaming technology** provides the fastest **Sol | **Retention / Replay** | ❌ No | ✅ Yes, configurable retention window | ❌ No | | **Schema / Data Format** | JSON over WebSocket | Avro/Protobuf over Kafka | Protobuf (typed contracts) | | **Delivery Guarantee** | At-most-once | ✅ At-least-once (can configure exactly-once) | At-most-once | -| **Integration Complexity** | Easiest for frontends, explorers, bots | Requires infra (Kafka cluster, consumers) | Lightweight, good for backend apps and trading stratergies | +| **Integration Complexity** | Easiest for frontends, explorers, bots | Requires infra (Kafka cluster, consumers) | Lightweight, good for backend apps and trading strategies | | **Bandwidth Efficiency** | Medium (JSON, more verbose) | High (binary encoding, batching) | Medium (Protobuf, direct streams) | | **Use Case Fit** | Dashboards, explorers, analytics needing USD values & rich filters | Mission-critical infra: indexing, ETL pipelines, archival, guaranteed delivery | Ultra-low latency trading, real-time DeFi apps, terminals, Telegram bots | @@ -70,8 +69,8 @@ Our newest **ultra-low latency streaming technology** provides the fastest **Sol ### Choose **Real-time GraphQL WebSocket API** if: - Building **crypto trading web applications** -- Need **[advanced filtering capabilities](https://docs.bitquery.io/docs/graphql/filters/)** with complex conditions and **real-time USD prices** -- Require **[cryptocurrency price calculations](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/)** and **DeFi token metrics** +- Need **[advanced filtering capabilities](/docs/graphql/filters/)** with complex conditions and **real-time USD prices** +- Require **[cryptocurrency price calculations](/docs/trading/crypto-price-api/introduction/)** and **DeFi token metrics** - Want fastest development and prototyping experience for **blockchain applications** - Building **crypto dashboards**, **DeFi monitoring tools**, or **blockchain analytics platforms** - Need unified interface for both **historical blockchain data** and **real-time streams** @@ -90,52 +89,52 @@ Our newest **ultra-low latency streaming technology** provides the fastest **Sol - Working specifically with **Solana blockchain ecosystem** - Need **ultra-low latency** (< 100ms) for **Solana trading** - Want basic server-side filtering to reduce bandwidth (more limited than WebSocket) -- Building **[high-frequency Solana trading applications](https://docs.bitquery.io/docs/blockchain/Solana/Solana-Raydium-DEX-API/)** and **MEV bots** +- Building **[high-frequency Solana trading applications](/docs/blockchain/Solana/Solana-Raydium-DEX-API/)** and **MEV bots** - Developing lightweight backend services for **Solana DeFi** -- Creating **[Solana trading Telegram bots](https://docs.bitquery.io/docs/usecases/telegram-bot/)** or **terminal applications** +- Creating **[Solana trading Telegram bots](/docs/usecases/telegram-bot/)** or **terminal applications** ## Getting Started ### GraphQL Subscriptions (WebSockets) -1. **Authentication**: Use your [IDE credentials](https://docs.bitquery.io/docs/authorisation/how-to-generate/) or [OAuth tokens](https://docs.bitquery.io/docs/authorisation/websocket/) +1. **Authentication**: Use your [IDE credentials](/docs/authorization/how-to-generate/) or [OAuth tokens](/docs/authorization/websocket/) 2. **Connect**: `wss://streaming.bitquery.io/graphql` -3. **Start**: Create your first subscription in the [Bitquery IDE](https://ide.bitquery.io) using our [starter subscriptions](https://docs.bitquery.io/docs/start/starter-subscriptions/) +3. **Start**: Create your first subscription in the [Bitquery IDE](https://ide.bitquery.io) using our [starter subscriptions](/docs/start/starter-subscriptions/) -**Learn more**: [WebSocket Documentation](https://docs.bitquery.io/docs/subscriptions/websockets/) | [Examples](https://docs.bitquery.io/docs/subscriptions/examples/) +**Learn more**: [WebSocket Documentation](/docs/subscriptions/websockets/) | [Examples](/docs/subscriptions/examples/) ### Kafka Streams 1. **Get Access**: Contact our [sales team](https://bitquery.io/forms/api) for Kafka credentials 2. **Connect**: Use SASL authentication with provided username/password 3. **Subscribe**: Choose from topics like `ethereum.dextrades`, `solana.transactions`, etc. -**Learn more**: [Kafka Concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/) | [Best Practices](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/#best-practises) +**Learn more**: [Kafka Concepts](/docs/streams/kafka-streaming-concepts/) | [Best Practices](/docs/streams/kafka-streaming-concepts/#best-practises) ### gRPC Streams (CoreCast) 1. **Get Token**: Generate at [API Access Tokens](https://account.bitquery.io/user/api_v2/access_tokens) 2. **Connect**: `corecast.bitquery.io` with your API token 3. **Filter**: Define filters for addresses, tokens, or value thresholds -**Learn more**: [gRPC Introduction](https://docs.bitquery.io/docs/grpc/solana/introduction/) | [Code Examples](https://github.com/bitquery/grpc-code-samples) +**Learn more**: [gRPC Introduction](/docs/grpc/solana/introduction/) | [Code Examples](https://github.com/bitquery/grpc-code-samples) ## Multi-chain Blockchain Data Coverage ### GraphQL Subscriptions & Kafka Support: -- **[Ethereum](https://docs.bitquery.io/docs/blockchain/Ethereum/)** & Layer 2s ([Arbitrum](https://docs.bitquery.io/docs/blockchain/Arbitrum/), [Optimism](https://docs.bitquery.io/docs/blockchain/Optimism/), [Base](https://docs.bitquery.io/docs/blockchain/Base/), [Polygon](https://docs.bitquery.io/docs/blockchain/Matic/)) -- **[Binance Smart Chain (BSC)](https://docs.bitquery.io/docs/blockchain/BSC/)** -- **[Robinhood](https://docs.bitquery.io/docs/blockchain/robinhood/)** -- **[Solana](https://docs.bitquery.io/docs/blockchain/Solana/)** -- **[TRON](https://docs.bitquery.io/docs/blockchain/Tron/)** -- **[TON](https://docs.bitquery.io/docs/blockchain/TON/)** (limited support) +- **[Ethereum](/docs/blockchain/Ethereum/)** & Layer 2s ([Arbitrum](/docs/blockchain/Arbitrum/), [Optimism](/docs/blockchain/Optimism/), [Base](/docs/blockchain/Base/), [Polygon](/docs/blockchain/Matic/)) +- **[Binance Smart Chain (BSC)](/docs/blockchain/BSC/)** +- **[Robinhood](/docs/blockchain/robinhood/)** +- **[Solana](/docs/blockchain/Solana/)** +- **[TRON](/docs/blockchain/Tron/)** +- **[TON](/docs/blockchain/supported-chains/)** (limited support; see coverage matrix) ### gRPC Streams: -- **[Solana](https://docs.bitquery.io/docs/blockchain/Solana/)** (with more blockchains coming soon) +- **[Solana](/docs/blockchain/Solana/)** (with more blockchains coming soon) ## Support & Resources - **Documentation**: Comprehensive guides for each technology - **Community**: Join our [Telegram](https://t.me/Bloxy_info) for support - **Code Examples**: [GitHub repositories](https://github.com/bitquery) with sample implementations -- **Interactive Tools**: Test queries in our [IDE](https://ide.bitquery.io) with our [starter queries](https://docs.bitquery.io/docs/start/starter-queries/) +- **Interactive Tools**: Test queries in our [IDE](https://ide.bitquery.io) with our [starter queries](/docs/start/starter-queries/) --- diff --git a/docs/streams/kafka-streaming-concepts.md b/docs/streams/kafka-streaming-concepts.md index 7a901131..5ac1c418 100644 --- a/docs/streams/kafka-streaming-concepts.md +++ b/docs/streams/kafka-streaming-concepts.md @@ -1,23 +1,24 @@ --- sidebar_position: 1 +title: "Kafka Streaming Concepts" +description: "Learn Bitquery Kafka stream concepts: topics, offsets, SASL auth, protobuf payloads, and when Kafka beats WebSockets for crypto data." --- - # Bitquery Kafka Streams - Understanding Concepts -Bitquery provides realtime data via Kafka as well in addition to GraphQL subscriptions. In this section, we'll see how Kafka-based streaming works and how to integrate it into your application using practical code examples. For price data streams, check out our [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) Kafka topic. +Bitquery provides realtime data via Kafka as well in addition to GraphQL subscriptions. In this section, we'll see how Kafka-based streaming works and how to integrate it into your application using practical code examples. For price data streams, check out our [Crypto Price API](/docs/trading/crypto-price-api/introduction/) Kafka topic. ## How to Get Access to these Streams? IDE credentials will not work with our Kafka Streams. You need a separate username and password. Please contact sales on our official telegram channel or fill out the [form on our website](https://bitquery.io/forms/api). -### Pro and Cons +### Pros and Cons Kafka provides faster and more reliable streams comparing to GraphQL subscriptions due to the following advantages: -1. It has lower lattency due to the shorter data pipeline, as GraphQL subscriptions involve custom databases and additional logic to process, filter and format the data -2. Better reliabilty of the connection protocol compared to WebSocket interface, better optimised for persistent connections +1. It has lower latency due to the shorter data pipeline, as GraphQL subscriptions involve custom databases and additional logic to process, filter and format the data +2. Better reliability of the connection protocol compared to WebSocket interface, better optimized for persistent connections 3. Messages from Kafka topic can be read from the latest offset, it is possible to create consumers that have all messages without gaps and interruption. -4. Scalability is better as multiple consumers may split the load to consume one topic, automaticlly redistributing load on them +4. Scalability is better as multiple consumers may split the load to consume one topic, automatically redistributing load on them There are some disadvantages however compared to GraphQL subscriptions: @@ -54,10 +55,10 @@ This decision sometimes not straightforward, consult our sales and support team, ### Kafka Streams Lattency -Topics for the same blockchain are not equal by lattency. If you have requirements on lattency, consider to select the proper stream for your application: +Topics for the same blockchain are not equal by latency. If you have requirements on latency, consider to select the proper stream for your application: 1. Broadcasted topics are available for most blockchains. They can be faster, as the transactions are not waiting till include and commit the block in the chain -2. Streams are chained while they are parsing, the closer the topic to the original blockchain node, the less is the lattency. Consider selecting the closest topic that you can effectively parse. Every transformation introduces 100-1000 msec latency in the overall topic delay. +2. Streams are chained while they are parsing, the closer the topic to the original blockchain node, the less is the latency. Consider selecting the closest topic that you can effectively parse. Every transformation introduces 100-1000 msec latency in the overall topic delay. The diagram shows the data pipeline of the streams on the way to KAFKA topics. Broadcasted and committed transaction datapipelines are identical: @@ -168,7 +169,7 @@ All topics deliver data in **protobuf** format. JSON samples for inspection: [ka The **`trading`** namespace defines two Kafka topics. **Both use the same credentials** as your subscription: -- **`trading.prices`** — Multi-chain [Price Index Streams](https://docs.bitquery.io/docs/trading/price-index/introduction/). See the [Crypto Price API](/docs/trading/crypto-price-api/introduction) for usage. +- **`trading.prices`** — Multi-chain [Price Index Streams](/docs/trading/crypto-price-api/introduction/). See the [Crypto Price API](/docs/trading/crypto-price-api/introduction) for usage. - **`trading.trades`** — Real-time DEX trades aligned with the [Crypto Trades API](/docs/trading/crypto-trades-api/trades-api). Message structure is defined in [`market/trades.proto`](https://github.com/bitquery/streaming_protobuf/blob/main/market/trades.proto) in [Bitquery Streaming Protobuf](https://github.com/bitquery/streaming_protobuf). ### EVM chains @@ -307,7 +308,7 @@ Your consumer will read messages from the topic, and you will be able to parse t - **Message Packing:** Transactions are packed in small chunks, with no more than 250 transactions per message. - **Message Expiration:** Topic messages expire after 24 hours in the stream. -## Best Practises +## Best Practices {#best-practises} When working with Kafka streams, ensuring efficient message consumption and processing is crucial for maintaining low latency and high throughput. Here are the best practices to follow: diff --git a/docs/streams/protobuf/chains/Bitcoin-protobuf.md b/docs/streams/protobuf/chains/Bitcoin-protobuf.md index c4887456..a6a4eae4 100644 --- a/docs/streams/protobuf/chains/Bitcoin-protobuf.md +++ b/docs/streams/protobuf/chains/Bitcoin-protobuf.md @@ -1,3 +1,7 @@ +--- +title: "Bitcoin Kafka Protobuf Streams" +description: "Bitcoin Streams with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading systems. See examples in the Bitquery IDE." +--- # Bitcoin Streams This section provides details about Bitquery's Bitcoin Streams via Kafka. The top-level Kafka section explains how we use Kafka Streams to deliver data. diff --git a/docs/streams/protobuf/chains/EVM-protobuf.md b/docs/streams/protobuf/chains/EVM-protobuf.md index a1828cd5..a79ba210 100644 --- a/docs/streams/protobuf/chains/EVM-protobuf.md +++ b/docs/streams/protobuf/chains/EVM-protobuf.md @@ -1,3 +1,7 @@ +--- +title: "EVM Kafka Protobuf Streams" +description: "EVM Protobuf with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading systems. Great for bots, dashboards, and alerts." +--- # EVM Streams This section provides details about Bitquery's EVM Streams via Kafka. The top-level Kafka section explains how we use Kafka Streams to deliver data. @@ -98,7 +102,7 @@ Each transaction includes: - `PostBalance` — Balance after the transaction - `BalanceChangeReasonCode` — Numeric code describing why the balance changed -(see [Transaction Balance Tracker documentation](https://docs.bitquery.io/docs/blockchain/Ethereum/balances/transaction-balance-tracker/) for code meanings) +(see [Transaction Balance Tracker documentation](/docs/blockchain/Ethereum/balances/transaction-balance-tracker/) for code meanings) ### Token Data @@ -154,7 +158,7 @@ For detailed information about DEXPools, including: - When DEXPool records are emitted for different protocol versions (Uniswap V2, V3, V4) - Filtering and advanced use cases -See the [DEXPools Cube on EVM Chains documentation](https://docs.bitquery.io/docs/cubes/evm-dexpool/). +See the [DEXPools Cube on EVM Chains documentation](/docs/cubes/evm-dexpool/). ### Layer 2 Support diff --git a/docs/streams/protobuf/chains/Solana-protobuf.md b/docs/streams/protobuf/chains/Solana-protobuf.md index 2126c825..a51a8b87 100644 --- a/docs/streams/protobuf/chains/Solana-protobuf.md +++ b/docs/streams/protobuf/chains/Solana-protobuf.md @@ -1,3 +1,7 @@ +--- +title: "Solana Shred Streams" +description: "Solana Shred Streams with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading systems. See examples in the Bitquery IDE." +--- # Solana Shred Streams This section provides details about Bitquery's Solana Shred Streams via Kafka. The top-level Kafka section explains how we use Kafka Streams to deliver data. diff --git a/docs/streams/protobuf/chains/Tron-protobuf.md b/docs/streams/protobuf/chains/Tron-protobuf.md index 22e9c38d..bfc3f0b4 100644 --- a/docs/streams/protobuf/chains/Tron-protobuf.md +++ b/docs/streams/protobuf/chains/Tron-protobuf.md @@ -1,3 +1,7 @@ +--- +title: "Tron Kafka Protobuf Streams" +description: "Tron Protobuf with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading systems. Run it in the IDE, then ship in your app." +--- # TRON Streams You can find the schema [here](https://github.com/bitquery/streaming_protobuf/tree/main/tron). diff --git a/docs/streams/protobuf/filtering_kafka_streams.md b/docs/streams/protobuf/filtering_kafka_streams.md index 013e4181..47d6cafa 100644 --- a/docs/streams/protobuf/filtering_kafka_streams.md +++ b/docs/streams/protobuf/filtering_kafka_streams.md @@ -1,3 +1,7 @@ +--- +title: "Filtering Kafka Streams for Specific Usecases" +description: "Filtering Kafka Streams for Specific Usecases with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading systems." +--- # Filtering Kafka Streams for Specific Usecases In this section, we will see code examples and patterns for filtering Kafka stream messages based on specific criteria — such as smart contract methods, token addresses, DEX interactions, and more. @@ -6,10 +10,10 @@ These examples assume you’ve already set up a working Kafka consumer and are s Refer to specific pages for topic and message related explanation. -- [Solana](https://docs.bitquery.io/docs/streams/protobuf/chains/Solana-protobuf/) -- [EVM including ETH, BSC, Base etc](https://docs.bitquery.io/docs/streams/protobuf/chains/EVM-protobuf/) -- [Bitcoin](https://docs.bitquery.io/docs/streams/protobuf/chains/Bitcoin-protobuf/) -- [Tron](https://docs.bitquery.io/docs/streams/protobuf/chains/Tron-protobuf/) +- [Solana](/docs/streams/protobuf/chains/Solana-protobuf/) +- [EVM including ETH, BSC, Base etc](/docs/streams/protobuf/chains/EVM-protobuf/) +- [Bitcoin](/docs/streams/protobuf/chains/Bitcoin-protobuf/) +- [Tron](/docs/streams/protobuf/chains/Tron-protobuf/) ## Filtering for a specific program and method in Solana @@ -77,6 +81,3 @@ def process_message(message): print("Full Transaction Data:\n") ``` - - - diff --git a/docs/streams/protobuf/kafka-protobuf-go.md b/docs/streams/protobuf/kafka-protobuf-go.md index 3245fe8a..e26141af 100644 --- a/docs/streams/protobuf/kafka-protobuf-go.md +++ b/docs/streams/protobuf/kafka-protobuf-go.md @@ -3,24 +3,23 @@ slug: kafka-protobuf-go sidebar_position: 2 sidebar_label: Go Example to Use Kafka Protobuf Streams for Real-time Data title: Go Example to Use Kafka Protobuf Streams for Real-time Data -description: Connect a Go app to Bitquery Kafka with confluent-kafka-go, decode Solana ParsedIdlBlockMessage from protobuf, and run the minimal go-consumer-example from kafka-streams-examples-usecases. +description: "Go Example to Use Kafka Protobuf Streams for Real-time Data with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading." --- - # Go Example to Use Kafka Protobuf Streams for Real-time Data This guide explains how to consume **Bitquery Kafka** topics from **Go**, receive **Protocol Buffers** payloads, and decode **Solana** blocks as **`ParsedIdlBlockMessage`**. The **reference implementation** you run is the minimal app in **[`bitquery/kafka-streams-examples-usecases`](https://github.com/bitquery/kafka-streams-examples-usecases)** ([`go-consumer-example/`](https://github.com/bitquery/kafka-streams-examples-usecases/tree/main/go-consumer-example)): one process, **`.env`** configuration, **`Poll`** loop, stdout for decoded data and stderr for logs. -Read the platform overview in **[Kafka streaming concepts — Protobuf streams](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/#protobuf-streams)**. **`.proto` sources and generated Go types** live under **[Bitquery Streaming Protobuf](https://github.com/bitquery/streaming_protobuf)** (Solana tree: [`solana/`](https://github.com/bitquery/streaming_protobuf/tree/main/solana)); this sample imports **`github.com/bitquery/streaming_protobuf/v2/solana/messages`**. +Read the platform overview in **[Kafka streaming concepts — Protobuf streams](/docs/streams/kafka-streaming-concepts/#what-to-know-about-protobuf-streams)**. **`.proto` sources and generated Go types** live under **[Bitquery Streaming Protobuf](https://github.com/bitquery/streaming_protobuf)** (Solana tree: [`solana/`](https://github.com/bitquery/streaming_protobuf/tree/main/solana)); this sample imports **`github.com/bitquery/streaming_protobuf/v2/solana/messages`**. -**Default wire security:** **SASL** (**SCRAM-SHA-512**) over **Kafka without TLS** on port **9092** (`SASL_PLAINTEXT`). Optional **TLS** is **`SASL_SSL`** on **9093** with PEM files—see **[SSL (SASL_SSL)](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/#ssl-connection-sasl_ssl-)**. The minimal example does not enable TLS until you extend **[`kafka.ConfigMap`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/go-consumer-example/main.go)**. +**Default wire security:** **SASL** (**SCRAM-SHA-512**) over **Kafka without TLS** on port **9092** (`SASL_PLAINTEXT`). Optional **TLS** is **`SASL_SSL`** on **9093** with PEM files—see **[SSL (SASL_SSL)](/docs/streams/kafka-streaming-concepts/#ssl-connection-sasl_ssl-)**. The minimal example does not enable TLS until you extend **[`kafka.ConfigMap`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/go-consumer-example/main.go)**. -> **Scaling:** The repository consumer is intentionally small. For production throughput, use **parallel partition readers**, **queues**, and/or **multiple consumer instances in the same group**, per Bitquery’s partition guidance in **[Kafka streaming concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/)**. A larger **Go** reference (YAML, partitioned consumers, worker-style processing) remains **[`stream_protobuf_example`](https://github.com/bitquery/stream_protobuf_example)**—a **different** layout than `go-consumer-example`. +> **Scaling:** The repository consumer is intentionally small. For production throughput, use **parallel partition readers**, **queues**, and/or **multiple consumer instances in the same group**, per Bitquery’s partition guidance in **[Kafka streaming concepts](/docs/streams/kafka-streaming-concepts/)**. A larger **Go** reference (YAML, partitioned consumers, worker-style processing) remains **[`stream_protobuf_example`](https://github.com/bitquery/stream_protobuf_example)**—a **different** layout than `go-consumer-example`. ### Prerequisites | # | Requirement | | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| 1 | **Bitquery Kafka access** — username and password for streams ([access](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/#how-to-get-access-to-these-streams)). | +| 1 | **Bitquery Kafka access** — username and password for streams ([access](/docs/streams/kafka-streaming-concepts/#how-to-get-access-to-these-streams)). | | 2 | **Authorized topic** — default **`solana.transactions.proto`**; your contract must include the topic you set. | | 3 | **Go** **1.23+** — see [`go.mod`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/go-consumer-example/go.mod). | | 4 | **`confluent-kafka-go/v2`** with **CGO** and system **`librdkafka`** (e.g. macOS: `brew install librdkafka pkg-config`; Debian/Ubuntu: `librdkafka-dev`, `pkg-config`, `gcc`). | @@ -119,7 +118,7 @@ Updating **`KAFKA_TOPIC`** only works when the topic still decodes as **`ParsedI ## TLS (optional) -Follow **[SASL_SSL](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/#ssl-connection-sasl_ssl-)** and extend **`kafka.ConfigMap`** (and broker list, usually **9093**). PEM filenames and fetch commands are summarized in the **[examples repository `README.md`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/README.md)** and **[`kafka-consumer-example`](https://github.com/bitquery/kafka-consumer-example)**. +Follow **[SASL_SSL](/docs/streams/kafka-streaming-concepts/#ssl-connection-sasl_ssl-)** and extend **`kafka.ConfigMap`** (and broker list, usually **9093**). PEM filenames and fetch commands are summarized in the **[examples repository `README.md`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/README.md)** and **[`kafka-consumer-example`](https://github.com/bitquery/kafka-consumer-example)**. ## Troubleshooting @@ -132,5 +131,5 @@ Follow **[SASL_SSL](https://docs.bitquery.io/docs/streams/kafka-streaming-concep ## See also -- **[Kafka streaming concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/)** +- **[Kafka streaming concepts](/docs/streams/kafka-streaming-concepts/)** - **[`stream_protobuf_example`](https://github.com/bitquery/stream_protobuf_example)** — optional advanced Go sample (not the same as `go-consumer-example`). diff --git a/docs/streams/protobuf/kafka-protobuf-js.md b/docs/streams/protobuf/kafka-protobuf-js.md index c161803f..5c609d8a 100644 --- a/docs/streams/protobuf/kafka-protobuf-js.md +++ b/docs/streams/protobuf/kafka-protobuf-js.md @@ -3,20 +3,19 @@ slug: kafka-protobuf-js sidebar_position: 4 sidebar_label: Javascript Tutorial to Setup Solana Kafka Shred Stream title: Javascript Tutorial to Setup Solana Kafka Shred Stream -description: Use Node.js, KafkaJS, LZ4, and bitquery-protobuf-schema to consume Bitquery Solana Kafka protobuf; run js-consumer-example from kafka-streams-examples-usecases. +description: "Javascript Tutorial to Setup Solana Kafka Shred Stream with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading systems." --- - # Javascript Tutorial to Setup Solana Kafka Shred Stream This tutorial explains how to consume **Solana** protobuf messages from **Bitquery Kafka** using **JavaScript** (Node.js **CommonJS** — not a browser bundle), and print them with **`bytes`** fields decoded to **base58** where **`printProtobufMessage`** applies that encoding. -**Streaming concepts:** **[Kafka streaming concepts — Protobuf streams](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/#protobuf-streams)**. +**Streaming concepts:** **[Kafka streaming concepts — Protobuf streams](/docs/streams/kafka-streaming-concepts/#what-to-know-about-protobuf-streams)**. **Runnable project:** **[`bitquery/kafka-streams-examples-usecases`](https://github.com/bitquery/kafka-streams-examples-usecases)** — **[`js-consumer-example/`](https://github.com/bitquery/kafka-streams-examples-usecases/tree/main/js-consumer-example)** ([`src/index.js`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/js-consumer-example/src/index.js), [`src/config.js`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/js-consumer-example/src/config.js), [`package.json`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/js-consumer-example/package.json)). Use **[`bitquery-protobuf-schema npm Package`](https://www.npmjs.com/package/bitquery-protobuf-schema)** so you do **not** hand-manage `.proto` files—the package resolves the schema from **`KAFKA_TOPIC`**. -> **Throughput:** Treat this repo as a **minimal** consumer. Saturating high-volume topics typically requires tuning **KafkaJS** parallelism, **partition-aware** runners, or **multiple consumers under one consumer group**. See **[Kafka streaming concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/)** for partition-oriented guidance. +> **Throughput:** Treat this repo as a **minimal** consumer. Saturating high-volume topics typically requires tuning **KafkaJS** parallelism, **partition-aware** runners, or **multiple consumers under one consumer group**. See **[Kafka streaming concepts](/docs/streams/kafka-streaming-concepts/)** for partition-oriented guidance. ## Prerequisites @@ -94,7 +93,7 @@ KafkaJS timeouts in code: **`connectionTimeout: 10_000`**, **`requestTimeout: 60 6. **Compression** — LZ4 codec registered for Kafka compression on the wire. 7. **Errors** — caught per message where possible; fatal errors exit non-zero. -**TLS:** baseline is **plaintext Kafka** on **9092**. For **`SASL_SSL`**, populate KafkaJS **`ssl`** objects and migrate brokers per **[Kafka streaming concepts — SASL_SSL](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/#ssl-connection-sasl_ssl-)** plus **`js-consumer-example/README.md`**. +**TLS:** baseline is **plaintext Kafka** on **9092**. For **`SASL_SSL`**, populate KafkaJS **`ssl`** objects and migrate brokers per **[Kafka streaming concepts — SASL_SSL](/docs/streams/kafka-streaming-concepts/#ssl-connection-sasl_ssl-)** plus **`js-consumer-example/README.md`**. ## Clone and run (quick reference) @@ -127,4 +126,4 @@ npm run start:debug ## See also - **[bitquery-protobuf-schema (npm package)](https://www.npmjs.com/package/bitquery-protobuf-schema)** -- **[Kafka streaming concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/)** +- **[Kafka streaming concepts](/docs/streams/kafka-streaming-concepts/)** diff --git a/docs/streams/protobuf/kafka-protobuf-python.md b/docs/streams/protobuf/kafka-protobuf-python.md index 8f1c7f62..8d4e71c6 100644 --- a/docs/streams/protobuf/kafka-protobuf-python.md +++ b/docs/streams/protobuf/kafka-protobuf-python.md @@ -3,18 +3,17 @@ slug: kafka-protobuf-python sidebar_position: 3 sidebar_label: Python Tutorial to use Solana Shreds from Kafka title: Python Tutorial to use Solana Shreds from Kafka -description: Consume Bitquery Kafka Solana protobuf from Python with confluent_kafka and bitquery-pb2-kafka-package; run python-consumer-example from kafka-streams-examples-usecases. +description: "Python Tutorial to use Solana Shreds from Kafka with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading systems." --- - # Python Tutorial to use Solana Shreds from Kafka This tutorial explains how to consume **Solana** transaction protobuf messages from **Bitquery Kafka** using **Python**, and print them with **`bytes`** fields shown in **base58** (pipe-friendly **stdout**; logs on **stderr**). -Background: **[Kafka streaming concepts — Protobuf streams](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/#protobuf-streams)**. +Background: **[Kafka streaming concepts — Protobuf streams](/docs/streams/kafka-streaming-concepts/#what-to-know-about-protobuf-streams)**. **Runnable project:** **[`bitquery/kafka-streams-examples-usecases`](https://github.com/bitquery/kafka-streams-examples-usecases)** — folder **[`python-consumer-example/`](https://github.com/bitquery/kafka-streams-examples-usecases/tree/main/python-consumer-example)** ([`consumer.py`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/python-consumer-example/consumer.py), [`settings.py`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/python-consumer-example/settings.py), [`protobuf_print.py`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/python-consumer-example/protobuf_print.py)). -> **Scaling:** This sample is a single process. For high throughput, add **parallel partition consumption** and/or **worker pools** behind the poll loop, following Bitquery’s Kafka guidance in **[Kafka streaming concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/)**. +> **Scaling:** This sample is a single process. For high throughput, add **parallel partition consumption** and/or **worker pools** behind the poll loop, following Bitquery’s Kafka guidance in **[Kafka streaming concepts](/docs/streams/kafka-streaming-concepts/)**. ## Prerequisites @@ -109,7 +108,7 @@ python consumer.py ## TLS (optional) -Extend the **`conf`** dict from **`settings.py`** using Bitquery’s **[SASL_SSL](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/#ssl-connection-sasl_ssl-)** snippet (brokers **9093**, PEM paths). Summary and **`curl`** for PEMs: **[examples repo `README.md`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/README.md)**. +Extend the **`conf`** dict from **`settings.py`** using Bitquery’s **[SASL_SSL](/docs/streams/kafka-streaming-concepts/#ssl-connection-sasl_ssl-)** snippet (brokers **9093**, PEM paths). Summary and **`curl`** for PEMs: **[examples repo `README.md`](https://github.com/bitquery/kafka-streams-examples-usecases/blob/main/README.md)**. ## Troubleshooting @@ -123,4 +122,4 @@ Extend the **`conf`** dict from **`settings.py`** using Bitquery’s **[SASL_SSL ## See also - **[bitquery-pb2-kafka-package (PyPI)](https://pypi.org/project/bitquery-pb2-kafka-package/)** -- **[Kafka streaming concepts](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/)** +- **[Kafka streaming concepts](/docs/streams/kafka-streaming-concepts/)** diff --git a/docs/streams/protobuf/kafka-trading-topics-protobuf.md b/docs/streams/protobuf/kafka-trading-topics-protobuf.md index d3400617..838deca6 100644 --- a/docs/streams/protobuf/kafka-trading-topics-protobuf.md +++ b/docs/streams/protobuf/kafka-trading-topics-protobuf.md @@ -2,9 +2,8 @@ sidebar_position: 5 sidebar_label: Multi-Chain Trading Data Streams title: Multi-Chain Trading Data Streams (Protobuf) -description: Kafka topics trading.prices and trading.trades—not tied to one network. Credentials, docs links, and schema references match Kafka streaming concepts. +description: "Multi-Chain Trading Data Streams (Protobuf) with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading systems." --- - # Multi-Chain Trading Data Streams (Protobuf) Broker setup, SASL authentication, consumer groups, and general Kafka behavior are covered in **[Bitquery Kafka Streams — Understanding Concepts](/docs/streams/kafka-streaming-concepts)**. @@ -15,7 +14,7 @@ All Kafka topics documented there deliver messages in **protobuf** format (JSON The **`trading`** namespace defines two Kafka topics. **Both use the same credentials** as your subscription: -- **`trading.prices`** — Multi-chain [Price Index Streams](https://docs.bitquery.io/docs/trading/price-index/introduction/). See the [Crypto Price API](/docs/trading/crypto-price-api/introduction) for usage. +- **`trading.prices`** — Multi-chain [Price Index Streams](/docs/trading/crypto-price-api/introduction/). See the [Crypto Price API](/docs/trading/crypto-price-api/introduction) for usage. - **`trading.trades`** — Real-time DEX trades aligned with the [Crypto Trades API](/docs/trading/crypto-trades-api/trades-api). Message structure is defined in [`market/trades.proto`](https://github.com/bitquery/streaming_protobuf/blob/main/market/trades.proto) in [Bitquery Streaming Protobuf](https://github.com/bitquery/streaming_protobuf). ## See also diff --git a/docs/streams/real-time-indexer-with-kafka-stream.md b/docs/streams/real-time-indexer-with-kafka-stream.md index 5d117a50..7f8216e3 100644 --- a/docs/streams/real-time-indexer-with-kafka-stream.md +++ b/docs/streams/real-time-indexer-with-kafka-stream.md @@ -1,7 +1,8 @@ --- sidebar_position: 2 +title: "Real Time Indexer With Kafka Stream" +description: "Real Time Indexer With Kafka Stream with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading systems." --- - # Real-Time Blockchain Indexer: Build Reliable Indexers with Kafka Streams Instead of Archive Nodes, gRPC, or Webhook Services Building a real-time blockchain indexer is one of the most challenging infrastructure tasks in the process of tracking trades, monitoring token transfers, parsing internal calls, or building a comprehensive on-chain analytics platform. If you decide to run your own archive node, you need to plan for big SSD storage (multiple TBs), fast disks / high IOPS, and robust backup/monitoring. If not, you might be looking for need reliable, low-latency access to blockchain data at scale. @@ -195,7 +196,7 @@ Build robust indexing pipelines that: Building a real-time indexer with Bitquery's Kafka streams is straightforward: 1. **Get Kafka Access**: Contact Bitquery sales by filling the [form on the website](https://bitquery.io/forms/api) for Kafka credentials -2. **Choose Your Topics**: Select the topics that match your indexing needs. List is available [here](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/#complete-list-of-topics) +2. **Choose Your Topics**: Select the topics that match your indexing needs. List is available [here](/docs/streams/kafka-streaming-concepts/#complete-list-of-topics) 3. **Set Up Consumers**: Create Kafka consumers with proper offset management 4. **Process Messages**: Parse protobuf messages and update your index 5. **Handle Failures**: Use Bitquery Kafka's 24-hour retention to recover from crashes diff --git a/docs/streams/real-time-solana-data.md b/docs/streams/real-time-solana-data.md index 68f6a22d..10f90df2 100644 --- a/docs/streams/real-time-solana-data.md +++ b/docs/streams/real-time-solana-data.md @@ -1,3 +1,7 @@ +--- +title: "Real Time Solana Data" +description: "Real Time Solana Data with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading systems. See examples in the Bitquery IDE." +--- # The Need for Real-Time Data on Solana: Latency, Scale, and Fidelity at Stake > “Better be first 99 percent of the time than second 100 percent of the time.” @@ -39,14 +43,14 @@ Filtering options are basic, so you may process much more data than you need, dr People are asking questions on Stack Exchange about custom filtering options in Geyser, which Bitquery provides with just too much ease. **[Ref 1:](https://solana.stackexchange.com/questions/9779/geyser-support-for-events)** -![Stack Exchange question on Geyser Filtering - 1](../../static/img/streams/question-1-streams.png) +![Stack Exchange question on Geyser Filtering - 1](/img/streams/question-1-streams.png) **[Ref 2:](https://solana.stackexchange.com/questions/18663/how-to-filter-raydium-pool-with-geyser)** -![Stack Exchange question on Geyser Filtering - 2](../../static/img/streams/question-2-streams.png) +![Stack Exchange question on Geyser Filtering - 2](/img/streams/question-2-streams.png) ## Bitquery: A Powerful Alternative -Bitquery offers a powerful real-time streaming system with three interfaces: **GraphQL Subscriptions**, **Kafka**, and **gRPC (CoreCast)**. You can learn more about the differences and benefits of each in the [Bitquery documentation](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/). For ultra-low-latency gRPC streams (DEX trades, transfers, transactions), see [Solana gRPC Streams (CoreCast) →](https://docs.bitquery.io/docs/grpc/solana/introduction/). +Bitquery offers a powerful real-time streaming system with three interfaces: **GraphQL Subscriptions**, **Kafka**, and **gRPC (CoreCast)**. You can learn more about the differences and benefits of each in the [Bitquery documentation](/docs/streams/kafka-streaming-concepts/). For ultra-low-latency gRPC streams (DEX trades, transfers, transactions), see [Solana gRPC Streams (CoreCast) →](/docs/grpc/solana/introduction/). - **No Infra Needed**: You don’t need to run your own Solana node. Just use the Bitquery endpoint—no server costs, setup, or upgrades. - **Powerful Filtering**: Use GraphQL’s expressive filters to get only the data you need (by address, token, program, amount, and more). No more sifting through irrelevant noise. @@ -78,15 +82,15 @@ You can test these queries live on the [Bitquery IDE](https://ide.bitquery.io/). Create targeted data streams for specific use cases: -- [Monitor 100 specific wallet addresses](https://docs.bitquery.io/docs/usecases/monitoring-solana-at-scale-managing-hundreds-of-addresses/) for whale tracking and large transaction alerts -- Custom token streams filtering by specific programs, amounts, or trading pairs. For eg: [track newly created pump fun tokens](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/#track-newly-created-pump-fun-tokens-creation-time-dev-address-metadata) +- [Monitor 100 specific wallet addresses](/docs/usecases/monitoring-solana-at-scale-managing-hundreds-of-addresses/) for whale tracking and large transaction alerts +- Custom token streams filtering by specific programs, amounts, or trading pairs. For eg: [track newly created pump fun tokens](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/#how-do-i-get-newly-created-pumpfun-tokens) - Focus processing power only on relevant data, reducing costs and complexity ## Kafka Stream by Bitquery Bitquery’s Kafka streams are a unique product that provides ultra-low latency data directly from blockchain. Here are some key features. -**[Bitquery offers three main Kafka streams](https://docs.bitquery.io/docs/streams/protobuf/chains/Solana-protobuf/)**: +**[Bitquery offers three main Kafka streams](/docs/streams/protobuf/chains/Solana-protobuf/)**: - `solana.dextrades.proto` — Includes all trade and liquidity pool change data. - `solana.tokens.proto` — Covers token transfers, supply changes, and balance updates at both the account and instruction level. @@ -124,15 +128,15 @@ Bitquery’s Kafka streams are a unique product that provides ultra-low latency Kafka streams deliver sub-second latency, crucial for high-frequency trading where Solana processes $25+ billion in daily volume. Access to unconfirmed transactions provides early market signals before block finalization. Latency goes to as low as 4–5ms. -![Kafka Latency Go test results](../../static/img/streams/kafka-latency-go-test.png) +![Kafka Latency Go test results](/img/streams/kafka-latency-go-test.png) ### Enterprise Scalability Kafka's distributed architecture handles massive throughput with built-in replication and automatic failover. Scale from thousands to millions of transactions per second without infrastructure management. -Read this tutorial on [how to use Bitquery’s Kafka Streams to monitor millions of Solana wallet balances](https://docs.bitquery.io/docs/usecases/track-millions-of-solana-wallets/). +Read this tutorial on [how to use Bitquery’s Kafka Streams to monitor millions of Solana wallet balances](/docs/usecases/track-millions-of-solana-wallets/). -Also, check out how you can [track withdrawals and deposits for 1000s of Binance exchange wallets](https://docs.bitquery.io/docs/usecases/binance-exchange-wallet-monitoring/). +Also, check out how you can [track withdrawals and deposits for 1000s of Binance exchange wallets](/docs/usecases/binance-exchange-wallet-monitoring/). ### Development Efficiency diff --git a/docs/streams/sniper-trade-using-bitquery-kafka-stream.md b/docs/streams/sniper-trade-using-bitquery-kafka-stream.md index 0c853d76..789e8c98 100644 --- a/docs/streams/sniper-trade-using-bitquery-kafka-stream.md +++ b/docs/streams/sniper-trade-using-bitquery-kafka-stream.md @@ -1,6 +1,10 @@ +--- +title: "Building a Trading Bot Using Bitquery Kafka Streams" +description: "Building a Trading Bot Using Bitquery Kafka Streams with Bitquery Kafka and protobuf streams for low-latency blockchain ingestion in trading systems." +--- # Building a Trading Bot Using Bitquery Kafka Streams -This is a tutorial to build a fast, automated BSC (Binance Smart Chain) sniper bot for trading newly launched Four Meme tokens. The bot **detects new token launches in real time via [Bitquery’s Kafka streams](https://docs.bitquery.io/docs/streams/kafka-streaming-concepts/)**, buys them instantly using the Four Meme Launchpad contract, and sells them after 1 minute—aiming to capitalize on rapid price movements. +This is a tutorial to build a fast, automated BSC (Binance Smart Chain) sniper bot for trading newly launched Four Meme tokens. The bot **detects new token launches in real time via [Bitquery’s Kafka streams](/docs/streams/kafka-streaming-concepts/)**, buys them instantly using the Four Meme Launchpad contract, and sells them after 1 minute—aiming to capitalize on rapid price movements. Checkout the complete codebase [here](https://github.com/bitquery/sniper-bot-bsc) if facing any issue. @@ -24,7 +28,7 @@ import VideoPlayer from "../../src/components/videoplayer.js"; ## Final Output -![output](../../static/img/sniper_bot_bsc.gif) + --- @@ -439,7 +443,6 @@ pm2 logs evm-sniper - Gas fees and front-running risks exist on BSC—proceed at your own risk. - Code is for educational and research purposes only. - ## Video Tutorial - \ No newline at end of file + diff --git a/docs/subscriptions/aws/s3_tutorial.md b/docs/subscriptions/aws/s3_tutorial.md index cc56e6ec..7b1ad57d 100644 --- a/docs/subscriptions/aws/s3_tutorial.md +++ b/docs/subscriptions/aws/s3_tutorial.md @@ -1,3 +1,7 @@ +--- +title: "Using Bitquery Subscriptions to Load On-chain Data into S3" +description: "Using Bitquery Subscriptions to Load On-chain Data into S3 using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring." +--- # Using Bitquery Subscriptions to Load On-chain Data into S3 In this tutorial we will use Bitquery Subscription queries to fetch latest Pumpfun information on Solana upload it to an S3 Bucket. @@ -9,7 +13,7 @@ In this tutorial we will use Bitquery Subscription queries to fetch latest Pumpf Before diving into the tutorial, ensure you have: 1. **AWS Account**: With access to an S3 bucket and all permissions configured for Write Access. -2. **Bitquery Account**: For generating a token to access the Streaming APIs. Follow [this link](https://docs.bitquery.io/docs/authorisation/how-to-generate/) for token generation. +2. **Bitquery Account**: For generating a token to access the Streaming APIs. Follow [this link](/docs/authorization/how-to-generate/) for token generation. 3. **Python Environment**: With required libraries installed. Install required libraries if not already done: @@ -50,7 +54,7 @@ import websockets url = "wss://streaming.bitquery.io/eap?token=your_bitquery_token" ``` -- Replace `your_bitquery_token` with the token generated from Bitquery ([guide](https://docs.bitquery.io/docs/authorisation/how-to-generate/)). +- Replace `your_bitquery_token` with the token generated from Bitquery ([guide](/docs/authorization/how-to-generate/)). #### **4. Writing the Subscription Query** @@ -93,7 +97,7 @@ subscription MyQuery { """ ``` -You can find more queries here: [Solana Pump Fun API](https://docs.bitquery.io/docs/blockchain/Solana/Pump-Fun-API/). +You can find more queries here: [Solana Pump Fun API](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API/). #### **5. Fetching and Uploading Data** diff --git a/docs/subscriptions/backfilling-subscription.md b/docs/subscriptions/backfilling-subscription.md index 5c4af85b..da6dba71 100644 --- a/docs/subscriptions/backfilling-subscription.md +++ b/docs/subscriptions/backfilling-subscription.md @@ -1,20 +1,9 @@ --- title: "Backfill Data After WebSocket Disconnect - Python Tutorial" -description: "Python tutorial: backfill missing data when WebSocket disconnects. Handle reconnections, query historical gaps, and gracefully close Bitquery streams." +description: "Backfill Data After WebSocket Disconnect - Python Tutorial using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring." sidebar_position: 6 keywords: ["backfill subscription", "WebSocket disconnection", "Bitquery Python", "GraphQL backfill", "stream reconnection"] --- - - - - - - - - - - - # How to Backfill Data After a WebSocket Disconnection in Python In this section, we'll discuss potential approaches to backfill data when stream disconnects. We will write code to receive live data, handles potential errors and disconnections, backfills any missing data during downtime, and ensures a graceful closure of connections. @@ -32,7 +21,6 @@ In this tutorial, we'll build a system that: We'll use Python's `asyncio` for asynchronous operations, the `gql` library for GraphQL interactions, and the `requests` library for HTTP requests. - ## Prerequisites Before diving into the implementation, ensure you have the following: @@ -532,7 +520,6 @@ Backfilled Data: {...} # Historical data fetched to fill the gap ## Alternative Approach: Using Block Heights to Backfill Data You can implement an alternative approach that uses block heights instead of relying on time periods. - 1. **Track the Last Processed Block Height**: Continuously update and save the latest block height received from the live data stream. 2. **Detect Disconnections**: Monitor the WebSocket connection for any interruptions. 3. **Backfill Missing Data**: Using historical query, use the last saved block height to query and retrieve data from the missed blocks. diff --git a/docs/subscriptions/example-rust.md b/docs/subscriptions/example-rust.md index 51760f4d..c6a01407 100644 --- a/docs/subscriptions/example-rust.md +++ b/docs/subscriptions/example-rust.md @@ -1,7 +1,8 @@ --- sidebar_position: 5 +title: "Building with WebSockets: Code Sample in Rust" +description: "Building with WebSockets: Code Sample in Rust using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring." --- - # Building with WebSockets: Code Sample in Rust In this section we will see how to use bitquery subscriptions in Rust. The final output will look something like this @@ -40,7 +41,6 @@ This is the basic outline of what we will do - The `subscribe` function handles the connection setup and starts the streaming operation. - The `main` function initializes the subscription and processes the incoming data. - This Rust code sets up a WebSocket client to subscribe to real-time data from Bitquery Solana APIs using the GraphQL over WebSocket protocol. ### **How Everything Connects** @@ -51,7 +51,6 @@ This Rust code sets up a WebSocket client to subscribe to real-time data from Bi 4. **Tokio Task Spawner (`tokio_spawner.rs`)**: Helps manage background tasks. 5. **Main Function (`main.rs`)**: Sets up and runs our application. - ### **TokioSpawner Module** Let's create a `TokioSpawner` module responsible for handling task execution within the Tokio runtime. It allows tasks to be spawned asynchronously within the WebSocket client. @@ -212,10 +211,9 @@ This function sets up a WebSocket connection to the Bitquery streaming endpoint. 6. **Return Client and Stream**: - Return the client and the stream of data. - ### Main Function -In this function we will pass the OAuth token. The best practise would be to include it as an environment variable, but for the sake of this tutorial it has been hard coded. You can generate a token [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +In this function we will pass the OAuth token. The best practice would be to include it as an environment variable, but for the sake of this tutorial it has been hard coded. You can generate a token [here](/docs/authorization/how-to-generate/) #### Imports ```rust @@ -252,7 +250,6 @@ pub type DexTradesVariables = queries::dex_trades::Variables; ``` Defines type aliases for the GraphQL query and variables. - ```rust #[tokio::main] async fn main() -> Result<()> { @@ -285,8 +282,6 @@ This is the entry point of the application. - Iterate over the stream of incoming responses. - Print each response using `dbg!`. - - ### 4. Run the Project With everything set up, you can now build and run your project: diff --git a/docs/subscriptions/examples.md b/docs/subscriptions/examples.md index d2d907bb..2916eb75 100644 --- a/docs/subscriptions/examples.md +++ b/docs/subscriptions/examples.md @@ -1,15 +1,16 @@ --- sidebar_position: 4 +title: "Building with WebSockets" +description: "Building with WebSockets using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring." --- - # Building with WebSockets: Code Samples in Python & JavaScript This section provides examples of how to implement subscription queries in your code. -**Remember: You need to implement logic to handle silent disconnect( when no data or keep-alive is received for say X seconds) in your code. Sample [here](https://docs.bitquery.io/docs/subscriptions/silent-disconnect-reconnect/)**. +**Remember: You need to implement logic to handle silent disconnect( when no data or keep-alive is received for say X seconds) in your code. Sample [here](/docs/subscriptions/silent-disconnect-reconnect/)**. ## How do I subscribe to live DEX trades using Bitquery WebSocket? {#how-do-i-subscribe-to-live-dex-trades-using-bitquery-websocket} -Use Bitquery’s **GraphQL over WebSocket**: connect to [`wss://streaming.bitquery.io/graphql`](https://docs.bitquery.io/docs/subscriptions/websockets/) with the **`graphql-ws`** or **`graphql-transport-ws`** subprotocol, authenticate as described in [WebSocket authorisation](https://docs.bitquery.io/docs/authorisation/websocket/), then send a **`subscription`** whose root field is your chain API (for example `EVM` or `Solana`) and a **`DEXTrades`** selection. Each new trade matching your `where` clause is pushed as a message. Test the subscription in the [Bitquery IDE](https://ide.bitquery.io) by changing the operation from `query` to `subscription`, then reuse the same document in your client. +Use Bitquery’s **GraphQL over WebSocket**: connect to [`wss://streaming.bitquery.io/graphql`](/docs/subscriptions/websockets/) with the **`graphql-ws`** or **`graphql-transport-ws`** subprotocol, authenticate as described in [WebSocket authorization](/docs/authorization/websocket/), then send a **`subscription`** whose root field is your chain API (for example `EVM` or `Solana`) and a **`DEXTrades`** selection. Each new trade matching your `where` clause is pushed as a message. Test the subscription in the [Bitquery IDE](https://ide.bitquery.io) by changing the operation from `query` to `subscription`, then reuse the same document in your client. The GraphQL document is the same whether you run it from Python, JavaScript, or any other client; only the WebSocket wiring differs (see the sections below). @@ -47,7 +48,7 @@ subscription LiveDexTrades { } ``` -Narrow results with a `where` argument on `DEXTrades` (specific pair, DEX, USD size, and so on) using the same [filter syntax](https://docs.bitquery.io/docs/graphql/filters/) as queries. For more BSC examples and IDE links, see [BSC DEX Trades](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades/); for Solana, see [Solana DEX Trades](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/). A saved BSC stream you can open in the IDE: [Subscribe to BSC DEX trades](https://ide.bitquery.io/subscribe-to-bsc-dex-trades). +Narrow results with a `where` argument on `DEXTrades` (specific pair, DEX, USD size, and so on) using the same [filter syntax](/docs/graphql/filters/) as queries. For more BSC examples and IDE links, see [BSC DEX Trades](/docs/blockchain/BSC/bsc-dextrades/); for Solana, see [Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades/). A saved BSC stream you can open in the IDE: [Subscribe to BSC DEX trades](https://ide.bitquery.io/subscribe-to-bsc-dex-trades). ## Implementation Example: Using WebSocket Using Python @@ -59,7 +60,6 @@ import asyncio from gql import Client, gql from gql.transport.websockets import WebsocketsTransport - async def main(): transport = WebsocketsTransport( url="wss://streaming.bitquery.io/graphql?token=ory_at_...", @@ -98,18 +98,16 @@ async def main(): await transport.close() #this sends complete message to server before closing websocket print("Transport closed") - # Run the asyncio event loop asyncio.run(main()) - ``` The `transport.connect()` function is used to establish a connection to the WebSocket server and start the subscription. Similarly, `transport.close()` is used to close the connection and stop the subscription after 100 seconds. -## Implementation Example:Using WebSocket Using JavaScript +## Implementation Example: Using WebSocket Using JavaScript {#implementation-exampleusing-websocket-using-javascript} -Open any online code editor and use this JavaScript code to use the websocket. Starting January you need to use OAuth to use the V2 APIs. Read more [here](https://docs.bitquery.io/docs/authorisation/websocket/) +Open any online code editor and use this JavaScript code to use the websocket. Starting January you need to use OAuth to use the V2 APIs. Read more [here](/docs/authorization/websocket/) ```javascript const { WebSocket } = require("ws"); diff --git a/docs/subscriptions/google-bigquery/bigquery.md b/docs/subscriptions/google-bigquery/bigquery.md index bfaf53e4..8068044d 100644 --- a/docs/subscriptions/google-bigquery/bigquery.md +++ b/docs/subscriptions/google-bigquery/bigquery.md @@ -1,8 +1,11 @@ +--- +title: "Filing Data into Google BigQuery" +description: "Filing Data into Google BigQuery using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring." +--- # Filing Data into Google BigQuery In this part, we'll demonstrate how to set up Google BigQuery to store data from Google Pub/Sub. The incoming data will be stored in a BigQuery table called `newtrades`. We'll go step-by-step, covering table creation, schema definition, and configuring Pub/Sub to write directly to BigQuery. - ### 1. Create a Table and Define the Schema #### Create a Dataset @@ -110,4 +113,3 @@ python bitquery_pubsub.py - Use SQL queries to analyze trends in the trade data. - Automate data pipelines using Google Cloud Dataflow or scheduled BigQuery queries. - diff --git a/docs/subscriptions/google-bigquery/intro.mdx b/docs/subscriptions/google-bigquery/intro.mdx index 39056679..db0269b4 100644 --- a/docs/subscriptions/google-bigquery/intro.mdx +++ b/docs/subscriptions/google-bigquery/intro.mdx @@ -1,3 +1,7 @@ +--- +title: "BigQuery Blockchain Data Intro" +description: "Getting Started using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring. Run it in the IDE, then ship in your app." +--- # Getting Started In this section, we will see how to set up a pipeline using Bitquery real-time GraphQL subscriptions. diff --git a/docs/subscriptions/google-bigquery/pub-sub.md b/docs/subscriptions/google-bigquery/pub-sub.md index 38a54e53..f9fe057b 100644 --- a/docs/subscriptions/google-bigquery/pub-sub.md +++ b/docs/subscriptions/google-bigquery/pub-sub.md @@ -1,3 +1,7 @@ +--- +title: "Setting up Google Pub-Sub" +description: "Setting up Google Pub-Sub using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring." +--- # Setting up Google Pub-Sub This tutorial walks through a process of subscribing to the Bitquery Streaming API and publishing its data to a Google Cloud Pub/Sub topic. @@ -17,7 +21,6 @@ This tutorial walks through a process of subscribing to the Bitquery Streaming A - Click on the topic and create a subscription (e.g., `test1d`). - Choose Pull or Push, depending on your architecture. - 3. Service Account Configuration: - Create a service account with the role `Pub/Sub Publisher`. - Download the service account key as `key.json`. @@ -54,7 +57,7 @@ os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "key.json" #### Bitquery WebSocket API Details -Configure the WebSocket URL and the query to fetch Pumpfun DEX trades. To learn how to generate a token to use with the url, go [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +Configure the WebSocket URL and the query to fetch Pumpfun DEX trades. To learn how to generate a token to use with the url, go [here](/docs/authorization/how-to-generate/) ```python url = "wss://streaming.bitquery.io/eap?token=" diff --git a/docs/subscriptions/mempool-subscriptions.md b/docs/subscriptions/mempool-subscriptions.md index 16dd3423..c2e5aa18 100644 --- a/docs/subscriptions/mempool-subscriptions.md +++ b/docs/subscriptions/mempool-subscriptions.md @@ -1,8 +1,8 @@ --- sidebar_position: 5 +title: "Subscribing to Mempool Updates" +description: "Subscribing to Mempool Updates using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring." --- - - # Subscribing to Mempool Updates The Mempool API allows you to access real-time data from the mempool for EVM chains including Ethereum, and BNB chains. You can use this API to monitor transactions, token trades, transfers, and any data stored in the mempool. Check examples [in this page](/docs/blockchain/Ethereum/mempool/mempool-api/). diff --git a/docs/subscriptions/silent-disconnect-reconnect.md b/docs/subscriptions/silent-disconnect-reconnect.md index c9509135..7abb7728 100644 --- a/docs/subscriptions/silent-disconnect-reconnect.md +++ b/docs/subscriptions/silent-disconnect-reconnect.md @@ -1,3 +1,7 @@ +--- +title: "Reconnect Automatically After Disconnect" +description: "Reconnect Automatically After Disconnect using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring." +--- # Reconnect Automatically After Disconnect When using Bitquery GraphQL streams via WebSocket, you need to implement reconnect logic if you don't receive any data or a 'ka' message for, say, 10 seconds. diff --git a/docs/subscriptions/subscription.md b/docs/subscriptions/subscription.md index a607b8ed..16c7def8 100644 --- a/docs/subscriptions/subscription.md +++ b/docs/subscriptions/subscription.md @@ -1,7 +1,8 @@ --- sidebar_position: 1 +title: "GraphQL Subscriptions Guide" +description: "GraphQL Subscriptions Guide using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring." --- - # What is a Subscription? Subscription is defined by the subscription type of GraphQL request: @@ -14,7 +15,7 @@ subscription { } ``` -![Export code](/img/ide/ide_subscription.gif) + Almost any query can be converted to subscription just by replacing `query` type to `subscription`. @@ -28,9 +29,9 @@ When creating queries for GraphQL subscriptions, here are some tips to consider: 4. **Modifying Subscriptions Does Not Work**: If you try to modify a running subscription, it will end the subscription. -In addition, optimizing your queries can significantly enhance the performance of your subscriptions. For more insights on how to optimize your websocket queries, go [here](/docs/graphql/optimizing-graphql-queries.md). +In addition, optimizing your queries can significantly enhance the performance of your subscriptions. For more insights on how to optimize your websocket queries, go [here](/docs/graphql/optimizing-graphql-queries/). -Subscriptions are also priced using our point-based system. Read about it [here](/docs/ide/points.md) +Subscriptions are also priced using our point-based system. Read about it [here](/docs/ide/points/) ## Default Parameters (GraphQL v2) @@ -42,7 +43,7 @@ GraphQL v2 applies the following default to subscriptions. You can override it b Each subscription message returns at most 800 items by default. Override this by specifying a different `limit` in your subscription filters if you need a different batch size. -For **default success and other filters** (e.g. only successful transactions, calls, events, transfers, DEX trades; Trade API defaults), see [Default filters (GraphQL v2)](/docs/graphql/query.md#default-filters-graphql-v2) in Query Principles. For default limits on **queries**, see [Limits](/docs/graphql/limits.md). +For **default success and other filters** (e.g. only successful transactions, calls, events, transfers, DEX trades; Trade API defaults), see [Default filters (GraphQL v2)](/docs/graphql/query/#default-filters-graphql-v2) in Query Principles. For default limits on **queries**, see [Limits](/docs/graphql/limits/). ## Creating Multiple Subscriptions in one Websocket diff --git a/docs/subscriptions/trigger.md b/docs/subscriptions/trigger.md index e09725bd..f32235cd 100644 --- a/docs/subscriptions/trigger.md +++ b/docs/subscriptions/trigger.md @@ -1,7 +1,8 @@ --- sidebar_position: 2 +title: "What is a Trigger?" +description: "What is a Trigger? using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring. Keep queries fast with indexed filters." --- - # What is a Trigger? The new data pushed to subscription on receiving the new block in the real time database assuming that the criteria, @@ -26,7 +27,6 @@ It has the following options: In most cases you just not specify this attribute, assuming all option is what you need. Other options are suitable for event-driven applications: - ## Filtering Out All Branch Blocks Even with `trigger_on: head`, you might receive branch blocks. When a blockchain forks, the subscription cannot determine in real time whether the fork selected will become the longest chain (trunk) in the future. At the moment a fork occurs, the system may initially treat a branch block as the head, only to later discover it becomes part of a branch when a longer chain emerges. @@ -45,4 +45,4 @@ Use ```head_updates``` together with ```branches_updates``` when you need to acc :::tip Use ```head``` if you need to listen only head blocks in your application. This can slightly delay the data however, as the new block may need the other block to wait to be detected that it is on the tree. -::: \ No newline at end of file +::: diff --git a/docs/subscriptions/websockets.md b/docs/subscriptions/websockets.md index 8a60042f..2007c0ad 100644 --- a/docs/subscriptions/websockets.md +++ b/docs/subscriptions/websockets.md @@ -1,7 +1,8 @@ --- sidebar_position: 3 +title: "Bitquery WebSocket Subscriptions" +description: "Bitquery WebSocket Subscriptions using Bitquery GraphQL subscriptions over WebSocket for live multi-chain blockchain monitoring." --- - # Accessing Streaming Data via WebSocket In the previous section, we learned how to get live data in Bitquery IDE by creating subscription queries. Now, let's take a closer look at how these live updates actually work and what happens behind the scenes to provide you with this real-time data. @@ -12,12 +13,11 @@ Bitquery makes real-time data available using WebSockets. We use a specific WebS wss://streaming.bitquery.io/graphql ``` -For a **live DEX trades** subscription example (GraphQL document plus BSC/Solana links), see [How do I subscribe to live DEX trades using Bitquery WebSocket?](https://docs.bitquery.io/docs/subscriptions/examples#how-do-i-subscribe-to-live-dex-trades-using-bitquery-websocket). +For a **live DEX trades** subscription example (GraphQL document plus BSC/Solana links), see [How do I subscribe to live DEX trades using Bitquery WebSocket?](/docs/subscriptions/examples#how-do-i-subscribe-to-live-dex-trades-using-bitquery-websocket). ### Limits -You are charged for the number of subscriptions (aka streams) and not for the number of websockets. Read more on pricing for streams [here](https://docs.bitquery.io/docs/ide/points/#how-are-points-calculated-for-subscriptions) - +You are charged for the number of subscriptions (aka streams) and not for the number of websockets. Read more on pricing for streams [here](/docs/ide/points/#1-websocket-subscriptions-graphql) ### Data Handling @@ -25,16 +25,15 @@ It's important to note that for committed blocks, data will come in portions (by **Websockets using Bitquery graphQL streams cannot send "close" messages, only way to end the subscription/stream is to close the websocket** - ## Authorising Websockets -Read [here](https://docs.bitquery.io/docs/authorisation/websocket/) on how to use websockets with OAuth. +Read [here](/docs/authorization/websocket/) on how to use websockets with OAuth. Here is the link to a Postman collection with samples demonstrating how to use the wss endpoint: > [Postman Collection for Examples](https://www.postman.com/interstellar-eclipse-270749/workspace/bitquery) -Continue reading about how to create and use websockets in this [section](https://docs.bitquery.io/docs/subscriptions/subscription/) +Continue reading about how to create and use websockets in this [section](/docs/subscriptions/subscription/) ## Supported Standards @@ -47,8 +46,7 @@ Essentially they are the same, differ only in details. Typically, you use some l which already implement one of these. we support both of them. We adhere to the standard logic for ping, pong, and disconnect actions. We adhere to the standard logic for ping, pong, and disconnect actions. Once the socket is open, the server sends a 'ka' message if you're using graphql-ws. Alternatively, if you're using graphql-transport-ws, the server will send a 'pong' message. This process ensures that the connection remains active and healthy. -You can find examples of how to use it in your code [here](https://docs.bitquery.io/docs/subscriptions/examples/) - +You can find examples of how to use it in your code [here](/docs/subscriptions/examples/) ## Why do I get a failed WebSocket connection error when converting query to subscription? @@ -83,7 +81,7 @@ When switching from a regular GraphQL query to a WebSocket subscription in Bitqu 4. **Authentication** - You must authenticate using OAuth or provide your Bitquery API token over the WebSocket connection. - - See [WebSocket authorisation guide](https://docs.bitquery.io/docs/authorisation/websocket/) for details. + - See [WebSocket authorization guide](/docs/authorization/websocket/) for details. 5. **Subprotocol** - Your WebSocket client must support either `graphql-ws` or `graphql-transport-ws` subprotocols. @@ -91,7 +89,7 @@ When switching from a regular GraphQL query to a WebSocket subscription in Bitqu 6. **Compatibility Caveats** - Some fields or dataset combinations supported in queries are *not* yet available via streaming subscriptions. - - If you get “subscription not valid” errors, check [this guide](https://docs.bitquery.io/docs/subscriptions/subscription/) or Bitquery v2 query docs for compatibility information. + - If you get “subscription not valid” errors, check [this guide](/docs/subscriptions/subscription/) or Bitquery v2 query docs for compatibility information. 7. **Error Diagnosis** - _Connection failed_ errors usually indicate a transport or authentication problem. diff --git a/docs/tools-directory.md b/docs/tools-directory.md index 630f02f9..390344a2 100644 --- a/docs/tools-directory.md +++ b/docs/tools-directory.md @@ -1,7 +1,7 @@ --- sidebar_position: 4 title: Tools & SDKs Directory -description: Discover sample apps, dashboards, and SDKs built with Bitquery blockchain data APIs. Try live demos, clone repos, and integrate crypto data into your projects. +description: "Tools & SDKs Directory: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance. Works with WebSocket live subscriptions." keywords: - Bitquery tools - blockchain API tools @@ -14,10 +14,9 @@ keywords: - OpenClaw - ClawHub --- - # Tools & SDKs Directory -Explore **sample applications**, **dashboards**, and **SDKs** built with Bitquery blockchain data. Use these tools to analyze tokens, monitor liquidity, score DeFi portfolios, build charts, or integrate real-time crypto data into your own apps. Each entry includes source code (GitHub), documentation, and—where available—a live demo you can try. For a complete list of step-by-step tutorials (bots, snipers, dashboards, wash trading, NFT tools), see the [How-To Guides index](https://docs.bitquery.io/docs/how-to-guides-index/). +Explore **sample applications**, **dashboards**, and **SDKs** built with Bitquery blockchain data. Use these tools to analyze tokens, monitor liquidity, score DeFi portfolios, build charts, or integrate real-time crypto data into your own apps. Each entry includes source code (GitHub), documentation, and—where available—a live demo you can try. For a complete list of step-by-step tutorials (bots, snipers, dashboards, wash trading, NFT tools), see the [How-To Guides index](/docs/category/how-to-guides/). --- diff --git a/docs/trading/crypto-price-api/crypto-marketcap-api.md b/docs/trading/crypto-price-api/crypto-marketcap-api.md index 2eed945b..136e84a3 100644 --- a/docs/trading/crypto-price-api/crypto-marketcap-api.md +++ b/docs/trading/crypto-price-api/crypto-marketcap-api.md @@ -1,6 +1,6 @@ --- title: "Crypto MarketCap API & Market Data" -description: "Real-time crypto market cap API by Bitquery: USD market cap, FDV & token supply on Solana, Ethereum & BSC. GraphQL subscriptions, Kafka trading.prices, multi-chain OHLC & DEX examples." +description: "Crypto MarketCap API & Market Data via Bitquery Trading APIs for multi-chain prices, OHLC candles, volume metrics, and live streams." keywords: - crypto market cap API - Crypto Market data @@ -12,7 +12,6 @@ keywords: - Solana Ethereum BSC market cap - multi-chain OHLC API --- - # Crypto MarketCap API and Market Data The **Crypto MarketCap API** is part of the Crypto Price APIs: you can **query** USD **market capitalization** and related **supply** fields, or **stream** them in **real time** for many chains using GraphQL **subscriptions** or the **`trading.prices`** Kafka topic described in the [Crypto Price API introduction](/docs/trading/crypto-price-api/introduction). @@ -225,7 +224,7 @@ This section aggregates commonly used queries for market data across chains, pai Subscribe to **`Trading.Tokens`** with a **network** and **interval** to stream OHLC, volume, and **`Supply`** (including **MarketCap**) for many tokens on that chain in one feed. -The following stream provide 60 second aggregated data. For information on all available time intervals, see the supported intervals documentation [here](http://localhost:3000/docs/trading/crypto-price-api/introduction/#supported-time-intervals). +The following stream provide 60 second aggregated data. For information on all available time intervals, see the supported intervals documentation [here](/docs/trading/crypto-price-api/introduction/#supported-time-intervals). [Run Query](https://ide.bitquery.io/Aggregated-Price-of-all-tokens-in-real-time-on-one-chain_1) diff --git a/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api.md b/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api.md index b36551c4..9629800b 100644 --- a/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api.md +++ b/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api.md @@ -1,32 +1,31 @@ --- title: "Crypto Tokens OHLC Candle K-Line API" -description: "Get real-time and historical OHLC (Open, High, Low, Close) candle data, K-line charts, and price analytics for crypto tokens across all supported blockchains. Perfect for trading bots, charting applications, and market analysis." +description: "Crypto Tokens OHLC Candle K-Line API via Bitquery Trading APIs for multi-chain prices, OHLC candles, volume metrics, and live streams." keywords: ["OHLC API", "crypto candle data", "K-line API", "real-time price data", "crypto trading API", "blockchain price data", "candlestick charts", "crypto market data", "trading bot API", "crypto analytics", "multi-chain price data", "DEX price API", "crypto streaming API", "Kafka crypto data", "TradingView integration", "crypto arbitrage API"] --- - # Crypto Tokens OHLC Candle K-Line API - Real-Time & Historical Price Data Get real-time and historical OHLC (Open, High, Low, Close) candle data, K-line charts, and price analytics for crypto tokens across all supported blockchains including Ethereum, Solana, BSC, Polygon, and Tron. -**Recommendation:** Use the **[Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/)** as your **main source** for OHLC and K-line data—**real-time streams** and **pre-aggregated** bars (low-latency, easy to use). When you need **full historical OHLC** (deep backfill, archive ranges, or candles built from raw DEX trades), use **`DEXTradeByTokens`** on **`EVM`** or **`Solana`** and aggregate trades into candles—see [comparison below](#crypto-price-api-vs-dextradebytoken). +**Recommendation:** Use the **[Crypto Price API](/docs/trading/crypto-price-api/introduction/)** as your **main source** for OHLC and K-line data—**real-time streams** and **pre-aggregated** bars (low-latency, easy to use). When you need **full historical OHLC** (deep backfill, archive ranges, or candles built from raw DEX trades), use **`DEXTradeByTokens`** on **`EVM`** or **`Solana`** and aggregate trades into candles—see [comparison below](#crypto-price-api-vs-dextradebytoken). ## How do I get OHLCV data for a token using Bitquery? {#how-do-i-get-ohlcv-data-for-a-token-using-bitquery} -**Use the [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) first** (`Trading` → `Tokens`, `Pairs`, or `Currencies`): **pre-aggregated OHLC**, streaming, and intervals such as **1-second** and **1-minute**, with a **clean, multi-DEX index** view. **For historical OHLC** beyond what the Price API covers, switch to **`DEXTradeByTokens`** (or chain-specific DEX docs): bucket with **`Block { Time(interval: { count, in: minutes | hours | days }) }`** and derive open/high/low/close from **`PriceInUSD`** / **`Trade_Price`**. See [Crypto Price API vs DEXTradeByTokens](#crypto-price-api-vs-dextradebytoken) and the quick table below. +**Use the [Crypto Price API](/docs/trading/crypto-price-api/introduction/) first** (`Trading` → `Tokens`, `Pairs`, or `Currencies`): **pre-aggregated OHLC**, streaming, and intervals such as **1-second** and **1-minute**, with a **clean, multi-DEX index** view. **For historical OHLC** beyond what the Price API covers, switch to **`DEXTradeByTokens`** (or chain-specific DEX docs): bucket with **`Block { Time(interval: { count, in: minutes | hours | days }) }`** and derive open/high/low/close from **`PriceInUSD`** / **`Trade_Price`**. See [Crypto Price API vs DEXTradeByTokens](#crypto-price-api-vs-dextradebytoken) and the quick table below. ## OHLCV & price data — quick answers {#ohlcv-and-price-data-quick-answers} | Question | Where to read / run | |----------|---------------------| -| How do I get OHLCV data for a token using Bitquery? | **Last 7 Days** [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) ; **historical:** [DEXTradeByTokens OHLC](https://docs.bitquery.io/docs/cubes/dextradesbyTokens/#how-do-i-get-ohlc-in-a-dextradebytokens-query) | -| How do I get OHLC in a DEXTradeByTokens query? | [DEXTradeByTokens OHLC](https://docs.bitquery.io/docs/cubes/dextradesbyTokens/#how-do-i-get-ohlc-in-a-dextradebytokens-query) (for **historical** OHLC or DEX-level control) | -| How do I get historical OHLCV for a Solana token? | **Main OHLC:** [Crypto Price API — Quick start](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/#quick-start) · [Tokens cube](https://docs.bitquery.io/docs/trading/crypto-price-api/tokens/) · **Historical / DEX:** [Historical OHLCV on Solana](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/#how-do-i-get-historical-ohlcv-for-a-solana-token) · [Solana OHLC API](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/#solana-ohlc-api) | -| How do I get the current price of a token using Bitquery API? | [Quick start](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/#quick-start) · [Tokens cube](https://docs.bitquery.io/docs/trading/crypto-price-api/tokens/) · [Examples](https://docs.bitquery.io/docs/trading/crypto-price-api/examples/) | -| How do I get price change percentage for a token? | [Price change](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/#volume-of-multiple-tokens-across-different-chains) | -| How do I get 1-minute OHLC candles for a DEX pair? | **Main:** [Your first OHLC query](#your-first-ohlc-query) (`Duration: { eq: 60 }`) · [Pairs cube](https://docs.bitquery.io/docs/trading/crypto-price-api/pairs/) · **Historical:** [DEX OHLC pattern](https://docs.bitquery.io/docs/cubes/dextradesbyTokens/#how-do-i-get-ohlc-in-a-dextradebytokens-query) | -| How do I get the all-time high (ATH) price of a token? | [Solana ATH example](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/#get-ath-market-cap-of-tokens)| -| Is there an API to get token price in USD on Solana? | [Crypto Price API — Quick start](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/#quick-start) · [Tokens cube](https://docs.bitquery.io/docs/trading/crypto-price-api/tokens/) · [Latest USD (Solana DEX trades)](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades/#latest-usd-price-of-a-token) | -| How do I use DEXTradeByTokens vs DEXTrades for OHLCV? | [OHLCV: which cube?](https://docs.bitquery.io/docs/cubes/dextradesbyTokens/#how-do-i-use-dextradebytokens-vs-dextrades-for-ohlcv) · [DEXTrades cube](https://docs.bitquery.io/docs/cubes/dextrades/) | +| How do I get OHLCV data for a token using Bitquery? | **Last 7 Days** [Crypto Price API](/docs/trading/crypto-price-api/introduction/) ; **historical:** [DEXTradeByTokens OHLC](/docs/cubes/dextradesbyTokens/#how-do-i-get-ohlc-in-a-dextradebytokens-query) | +| How do I get OHLC in a DEXTradeByTokens query? | [DEXTradeByTokens OHLC](/docs/cubes/dextradesbyTokens/#how-do-i-get-ohlc-in-a-dextradebytokens-query) (for **historical** OHLC or DEX-level control) | +| How do I get historical OHLCV for a Solana token? | **Main OHLC:** [Crypto Price API — Quick start](/docs/trading/crypto-price-api/introduction/#quick-start) · [Tokens cube](/docs/trading/crypto-price-api/tokens/) · **Historical / DEX:** [Historical OHLCV on Solana](/docs/blockchain/Solana/solana-dextrades/#how-do-i-get-historical-ohlcv-for-a-solana-token) · [Solana OHLC API](/docs/blockchain/Solana/solana-dextrades/#solana-ohlc-api) | +| How do I get the current price of a token using Bitquery API? | [Quick start](/docs/trading/crypto-price-api/introduction/#quick-start) · [Tokens cube](/docs/trading/crypto-price-api/tokens/) · [Examples](/docs/trading/crypto-price-api/examples/) | +| How do I get price change percentage for a token? | [Price change](/docs/start/starter-queries/#volume-of-multiple-tokens-across-different-chains) | +| How do I get 1-minute OHLC candles for a DEX pair? | **Main:** [Your first OHLC query](#your-first-ohlc-query) (`Duration: { eq: 60 }`) · [Pairs cube](/docs/trading/crypto-price-api/pairs/) · **Historical:** [DEX OHLC pattern](/docs/cubes/dextradesbyTokens/#how-do-i-get-ohlc-in-a-dextradebytokens-query) | +| How do I get the all-time high (ATH) price of a token? | [Solana ATH example](/docs/blockchain/Solana/solana-dextrades/#get-ath-market-cap-of-tokens)| +| Is there an API to get token price in USD on Solana? | [Crypto Price API — Quick start](/docs/trading/crypto-price-api/introduction/#quick-start) · [Tokens cube](/docs/trading/crypto-price-api/tokens/) · [Latest USD (Solana DEX trades)](/docs/blockchain/Solana/solana-dextrades/#latest-usd-price-of-a-token) | +| How do I use DEXTradeByTokens vs DEXTrades for OHLCV? | [OHLCV: which cube?](/docs/cubes/dextradesbyTokens/#how-do-i-use-dextradebytokens-vs-dextrades-for-ohlcv) · [DEXTrades cube](/docs/cubes/dextrades/) | ## What is OHLC Data? @@ -37,9 +36,9 @@ OHLC (Open, High, Low, Close) data, also known as candlestick or K-line data, is - **Low**: The lowest price reached during the interval - **Close**: The last price recorded in the interval -Our [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) provides pre-aggregated OHLC data with ultra-low latency—**use it as the main source** for live charts and typical OHLC needs. +Our [Crypto Price API](/docs/trading/crypto-price-api/introduction/) provides pre-aggregated OHLC data with ultra-low latency—**use it as the main source** for live charts and typical OHLC needs. -**Historical OHLC:** For **deep history** or candles computed from **raw DEX trades**, use **[DEXTradeByTokens](https://docs.bitquery.io/docs/cubes/dextradesbyTokens/)** on **EVM** or **Solana** (with `dataset: combined` or `archive` as needed). +**Historical OHLC:** For **deep history** or candles computed from **raw DEX trades**, use **[DEXTradeByTokens](/docs/cubes/dextradesbyTokens/)** on **EVM** or **Solana** (with `dataset: combined` or `archive` as needed). ## Getting Started @@ -148,7 +147,6 @@ subscription { - Any application requiring reliable real-time price streams - Fixed time intervals available due to pre-aggregated data - ### **When to Use DEXTradeByTokens API:** - **Historical OHLC** and long-range backfills @@ -156,10 +154,9 @@ subscription { - **Full** price history, custom intervals, or archive-backed ranges - Any time interval can be used because aggregation is defined in the query over trades - ## Supported Time Intervals -Our [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) OHLC API supports fixed time intervals optimized for different trading strategies: +Our [Crypto Price API](/docs/trading/crypto-price-api/introduction/) OHLC API supports fixed time intervals optimized for different trading strategies: | Interval | Duration | |----------|----------| @@ -185,7 +182,7 @@ For volume-driven analysis, we also support volume-based intervals: ## Choosing the Right Cube for OHLC Data -The [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) offers three different cubes for accessing OHLC data. Understanding which cube to use is crucial for getting the right data for your specific use case: +The [Crypto Price API](/docs/trading/crypto-price-api/introduction/) offers three different cubes for accessing OHLC data. Understanding which cube to use is crucial for getting the right data for your specific use case: Before we dive into the cubes, let's clarify the key terminology: @@ -193,7 +190,6 @@ Before we dive into the cubes, let's clarify the key terminology: **Token** - Specific implementations of a currency on blockchains (e.g., cbBTC, WBTC are Bitcoin tokens) **Pair** - Trading pairs between two assets (e.g., cbBTC/ETH, WBTC/ETH, WBTC/SOL) - ### **Currency Cube** - Chain-Agnostic Aggregated View Use the **Currency** cube when you want a unified price view of an asset across all blockchains. @@ -204,7 +200,7 @@ Use the **Currency** cube when you want a unified price view of an asset across - Can provide only USD-quoted prices - Can combine volume and price data from all chains -[Learn more about Currency Cube ➤](https://docs.bitquery.io/docs/trading/crypto-price-api/currency/) +[Learn more about Currency Cube ➤](/docs/trading/crypto-price-api/currency/) ### **Tokens Cube** - Chain-Specific Token Data @@ -216,8 +212,7 @@ Use the **Tokens** cube when you need OHLC data for a specific token on a specif - Can provide only USD-quoted prices - Can combine volume and price data from all chains - -[Learn more about Tokens Cube ➤](https://docs.bitquery.io/docs/trading/crypto-price-api/tokens/) +[Learn more about Tokens Cube ➤](/docs/trading/crypto-price-api/tokens/) ### **Pairs Cube** - Trading Pair Specific Data @@ -229,8 +224,7 @@ Use the **Pairs** cube when you need OHLC data for specific trading pairs on spe - Market/DEX-specific data - Most granular level of price data - -[Learn more about Pairs Cube ➤](https://docs.bitquery.io/docs/trading/crypto-price-api/pairs/) +[Learn more about Pairs Cube ➤](/docs/trading/crypto-price-api/pairs/) ## Real-Time OHLC Stream Examples @@ -438,7 +432,7 @@ subscription { ## Historical OHLC Queries -**Note:** These examples use the **Crypto Price API** for **recent** OHLC. For **full historical** OHLC, use **[DEXTradeByTokens](https://docs.bitquery.io/docs/cubes/dextradesbyTokens/)**. +**Note:** These examples use the **Crypto Price API** for **recent** OHLC. For **full historical** OHLC, use **[DEXTradeByTokens](/docs/cubes/dextradesbyTokens/)**. ### 1. Bitcoin OHLC (Crypto Price API) @@ -1099,7 +1093,7 @@ Find arbitrage opportunities using OHLC data across chains: ## Can I get 1-minute historical OHLC data for a full year? {#can-i-get-1-minute-historical-ohlc-data-for-a-full-year} -**Crypto Price API:** best for **live and recent** OHLC; an unbroken **one-year 1-minute** series may exceed what the Price Index is designed to serve—check your **plan** and try coarser intervals or **DEX-derived** data for deep history. **DEXTradeByTokens:** bucket with **`Time(interval: { count: 1, in: minutes })`** and a **365-day** **`Block.Time`** range; **minutes with no trades** will be **empty** or **sparse**, and the query can be **heavy**. Prefer **hourly/daily** bars or export **raw trades** for backfill. See [Historical Solana aggregate data](https://docs.bitquery.io/docs/blockchain/Solana/historical-aggregate-data/) and [DEXTradesByTokens OHLC](https://docs.bitquery.io/docs/cubes/dextradesbyTokens/#how-do-i-get-ohlc-in-a-dextradebytokens-query). +**Crypto Price API:** best for **live and recent** OHLC; an unbroken **one-year 1-minute** series may exceed what the Price Index is designed to serve—check your **plan** and try coarser intervals or **DEX-derived** data for deep history. **DEXTradeByTokens:** bucket with **`Time(interval: { count: 1, in: minutes })`** and a **365-day** **`Block.Time`** range; **minutes with no trades** will be **empty** or **sparse**, and the query can be **heavy**. Prefer **hourly/daily** bars or export **raw trades** for backfill. See [Historical Solana aggregate data](/docs/blockchain/Solana/historical-aggregate-data/) and [DEXTradesByTokens OHLC](/docs/cubes/dextradesbyTokens/#how-do-i-get-ohlc-in-a-dextradebytokens-query). ## Supported Blockchains @@ -1120,17 +1114,15 @@ Our OHLC API supports all major blockchains: - **Kafka Broker**: `streaming.bitquery.io:9092` - **Topic**: `trading.prices` - - ## Best Practices -1. **Choose the right API**: Use [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) as the **main** source for OHLC; use [DEXTradeByTokens](https://docs.bitquery.io/docs/cubes/dextradesbyTokens/) for **historical** OHLC from DEX trades +1. **Choose the right API**: Use [Crypto Price API](/docs/trading/crypto-price-api/introduction/) as the **main** source for OHLC; use [DEXTradeByTokens](/docs/cubes/dextradesbyTokens/) for **historical** OHLC from DEX trades 2. **Choose the Right Interval**: Use 1s for high-frequency trading, 1m for standard charting 3. **Use USD Quoting**: Set `IsQuotedInUsd: true` for consistent price comparison ## Support -- **Documentation**: [Crypto Price API Docs](https://docs.bitquery.io/docs/trading/crypto-price-api/) +- **Documentation**: [Crypto Price API Docs](/docs/trading/crypto-price-api/introduction/) - **IDE**: [Bitquery IDE](https://ide.bitquery.io) - **Community**: [Discord](https://discord.gg/bitquery) - **Support**: [Contact Support](https://bitquery.io/contact) diff --git a/docs/trading/crypto-price-api/cube-examples.md/currency-examples.md b/docs/trading/crypto-price-api/cube-examples.md/currency-examples.md deleted file mode 100644 index e69de29b..00000000 diff --git a/docs/trading/crypto-price-api/cube-examples.md/pair-examples.md b/docs/trading/crypto-price-api/cube-examples.md/pair-examples.md deleted file mode 100644 index e69de29b..00000000 diff --git a/docs/trading/crypto-price-api/cube-examples.md/token-examples.md b/docs/trading/crypto-price-api/cube-examples.md/token-examples.md deleted file mode 100644 index e69de29b..00000000 diff --git a/docs/trading/crypto-price-api/currency.md b/docs/trading/crypto-price-api/currency.md index 01819cdf..3bd70a27 100644 --- a/docs/trading/crypto-price-api/currency.md +++ b/docs/trading/crypto-price-api/currency.md @@ -1,3 +1,7 @@ +--- +title: "Crypto Currency Price API" +description: "Query currency-level crypto prices and conversions with Bitquery Trading APIs, including GraphQL examples and streaming options." +--- # Currency Cube The Currency Cube provides a unified, chain-agnostic price for an asset in USD, such as Bitcoin by aggregating prices and volumes from all its representations (e.g., WBTC, cbBTC, and other bridged or wrapped forms) across all supported chains. This multi-chain cryptocurrency price data approach ensures consistent pricing across different blockchain implementations. @@ -72,7 +76,6 @@ The OHLC values (Open, High, Low, Close) are determined across all chains and to } } - ``` ### Supply diff --git a/docs/trading/crypto-price-api/examples.md b/docs/trading/crypto-price-api/examples.md index 35eaa5d5..5a81b0ed 100644 --- a/docs/trading/crypto-price-api/examples.md +++ b/docs/trading/crypto-price-api/examples.md @@ -1,3 +1,7 @@ +--- +title: "Quick Start Examples" +description: "Quick Start Examples via Bitquery Trading APIs for multi-chain prices, OHLC candles, volume metrics, and live streams. See examples in the Bitquery IDE." +--- # Quick Start Examples ## Real-Time Token Prices in USD on Solana @@ -330,7 +334,7 @@ This query retrieves the OHLC (Open, High, Low, Close) prices of a currency(in t Mention the chain/network using the `Token: {Network}` filter. Available values: `Ethereum`, `Solana`, `Base`, `Optimism`, `Opbnb`, `Matic`, `Arbitrum`, `Binance Smart Chain`, `Tron`. -The available duration intervals are listed [here](https://docs.bitquery.io/docs/trading/price-index/introduction/#understanding-intervals). +The available duration intervals are listed [here](/docs/trading/crypto-price-api/introduction/#understanding-intervals). In Tokens cube, only `IsQuotedInUsd:true` is supported so you will see OHLC and Price values in USD only. diff --git a/docs/trading/crypto-price-api/in-depth.md b/docs/trading/crypto-price-api/in-depth.md index ba1be83a..3926b465 100644 --- a/docs/trading/crypto-price-api/in-depth.md +++ b/docs/trading/crypto-price-api/in-depth.md @@ -1,3 +1,7 @@ +--- +title: "Breaking Down Price Streams in Detail" +description: "Breaking Down Price Streams in Detail via Bitquery Trading APIs for multi-chain prices, OHLC candles, volume metrics, and live streams." +--- # Breaking Down Price Streams in Detail This section is not necessary reading to start using the APIs; it explains how we have set up and designed the APIs and what algorithmic rules we follow to show data. You can go to the [examples section](/docs/trading/crypto-price-api/examples) to start using it. diff --git a/docs/trading/crypto-price-api/introduction.mdx b/docs/trading/crypto-price-api/introduction.mdx index db866306..326b615b 100644 --- a/docs/trading/crypto-price-api/introduction.mdx +++ b/docs/trading/crypto-price-api/introduction.mdx @@ -1,6 +1,6 @@ --- title: "Crypto Price API – Real-Time Token Data, Charts & OHLC" -description: "Access real-time crypto prices, OHLC, moving averages & volume across EVM, Solana, Tron & more. Ultra-low latency for trading bots, DeFi & charting apps." +description: "Crypto Price API – Real-Time Token Data, Charts & OHLC via Bitquery Trading APIs for multi-chain prices, OHLC candles, volume metrics, and live streams." keywords: - "crypto price API" - "cryptocurrency price api" @@ -27,23 +27,22 @@ keywords: - "Coinmarketcap api" - "low latency price feed" --- - import FAQ from "@site/src/components/FAQ"; # Crypto Price API – Real-Time Token Data, Charts & OHLC :::tip Real-time + last ~30 days only -The Crypto Price API cubes (`Trading.Tokens`, `Trading.Currencies`, `Trading.Pairs`) are part of the **Trading cube** family — built for **real-time and the last ~30 days**. For OHLC built from raw trades **older than ~30 days**, use chain-level [`DEXTradeByTokens`](https://docs.bitquery.io/docs/cubes/dextradesbyTokens) instead. See the [**Trading Data Overview**](https://docs.bitquery.io/docs/trading/trading-data-overview) for the side-by-side comparison. +The Crypto Price API cubes (`Trading.Tokens`, `Trading.Currencies`, `Trading.Pairs`) are part of the **Trading cube** family — built for **real-time and the last ~30 days**. For OHLC built from raw trades **older than ~30 days**, use chain-level [`DEXTradeByTokens`](/docs/cubes/dextradesbyTokens) instead. See the [**Trading Data Overview**](/docs/trading/trading-data-overview) for the side-by-side comparison. ::: Bitquery provides **Crypto Price APIs and Streams** via GraphQL and [Kafka](https://github.com/bitquery/streaming_protobuf/blob/feature/trading/market/price_index.proto). This **cryptocurrency price API** delivers comprehensive pricing data across multiple blockchains. -These tools let you stream and query aggregated price data in USD or other paired currencies based on time and volume for all tokens across EVM, Solana, Tron, and other supported chains. Our **crypto prices api** is the **main** source for **real-time** pricing and **OHLC**; for **historical** OHLC from DEX trades, use **`DEXTradeByTokens`** as described in the [OHLC documentation](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/). +These tools let you stream and query aggregated price data in USD or other paired currencies based on time and volume for all tokens across EVM, Solana, Tron, and other supported chains. Our **crypto prices api** is the **main** source for **real-time** pricing and **OHLC**; for **historical** OHLC from DEX trades, use **`DEXTradeByTokens`** as described in the [OHLC documentation](/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/). -The Crypto Price API provides more than just pair prices, it also includes [OHLCV (K-Line)](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/), Simple Moving Averages (SMA), Weighted Moving Averages (WMA), mean prices, and other key price-related statistics. +The Crypto Price API provides more than just pair prices, it also includes [OHLCV (K-Line)](/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/), Simple Moving Averages (SMA), Weighted Moving Averages (WMA), mean prices, and other key price-related statistics. While you can access the aggregated price for a single trading pair, the Price Index also supports cross-chain and cross-DEX aggregation, giving you a unified view of token prices across multiple ecosystems. -**OHLC & K-lines:** Use this **Crypto Price API** as the **primary** source. For **historical** OHLC (long backfills, archive data, or trade-built candles), use **`DEXTradeByTokens`** (see [OHLC guide — when to use DEX](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/#crypto-price-api-vs-dextradebytoken)). +**OHLC & K-lines:** Use this **Crypto Price API** as the **primary** source. For **historical** OHLC (long backfills, archive data, or trade-built candles), use **`DEXTradeByTokens`** (see [OHLC guide — when to use DEX](/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/#crypto-price-api-vs-dextradebytoken)). ## Key Features of These APIs @@ -215,7 +214,7 @@ This consistent window size ensures comparable moving average calculations acros loading="lazy" /> -This stream has pre-calculated OHLC data in the response which you can feed directly to your charting solution without additional calculations. Our **cryptocurrency price api** is accessible through GraphQL queries and subscriptions, making it easy to integrate into your applications. The **crypto prices api** supports **real-time streaming** and **recent OHLC history** (about the **last 7 days** in the Price Index); for **older** OHLC, use **`DEXTradeByTokens`** as in the [OHLC guide](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/#crypto-price-api-vs-dextradebytoken). +This stream has pre-calculated OHLC data in the response which you can feed directly to your charting solution without additional calculations. Our **cryptocurrency price api** is accessible through GraphQL queries and subscriptions, making it easy to integrate into your applications. The **crypto prices api** supports **real-time streaming** and **recent OHLC history** (about the **last 7 days** in the Price Index); for **older** OHLC, use **`DEXTradeByTokens`** as in the [OHLC guide](/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/#crypto-price-api-vs-dextradebytoken). > **Note**: All queries can be converted to a GraphQL stream (WebSocket) by changing the keyword `query` to `subscription` @@ -583,7 +582,7 @@ Use `TargetVolume` to get price intervals aggregated over a volume threshold: With the new Price API, you can simply feed the stream to your custom datafeed object in the TradingView code and have it update charts in real-time. -- A sample tutorial is available [here](https://docs.bitquery.io/docs/usecases/tradingview-subscription-realtime/getting-started/) +- A sample tutorial is available [here](/docs/usecases/tradingview-subscription-realtime/getting-started/) - The stream is available ready-to-chart SDK [here](https://www.npmjs.com/package/@bitquery/tradingview-sdk). Simply copy paste the advanced charting library into the correct folder, add Bitquery access token and it is ready. ## Video Tutorial | Introduction to Crypto Price APIs diff --git a/docs/trading/crypto-price-api/limit-order-price-api.md b/docs/trading/crypto-price-api/limit-order-price-api.md index 91a53b4e..1a9f0d07 100644 --- a/docs/trading/crypto-price-api/limit-order-price-api.md +++ b/docs/trading/crypto-price-api/limit-order-price-api.md @@ -1,6 +1,6 @@ --- title: "Limit Order Price API" -description: "Use our crypto price API for limit orders to get reliable price for limit order execution. Our limit order price API prevents false triggers with aggregated price feeds and dampening mechanisms." +description: "Limit Order Price API via Bitquery Trading APIs for multi-chain prices, OHLC candles, volume metrics, and live streams. See examples in the Bitquery IDE." keywords: [ "limit order price api", @@ -23,7 +23,6 @@ keywords: "crypto limit orders" ] --- - # Limit Order Price API: Crypto Price API for Limit Orders ## The Problem: Why Raw Trade Data Fails for Limit Orders @@ -44,7 +43,7 @@ The same token can trade at vastly different prices (e.g., $100 on Uniswap vs $9 ## The Solution: Aggregated Price Streams -Bitquery's [Crypto Price API for limit orders](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/) provides **aggregated price data** with built-in dampening mechanisms, serving as a reliable limit order price API: +Bitquery's [Crypto Price API for limit orders](/docs/trading/crypto-price-api/introduction/) provides **aggregated price data** with built-in dampening mechanisms, serving as a reliable limit order price API: **Multi-pool aggregation** across all major DEXs **Cross-chain price discovery** for market-wide pricing @@ -76,8 +75,6 @@ Bitquery's [Crypto Price API for limit orders](https://docs.bitquery.io/docs/tra #### 4. **Trade Filtering** Trades are excluded only when the trade amount is zero or below decimal precision (e.g. < 10^decimals/10,000), avoiding precision loss. Moving averages (SMA, WMA, EMA) and anomaly-resistant OHLC are still calculated on the resulting feed. For full details see the [Price Index Algorithm](/docs/trading/crypto-price-api/price-index-algorithm). - - ## TradingView Integration TradingView integration can be achieved through a custom datafeed that connects to Bitquery's real-time price streams. The datafeed supports multiple timeframe resolutions (1s to 1h), subscribes to real-time OHLC data via WebSocket, and provides the structured bar data format that TradingView requires for live chart updates. This enables professional-grade charting with institutional-quality aggregated price data. @@ -86,7 +83,7 @@ TradingView integration can be achieved through a custom datafeed that connects ### **Production Resources** -**Complete Tutorial**: Follow our comprehensive [TradingView Real-Time Streaming Tutorial](https://docs.bitquery.io/docs/usecases/tradingview-subscription-realtime/getting-started/) that shows how to integrate Bitquery's Crypto Price API with TradingView's Advanced Charts. +**Complete Tutorial**: Follow our comprehensive [TradingView Real-Time Streaming Tutorial](/docs/usecases/tradingview-subscription-realtime/getting-started/) that shows how to integrate Bitquery's Crypto Price API with TradingView's Advanced Charts. **Production-Ready Code**: - **GitHub Repository**: [Complete implementation examples](https://github.com/bitquery/tradingview-subscription-realtime/tree/main) @@ -306,15 +303,15 @@ subscription { ## Production Resources & Documentation ### **Implementation Guides** -- **[Crypto Price API Documentation](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/)** - Complete API reference with live examples -- **[DEX Trade Filtering Guide](https://docs.bitquery.io/docs/usecases/how-to-filter-anomaly-prices/)** - How to handle raw data anomalies -- **[OHLC Candlestick API](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/)** - Ready-to-chart data with [live Bitcoin OHLC example ➤](https://ide.bitquery.io/bitcoin-currency-price-stream) -- **[DEXTradeByTokens API](https://docs.bitquery.io/docs/cubes/dextradesbyTokens/)** - Raw trade data for comparison +- **[Crypto Price API Documentation](/docs/trading/crypto-price-api/introduction/)** - Complete API reference with live examples +- **[DEX Trade Filtering Guide](/docs/usecases/how-to-filter-anomaly-prices/)** - How to handle raw data anomalies +- **[OHLC Candlestick API](/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api/)** - Ready-to-chart data with [live Bitcoin OHLC example ➤](https://ide.bitquery.io/bitcoin-currency-price-stream) +- **[DEXTradeByTokens API](/docs/cubes/dextradesbyTokens/)** - Raw trade data for comparison ### **Real-Time Streaming** - **GraphQL Endpoint**: `https://streaming.bitquery.io/graphql` ([Try in IDE ➤](https://ide.bitquery.io/?endpoint=https://streaming.bitquery.io/graphql)) - **Kafka Topic**: `trading.prices` ([Schema & SDKs ➤](https://github.com/bitquery/streaming_protobuf/tree/main/market)) -- **WebSocket Subscriptions**: Convert any query to `subscription` for real-time data ([WebSocket Guide ➤](https://docs.bitquery.io/docs/subscriptions/websockets/)) +- **WebSocket Subscriptions**: Convert any query to `subscription` for real-time data ([WebSocket Guide ➤](/docs/subscriptions/websockets/)) ## **Proven Production Benefits** Based on real trading platform implementations ([see live comparison ➤](https://ide.bitquery.io/raw-vs-aggregated-price-comparison)): @@ -331,13 +328,13 @@ Based on real trading platform implementations ([see live comparison ➤](https: - **Real-time USD pricing**: Built-in conversion eliminating additional API calls - **Bad trade filtering**: Automatic removal of outliers and routing anomalies -[Explore all technical features ➤](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/#key-features-of-these-apis) +[Explore all technical features ➤](/docs/trading/crypto-price-api/introduction/#key-features-of-these-apis) Ready to implement our crypto price API for limit orders in your trading system? **Get Started with Our Limit Order Price API:** - [Try live examples in our IDE ➤](https://ide.bitquery.io/?query_name=crypto-price-examples) -- [Read the complete API documentation ➤](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction) +- [Read the complete API documentation ➤](/docs/trading/crypto-price-api/introduction) - [Download SDKs and schemas ➤](https://github.com/bitquery/streaming_protobuf/tree/main/market) - [Join our community ➤](https://t.me/Bloxy_info) diff --git a/docs/trading/crypto-price-api/pairs.md b/docs/trading/crypto-price-api/pairs.md index df3402e8..3a65cc91 100644 --- a/docs/trading/crypto-price-api/pairs.md +++ b/docs/trading/crypto-price-api/pairs.md @@ -1,3 +1,7 @@ +--- +title: "Crypto Trading Pairs Price API" +description: "Get crypto trading pair prices, volume, and OHLC with Bitquery Trading APIs using GraphQL queries and real-time stream options." +--- # Pairs Cube The Pairs cube provides trading data for a base token traded against a quote token on a particular DEX or protocol. @@ -51,7 +55,6 @@ The Pairs cube provides trading data for a base token traded against a quote tok } } - ``` - `Volume.Base`: diff --git a/docs/trading/crypto-price-api/price-index-algorithm.md b/docs/trading/crypto-price-api/price-index-algorithm.md index e69ceea1..0159c62e 100644 --- a/docs/trading/crypto-price-api/price-index-algorithm.md +++ b/docs/trading/crypto-price-api/price-index-algorithm.md @@ -1,6 +1,6 @@ --- title: "Price Index Algorithm" -description: "How the Crypto Price API filters trades and computes token and currency prices using exponentially decayed volume weighting over the last hour (50% weight at the window midpoint)." +description: "Price Index Algorithm via Bitquery Trading APIs for multi-chain prices, OHLC candles, volume metrics, and live streams. See examples in the Bitquery IDE." sidebar_position: 2 keywords: - "price index algorithm" @@ -11,7 +11,6 @@ keywords: - "currency price" - "DEX price aggregation" --- - # Price Index Algorithm This page describes how the Price Index (Crypto Price API) filters trades and computes prices for tokens and currencies. It is the single source of truth for the algorithm in effect from **April 2026**. diff --git a/docs/trading/crypto-price-api/supply-fields.md b/docs/trading/crypto-price-api/supply-fields.md index d04cce16..4ee948ce 100644 --- a/docs/trading/crypto-price-api/supply-fields.md +++ b/docs/trading/crypto-price-api/supply-fields.md @@ -1,6 +1,6 @@ --- title: "Supply Fields Reference" -description: "Definitions for Supply metrics (circulating, total, max supply, market cap, FDV) on the Crypto Price API Tokens, Currency, and Pairs cubes." +description: "Supply Fields Reference via Bitquery Trading APIs for multi-chain prices, OHLC candles, volume metrics, and live streams." sidebar_position: 3 keywords: - "crypto price api supply" @@ -10,7 +10,6 @@ keywords: - "fully diluted valuation" - "fdv" --- - # Supply fields reference The **`Supply`** object appears on the **Tokens**, **Currency**, and **Pairs** cubes with the same field names. Values describe the **underlying asset** (**currency**), not a specific pool or DEX pair. @@ -33,7 +32,6 @@ An estimate of the number of tokens **available to the market** (public float), **Circulating supply** and **max supply** coverage is available for assets that trade on **CEXs**; many **meme tokens** and thinly covered assets may **not** have these supply figures, so those fields are often missing for those names. - ### `TotalSupply` The **total issued supply** of the asset as represented in reference data taken from on-chain **total supply**. May differ from **circulating** when a large portion is not treated as circulating. diff --git a/docs/trading/crypto-price-api/tokens.md b/docs/trading/crypto-price-api/tokens.md index d16edc32..32eb025d 100644 --- a/docs/trading/crypto-price-api/tokens.md +++ b/docs/trading/crypto-price-api/tokens.md @@ -1,3 +1,7 @@ +--- +title: "Crypto Token Price API" +description: "Fetch token USD prices, market stats, and history with Bitquery crypto price APIs using GraphQL queries and live subscriptions." +--- # Tokens Cube The **Tokens** cube provides chain-specific, aggregated price and volume data for individual tokens. For a **query** example that returns tokens with volume and average price over the last 24h (including conditional metrics for 1h, 4h, 24h), see [Aggregated Token Data](https://ide.bitquery.io/aggregated-data) or the [Crypto Price API examples](/docs/trading/crypto-price-api/examples#aggregated-token-data-volume--price-last-24h). diff --git a/docs/trading/crypto-trades-api/traders-api.md b/docs/trading/crypto-trades-api/traders-api.md index 94cec30d..800b5903 100644 --- a/docs/trading/crypto-trades-api/traders-api.md +++ b/docs/trading/crypto-trades-api/traders-api.md @@ -1,6 +1,6 @@ --- title: "Traders API — Real-Time Wallet Trade Streams" -description: "Stream real-time wallet trades with Bitquery Traders API. Track specific wallets, monitor multiple addresses, detect whale trades, filter by token/pair/DEX/chain, rank top traders by volume or PnL, and aggregate wallet PnL across Solana, Ethereum & BSC via GraphQL." +description: "Traders API — Real-Time Wallet Trade Streams via Bitquery Trading APIs for multi-chain prices, OHLC candles, volume metrics, and live streams." keywords: - traders API - wallet trade tracking API @@ -19,16 +19,15 @@ keywords: - top traders by PnL API - crypto wallet activity feed --- - # Traders API — Real-Time Wallet Trade Streams :::tip Which trade API should you use? -The Traders API is the wallet-centric view of **`Trading.Trades`** — designed for **real-time and the last ~30 days**. For older / historical wallet activity (anything beyond ~30 days), use chain-level [`DEXTrades`](https://docs.bitquery.io/docs/cubes/dextrades) or [`DEXTradeByTokens`](https://docs.bitquery.io/docs/cubes/dextradesbyTokens) on the relevant chain root. See the [**Trading Data Overview**](https://docs.bitquery.io/docs/trading/trading-data-overview) for the full comparison. +The Traders API is the wallet-centric view of **`Trading.Trades`** — designed for **real-time and the last ~30 days**. For older / historical wallet activity (anything beyond ~30 days), use chain-level [`DEXTrades`](/docs/cubes/dextrades) or [`DEXTradeByTokens`](/docs/cubes/dextradesbyTokens) on the relevant chain root. See the [**Trading Data Overview**](/docs/trading/trading-data-overview) for the full comparison. ::: > **Bitquery Traders API** lets you **stream wallet trades in real time** across **Solana**, **Ethereum**, **BSC**, **Base**, and **Arbitrum** . You can track a **single wallet** or **multiple addresses**, detect **whale trades** above a USD threshold, filter by **token**, **pair**, **DEX program**, or **chain**, rank **top traders by volume** or **PnL**, and aggregate **buy/sell USD** with **`sum`**, **`calculate`**, **`limitBy`**, and **`orderBy`** using **GraphQL subscriptions** and **queries**. -This page focuses on **trader/wallet-centric** queries using the unified **Trading** schema. For trade-level streaming (by token, pair, chain, or DEX), see the **[Trades API](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api)**. +This page focuses on **trader/wallet-centric** queries using the unified **Trading** schema. For trade-level streaming (by token, pair, chain, or DEX), see the **[Trades API](/docs/trading/crypto-trades-api/trades-api)**. ## Video Tutorial @@ -1247,13 +1246,13 @@ You can run this query [in the Bitquery IDE](https://ide.bitquery.io/Traders-pay > Extend your **trader analytics** with these complementary Bitquery APIs — **trade streams**, **price data**, **market cap**, **OHLC**, and **chain-specific DEX** docs for deeper wallet and token analysis. -- **[Trades API](https://docs.bitquery.io/docs/trading/crypto-trades-api/trades-api)** — stream trades by token, pair, chain, DEX, or USD threshold (not wallet-filtered) -- **[Crypto MarketCap API](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-marketcap-api)** — USD market cap, FDV, and token supply data -- **[Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction)** — Tokens, Pairs, Currencies cubes and Kafka `trading.prices` -- **[OHLC / K-line API](https://docs.bitquery.io/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api)** — candlestick and interval data for charting -- **[Solana DEX Trades](https://docs.bitquery.io/docs/blockchain/Solana/solana-dextrades)** — chain-level `DEXTrades` and `DEXTradeByTokens` with aggregation (top traders, PnL, first buyers) -- **[Solana Trader API](https://docs.bitquery.io/docs/blockchain/Solana/solana-trader-API)** — Solana-specific wallet queries with `DEXTradeByTokens` aggregation -- **[BSC DEX Trades](https://docs.bitquery.io/docs/blockchain/BSC/bsc-dextrades)** — BSC top traders by profit, first buyers, and per-wallet token stats -- **[Pump.fun API](https://docs.bitquery.io/docs/blockchain/Solana/Pumpfun/Pump-Fun-API)** — Pump.fun trades, bonding curve, top traders, and market cap -- **[PumpSwap API](https://docs.bitquery.io/docs/blockchain/Solana/Pumpfun/pump-swap-api)** — PumpSwap AMM trades, pools, and pricing -- **[gRPC Copy Trading Bot](https://docs.bitquery.io/docs/grpc/solana/examples/grpc-copy-trading-bot)** — low-latency CoreCast gRPC streaming for copy trading +- **[Trades API](/docs/trading/crypto-trades-api/trades-api)** — stream trades by token, pair, chain, DEX, or USD threshold (not wallet-filtered) +- **[Crypto MarketCap API](/docs/trading/crypto-price-api/crypto-marketcap-api)** — USD market cap, FDV, and token supply data +- **[Crypto Price API](/docs/trading/crypto-price-api/introduction)** — Tokens, Pairs, Currencies cubes and Kafka `trading.prices` +- **[OHLC / K-line API](/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api)** — candlestick and interval data for charting +- **[Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades)** — chain-level `DEXTrades` and `DEXTradeByTokens` with aggregation (top traders, PnL, first buyers) +- **[Solana Trader API](/docs/blockchain/Solana/solana-trader-API)** — Solana-specific wallet queries with `DEXTradeByTokens` aggregation +- **[BSC DEX Trades](/docs/blockchain/BSC/bsc-dextrades)** — BSC top traders by profit, first buyers, and per-wallet token stats +- **[Pump.fun API](/docs/blockchain/Solana/Pumpfun/Pump-Fun-API)** — Pump.fun trades, bonding curve, top traders, and market cap +- **[PumpSwap API](/docs/blockchain/Solana/Pumpfun/pump-swap-api)** — PumpSwap AMM trades, pools, and pricing +- **[gRPC Copy Trading Bot](/docs/grpc/solana/examples/grpc-copy-trading-bot)** — low-latency CoreCast gRPC streaming for copy trading diff --git a/docs/trading/crypto-trades-api/trades-api.md b/docs/trading/crypto-trades-api/trades-api.md index 301e1b3e..fc877130 100644 --- a/docs/trading/crypto-trades-api/trades-api.md +++ b/docs/trading/crypto-trades-api/trades-api.md @@ -1,6 +1,6 @@ --- -title: "Crypto Trades API — Real-Time DEX Trade Streams Across Chains" -description: "Stream real-time DEX trades with Bitquery Crypto Trades API. Get swap-level price, USD amounts, market cap, FDV & supply on Solana, Ethereum, BSC, Base & Arbitrum via GraphQL subscriptions." +title: "Crypto Trades API — Real-Time DEX Trade Streams Across" +description: "Crypto Trades API — Real-Time DEX Trade Streams Across via Bitquery Trading APIs for multi-chain prices, OHLC candles, volume metrics, and live streams." keywords: - crypto trades API - real-time DEX trade stream @@ -18,7 +18,7 @@ import FAQ from "@site/src/components/FAQ"; # Crypto Trades API — Real-Time DEX Trade Streams :::tip Which trade API should you use? -This page covers **`Trading.Trades`** — the curated, multi-chain trade feed for **real-time and the last ~30 days**. For older / historical data (anything beyond ~30 days) drop down to chain-level [`DEXTrades`](https://docs.bitquery.io/docs/cubes/dextrades) or [`DEXTradeByTokens`](https://docs.bitquery.io/docs/cubes/dextradesbyTokens). See the [**Trading Data Overview**](https://docs.bitquery.io/docs/trading/trading-data-overview) for a full side-by-side comparison. +This page covers **`Trading.Trades`** — the curated, multi-chain trade feed for **real-time and the last ~30 days**. For older / historical data (anything beyond ~30 days) drop down to chain-level [`DEXTrades`](/docs/cubes/dextrades) or [`DEXTradeByTokens`](/docs/cubes/dextradesbyTokens). See the [**Trading Data Overview**](/docs/trading/trading-data-overview) for a full side-by-side comparison. ::: > **Bitquery Crypto Trades API** streams **individual swap-level DEX trades** in **real time** across **Solana**, **Ethereum**, **BSC**, **Base**, **Arbitrum**, and **Polygon**. Each row includes **price**, **USD amounts**, **market cap**, **FDV**, **supply**, **trader address**, and **transaction metadata** via **GraphQL subscriptions**. diff --git a/docs/trading/trading-data-overview.md b/docs/trading/trading-data-overview.md index d60b45b8..e246840e 100644 --- a/docs/trading/trading-data-overview.md +++ b/docs/trading/trading-data-overview.md @@ -1,6 +1,6 @@ --- title: "Trading Data Overview — Chain-Level Trades vs Trading Cube" -description: "Bitquery exposes DEX trading data in two ways: raw chain-level trades (DEXTrades / DEXTradeByTokens) and the unified Trading cube (Trading.Trades, Currencies, Tokens, Pairs). Learn the difference and pick the right API." +description: "Trading Data Overview — Chain-Level Trades vs Trading Cube via Bitquery Trading APIs for multi-chain prices, OHLC candles, volume metrics, and live." sidebar_position: 1 keywords: - bitquery trading data @@ -15,7 +15,6 @@ keywords: - crypto price api - multi-chain trading api --- - import FAQ from "@site/src/components/FAQ"; # Trading Data Overview — Chain-Level Trades vs Trading Cube @@ -69,7 +68,7 @@ Chain-level trades are parsed **directly from each blockchain**. Every DEX swap - Custom OHLC intervals not supported by the pre-aggregated cubes. - On-chain analytics scoped to a single chain or a specific DEX protocol. -Learn more: [DEX Trades API (EVM)](/docs/evm/dextrades) · [DEXTradeByTokens Cube](/docs/cubes/dextradesbyTokens) · [Crypto Price API vs DEXTradeByTokens](/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api#crypto-price-api-vs-dextradebytoken). +Learn more: [DEX Trades API (EVM)](/docs/schema/evm/dextrades) · [DEXTradeByTokens Cube](/docs/cubes/dextradesbyTokens) · [Crypto Price API vs DEXTradeByTokens](/docs/trading/crypto-price-api/crypto-ohlc-candle-k-line-api#crypto-price-api-vs-dextradebytoken). --- @@ -156,7 +155,7 @@ The first two rows answer the question for 80% of users — pick by **how far ba | Stream all swaps on 9 chains in **one** subscription | `Trading.Trades` | | Build OHLC at a **custom** interval (e.g. 7-second, 4-hour) | `DEXTradeByTokens` (in-query aggregation) | | Join trades to the originating **call / instruction / event log** | `EVM.DEXTrades` / `Solana.DEXTrades` | -| Analyse MEV, sandwich attacks, or raw flow | Chain-level (Trading cube filters these out) | +| Analyze MEV, sandwich attacks, or raw flow | Chain-level (Trading cube filters these out) | | Build wallet-level PnL with USD attribution out-of-the-box | `Trading.Trades` | :::tip Mixing both layers @@ -168,7 +167,7 @@ A common pattern is to use the **Trading cube** for the live + 30-day-window tab ## Next steps - **Trading cube docs:** [Crypto Trades API](/docs/trading/crypto-trades-api/trades-api) · [Crypto Price API](/docs/trading/crypto-price-api/introduction) · [Tokens cube](/docs/trading/crypto-price-api/tokens) · [Currencies cube](/docs/trading/crypto-price-api/currency) · [Pairs cube](/docs/trading/crypto-price-api/pairs) -- **Chain-level trade docs:** [DEX Trades (EVM)](/docs/evm/dextrades) · [DEXTradeByTokens cube](/docs/cubes/dextradesbyTokens) · [Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades) +- **Chain-level trade docs:** [DEX Trades (EVM)](/docs/schema/evm/dextrades) · [DEXTradeByTokens cube](/docs/cubes/dextradesbyTokens) · [Solana DEX Trades](/docs/blockchain/Solana/solana-dextrades) - **Price Index internals:** [Price Index Algorithm](/docs/trading/crypto-price-api/price-index-algorithm) · [Supply fields reference](/docs/trading/crypto-price-api/supply-fields) - **API delivery comparison:** [GraphQL Query vs Subscription vs Kafka](/docs/api-comparison) diff --git a/docs/usecases/Top-10-ethereum-tokens.md b/docs/usecases/Top-10-ethereum-tokens.md index ea6b5ced..b1f81644 100644 --- a/docs/usecases/Top-10-ethereum-tokens.md +++ b/docs/usecases/Top-10-ethereum-tokens.md @@ -1,7 +1,8 @@ --- sidebar_position: 4 +title: "Dashboard : Top 10 Ethereum Token Pairs" +description: "Build Dashboard : Top 10 Ethereum Token Pairs: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." --- - # Dashboard : Top 10 Ethereum Token Pairs The following tutorial helps build a Top 10 Ethereum Tokens Dashboard with Next JS and Bitquery APIs that fetches and displays the Top 10 Token Pairs in last 1 hour on Ethereum mainnet in desceneding order of number of transactions. @@ -19,7 +20,7 @@ Github Code Repository - [Repository Link](https://github.com/Akshat-cs/Top-10-E ## Prerequisites 1. **Node.js** and **npm** installed on your system. -2. **Bitquery Account** with OAuth token (follow instructions [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/)). +2. **Bitquery Account** with OAuth token (follow instructions [here](/docs/authorization/how-to-generate/)). 3. **Git** installed on your pc. ## Code Walkthrough diff --git a/docs/usecases/add-liquidity-signal-bot.md b/docs/usecases/add-liquidity-signal-bot.md index 12389c2c..7a8896d5 100644 --- a/docs/usecases/add-liquidity-signal-bot.md +++ b/docs/usecases/add-liquidity-signal-bot.md @@ -1,3 +1,7 @@ +--- +title: "Add-Liquidity Signals Telegram Bot" +description: "Build Add-Liquidity Signals Telegram Bot: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # Add-Liquidity Signals Telegram Bot This bot fetches real-time data on added liquidity for Solana DEX pools and sends alerts via Telegram. It highlights key details such as added liquidity, post-liquidity amounts, and provides direct trading links. @@ -25,7 +29,7 @@ import VideoPlayer from "../../src/components/videoplayer.js"; 1. **Python 3.8+** installed on your system. 2. **Telegram Bot Token** from [BotFather](https://telegram.me/BotFather). -3. **Bitquery API Token** for accessing Solana liquidity data. Get your API token [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/). +3. **Bitquery API Token** for accessing Solana liquidity data. Get your API token [here](/docs/authorization/how-to-generate/). ## Installation @@ -41,7 +45,7 @@ import VideoPlayer from "../../src/components/videoplayer.js"; pip install python-telegram-bot aiohttp ``` -3. Replace Bot token and OAuth Token values in the `top-liquidity-additions.py` file with your own tokens. Get the BOT_TOKEN from Bot father and Bitquery OAuth token using these [steps](https://docs.bitquery.io/docs/authorisation/how-to-generate/): +3. Replace Bot token and OAuth Token values in the `top-liquidity-additions.py` file with your own tokens. Get the BOT_TOKEN from Bot father and Bitquery OAuth token using these [steps](/docs/authorization/how-to-generate/): ``` BOT_TOKEN=your-telegram-bot-token diff --git a/docs/usecases/arbitrum-sniper-bot.mdx b/docs/usecases/arbitrum-sniper-bot.mdx index 3fee5293..dbf135d5 100644 --- a/docs/usecases/arbitrum-sniper-bot.mdx +++ b/docs/usecases/arbitrum-sniper-bot.mdx @@ -1,3 +1,7 @@ +--- +title: "Arbitrum Sniper Bot" +description: "Build Arbitrum Sniper Bot: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code. See examples in the Bitquery IDE." +--- # Tutorial : Building a Arbitrum Sniper Bot Using Bitquery Arbitrum Events API and Uniswap SDK This tutorial will guide you through building a Arbitrum sniper bot using Bitquery Events API and the Uniswap SDK for executing swaps. @@ -17,7 +21,7 @@ Github Code Repository - [Repository Link](https://github.com/Akshat-cs/Arbitrum ### Prerequisites 1. **Node.js** and **npm** installed on your system. -2. **Bitquery Free Developer Account** with OAuth token (follow instructions [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/)). +2. **Bitquery Free Developer Account** with OAuth token (follow instructions [here](/docs/authorization/how-to-generate/)). 3. **Any Arbitrum Chain supported Wallet** with some Arbitrum ETH for transaction fees and also some WETH as I have used WETH in the video tutorial to make swap. I have used the Bitquery Arbitrum Events API to get the latest created pool which has Token A as WETH with Token Addres `0x82aF49447D8a07e3bd95BD0d56f35241523fBab1`. - If you want to conduct the swap using different Token then you can change the address in this `Arguments: {startsWith: {Value: {Address: {is: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1"}}}}` in tokens.ts file to your Token Address that you want to conduct swaps with. @@ -42,7 +46,7 @@ Github Code Repository - [Repository Link](https://github.com/Akshat-cs/Arbitrum 1. **Create a `.env` file :** - This file will contain all the environment variables. Put in your Wallet private key that you are using to conduct swap. And also put in the Bitquery OAuth Token, follow the instructions on how to get it [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/). + This file will contain all the environment variables. Put in your Wallet private key that you are using to conduct swap. And also put in the Bitquery OAuth Token, follow the instructions on how to get it [here](/docs/authorization/how-to-generate/). ```javascript # Arbitrum MAINNET @@ -252,7 +256,6 @@ For the sake of the demo we have used a query, to **track new tokens in real-tim } } - ``` 4. **Create a `index.ts` file:** diff --git a/docs/usecases/automated-trading-ethereum-volume-surge-bot.mdx b/docs/usecases/automated-trading-ethereum-volume-surge-bot.mdx index 2fd01c39..fba2e574 100644 --- a/docs/usecases/automated-trading-ethereum-volume-surge-bot.mdx +++ b/docs/usecases/automated-trading-ethereum-volume-surge-bot.mdx @@ -1,6 +1,10 @@ +--- +title: "Automated Trading Ethereum Volume Surge Bot" +description: "Build Automated Trading Ethereum Volume Surge Bot: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # Automated Trading on Ethereum: How To Build a Volume Surge Detection Bot -In this tutorial, we will build a Python bot that monitors token trading volume on Ethereum and automatically executes buy orders when volume surges by 10% or more. For real-time price data with volume metrics, use our [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/). +In this tutorial, we will build a Python bot that monitors token trading volume on Ethereum and automatically executes buy orders when volume surges by 10% or more. For real-time price data with volume metrics, use our [Crypto Price API](/docs/trading/crypto-price-api/introduction/). We’ll leverage the Bitquery APIs with Python to monitor activities and automatically execute trades in real-time. We’ll explore how to access and use Bitquery APIs to fetch real-time trading volume data, calculate volume changes, and perform automated transactions on the Ethereum Sepolia testnet. @@ -20,7 +24,7 @@ In this section, we’ll build an MEV bot that detects a surge in trade volume f This tutorial will guide you through creating a Python script that detects a surge in trading volume for a specific token and executes a buy order on the Ethereum Sepolia testnet. We'll use the Bitquery API to fetch trading volume data and Web3.py to interact with the Ethereum blockchain. -This bot uses the [Bitquery API](https://docs.bitquery.io/docs/intro/) to fetch real-time trading data and Web3.py to interact with the Ethereum blockchain, demonstrating a practical application of Python in blockchain trading automation using the Bitquery API. +This bot uses the [Bitquery API](/docs/intro/) to fetch real-time trading data and Web3.py to interact with the Ethereum blockchain, demonstrating a practical application of Python in blockchain trading automation using the Bitquery API. - Here is the [link](https://github.com/bitquery/volume-surge-trading-bot/tree/main) to the GitHub Repository for the volume surge detection MEV bot - Here is also a [step-by-step video tutorial](https://www.youtube.com/watch?v=2sK-dtYF2-k) for the project. @@ -41,7 +45,7 @@ The requests library is used for making Https requests in python while the web3 2. Once you’ve set up your python environment and download the necessary library for the project as we’ve done in the previous step, you need to set up the API keys needed to retrieve the data from Bitquery. -- Follow [this link](https://docs.bitquery.io/docs/authorisation/how-to-generate/) to learn how to generate the tokens either programmatically or manually to use for this project. +- Follow [this link](/docs/authorization/how-to-generate/) to learn how to generate the tokens either programmatically or manually to use for this project. - Visit the alchemy website, and follow the necessary instructions to generate the URL needed to connect with your Sepolia Testnet through the Infura environment. @@ -102,7 +106,7 @@ print(f"PREDEFINED_TILL_DATE: {PREDEFINED_TILL_DATE}") At this step, you create the fetch_volume_data function to fetch historical trading volume data from Bitquery. -The fetch_volume_data function below takes the token_address parameter and uses the [DEXTradeByTokens API](https://docs.bitquery.io/docs/schema/evm/dextrades/) to retrieve the count of trade, sell, and buy amounts from the blockchain using the variables you set up in Step2 (Script configuration) above. +The fetch_volume_data function below takes the token_address parameter and uses the [DEXTradeByTokens API](/docs/schema/evm/dextrades/) to retrieve the count of trade, sell, and buy amounts from the blockchain using the variables you set up in Step2 (Script configuration) above. ```python # Function to fetch historical volume data from Bitquery @@ -135,7 +139,6 @@ print("Querying Bitquery API...") headers={'Authorization': f'Bearer {BITQUERY_AUTH_TOKEN}'} ) - if response.status_code == 200: print("Data successfully fetched.") data = response.json() @@ -150,7 +153,6 @@ print("Querying Bitquery API...") else: raise Exception(f"Failed to fetch data: {response.text}") - except Exception as e: print(f"Error in fetch_volume_data: {str(e)}") return None @@ -172,7 +174,6 @@ def get_volume(): if trades is None: return 0 # No trades, so volume is 0 - total_volume = sum(float(trade['buy']) + float(trade['sell']) for trade in trades) print(f"Total volume: {total_volume}") return total_volume @@ -279,26 +280,21 @@ def main(): initial_volume = get_volume() print("Initial Volume:", initial_volume) - while True: current_volume = get_volume() print("Current Volume:", current_volume) - if check_volume_surge(initial_volume, current_volume): print(f"Volume surge detected. Executing buy order.") tx_hash = execute_buy_order(TOKEN_ADDRESS) if tx_hash: print(f"Transaction hash: {tx_hash}") - time.sleep(60 * 1) # Check every 1 minute - except Exception as e: print(f"Error occurred: {str(e)}") - if __name__ == "__main__": main() ``` diff --git a/docs/usecases/base-sniper-bot.mdx b/docs/usecases/base-sniper-bot.mdx index 23d95376..6e97f84a 100644 --- a/docs/usecases/base-sniper-bot.mdx +++ b/docs/usecases/base-sniper-bot.mdx @@ -1,3 +1,7 @@ +--- +title: "Base Sniper Bot" +description: "Build Base Sniper Bot: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code. Keep queries fast with indexed filters." +--- # Tutorial : Building a Base Sniper Bot Using Bitquery Base Events API and Uniswap SDK This tutorial will guide you through building a Base sniper bot using Bitquery Events API and the Uniswap SDK for executing swaps. @@ -17,7 +21,7 @@ Github Code Repository - [Repository Link](https://github.com/Akshat-cs/Base-sni ### Prerequisites 1. **Node.js** and **npm** installed on your system. -2. **Bitquery Free Developer Account** with OAuth token (follow instructions [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/)). +2. **Bitquery Free Developer Account** with OAuth token (follow instructions [here](/docs/authorization/how-to-generate/)). 3. **Any Base Chain supported Wallet** with some Base ETH for transaction fees and also some WETH as I have used WETH in the video tutorial to make swap. I have used the Bitquery Base Events API to get the latest created pool which has Token A as WETH with Token Addres `0x4200000000000000000000000000000000000006`. - If you want to conduct the swap using different Token then you can change the address in this `Arguments: {startsWith: {Value: {Address: {is: "0x4200000000000000000000000000000000000006"}}}}` in tokens.ts file to your Token Address that you want to conduct swaps with. @@ -42,7 +46,7 @@ Github Code Repository - [Repository Link](https://github.com/Akshat-cs/Base-sni 1. **Create a `.env` file :** - This file will contain all the environment variables. Put in your Wallet private key that you are using to conduct swap. And also put in the Bitquery OAuth Token, follow the instructions on how to get it [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/). + This file will contain all the environment variables. Put in your Wallet private key that you are using to conduct swap. And also put in the Bitquery OAuth Token, follow the instructions on how to get it [here](/docs/authorization/how-to-generate/). ```javascript # BASE MAINNET diff --git a/docs/usecases/binance-exchange-wallet-monitoring.md b/docs/usecases/binance-exchange-wallet-monitoring.md index 9cfd2dcd..be5dcd77 100644 --- a/docs/usecases/binance-exchange-wallet-monitoring.md +++ b/docs/usecases/binance-exchange-wallet-monitoring.md @@ -1,6 +1,10 @@ +--- +title: "Binance Exchange Wallet Monitoring" +description: "Build Binance Exchange Wallet Monitoring: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # Monitoring Withdrawals and Deposits for 1000s of Binance Exchange Wallets -In this guide we will utilize the [Protobuf Kafka streams](docs/streams/protobuf/kafka-protobuf-python.md) provided by Bitquery to monitor withdrawls and deposits for a large number of Binance Exchange Wallets on BSC network. You can read more about Kafka solution by Bitquery [here](docs/streams/kafka-streaming-concepts.md). +In this guide we will utilize the [Protobuf Kafka streams](/docs/streams/protobuf/kafka-protobuf-python/) provided by Bitquery to monitor withdrawals and deposits for a large number of Binance Exchange Wallets on BSC network. You can read more about Kafka solution by Bitquery [here](/docs/streams/kafka-streaming-concepts/). Checkout the complete [codebase](https://github.com/bitquery/binance-exchange-wallets-monitoring) for any issues in the tutorial. @@ -91,7 +95,7 @@ consumer.subscribe([topic]) ## Creating Set of Binance Exchange Wallets -For the purpose of tutorial we have directly created a set containing a bunch of Binance exchange wallet addresses. When building an enterprise grade solution where the number of wallets are in thousands or millions, the set could be saved in a seperate file. The wallets are stored in a set instead of list due to fast lookup in sets. +For the purpose of tutorial we have directly created a set containing a bunch of Binance exchange wallet addresses. When building an enterprise grade solution where the number of wallets are in thousands or millions, the set could be saved in a separate file. The wallets are stored in a set instead of list due to fast lookup in sets. ```python wallets = { @@ -177,4 +181,4 @@ python main.py ## Final Result -![Final Results of Project](../../static/img/usecases/kafka-examples/result.png) +![Final Results of Project](/img/usecases/kafka-examples/result.png) diff --git a/docs/usecases/copy-trading-bot.md b/docs/usecases/copy-trading-bot.md index 79474840..c0cbce6b 100644 --- a/docs/usecases/copy-trading-bot.md +++ b/docs/usecases/copy-trading-bot.md @@ -1,14 +1,18 @@ +--- +title: "How to Build a Solana Copy Trading Bot - Tutorial" +description: "Build How to Build a Solana Copy Trading Bot - Tutorial: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- import VideoPlayer from "../../src/components/videoplayer.js"; # How to Build a Solana Copy Trading Bot - Tutorial -This project is a Solana copy trading bot that allows users to replicate trades executed by a specified account on the Solana blockchain. The bot fetches trading data using the Bitquery API. For real-time price monitoring, consider using our [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/). However since this is a tutorial project we don't execute a trade but rather store the trade info in an excel document. This is to provide an understanding on how Bitquery APIs could be used to build a full product. +This project is a Solana copy trading bot that allows users to replicate trades executed by a specified account on the Solana blockchain. The bot fetches trading data using the Bitquery API. For real-time price monitoring, consider using our [Crypto Price API](/docs/trading/crypto-price-api/introduction/). However since this is a tutorial project we don't execute a trade but rather store the trade info in an excel document. This is to provide an understanding on how Bitquery APIs could be used to build a full product. > Note: This material is for educational and informational purposes only and is not intended as investment advice. The content reflects the author's personal research and understanding. While specific investments and strategies are mentioned, no endorsement or association with these entities is implied. Readers should conduct their own research and consult with qualified professionals before making any investment decisions. Bitquery is not liable for any losses or damages resulting from the application of this information. ## How do I backtest a copy-trading strategy using Bitquery? -**Backtesting** means replaying history: pull past **DEX trades** (or transfers) for the leader wallet and optionally **token prices** over the same windows, then simulate entries/exits in your code. Use **`Solana.DEXTrades`** / **`DEXTradeByTokens`** with **`Block.Time`** ranges, pagination, and [starter trader / PnL examples](https://docs.bitquery.io/docs/start/starter-queries/). This tutorial shows how to **fetch** live trades; extend it with archived time ranges and your own PnL rules—Bitquery supplies data, not a built-in backtester. +**Backtesting** means replaying history: pull past **DEX trades** (or transfers) for the leader wallet and optionally **token prices** over the same windows, then simulate entries/exits in your code. Use **`Solana.DEXTrades`** / **`DEXTradeByTokens`** with **`Block.Time`** ranges, pagination, and [starter trader / PnL examples](/docs/start/starter-queries/). This tutorial shows how to **fetch** live trades; extend it with archived time ranges and your own PnL rules—Bitquery supplies data, not a built-in backtester. ## Understanding the Code @@ -94,7 +98,6 @@ url = "https://streaming.bitquery.io/graphql" 'Authorization': token } - ``` #### Response Handling diff --git a/docs/usecases/crypto-dashboard.md b/docs/usecases/crypto-dashboard.md index e31c1738..2e8f8028 100644 --- a/docs/usecases/crypto-dashboard.md +++ b/docs/usecases/crypto-dashboard.md @@ -1,222 +1,223 @@ ---- -sidebar_position: 4 ---- - -# Crypto Dashboard Project - -The following tutorial helps build a Cryptocurrency Portfolio Dashboard with React that fetches and displays the balance of different currencies for a given Ethereum address using the Bitquery Streaming API. - -This is how it will look ![finally](/img/ApplicationExamples/crypto_dashboard.gif) - -The app has the following features: - -1. It renders an input field and a button to trigger the data fetching process. -2. It displays a spinner while the data is being fetched. -3. It displays a table with the currency name and the corresponding balance once the data is fetched. -4. It handles errors during the data fetching process. - -The app uses the following libraries and APIs: - -1. React: A JavaScript library for building user interfaces. -2. Axios: A promise-based HTTP client for the browser and Node.js. -3. Bitquery GraphQL API: A service that provides access to blockchain data through a GraphQL interface. - -To use this code, you need to have the following dependencies installed in your project: - -1. react -2. react-dom -3. axios -4. react-icons - - -### Create App -Create an empty react app with the -``` -npx create-react-app my-app - -``` -command and clear the defaults in app.js file. - - -### Import Statements -``` -import React, { useState } from 'react'; -import axios from 'axios'; -import './portfolio.css'; -import { FaSpinner } from 'react-icons/fa'; - -``` -### Functional Component -```js -function App() { - const [data, setData] = useState(null); - const [address, setAddress] = useState(''); - const [isLoading, setIsLoading] = useState(false); - - const fetchData = () => { - setIsLoading(true); - var query = `query MyQuery { - EVM(dataset: combined, network: eth) { - BalanceUpdates( - where: { BalanceUpdate: { Address: { is: "${address}" } } } - ) { - Currency { - Name - } - balance: sum(of: BalanceUpdate_Amount) - } - } - }`; - - var data = JSON.stringify({ query }); - - var config = { - method: 'post', - url: 'https://streaming.bitquery.io/graphql', - headers: { - 'Content-Type': 'application/json', - Authorization: "Bearer your_access_token_here", - }, - data: data - }; - - axios(config) - .then(function (response) { - setData(response.data.data.EVM.BalanceUpdates); - setIsLoading(false); - }) - .catch(function (error) { - console.log(error); - setIsLoading(false); - }); - }; - -``` -### State Management with `useState` Hook - -- `const [data, setData] = useState(null);`: Declares a state variable `data` that is initially `null`. Also defines a setter function `setData` to update the state value of `data`. -- `const [address, setAddress] = useState('');`: Declares a state variable `address` that is initially an empty string. Also defines a setter function `setAddress` to update the state value of `address`. -- `const [isLoading, setIsLoading] = useState(false);`: Declares a state variable `isLoading` that is initially `false`. Also defines a setter function `setIsLoading` to update the state value of `isLoading`. - -### `fetchData` Method - -- `const fetchData = () => { ... }`: Defines a method `fetchData` that makes an HTTP POST request to the Bitquery API to retrieve data for the entered Ethereum address. - -### Component Render -```js - return ( -
-

Your Portfolio

- setAddress(event.target.value)} - placeholder="Enter address" - /> - - {isLoading ? ( -
- -
- ) : ( - data && ( - - - - - - - - - {data.map((item, index) => ( - - - - - ))} - -
CurrencyBalance
{item.Currency.Name}{item.balance}
- ) - )} -
- ); -} - -export default App; -``` -### CSS Styling -The app uses CSS classes defined in a separate portfolio.css file to style various elements: -```css -.balance-list { - display: table-cell; - flex-direction: column; - justify-content: center; - align-items: center; - margin-top: 2rem; - padding: 0; - list-style: none; - } - - .balance-list li { - display: flex; - flex-direction: row; - justify-content: space-between; - align-items: center; - margin: 1rem 0; - padding: 1rem 2rem; - font-size: 1rem; - background-color: #f8f8f8; - border: 1px solid #ccc; - border-radius: 5px; - } - - - - .currency-name { - font-weight: bold; - font-size: 1.2rem; - margin-right: 1rem; - } - - .balance-amount { - font-size: 1.2em; - font-family: monospace; - } - .fetch-data-button { - background-color: #4CAF50; - color: white; - padding: 12px 24px; - border: none; - border-radius: 4px; - cursor: pointer; - font-size: 1.2em; - } - - .fetch-data-button:hover { - background-color: #3e8e41; - } - - @keyframes fadeIn { - from { - opacity: 0; - } - to { - opacity: 1; - } - } - - .fade-in { - animation: fadeIn 1s ease-in-out; - } - - .address-input { - font-size: 1.2rem; - padding: 0.5rem; - border: none; - border-radius: 0.25rem; - box-shadow: 0 0 0.5rem rgba(0, 0, 0, 0.1); - outline: none; - margin-right: 0.5rem; - } - -``` \ No newline at end of file +--- +sidebar_position: 4 +title: "Crypto Dashboard Project" +description: "Build Crypto Dashboard Project: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- +# Crypto Dashboard Project + +The following tutorial helps build a Cryptocurrency Portfolio Dashboard with React that fetches and displays the balance of different currencies for a given Ethereum address using the Bitquery Streaming API. + +This is how it will look: + + + +The app has the following features: + +1. It renders an input field and a button to trigger the data fetching process. +2. It displays a spinner while the data is being fetched. +3. It displays a table with the currency name and the corresponding balance once the data is fetched. +4. It handles errors during the data fetching process. + +The app uses the following libraries and APIs: + +1. React: A JavaScript library for building user interfaces. +2. Axios: A promise-based HTTP client for the browser and Node.js. +3. Bitquery GraphQL API: A service that provides access to blockchain data through a GraphQL interface. + +To use this code, you need to have the following dependencies installed in your project: + +1. react +2. react-dom +3. axios +4. react-icons + +### Create App +Create an empty react app with the +``` +npx create-react-app my-app + +``` +command and clear the defaults in app.js file. + +### Import Statements +``` +import React, { useState } from 'react'; +import axios from 'axios'; +import './portfolio.css'; +import { FaSpinner } from 'react-icons/fa'; + +``` +### Functional Component +```js +function App() { + const [data, setData] = useState(null); + const [address, setAddress] = useState(''); + const [isLoading, setIsLoading] = useState(false); + + const fetchData = () => { + setIsLoading(true); + var query = `query MyQuery { + EVM(dataset: combined, network: eth) { + BalanceUpdates( + where: { BalanceUpdate: { Address: { is: "${address}" } } } + ) { + Currency { + Name + } + balance: sum(of: BalanceUpdate_Amount) + } + } + }`; + + var data = JSON.stringify({ query }); + + var config = { + method: 'post', + url: 'https://streaming.bitquery.io/graphql', + headers: { + 'Content-Type': 'application/json', + Authorization: "Bearer your_access_token_here", + }, + data: data + }; + + axios(config) + .then(function (response) { + setData(response.data.data.EVM.BalanceUpdates); + setIsLoading(false); + }) + .catch(function (error) { + console.log(error); + setIsLoading(false); + }); + }; + +``` +### State Management with `useState` Hook + +- `const [data, setData] = useState(null);`: Declares a state variable `data` that is initially `null`. Also defines a setter function `setData` to update the state value of `data`. +- `const [address, setAddress] = useState('');`: Declares a state variable `address` that is initially an empty string. Also defines a setter function `setAddress` to update the state value of `address`. +- `const [isLoading, setIsLoading] = useState(false);`: Declares a state variable `isLoading` that is initially `false`. Also defines a setter function `setIsLoading` to update the state value of `isLoading`. + +### `fetchData` Method + +- `const fetchData = () => { ... }`: Defines a method `fetchData` that makes an HTTP POST request to the Bitquery API to retrieve data for the entered Ethereum address. + +### Component Render +```js + return ( +
+

Your Portfolio

+ setAddress(event.target.value)} + placeholder="Enter address" + /> + + {isLoading ? ( +
+ +
+ ) : ( + data && ( + + + + + + + + + {data.map((item, index) => ( + + + + + ))} + +
CurrencyBalance
{item.Currency.Name}{item.balance}
+ ) + )} +
+ ); +} + +export default App; +``` +### CSS Styling +The app uses CSS classes defined in a separate portfolio.css file to style various elements: +```css +.balance-list { + display: table-cell; + flex-direction: column; + justify-content: center; + align-items: center; + margin-top: 2rem; + padding: 0; + list-style: none; + } + + .balance-list li { + display: flex; + flex-direction: row; + justify-content: space-between; + align-items: center; + margin: 1rem 0; + padding: 1rem 2rem; + font-size: 1rem; + background-color: #f8f8f8; + border: 1px solid #ccc; + border-radius: 5px; + } + + + + .currency-name { + font-weight: bold; + font-size: 1.2rem; + margin-right: 1rem; + } + + .balance-amount { + font-size: 1.2em; + font-family: monospace; + } + .fetch-data-button { + background-color: #4CAF50; + color: white; + padding: 12px 24px; + border: none; + border-radius: 4px; + cursor: pointer; + font-size: 1.2em; + } + + .fetch-data-button:hover { + background-color: #3e8e41; + } + + @keyframes fadeIn { + from { + opacity: 0; + } + to { + opacity: 1; + } + } + + .fade-in { + animation: fadeIn 1s ease-in-out; + } + + .address-input { + font-size: 1.2rem; + padding: 0.5rem; + border: none; + border-radius: 0.25rem; + box-shadow: 0 0 0.5rem rgba(0, 0, 0, 0.1); + outline: none; + margin-right: 0.5rem; + } + +``` diff --git a/docs/usecases/defi_portfolio_scorer.md b/docs/usecases/defi_portfolio_scorer.md index 35be98b8..48f0b64d 100644 --- a/docs/usecases/defi_portfolio_scorer.md +++ b/docs/usecases/defi_portfolio_scorer.md @@ -1,3 +1,7 @@ +--- +title: "DeFi Portfolio Scorer" +description: "Build DeFi Portfolio Scorer: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # DeFi Portfolio Scorer This guide demonstrates how to build a DeFi Portfolio Scorer tool that analyzes Ethereum wallet address and calculates a DeFi Strategy Score based on transaction patterns, protocol interactions, and asset holdings using Bitquery APIs. @@ -53,7 +57,7 @@ The final score ranges from 25 (minimum) to 100 (maximum), providing a comprehen ## Prerequisites 1. **Python 3.7+** installed on your system -2. **Bitquery API Token** - Get your API token [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +2. **Bitquery API Token** - Get your API token [here](/docs/authorization/how-to-generate/) 3. Basic understanding of Ethereum blockchain and DeFi protocols ## Installation diff --git a/docs/usecases/discord-bot.md b/docs/usecases/discord-bot.md index 43b37e94..a5f1b44c 100644 --- a/docs/usecases/discord-bot.md +++ b/docs/usecases/discord-bot.md @@ -1,3 +1,7 @@ +--- +title: "Creating a Discord Bot to Fetch Price Data" +description: "Build Creating a Discord Bot to Fetch Price Data: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # Tutorial: Creating a Discord Bot to Fetch Price Data In this tutorial, we will walk you through the process of creating a Discord bot using the `discord.js` library. The bot will fetch price data using the dextrades API and respond to a specific command in a Discord server. @@ -14,7 +18,6 @@ Before we begin, make sure you have the following: - A Discord account - A Bitquery API Token (you can sign up for a free API token at [Bitquery](https://ide.bitquery.io/)) - #### Setting up the Bot Before we began coding, you need to create a bot on https://discord.com/developers/applications . diff --git a/docs/usecases/how-to-filter-anomaly-prices.md b/docs/usecases/how-to-filter-anomaly-prices.md index 380b78ec..fb3ca8a8 100644 --- a/docs/usecases/how-to-filter-anomaly-prices.md +++ b/docs/usecases/how-to-filter-anomaly-prices.md @@ -1,3 +1,7 @@ +--- +title: "How to Filter Abnormal Prices" +description: "Build How to Filter Abnormal Prices: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # How to Filter Abnormal Prices You might see abnormal prices when you fetch data from Bitquery APIs. There can be two possibilities as to why these abnormal prices associated with trades are appearing in your API response. @@ -6,7 +10,7 @@ You might see abnormal prices when you fetch data from Bitquery APIs. There can - In the second case, the Bitquery DB itself has incorrect trade data, then create a ticket [here](http://support.bitquery.io). -In the first case, we are going to see 3 different methods to filter anomaly trades. Anomaly trades are the trades that result in abnormally high or low prices in USD. Bitquery provides raw trade data and does not omit any trades that are happening over the network. But this also results in some issues for the Bitquery data consumers if they are trying to build something around the Price of tokens, such as trying to get All time high price or building OHLC/K-line charts. For pre-filtered, clean price data, consider using our [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/). +In the first case, we are going to see 3 different methods to filter anomaly trades. Anomaly trades are the trades that result in abnormally high or low prices in USD. Bitquery provides raw trade data and does not omit any trades that are happening over the network. But this also results in some issues for the Bitquery data consumers if they are trying to build something around the Price of tokens, such as trying to get All time high price or building OHLC/K-line charts. For pre-filtered, clean price data, consider using our [Crypto Price API](/docs/trading/crypto-price-api/introduction/). 3 ways to omit these types of anomaly trades: @@ -16,7 +20,7 @@ Price Asymmetry represents the difference in TradeAmount in USD of main currency as a filter in our APIs as this will filter out trades with more than 10% difference in their trade amounts. Also, filter out low AmountinUSD trades from this, say `{Trade: {AmountInUSD: \{lt: "10"\}}}` -Read more about Price Asymmetry [here](https://docs.bitquery.io/docs/graphql/metrics/priceAsymmetry/). +Read more about Price Asymmetry [here](/docs/graphql/metrics/priceAsymmetry/). Here's an example [query on ethereum trades](https://ide.bitquery.io/Price-based-on-DEX-trades-in-USD). @@ -49,7 +53,7 @@ For example, the median represents the middle point of the data. Half of the res The level: 0.75 represents the 75th percentile and it shows that 75% of the responses had values lower than this, while level: 0.25 represents the 25th percentile and it shows that 25% of the values were lower. -Read more about quantile [here](https://docs.bitquery.io/docs/graphql/metrics/quantile/). +Read more about quantile [here](/docs/graphql/metrics/quantile/). We can also remove anomaly trades using the quantile metric. Also add one more filter to remove low AmountinUSD trades from this, say `{Trade: {AmountInUSD: {lt: "10"}}}` @@ -104,7 +108,7 @@ query AllTimeHighTokenPriceQuery( ## 3. Get all trades and filter on your end Get all the trades from Bitquery API and then filter trades using your own custom logic so that you can remove the anomaly trades with abnormal prices. -One such example we have shown [here](https://docs.bitquery.io/docs/usecases/solana-ohlc-calculator/) where custom logic is a very basic one, fetching quantile values of Trade USD Price with level: 0.05 and level: 0.95 and then only fetching trades between these 2 Trade Prices and thus removing extremes. +One such example we have shown [here](/docs/usecases/solana-ohlc-calculator/) where custom logic is a very basic one, fetching quantile values of Trade USD Price with level: 0.05 and level: 0.95 and then only fetching trades between these 2 Trade Prices and thus removing extremes. ## Conclusion diff --git a/docs/usecases/mempool-transaction-fee.md b/docs/usecases/mempool-transaction-fee.md index b654aa69..f2ca5f1b 100644 --- a/docs/usecases/mempool-transaction-fee.md +++ b/docs/usecases/mempool-transaction-fee.md @@ -1,3 +1,7 @@ +--- +title: "Mempool Transaction Fee Explorer" +description: "Build Mempool Transaction Fee Explorer: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # Mempool Transaction Fee Explorer In the world of cryptocurrency, understanding transaction fees and their dynamics is crucial for traders, investors, and blockchain enthusiasts alike. Ethereum, one of the leading blockchain platforms, relies on a concept known as the "Mempool" to manage pending transactions and determine their associated fees. diff --git a/docs/usecases/monitoring-solana-at-scale-managing-hundreds-of-addresses.md b/docs/usecases/monitoring-solana-at-scale-managing-hundreds-of-addresses.md index 759ac194..e414d533 100644 --- a/docs/usecases/monitoring-solana-at-scale-managing-hundreds-of-addresses.md +++ b/docs/usecases/monitoring-solana-at-scale-managing-hundreds-of-addresses.md @@ -1,3 +1,7 @@ +--- +title: "Monitoring Solana at Scale: Managing 100s of Addresses" +description: "Build Monitoring Solana at Scale: Managing 100s of Addresses: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # Monitoring Solana at Scale: Managing 100s of Addresses This guide demonstrates how to monitor real-time token transfers and DEX trades for hundreds of blockchain addresses efficiently using WebSockets and Streamlit. Learn to dynamically track and display key transfer and trade details in a real-time dashboard. @@ -138,7 +142,7 @@ The dashboard will open in your browser, where you will see real-time updates of This is how it will look. -![](/img/ApplicationExamples/solana_transfer_monitoring.gif) + ## Scaling the Monitoring diff --git a/docs/usecases/monitoring-solana-blockchain-real-time-tutorial.mdx b/docs/usecases/monitoring-solana-blockchain-real-time-tutorial.mdx index 541ee2dd..0dd18a4f 100644 --- a/docs/usecases/monitoring-solana-blockchain-real-time-tutorial.mdx +++ b/docs/usecases/monitoring-solana-blockchain-real-time-tutorial.mdx @@ -1,3 +1,7 @@ +--- +title: "Monitoring the Solana Blockchain in Real Time" +description: "Build Monitoring the Solana Blockchain in Real Time: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # Monitoring the Solana Blockchain in Real Time - Easy Tutorial Monitoring blockchain activities is crucial for developers, investors, and regulatory bodies. [Bitquery](https://bitquery.io) offers the infrastructure to monitor blockchain activities effectively. In this tutorial, we'll use [Bitquery Solana real-time data](https://bitquery.io/blockchains/solana-blockchain-api) and Python to build a real-time Solana DEX monitoring dashboard. @@ -27,7 +31,7 @@ from gql.transport.websockets import WebsocketsTransport ## Step 2: Set Up the WebSocket Connection -To generate a token to run the subscription, check [the guide here](https://docs.bitquery.io/docs/authorisation/how-to-generate/). +To generate a token to run the subscription, check [the guide here](/docs/authorization/how-to-generate/). Define the asynchronous function `run_subscription` to establish and manage the WebSocket connection with Bitquery. This function will handle subscribing to the real-time data streams. @@ -158,11 +162,8 @@ if __name__ == "__main__": main() ``` - - ## The Final Result import VideoPlayer from "../../src/components/videoplayer.js"; - - \ No newline at end of file + diff --git a/docs/usecases/nft-analytics.md b/docs/usecases/nft-analytics.md index c1289ed8..c65b9ccc 100644 --- a/docs/usecases/nft-analytics.md +++ b/docs/usecases/nft-analytics.md @@ -1,13 +1,13 @@ --- sidebar_position: 3 +title: "NFT Analytics Dashboard - Tutorial" +description: "Build NFT Analytics Dashboard - Tutorial: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." --- - # NFT Analytics Dashboard - Tutorial ### Marketplace Analysis Bitquery's queries can help NFT marketplace builders analyze the performance of different NFTs on various blockchain networks. By providing real-time data on transaction volume, and other key metrics, Bitquery can help builders optimize their marketplace's offerings and improve trading conditions for users. - ## Tutorial This is a tutorial to build a NFT Dashboard using Python code that connects to the Bitquery API and retrieves data for a particular NFT on the Ethereum network. The code then displays the data on a user-friendly interface built using Python and Streamlit. @@ -64,7 +64,6 @@ st.metric("Count of Punk Evil Rabbit NFTS Bought",count_nfts_bought) ``` The title() and header() methods are used to display the title and header of the dashboard, respectively. The metric() method is used to display the count of NFTs bought as a metric. - ### Adding a Table This code snippet retrieves the latest DEX trades for a specific NFT token from the Ethereum blockchain using The Graph API, and displays them in a data table using the streamlit library. @@ -91,7 +90,6 @@ st.dataframe(df) The chart section of the code creates a line chart using the streamlit library. The chart displays the number of NFTs bought on a daily basis on the OpenSea protocol on the Ethereum blockchain. - ```python ## chart payload3 = json.dumps({ @@ -115,8 +113,9 @@ st.subheader('Daily Metrics') st.line_chart(df_chart,x='Block_Date',y='Count_NFTS_bought') ``` -#### Here's how it looks ![finally](/img/nft_dashboard.gif) +#### Here's how it looks + If you want to build up query from scratch you are welcome or you can use the [premade examples](https://ide.bitquery.io/explore/All%20queries) as well. diff --git a/docs/usecases/nft-creator/app.md b/docs/usecases/nft-creator/app.md index 4465656e..7813554e 100644 --- a/docs/usecases/nft-creator/app.md +++ b/docs/usecases/nft-creator/app.md @@ -1,7 +1,8 @@ --- sidebar_position: 4 +title: "NFT Portfolio Tracker App Setup" +description: "Configure the React app shell for a Bitquery NFT portfolio tracker, including routes, layout, and API authentication setup." --- - # App Finally we will write the app code and the css @@ -88,7 +89,6 @@ return ( ); ``` - ### Complete Code ```JSX @@ -170,4 +170,3 @@ export default App; Use the css file in this [Github repo.](https://github.com/bitquery/nft-creator-portfolio/blob/main/src/pages/style.css) - diff --git a/docs/usecases/nft-creator/components.md b/docs/usecases/nft-creator/components.md index c25752d9..2c5b0082 100644 --- a/docs/usecases/nft-creator/components.md +++ b/docs/usecases/nft-creator/components.md @@ -1,7 +1,8 @@ --- sidebar_position: 2 +title: "NFT Portfolio Tracker UI Components" +description: "Build React UI components that display NFT balances and metadata cleanly using Bitquery GraphQL NFT API responses. Works with WebSocket live subscriptions." --- - # Components The Components are the heavy-lifters of the app and contain the code snippets for the functionality. @@ -19,16 +20,12 @@ The code for the Home component includes the following: 1. Import CSS style file: - - `import '../../pages/style.css';` This imports the CSS file "style.css" from the "pages" directory. 2. Import libraries and components: - - ```JSX import { useState, useEffect, React } from 'react' import { Container, Row, Col } from 'react-bootstrap' @@ -46,16 +43,12 @@ This imports the following components and libraries: 3. Set API OAuth Token: - - `const oauth_token = 'YOUR KEY'` This sets a constant variable "oauth_token" to the Bitquery API OAuth Token. 4. Define function to fetch data from API: - - `const fetchdata = async () => { // Code to fetch data };` @@ -64,8 +57,6 @@ This function uses axios to send a post request to the Bitquery API to retrieve 5. Define state variables: - - `const [balances, setBalances] = useState([]); const [loading, setLoading] = useState(true);` @@ -73,8 +64,6 @@ These variables define the state of the component. The "balances" variable is in 6. Use useEffect to call fetchdata function: - - `useEffect(() => { fetchdata(); }, []);` @@ -83,7 +72,6 @@ This calls the "fetchdata" function when the component mounts for the first time 7. Return JSX: - ```JSX return (
@@ -96,8 +84,6 @@ This returns the JSX that defines the component's appearance and functionality. 8. Render JSX: - - ```JSX @@ -115,8 +101,6 @@ This renders the JSX that defines the layout of the component. It includes a con 9. Define BalanceCard component: - - `function BalanceCard({ balance }) { // Code to render balance information }` @@ -125,8 +109,6 @@ This component takes in a "balance" prop and renders information about the balan 10. Export Home component as default: - - `export default Home;` This exports the "Home" component as the default export for the file. @@ -308,15 +290,12 @@ export default Home; ``` - ## About Page ### Import Statements The `Aboutpage` component imports the following libraries and modules: - - `import React from 'react' import '../../pages/style.css'; import { Container, Row, Col } from 'react-bootstrap'` @@ -329,7 +308,6 @@ import { Container, Row, Col } from 'react-bootstrap'` The `Aboutpage` component renders the following content: - ```JSX
@@ -394,15 +372,12 @@ The `Aboutpage` component is exported using the `export default` statement: This allows other modules to import and use the `Aboutpage` component. - ## Contact Page - The `Contactpage` component is a React functional component that renders the Contact Us page of a website. It includes a header, a paragraph of text, and a link to the Telegram channel where users can get in touch with the website's team. ### Import Statements - ```JSX import React from 'react'; import '../../pages/style.css'; @@ -413,8 +388,6 @@ This component uses `React` to create the component, `style.css` for custom styl ### Contactpage Component - - ```JSX function Contactpage() { return ( @@ -438,7 +411,6 @@ export default Contactpage; ## Header Component - ### State The Header component has two states: `expand` and `navColour`. @@ -625,4 +597,4 @@ function Pre(props) { } export default Pre; -``` \ No newline at end of file +``` diff --git a/docs/usecases/nft-creator/gettingstarted.md b/docs/usecases/nft-creator/gettingstarted.md index c897a024..094880be 100644 --- a/docs/usecases/nft-creator/gettingstarted.md +++ b/docs/usecases/nft-creator/gettingstarted.md @@ -1,7 +1,8 @@ --- sidebar_position: 1 +title: "Build an NFT Portfolio Tracker" +description: "Start the Bitquery NFT portfolio tracker tutorial: project setup, API token, environment config, and first NFT queries. See examples in the Bitquery IDE." --- - # Build Your Own NFT Portfolio Tracker with Bitquery NFT API - Begin Here ## What's the App? @@ -14,24 +15,22 @@ In addition to browsing and purchasing NFTs, users can also view the files assoc **The full code is available in this [Github repo.](https://github.com/bitquery/nft-creator-portfolio)** - ## Installation To install and run this app on your local machine, follow these steps: - 1. Clone this repository to your local machine using the command `git clone https://github.com/divyasshree-BQ/nft-creator-portfolio.git`. 2. Navigate to the project directory using the command `cd nft-creator-portfolio`. 3. Install the required dependencies using the command `npm install`. 4. Start the development server using the command `npm start`. 5. Open your web browser and go to [http://localhost:3000](http://localhost:3000/) to view the app. - Note: Before running the app, you'll need to sign up for an account or log in using an existing account at Bitquery (https://account.bitquery.io/auth/signup). Once you have an account, you can query your NFT data using the Bitquery API and copy the API key to use in the app. To learn more about using the Bitquery API with this app, please refer to the documentation provided by Bitquery. - ## Final Look -The app once completed will look like the demo shown ![below](/img/nft_portfolio_demo.gif) +The app once completed will look like the demo shown below: + + diff --git a/docs/usecases/nft-creator/pages.md b/docs/usecases/nft-creator/pages.md index b73a2a16..0a07743c 100644 --- a/docs/usecases/nft-creator/pages.md +++ b/docs/usecases/nft-creator/pages.md @@ -1,7 +1,8 @@ --- sidebar_position: 3 +title: "NFT Portfolio Tracker Pages" +description: "Create React pages for an NFT creator portfolio that loads holdings and metadata from Bitquery NFT GraphQL APIs. See examples in the Bitquery IDE." --- - # Pages ## About Page @@ -13,7 +14,6 @@ import React from 'react' import Header from '../components/Header/Header' import Aboutpage from '../components/Aboutpage/Aboutpage' - function About() { return (
@@ -65,4 +65,4 @@ function Home() { } export default Home -``` \ No newline at end of file +``` diff --git a/docs/usecases/nft-scanner.md b/docs/usecases/nft-scanner.md index 4774d577..841a0d63 100644 --- a/docs/usecases/nft-scanner.md +++ b/docs/usecases/nft-scanner.md @@ -1,8 +1,11 @@ +--- +title: "Build Multi-Chain NFT Scanner" +description: "Build Multi-Chain NFT Scanner: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # Build Multi-Chain NFT Scanner In this guide, we will use Bitquery Streaming API for scanning NFTs (Non-Fungible Tokens) across various blockchains for the given address. We'll explore how to build an NFT scanner that works with a specific wallet address using Python. - ## Why Bitquery for NFT Scanning? - **Multi-Blockchain Support**: Bitquery covers a wide range of blockchains, providing a holistic view of the NFT marketplace. diff --git a/docs/usecases/ohlcv-complete-guide.md b/docs/usecases/ohlcv-complete-guide.md index a8decec9..d953ea34 100644 --- a/docs/usecases/ohlcv-complete-guide.md +++ b/docs/usecases/ohlcv-complete-guide.md @@ -1,3 +1,7 @@ +--- +title: "OHLCV Candle Data Complete Guide" +description: "Learn how to build OHLCV candles from Bitquery DEX trade data, including intervals, aggregations, gaps, and chart-ready GraphQL examples." +--- # Complete Guide to Building the Perfect OHLCV Data Using Bitquery APIs In this guide, we will see how to get OHLCV (Open, High, Low, Close, Volume) candlestick data—or K-Line data—across different blockchain networks using Bitquery APIs. We’ll also explore how to filter out bot trades, outliers, and abnormally high or low prices to ensure accurate OHLC calculations. @@ -51,7 +55,7 @@ To fetch OHLC (Open, High, Low, Close) data for a specific token pair on EVM-com - **Robinhood** → `EVM(network: robinhood)` For full API documentation, refer to: -[Get OHLC Data for a Particular Token Pair](https://docs.bitquery.io/docs/examples/dextrades/token-trades-apis/#get-ohlc-data-for-a-particular-token-pair). +[Get OHLC Data for a Particular Token Pair](/docs/blockchain/Ethereum/dextrades/token-trades-apis/#get-ohlc-data-for-a-particular-token-pair). ### **Sample Query** @@ -101,7 +105,7 @@ Bitquery also supports non-EVM chains, such as **Solana** and **Tron**, enabling ## **OHLC on Solana** For a detailed guide, visit: -[Historical OHLC on Solana](https://docs.bitquery.io/docs/blockchain/Solana/historical-aggregate-data/#historical-ohlc-on-solana). +[Historical OHLC on Solana](/docs/blockchain/Solana/historical-aggregate-data/#historical-ohlc-on-solana). #### **Sample Query** @@ -144,7 +148,7 @@ For a detailed guide, visit: ## **OHLC on Tron** For details, visit: -[OHLC Data on Tron](https://docs.bitquery.io/docs/blockchain/Tron/tron-dextrades/#get-ohlc-data-of-a-token-on-tron-network). +[OHLC Data on Tron](/docs/blockchain/Tron/tron-dextrades/#get-ohlc-data-of-a-token-on-tron-network). #### **Sample Query** @@ -230,7 +234,6 @@ subscription LatestTrades { } } - ``` This GraphQL **subscription** query is fetching real-time **OHLC (Open, High, Low, Close)** data for Solana trades by continuously monitoring and streaming the latest trades. @@ -271,7 +274,7 @@ When fetching trade data from Bitquery APIs, you may encounter abnormal prices. 2. **Incorrect trade data in Bitquery’s database** – If you suspect incorrect data, report the issue by creating a support ticket. For a complete guide, visit: -[How to Filter Anomalous Prices](https://docs.bitquery.io/docs/usecases/how-to-filter-anomaly-prices/). +[How to Filter Anomalous Prices](/docs/usecases/how-to-filter-anomaly-prices/). ### **Methods to Filter Anomalous Trades** @@ -297,7 +300,7 @@ For a complete guide, visit: - To filter extreme values, keep trades only between the **5th and 95th percentiles**. For more details, check: -[Quantile Documentation](https://docs.bitquery.io/docs/graphql/metrics/quantile/). +[Quantile Documentation](/docs/graphql/metrics/quantile/). #### **3. Fetch All Trades and Filter Manually** @@ -399,11 +402,11 @@ _Effect:_ The low (`min1`) is adjusted upwards, likely removing an extreme drop. If you prefer not to use an aggregated GraphQL query, you can fetch raw trade data and manually compute OHLC values. -Complete guide to [using trades to calculate OHLC is available here](https://docs.bitquery.io/docs/usecases/solana-ohlc-calculator/) +Complete guide to [using trades to calculate OHLC is available here](/docs/usecases/solana-ohlc-calculator/) ## **Building TradingView Charts** To visualize OHLCV data using **TradingView Advanced Chart Library**, refer to: -- [TradingView Advanced Charts Guide](https://docs.bitquery.io/docs/usecases/tradingview-advanced-charts/getting-started/) -- [TradingView Real-Time Subscription](https://docs.bitquery.io/docs/usecases/tradingview-subscription-realtime/getting-started/) +- [TradingView Advanced Charts Guide](/docs/usecases/tradingview-subscription-realtime/getting-started/) +- [TradingView Real-Time Subscription](/docs/usecases/tradingview-subscription-realtime/getting-started/) diff --git a/docs/usecases/p-l-product/overview.mdx b/docs/usecases/p-l-product/overview.mdx index a07998ab..c413caa5 100644 --- a/docs/usecases/p-l-product/overview.mdx +++ b/docs/usecases/p-l-product/overview.mdx @@ -1,10 +1,11 @@ --- sidebar_position: 1 +title: "Crypto Profit and Loss Calculator" +description: "Build a JavaScript crypto PnL calculator with Bitquery DEX trades for cost basis, proceeds, realized gains, and reporting." --- - # Overview -Profit and Loss calculation in crypto is not easy to build. However, it is an important metric while evaluating the financial performance of an asset. In this tutorial, we will see how to build a simple profit and loss calculator in Javascript using Bitquery's [DEXTrades API](https://docs.bitquery.io/docs/examples/dextrades/dex-api/) +Profit and Loss calculation in crypto is not easy to build. However, it is an important metric while evaluating the financial performance of an asset. In this tutorial, we will see how to build a simple profit and loss calculator in Javascript using Bitquery's [DEXTrades API](/docs/blockchain/Ethereum/dextrades/dex-api/) ## Realized PnL @@ -17,7 +18,6 @@ WABP = sum(buyAmount*buyPriceInUSD)/sum(buyAmount) pnl = sum(sellAmount*(sellPriceInUSD-WABP)) ``` - ### Example Scenario: An account buys and sells a token as follows: @@ -30,7 +30,6 @@ An account buys and sells a token as follows: 2. **Sell Transaction**: - Sells 15 tokens at $7 each. - #### Step 1: Calculate the Weighted Average Buy Price (WABP) Using the formula: @@ -73,8 +72,7 @@ Realized PnL = 19.95 The realized PnL for this transaction is $19.95. -Click [here](https://docs.bitquery.io/docs/usecases/p-l-product/pnl) to get started with the project. - +Click [here](/docs/usecases/p-l-product/pnl) to get started with the project. ## Complete Video Tutorial diff --git a/docs/usecases/p-l-product/pnl.md b/docs/usecases/p-l-product/pnl.md index 0864ee47..7aa4f6eb 100644 --- a/docs/usecases/p-l-product/pnl.md +++ b/docs/usecases/p-l-product/pnl.md @@ -1,7 +1,8 @@ --- sidebar_position: 2 +title: "Calculating Profit or Loss Over Time" +description: "Build Calculating Profit or Loss Over Time: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." --- - # Calculating Profit or Loss Over Time This is the first step, where we calculate the Weighted Average of Buy Price(WABP) by getting all the `buy` trades of the token. @@ -19,8 +20,6 @@ pnl = sum(sellPriceInUSD-WABP) 1. Import the necessary libraries: - - ```javascript const axios = require('axios'); require('dotenv').config() @@ -127,8 +126,6 @@ const average = await getWeightedAverage(token, wallet); 12. Declare variables and Traverse the `sellTrades` array: - - ```javascript let pnl = 0; diff --git a/docs/usecases/polymarket-tg-alerts-bot.md b/docs/usecases/polymarket-tg-alerts-bot.md index 1876376a..da45fd8e 100644 --- a/docs/usecases/polymarket-tg-alerts-bot.md +++ b/docs/usecases/polymarket-tg-alerts-bot.md @@ -1,8 +1,12 @@ +--- +title: "Polymarket Tg Alerts Bot" +description: "Build Polymarket Tg Alerts Bot: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- import VideoPlayer from "../../src/components/videoplayer.js"; # How to Build a Polymarket Whale Alerts Telegram Bot with the Bitquery API -Build a production-ready **Polymarket Telegram bot** that streams realtime trades and lets users set custom alerts on trade size, share price, trader wallet, or specific market — all powered by the **[Bitquery Prediction Market API](https://docs.bitquery.io/docs/examples/prediction-market/prediction-market-api/)**. +Build a production-ready **Polymarket Telegram bot** that streams realtime trades and lets users set custom alerts on trade size, share price, trader wallet, or specific market — all powered by the **[Bitquery Prediction Market API](/docs/examples/prediction-market/prediction-market-api/)**. By the end of this guide you'll have a multi-user Telegram bot that subscribes to every Polymarket trade on Polygon over a single GraphQL WebSocket, filters trades against per-user alert rules, and pushes Telegram notifications with links to Polymarket, PolygonScan, and the trader's profile. @@ -587,10 +591,10 @@ All of these reuse the same GraphQL endpoint, same auth, same field shapes. ## Resources -- [Bitquery Prediction Market API docs](https://docs.bitquery.io/docs/examples/prediction-market/prediction-market-api/) -- [Prediction Trades API](https://docs.bitquery.io/docs/examples/prediction-market/prediction-trades-api/) -- [Prediction Managements API](https://docs.bitquery.io/docs/examples/prediction-market/prediction-managements-api/) -- [Prediction Settlements API](https://docs.bitquery.io/docs/examples/prediction-market/prediction-settlements-api/) +- [Bitquery Prediction Market API docs](/docs/examples/prediction-market/prediction-market-api/) +- [Prediction Trades API](/docs/examples/prediction-market/prediction-trades-api/) +- [Prediction Managements API](/docs/examples/prediction-market/prediction-managements-api/) +- [Prediction Settlements API](/docs/examples/prediction-market/prediction-settlements-api/) - [Source code](https://github.com/Akshat-cs/PolyBit-Polymarket-Alerts-Telegram-Bot) - [Live demo — @PolyBit_Polymarket_Bot](https://t.me/PolyBit_Polymarket_Bot) - [Get a Bitquery token](https://account.bitquery.io) diff --git a/docs/usecases/price-change-signal-bot.mdx b/docs/usecases/price-change-signal-bot.mdx index bc704b2b..ba25da26 100644 --- a/docs/usecases/price-change-signal-bot.mdx +++ b/docs/usecases/price-change-signal-bot.mdx @@ -1,6 +1,10 @@ +--- +title: "How to build a Crypto Price Change Signal Bot on Telegram" +description: "Build How to build a Crypto Price Change Signal Bot on Telegram: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application." +--- # How to build a Crypto Price Change Signal Bot on Telegram -This bot fetches real-time trading data from Bitquery and sends alerts on significant token price changes. For pre-aggregated price data with OHLC, consider using our [Crypto Price API](https://docs.bitquery.io/docs/trading/crypto-price-api/introduction/). The bot is built using the `python-telegram-bot` library to handle interactions with Telegram users and `aiohttp` for making asynchronous API requests. +This bot fetches real-time trading data from Bitquery and sends alerts on significant token price changes. For pre-aggregated price data with OHLC, consider using our [Crypto Price API](/docs/trading/crypto-price-api/introduction/). The bot is built using the `python-telegram-bot` library to handle interactions with Telegram users and `aiohttp` for making asynchronous API requests. Github Repository Link is available [here](https://github.com/bitquery/Price-Change-Signal-Telegram-Bot/tree/main) @@ -21,7 +25,7 @@ import VideoPlayer from "../../src/components/videoplayer.js"; 2. **Configuration and Constants** - `BOT_TOKEN`: The Telegram bot token from the BotFather. Get it from [here](https://telegram.me/BotFather) - - `OAUTH_TOKEN`: The authorization token for the Bitquery API. Check out the steps on how to get it [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/) + - `OAUTH_TOKEN`: The authorization token for the Bitquery API. Check out the steps on how to get it [here](/docs/authorization/how-to-generate/) - `logging.basicConfig`: Configures logging to track bot operations and potential errors. 3. **Helper Functions** diff --git a/docs/usecases/pumpfun-token-sniffer.md b/docs/usecases/pumpfun-token-sniffer.md index 5842b439..f56d122e 100644 --- a/docs/usecases/pumpfun-token-sniffer.md +++ b/docs/usecases/pumpfun-token-sniffer.md @@ -1,3 +1,7 @@ +--- +title: "Pump.fun Token Sniffer" +description: "Build Pump.fun Token Sniffer: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # Pump.fun Token Sniffer This guide demonstrates how to build a basic Pump.fun token analysis tool using Bitquery APIs. The tool displays various on-chain metrics related to Pump.fun tokens on Solana, helping users understand token distribution, holder behavior, and transfer patterns. @@ -49,7 +53,7 @@ The Pump.fun Token Sniffer is a Python-based analysis tool built with Bitquery A ## Prerequisites 1. **Python 3.8+** installed on your system -2. **Bitquery API Token** - Get your API token [here](https://docs.bitquery.io/docs/authorisation/how-to-generate/) +2. **Bitquery API Token** - Get your API token [here](/docs/authorization/how-to-generate/) 3. Basic understanding of Solana blockchain and Pump.fun tokens ## Installation diff --git a/docs/usecases/real-time-balance-tracker/overview.md b/docs/usecases/real-time-balance-tracker/overview.md index db49c387..8c8ecefc 100644 --- a/docs/usecases/real-time-balance-tracker/overview.md +++ b/docs/usecases/real-time-balance-tracker/overview.md @@ -1,14 +1,15 @@ --- sidebar_position: 1 +title: "Real-Time Wallet Balance Tracker" +description: "Plan a live wallet balance tracker with Bitquery balance streams, Node.js processing, and a simple browser UI for updates." --- - # Overview -Building a real time balance tracker can be really helpful for the investigation teams to closely monitor the activities of a wallet. In this tutorial we will learn how to build a simple real time balance tracker using Javascript and NodeJS for the logical reasoning, using Bitquery's [Balance Updates API](https://docs.bitquery.io/docs/examples/balances/balance-api/), while using HTML, CSS and JavaScript to make the monitoring application more intuitive. +Building a real time balance tracker can be really helpful for the investigation teams to closely monitor the activities of a wallet. In this tutorial we will learn how to build a simple real time balance tracker using Javascript and NodeJS for the logical reasoning, using Bitquery's [Balance API](/docs/blockchain/Ethereum/balances/balance-api/), while using HTML, CSS and JavaScript to make the monitoring application more intuitive. ## Real Time Balance Calculation Logic -To calculate or monitor the real time balance of a wallet, we will need a GraphQL API along with a stream that constantly provides the Balance Update using Bitquery's [Websocket Connection Implementation](https://docs.bitquery.io/docs/subscriptions/examples/#implementation-exampleusing-websocket-using-javascript). +To calculate or monitor the real time balance of a wallet, we will need a GraphQL API along with a stream that constantly provides the Balance Update using Bitquery's [Websocket Connection Implementation](/docs/subscriptions/examples/#implementation-exampleusing-websocket-using-javascript). This is the simplified formula we will use in this example: @@ -16,4 +17,4 @@ This is the simplified formula we will use in this example: Current Balance = sum(all_balance_updates) + stream_balance_updates ``` -If during the building of project you are stuck, you can refer to the following [Github Repository](https://github.com/Kshitij0O7/real-time-balance). \ No newline at end of file +If during the building of project you are stuck, you can refer to the following [Github Repository](https://github.com/Kshitij0O7/real-time-balance). diff --git a/docs/usecases/real-time-balance-tracker/scripts.md b/docs/usecases/real-time-balance-tracker/scripts.md index 96164ee1..90b20768 100644 --- a/docs/usecases/real-time-balance-tracker/scripts.md +++ b/docs/usecases/real-time-balance-tracker/scripts.md @@ -1,3 +1,7 @@ +--- +title: "Calculations and Scripting" +description: "Build Calculations and Scripting: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # Calculations and Scripting We will be using a simple fromula given below to calculate and trace the real-time balance changes. To execute this formula through code we will build two files (namely balance.js and index.js). @@ -114,7 +118,6 @@ app.use(express.json()); let currentAddress = ''; // Default address if none provided ``` - 3. Creating the endpoint to handle address input from frontend. ``` js @@ -213,4 +216,4 @@ app.listen(PORT, () => { }); ``` -Now we need to build a simple UI using HTML, CSS and Javascript to make this project inituitive. \ No newline at end of file +Now we need to build a simple UI using HTML, CSS and Javascript to make this project inituitive. diff --git a/docs/usecases/real-time-balance-tracker/ui.md b/docs/usecases/real-time-balance-tracker/ui.md index 1d14e4f2..6d341b7b 100644 --- a/docs/usecases/real-time-balance-tracker/ui.md +++ b/docs/usecases/real-time-balance-tracker/ui.md @@ -1,3 +1,7 @@ +--- +title: "Building a Basic UI for Balance Tracker" +description: "Building a Basic UI for Balance Tracker: a practical Bitquery tutorial with GraphQL examples, streams, and runnable application code." +--- # Building a Basic UI for Balance Tracker In this section we will create a simple UI using HTML, CSS and JavaScript to make the real-time Balance Tracker intuitive. For that we will create a HTML file named `index.js` in the same directory. @@ -8,9 +12,9 @@ In this section we will create a simple UI using HTML, CSS and JavaScript to mak - - - Real-Time Balance Tracker + + +