Raw liquidity pool rebalancing events across 7 EVM chains and Solana via Bitquery, paid per-call with USDC or Lightning.
What it does
This endpoint returns raw data on significant liquidity pool movements (adds, removes, rebalances) across decentralized exchanges. It is part of the Einstein AI x402 API suite, which wraps Bitquery on-chain data behind x402 micropayments. The "/raw" variant returns structured data without AI-generated analysis, making it suitable for programmatic consumption by agents and bots.
The endpoint accepts POST requests with optional parameters for chain (base, ethereum, bsc, arbitrum, polygon, optimism, solana), result limit (up to 500), and time period (1h to 30d). It defaults to querying the Base chain with a 24h lookback. Payment is $0.60 per request, settled in USDC on Base (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913), USDC on Solana, or 786 sats via Lightning Network. No API key is needed; authentication is handled entirely through the x402 X-PAYMENT header containing a signed transfer authorization.
The broader Einstein AI platform offers over 20 x402 endpoints covering market data (OHLCV, token charts), whale intelligence, launchpad monitoring (Pump.fun, Zora), security audits (rug pull scanner, MEV detection), and arbitrage scanning. Prices across the suite range from $0.25 to $1.15 per call. The platform supports multi-chain queries across Base, Ethereum, BSC, Arbitrum, Polygon, Optimism, zkSync, and Solana. A companion non-raw endpoint at /x402/bitquery/liquidityshifts provides the same data with AI-generated analysis at $0.75 per call.
Capabilities
Use cases
- —Detect large liquidity additions or removals from DEX pools to anticipate price impact
- —Monitor rebalancing events across multiple chains for arbitrage or risk management
- —Feed raw pool movement data into trading bots or alert systems
- —Track protocol-level capital flows between liquidity pools over configurable time windows
- —Identify potential rug-pull signals when liquidity is suddenly withdrawn
Fit
Best for
- —AI agents needing structured, machine-readable DEX liquidity data without AI commentary
- —Multi-chain DeFi monitoring dashboards
- —Automated trading systems that react to liquidity shifts
- —Security researchers tracking suspicious pool withdrawals
Not for
- —Users who want human-readable analysis (use /x402/bitquery/liquidityshifts instead)
- —Historical data beyond 30 days
- —Non-blockchain liquidity or traditional finance data
Quick start
curl -X POST https://emc2ai.io/x402/bitquery/poolmoves/raw \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <base64-signed-usdc-authorization>" \
-d '{"chain": "base", "limit": 10, "timeperiod": "24h"}'Example
Request
{
"chain": "base",
"limit": 10,
"timeperiod": "24h"
}Response
{
"result": {
"pools": [
{
"dex": "Uniswap V3",
"token0": "WETH",
"token1": "USDC",
"amountUsd": 125000.5,
"eventType": "remove",
"timestamp": "2025-01-15T12:34:56Z",
"poolAddress": "0xabc...def"
}
]
},
"status": "completed",
"payment": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "600000",
"scheme": "exact",
"txHash": "0x123...abc",
"network": "base",
"x402Version": 1
}
}Endpoint
Quality
The endpoint is live (402 challenge confirmed) with a full OpenAPI spec, clear pricing, multi-network payment options, and well-defined input schema. However, the specific /poolmoves/raw path is not explicitly listed in the OpenAPI paths (only /liquidityshifts is), and the response schema for the raw variant is inferred from the outputSchema in the x402 challenge rather than documented with concrete examples. The /api route returned a 522 error during crawl.
Warnings
- —The /poolmoves/raw endpoint is not explicitly listed in the OpenAPI spec paths; only /liquidityshifts appears. The endpoint may be an undocumented raw variant.
- —The /api route returned a Cloudflare 522 timeout during crawl, suggesting intermittent origin server issues.
- —The example response JSON is inferred from the outputSchema in the x402 challenge and general BitqueryResponse schema; no actual successful response was captured.
- —Lightning Network payment option lists 786 sats (~$0.60 equivalent) but the settlement mechanism details are not fully documented.
Citations
- —Endpoint returns 402 with x402 challenge accepting USDC on Base (600000 atomic = $0.60), USDC on Solana, and 786 sats via Lightninghttps://emc2ai.io/x402/bitquery/poolmoves/raw
- —USDC asset address on Base is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 with 6 decimalshttps://emc2ai.io/x402/bitquery/poolmoves/raw
- —Einstein AI x402 API prices range from $0.25 to $1.15 across endpoints, paid in USDC on Basehttps://emc2ai.io/docs
- —Supported chains include base, ethereum, bsc, arbitrum, polygon, optimism, solana for pool-related querieshttps://emc2ai.io/x402/bitquery/poolmoves/raw
- —The /liquidityshifts endpoint detects significant liquidity additions or removals across DEX pools at $0.75https://emc2ai.io/docs
- —Einstein accepts payments on three chains: USDC on Base, USDC on Solana, and BTC via Lightning Networkhttps://emc2ai.io/docs