# xx402 Base Token Batch Trade Decision API

> xx402 Base Token Batch Trade Decision API 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).

Analyzes one or more Base ERC20 tokens and returns ranked buy/watch/avoid trade decisions with risk breakdowns for autonomous agents

## Facts

- Endpoint: GET https://x402.xx402.icu/api/base-token-batch-trade-decision?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-batch-trade-decision-api-0c217ea0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WbSuFX0cQbcqOYvy0PiTN

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-batch-trade-decision-api-0c217ea0
```

Example prompt: Can you analyze USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) on Base and give me a trade decision — I'm thinking of putting in $1,000 and want to know if it's buy-safe, what the risk breakdown looks like, and how it ranks against up to 3 other tokens over the last 200 blocks?

## When to prefer this

Use this endpoint when an AI agent or risk tool needs to make or validate a DeFi trade decision on Base ERC20 tokens before execution. It is purpose-built for autonomous agents needing ranked, actionable buy/watch/avoid classifications with on-chain risk data, rather than just raw price or liquidity feeds. Prefer this over generic DeFi APIs when you need a single structured decision packet covering liquidity, holder flow, and transfer analysis across multiple tokens in one call for $0.01 USDC via x402.

## Known failure modes

- Invalid or non-Base token address returns empty or error result
- token_address not a valid ERC20 contract on Base returns no decision
- limit exceeded (max 5 tokens) causes parameter rejection
- window_blocks below minimum (100) or above maximum (1000) causes validation error
- Payment not made via x402 protocol returns 402 Payment Required
- RPC or on-chain data unavailability may cause partial source_status failures
- Highly illiquid tokens may return review or avoid with minimal data

## 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

Returns a JSON object with a summary, batch trade decision label, execution plan, categorized queues (buy_safe, buy_small, watch, review, avoid, priority), ranked candidate tokens, per-token decisions with risk breakdowns, best candidate identification, bucket counts, source status, and a disclaimer. Each token gets a scored risk profile based on on-chain liquidity, transfer flow, holder analysis, and pair data from the recent Base block window.

## Response schema (JSON Schema)

```json
{
 "keys": [
  "summary",
  "as_of",
  "batch_trade_decision",
  "execution_plan",
  "buy_safe_queue",
  "buy_small_queue",
  "watch_queue",
  "review_queue",
  "avoid_queue",
  "priority_queue",
  "ranked_candidates",
  "token_decisions",
  "best_candidate",
  "best_candidates",
  "risk_breakdown",
  "bucket_counts",
  "next_products",
  "source_status",
  "not_financial_advice",
  "sources"
 ],
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xx402-base-token-batch-trade-decision-api-0c217ea0/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)