bitquery · buddies2705 · Jul 30, 2026 · Jul 30, 2026 · Jul 30, 2026 · Jul 30, 2026
diff --git a/.gitignore b/.gitignore
@@ -32,4 +32,5 @@ keywords/
 aeo/
 lead_lag_btc_chainlink_vs_bitquery.py
 v1_to_v2_plan.md
+V1_DOCS_SEO_HANDOFF.md
 docs/streams/solana-rpc-websocket-vs-bitquery-streams.md
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
@@ -1,6 +1,6 @@
 ---
 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."
+description: "What internal transactions are, how they differ from internal transfers, and how to trace both on EVM chains using Bitquery Calls and Transfers queries."
 ---
 import FAQ from "@site/src/components/FAQ";
 

diff --git a/docs/blockchain/BSC/four-meme-api.mdx b/docs/blockchain/BSC/four-meme-api.mdx
@@ -1,5 +1,5 @@
 ---
-title: "BNB Chain Four Meme API"
+title: "Four Meme API — BSC Trades, Bonding Curve & Prices"
 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

diff --git a/docs/blockchain/BSC/pancake-swap-api.md b/docs/blockchain/BSC/pancake-swap-api.md
@@ -1,6 +1,6 @@
 ---
 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."
+description: "Query and stream PancakeSwap trades on BNB Chain with Bitquery GraphQL: latest swaps, live subscriptions, token prices, OHLC and trader activity."
 ---
 import FAQ from "@site/src/components/FAQ";
 

diff --git a/docs/blockchain/Base/aerodrome-base-api.mdx b/docs/blockchain/Base/aerodrome-base-api.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Base Aerodrome Base API"
+title: "Aerodrome Finance API — Base DEX Trades & Liquidity"
 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
 ---

