Detect significant DEX liquidity additions and removals across 7+ EVM chains via x402 micropayment.
What it does
This endpoint from Einstein AI detects significant liquidity shifts (additions and removals) across decentralized exchange pools. It queries Bitquery on-chain data and returns raw results without AI-generated analysis (the `/raw` variant). Supported chains include Ethereum, Base, BSC, Arbitrum, Polygon, Optimism, and Solana. All parameters—chain, limit (up to 500), and time period (1h to 30d)—are optional with sensible defaults. The endpoint defaults to Ethereum when no chain is specified.
Payment is handled via the x402 protocol with three settlement options: USDC on Base ($0.60 per call), USDC on Solana ($0.60), or Bitcoin Lightning (786 sats, ~$0.60 equivalent). No API keys are required; callers include a signed payment authorization in the X-PAYMENT header. The endpoint returns JSON containing a status field, a result object with the liquidity shift data, and a payment receipt.
Einstein AI is part of the Virtuals Protocol ecosystem and exposes a broad suite of blockchain intelligence endpoints covering market data, whale tracking, launchpad monitoring, security audits, and DeFi analytics—all payable per request. This specific endpoint is useful for monitoring large-scale liquidity events that may signal upcoming price moves, rug pulls, or protocol migrations.
Capabilities
Use cases
- —Detect large liquidity removals that may precede rug pulls or token dumps
- —Monitor liquidity additions to identify new trading opportunities on DEXes
- —Track cross-chain liquidity migration patterns between protocols
- —Feed automated trading agents with real-time liquidity shift signals
- —Audit DeFi protocol health by observing pool depth changes over time
Fit
Best for
- —AI agents needing programmatic, pay-per-call DEX liquidity data
- —DeFi researchers monitoring pool dynamics across multiple chains
- —Trading bots that react to significant liquidity events
Not for
- —Users needing free or unlimited-call liquidity data
- —Historical liquidity analysis beyond 30 days
- —Centralized exchange (CEX) order book or liquidity data
Quick start
curl -X POST https://emc2ai.io/x402/bitquery/liquidityshifts/raw \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <base64-signed-usdc-authorization>" \
-d '{"chain": "ethereum", "limit": 10, "timeperiod": "24h"}'Example
Request
{
"chain": "ethereum",
"limit": 10,
"timeperiod": "24h"
}Response
{
"result": {
"liquidityShifts": [
{
"pool": "0xabc...def",
"type": "removal",
"token0": "WETH",
"token1": "USDC",
"amountUsd": 1250000,
"timestamp": "2025-01-15T12:34:56Z"
}
]
},
"status": "completed",
"payment": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "600000",
"scheme": "exact",
"txHash": "0x123...abc",
"network": "base",
"timestamp": "2025-01-15T12:34:57Z",
"x402Version": 1
}
}Endpoint
Quality
The endpoint is live (402 challenge captured with full outputSchema on three payment networks), backed by a comprehensive OpenAPI spec with typed request/response schemas. The /raw variant's exact response fields are inferred from the generic BitqueryResponse schema and outputSchema rather than a documented example, and the crawled docs page focuses on the broader platform rather than this specific endpoint.
Warnings
- —The /api route returned a 522 (host timeout) during crawl, suggesting occasional origin instability.
- —The /raw variant is not explicitly listed in the OpenAPI paths—only /x402/bitquery/liquidityshifts is documented. The /raw suffix likely returns data without AI analysis, but this is inferred from naming convention.
- —Example response structure is inferred from the outputSchema and BitqueryResponse component; actual field names in the result object may differ.
Citations
- —Endpoint returns 402 with x402 challenge accepting USDC on Base, USDC on Solana, and BTC on Lightninghttps://emc2ai.io/x402/bitquery/liquidityshifts/raw
- —Price is $0.60 per call (600000 atomic units, 6 decimals USDC)https://emc2ai.io/x402/bitquery/liquidityshifts/raw
- —Supported chains: ethereum, base, bsc, arbitrum, polygon, optimism, zksync; default ethereumhttps://emc2ai.io/x402/bitquery/liquidityshifts/raw
- —OpenAPI spec lists liquidityShifts as detecting significant liquidity additions or removals across DEX poolshttps://emc2ai.io
- —Einstein AI supports x402 v2 Bazaar Discovery with payments on Base, Solana, and Lightninghttps://emc2ai.io/docs
- —Paid features cost $0.20–$1.00 per invocationhttps://emc2ai.io/docs