# Einstein AI x402 API – DEX Liquidity Shifts Detector

> Einstein AI x402 API – DEX Liquidity Shifts Detector is a paid API for AI agents from api.relai.fi, paid per call via x402, $0.750000/call, status unknown (last checked 2026-09-15).

Detects significant liquidity additions or removals across DEX pools on major blockchain networks over a configurable time period.

## Facts

- Endpoint: POST https://api.relai.fi/relay/1769629274857/x402/bitquery/liquidityshifts
- Price: $0.750000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/einstein-ai-x402-api-dex-liquidity-shifts-detector-622ebf54
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6dS1vxam-toHVN74YwnLm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability einstein-ai-x402-api-dex-liquidity-shifts-detector-622ebf54 -d '<json body>'
```

Example prompt: Show me the top 25 significant liquidity additions and removals across Arbitrum DEX pools from the last 4 hours so I can spot any whale activity or potential rug pulls.

## When to prefer this

Use this endpoint when you need on-chain DEX liquidity shift intelligence across major EVM chains without building a BitQuery integration yourself. Ideal for detecting whale behavior, potential rug pulls, or significant DeFi capital movements in near real-time. Prefer this over raw BitQuery when you want a pay-per-call model with no API key setup.

## Known failure modes

- Unsupported chain specified — only ethereum, base, bsc, arbitrum, polygon, optimism, zksync are valid
- limit exceeds maximum of 500 — returns error or capped results
- Invalid timeperiod enum value — must be one of 1h, 4h, 24h, 7d, 30d
- BitQuery upstream timeout or data unavailability — returns 5xx error
- Payment failure via x402 protocol — call not executed, 402 returned

## How this service works

Detect significant liquidity additions or removals across DEX pools. Supported chains: ethereum, base, bsc, arbitrum, polygon, optimism, zksync. Default chain: ethereum. Required params: none (chain/limit/timeperiod are optional and defaulted).

## Output

A list of significant liquidity shift events across DEX pools on the queried chain, including pool details, direction (addition or removal), magnitude of liquidity change, and timing — up to the specified limit, filtered to the requested time period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum",
    "bsc",
    "arbitrum",
    "polygon",
    "optimism",
    "solana"
   ],
   "type": "string",
   "description": "Blockchain to query (e.g., base, ethereum, bsc, solana)"
  },
  "limit": {
   "type": "string",
   "description": "Maximum number of results to return (default: 10, max: 500)"
  },
  "timeperiod": {
   "enum": [
    "1h",
    "4h",
    "24h",
    "7d",
    "30d"
   ],
   "type": "string",
   "description": "Time period for analysis (e.g., 1h, 24h, 7d, 30d)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/einstein-ai-x402-api-dex-liquidity-shifts-detector-622ebf54/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.relai.fi](https://www.zero.xyz/host/api.relai.fi/llms.txt)