diff --git a/docs/blockchain/Base/ai-agent-base-data.mdx b/docs/blockchain/Base/ai-agent-base-data.mdx
@@ -273,9 +273,6 @@ query BaseTokenHolders($tokenAddress: String!) {
       limit: { count: 50 }
       where: { Currency: { SmartContract: { is: $tokenAddress } } }
     ) {
-      BalanceUpdate {
-        Address
-      }
       Currency {
         Name
         Symbol

diff --git a/docs/blockchain/Base/base-dextrades.mdx b/docs/blockchain/Base/base-dextrades.mdx
@@ -1,7 +1,7 @@
 ---
 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."
+description: "Query and stream Base chain DEX trades with Bitquery GraphQL: live swap streams, real-time token prices, USD pricing and per-pair trade history."
 ---
 import FAQ from "@site/src/components/FAQ";
 

diff --git a/docs/blockchain/Ethereum/dextrades/uniswap-api.mdx b/docs/blockchain/Ethereum/dextrades/uniswap-api.mdx
@@ -1,7 +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."
+description: "Query Uniswap v1-v4 on Ethereum with Bitquery GraphQL: real-time trades, TradingView-ready OHLC streams across chains, per-pair trades and top traders."
 ---
 import FAQ from "@site/src/components/FAQ";
 

diff --git a/docs/blockchain/Ethereum/pepe-api.md b/docs/blockchain/Ethereum/pepe-api.md
@@ -680,15 +680,15 @@ query MyQuery {
 
 <!-- ## PEPE Total Holder Count (Snapshot)
 
-Check how many unique wallets hold PEPE at a given date. Change the `snapshot` date to compare across time.
+Check how many unique wallets hold PEPE at a given date. Change the `date` argument to compare across time.
 
 [Run In IDE ➤](https://ide.bitquery.io/pepe-holder-count-snapshot)
 
 ```graphql
 {
   EVM(network: eth) {
     Holders(
-      snapshot: "2026-05-01",
+      date: "2026-05-01",
       where: { Currency: { SmartContract: { is: "0x6982508145454ce325ddbe47a25d4ec3d2311933" } } }
     ) {
       count(of: Holder_Address, distinct: true)

diff --git a/docs/blockchain/Ethereum/token-holders/token-holder-api.mdx b/docs/blockchain/Ethereum/token-holders/token-holder-api.mdx
@@ -1,7 +1,7 @@
 ---
 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."
+description: "Rank Ethereum token holders with the Bitquery Holders cube: top holders, holder counts, dated snapshots, balance thresholds and distribution statistics."
 ---
 import FAQ from "@site/src/components/FAQ";
 

diff --git a/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api.md b/docs/blockchain/Ethereum/transfers/erc20-token-transfer-api.md
@@ -1,7 +1,7 @@
 ---
 sidebar_position: 1
 title: "ERC20 Token Transfers API"
-description: "Query and stream Ethereum ERC-20 and native transfers: filter by contract or address, aggregate volume, rank top transfers, and backfill with deterministic pagination."
+description: "Query and stream Ethereum ERC-20 and native transfers: filter by contract or address, aggregate volume, rank top transfers and backfill deterministically."
 keywords:
   - ERC20 token transfers API
   - Ethereum token transfers

diff --git a/docs/blockchain/Ethereum/transfers/rwa-api.md b/docs/blockchain/Ethereum/transfers/rwa-api.md
@@ -26,12 +26,12 @@ You can view and execute the query for the top holders of an RWA using the follo
       orderBy: { descending: Balance_Amount },
       where: { Currency: { SmartContract: { is: "0x59D9356E565Ab3A36dD77763Fc0d87fEaf85508C" } } }
     ) {
-      BalanceUpdate {
-        transactions: Count
-      }
       Holder {
         Address
       }
+      Balance {
+        UpdateCount
+      }
       Balance {
         Amount
       }

diff --git a/docs/blockchain/Matic/matic-balance-api.md b/docs/blockchain/Matic/matic-balance-api.md
@@ -1,7 +1,7 @@
 ---
 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."
+description: "Query Polygon address balances with the Bitquery Balances cube: token and native POL balances, balances on a given date, and per-token lookups."
 ---
 # Polygon (MATIC) Address Balance API
 

diff --git a/docs/blockchain/Solana/Solana-DexPools-API.md b/docs/blockchain/Solana/Solana-DexPools-API.md
@@ -1,7 +1,7 @@
 ---
 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."
+description: "Query Solana liquidity pools with Bitquery GraphQL: pool updates in real time, tokens above a liquidity threshold, per-token pools and latest reserves."
 ---
 import FAQ from "@site/src/components/FAQ";
 

diff --git a/docs/blockchain/Solana/Solana-Lifinity-dex-api.mdx b/docs/blockchain/Solana/Solana-Lifinity-dex-api.mdx
@@ -1,6 +1,6 @@
 ---
 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."
+description: "Query Lifinity on Solana with Bitquery GraphQL: real-time trades, latest token prices, OHLC candles and the top traders of any token on the DEX."
 ---
 # Lifinity DEX API
 

diff --git a/docs/blockchain/Solana/Solana-OpenBook-api.mdx b/docs/blockchain/Solana/Solana-OpenBook-api.mdx
@@ -1,6 +1,6 @@
 ---
 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."
+description: "Query OpenBook v2 on Solana with Bitquery GraphQL: real-time trades, pair price averages, and every instruction including placeOrder and placeTakeOrder."
 ---
 # OpenBook DEX API
 

diff --git a/docs/blockchain/Solana/Solana-Phoenix-api.md b/docs/blockchain/Solana/Solana-Phoenix-api.md
@@ -1,6 +1,6 @@
 ---
 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."
+description: "Query the Phoenix order book on Solana with Bitquery GraphQL: real-time trades, latest and streaming token prices, and OHLC candles for any pair."
 ---
 # Phoenix DEX API
 

diff --git a/docs/blockchain/Solana/Solana-Raydium-DEX-API.mdx b/docs/blockchain/Solana/Solana-Raydium-DEX-API.mdx
@@ -1,7 +1,7 @@
 ---
 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."
+description: "Query Raydium on Solana with Bitquery GraphQL: new liquidity pools over WebSocket, pair creation times, historical pairs, token prices and OHLC candles."
 ---
 import FAQ from "@site/src/components/FAQ";
 

diff --git a/docs/blockchain/Solana/solana-orca-dex-api.mdx b/docs/blockchain/Solana/solana-orca-dex-api.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_position: 7
-title: "Solana Orca DEX API"
+title: "Orca DEX API — Solana Liquidity Pools & Trades"
 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";

diff --git a/docs/blockchain/Solana/solana-photon-api.md b/docs/blockchain/Solana/solana-photon-api.md
@@ -1,7 +1,7 @@
 ---
 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."
+description: "Track Photon-routed Solana trades with Bitquery GraphQL: latest trades by pair, trader-level rows with USD price, market cap and supply, plus live streams."
 ---
 import FAQ from "@site/src/components/FAQ";
 

diff --git a/docs/blockchain/Solana/token-supply-cube.mdx b/docs/blockchain/Solana/token-supply-cube.mdx
@@ -1,7 +1,7 @@
 ---
 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."
+description: "Track Solana token supply with Bitquery GraphQL: subscribe to supply changes, query mint and burn events, and read circulating supply for any SPL token."
 ---
 # Solana Token Supply API
 

diff --git a/docs/blockchain/Tron/sunswap-api.md b/docs/blockchain/Tron/sunswap-api.md
@@ -1,6 +1,6 @@
 ---
 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."
+description: "Query SunSwap on Tron with Bitquery GraphQL: latest trades, per-token trade history, and new Sunpump tokens plus sell events from the Tron mempool."
 ---
 # Tron SunSwap API
 

diff --git a/docs/blockchain/robinhood/robinhood-calls-api.md b/docs/blockchain/robinhood/robinhood-calls-api.md
@@ -1,6 +1,6 @@
 ---
 title: "Robinhood Calls & Traces API — WebSocket Streams"
-description: "Stream Robinhood contract calls and internal traces over GraphQL WebSockets — decoded inputs, call trees, deployments, reverts. A debug_traceTransaction alternative."
+description: "Stream Robinhood contract calls and internal traces over GraphQL WebSockets: decoded inputs, call trees, deployments and reverts. No node required."
 sidebar_position: 5
 keywords:
   - Robinhood calls API

diff --git a/docs/blockchain/robinhood/robinhood-token-holders-api.md b/docs/blockchain/robinhood/robinhood-token-holders-api.md
@@ -1,6 +1,6 @@
 ---
-title: "Robinhood Token Holders API — Rankings, Counts & Distribution"
-description: "Query Robinhood token holders with Bitquery GraphQL: top-holder rankings, holder counts, distribution stats, whale floors, dormancy screens, and stock-token holders."
+title: "Robinhood Token Holders API — Rankings & Distribution"
+description: "Query Robinhood token holders with Bitquery GraphQL: top-holder rankings, holder counts, distribution stats, whale floors and dormancy screens."
 sidebar_position: 7
 keywords:
   - Robinhood token holders API

diff --git a/docs/blockchain/robinhood/robinhood-transactions-receipts-api.md b/docs/blockchain/robinhood/robinhood-transactions-receipts-api.md
@@ -1,6 +1,6 @@
 ---
-title: "Robinhood Transactions & Receipts API (eth_getBlockReceipts equivalent)"
-description: "Query Robinhood transactions and receipts with Bitquery GraphQL — block receipts, single-tx receipts, status, gas, and fees. A no-node eth_get*Receipt alternative."
+title: "Robinhood Transactions & Receipts API"
+description: "Query Robinhood transactions and receipts with Bitquery GraphQL: block receipts, single-tx receipts, status, gas and fees. No node required."
 sidebar_position: 6
 keywords:
   - Robinhood transactions API

diff --git a/docs/intro.md b/docs/intro.md
@@ -1,7 +1,7 @@
 ---
 sidebar_position: 1
 title: "Bitquery API Documentation - Blockchain Data Platform"
-description: "Bitquery API Documentation - Blockchain Data Platform: Bitquery documentation with GraphQL examples, real-time streams, and integration guidance."
+description: "Start here for Bitquery's blockchain data platform: GraphQL query and WebSocket subscription APIs, the IDE, Kafka streams and cloud data delivery."
 ---
 # Overview
 

diff --git a/docs/stablecoin-APIs/stablecoin-payments-api.md b/docs/stablecoin-APIs/stablecoin-payments-api.md
@@ -236,7 +236,9 @@ For the full transfer schema (mint/burn detection, `Type`, dataset selection), s
 
 ## Compliance & Risk Checks
 
-For **AML/KYC and risk monitoring**, you can analyze a payment counterparty's full lifecycle on the asset — first/last activity dates, in/out counts, and current balance — in a single query.
+For **AML/KYC and risk monitoring**, you can analyze a payment counterparty's lifecycle on the asset — first and last activity dates, total change count, and current balance — in a single query.
+
+The `Holders` cube does not break activity down by direction. For separate inbound and outbound counts or amounts, aggregate the [Transfers cube](/docs/cubes/transfers-cube) by `Transfer.Sender` / `Transfer.Receiver` instead.
 
 🔗 [Example API](https://ide.bitquery.io/stats-for-an-adddress)
 
@@ -254,16 +256,10 @@ For **AML/KYC and risk monitoring**, you can analyze a payment counterparty's fu
       Holder {
         Address
       }
-      BalanceUpdate {
-        InCount
-        OutCount
-        Count
-        InAmount
-        OutAmount
-        FirstDate
-        LastDate
-      }
       Balance {
+        UpdateCount
+        FirstChangeTime
+        LastChangeTime
         Amount
       }
     }
@@ -319,11 +315,9 @@ Identify addresses that **last received USDT** on a specific date — useful for
       Holder {
         Address
       }
-      BalanceUpdate {
-        FirstDate
-        LastDate
-      }
       Balance {
+        FirstChangeTime
+        LastChangeTime
         Amount
       }
     }
@@ -333,7 +327,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](/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**, with current balance and activity history (first change, last change, total change count). For directional inflow/outflow totals, aggregate the [Transfers cube](/docs/cubes/transfers-cube) by sender and receiver. 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)
 
@@ -349,16 +343,10 @@ Find **top holders of USDT on Ethereum**, including inflows, outflows, and full
       Holder {
         Address
       }
-      BalanceUpdate {
-        InCount
-        OutCount
-        Count
-        InAmount
-        OutAmount
-        FirstDate
-        LastDate
-      }
       Balance {
+        UpdateCount
+        FirstChangeTime
+        LastChangeTime
         Amount
       }
     }

diff --git a/docusaurus.config.js b/docusaurus.config.js
@@ -1154,6 +1154,10 @@ const config = {
     ],
     require.resolve("./plugins/llms-txt.js"),
     require.resolve("./plugins/tech-article-jsonld.js"),
+    // Must run after any plugin that writes <title>. Drops the " | Bitquery Docs"
+    // suffix only on titles that render over 60 chars, so keyword-loaded page
+    // titles do not have to shed keywords to make room for branding.
+    require.resolve("./plugins/title-suffix-trim.js"),
   ],
   presets: [
     [