# xx402 Base Token Liquidity & DEX Route Analysis

> xx402 Base Token Liquidity & DEX Route Analysis is a paid API for AI agents from x402.xx402.icu, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-21).

Returns DEX liquidity depth, pool fragmentation, slippage guardrails, and order-size guidance for a Base ERC20 token to support autonomous trade execution decisions.

## Facts

- Endpoint: GET https://x402.xx402.icu/api/base-token-liquidity?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xx402-base-token-liquidity-dex-route-analysis-6368b590
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CTYODdgEOPV-jIvRYgA18

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 xx402-base-token-liquidity-dex-route-analysis-6368b590
```

Example prompt: Before I swap $50,000 worth of the Base token at 0x4200000000000000000000000000000000000006, check the DEX liquidity depth and tell me whether that trade size is safe — show me the top 8 pairs, slippage guardrails, and an allow/review/avoid decision.

## When to prefer this

Choose this endpoint when an autonomous agent or risk tool needs real-time DEX liquidity assessment for a specific Base chain ERC20 token before executing or sizing a swap. It is especially valuable when the intended trade size is large enough to cause slippage and the agent needs an explicit allow/review/avoid decision rather than raw pool data alone. Prefer it over generic DeFi APIs when you need Base-native route depth, fragmentation scoring, and order-size laddering in a single paid micro-call.

## Known failure modes

- Invalid token_address format (not a valid 0x ERC20 address) returns validation error
- Token not found on Base chain returns empty or minimal liquidity data
- limit parameter out of range (below 1 or above 12) returns schema validation error
- Upstream DEX data source unavailable causes degraded or stale liquidity data
- Payment not settled via x402 protocol returns HTTP 402 before data is served

## How this service works

Paid Base token, wallet, DeFi, chain-read, x402 buyer/seller discovery, and specialized Bitcoin 15-minute Up/Down prediction-market data packets for autonomous agents and risk tools.

## Output

A JSON object containing a liquidity verdict (allow/review/avoid), top DEX pairs, market depth metrics, pool fragmentation score, slippage guardrails, an order size ladder, route depth checklist, swap sizing plan, route failure reasons, risk flags, source status, and optional route_size_decision keyed to the intended trade amount — all annotated with not_financial_advice disclaimer.

## Response schema (JSON Schema)

```json
{
 "keys": [
  "summary",
  "purchase_acceptance",
  "buyer_next_action",
  "next_paid_call",
  "next_products",
  "decision_evidence",
  "repeat_purchase_guard",
  "liquidity_decision",
  "agent_trade_ticket",
  "execution_time_horizon",
  "max_order_usd_by_confidence",
  "route_failure_reasons",
  "pool_fragmentation_score",
  "recheck_after_seconds",
  "order_size_ladder",
  "slippage_guardrails",
  "liquidity_verdict",
  "route_depth_checklist",
  "swap_sizing_plan",
  "buyer_execution_plan",
  "route_size_decision",
  "priority_queue",
  "best_next_products",
  "risk_breakdown",
  "review_queue",
  "avoid_queue",
  "market_depth",
  "route_safety",
  "top_pairs",
  "liquidity_review_queue",
  "bucket_counts",
  "risk_flags",
  "source_status",
  "not_financial_advice",
  "sources"
 ],
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xx402-base-token-liquidity-dex-route-analysis-6368b590/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.xx402.icu](https://www.zero.xyz/host/x402.xx402.icu/llms.txt)