# Base Token Liquidity Intelligence API

> Base Token Liquidity Intelligence API is a paid API for AI agents from xx402.icu, paid per call via x402, $0.01/call, status down (last checked 2026-09-15).

Returns DEX pair liquidity data, risk flags, and liquidity summary for a given Base ERC20 token contract address

## Facts

- Endpoint: GET https://xx402.icu/x402/api/base-token-liquidity
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-token-liquidity-intelligence-api-96c78c05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y9sx04s66mROwxlTKwcBV

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 base-token-liquidity-intelligence-api-96c78c05
```

Example prompt: Can you check the liquidity situation for the USDC token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — show me up to 10 DEX pairs along with any risk flags?

## When to prefer this

Use this endpoint when you need structured liquidity data specifically for a Base chain ERC20 token, including DEX pair rankings and risk flags, especially when evaluating trade safety, pool health, or exit liquidity for DeFi risk workflows. Prefer this over generic blockchain explorers when you need pre-scored risk intelligence rather than raw onchain data.

## Known failure modes

- Invalid or non-ERC20 token address returns an error or empty result
- Token not yet indexed on Base returns no pairs
- Limit parameter outside 1–12 range causes validation error
- Token with no DEX pairs returns empty top_pairs array
- Network or upstream data source outage causes timeout or incomplete response

## How this service works

Paid x402 buyer market scout, x402 paid resource preflight, x402 seller visibility audit, Base actionable risk feed, liquidity exit risk alerts, pool launch risk feed, stable asset risk feed, contract control event feed, protocol outflow risk feed, yield pool allocation risk feed, protocol fee quality feed, token watchlist decision packet, wallet watchlist decision packet, approval risk feed, ranked DeFi review queues with incident history, onchain risk decision packet, promoted token campaign decision packet, large transfer decision packet, token candidate screening decision radar, DEX pair anomaly decision radar, wallet safety decision packet, counterparty flow, allowance, approval exposure, DEX pair routing risk, token trade safety, token liquidity, token flow, holder concentration, contract controls, batch token screening decision packets, token diligence, and BTC15 prediction-market microstructure, execution-friction, calibration-slice, recent market tape, resolved feature sample, and threshold-pressure packets for agents and risk tools.

## Output

A JSON object containing a liquidity summary, a ranked list of top DEX trading pairs (up to the requested limit), any identified risk flags (e.g. low liquidity, exit risk, concentrated pools), and the underlying data sources used.

## Response schema (JSON Schema)

```json
{
 "keys": [
  "summary",
  "liquidity_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",
  "sources"
 ],
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-token-liquidity-intelligence-api-96c78c05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from xx402.icu](https://www.zero.xyz/host/xx402.icu/llms.txt)