{"uid":"cap_WbSuFX0cQbcqOYvy0PiTN","slug":"xx402-base-token-batch-trade-decision-api-0c217ea0","name":"xx402 Base Token Batch Trade Decision API","description":"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.","url":"https://x402.xx402.icu/api/base-token-batch-trade-decision?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"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"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EH3zKhFP-MocWwpAywkrL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes one or more Base ERC20 tokens and returns ranked buy/watch/avoid trade decisions with risk breakdowns for autonomous agents","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Pre-trade risk check for DeFi bot","prompt":"Before my trading bot executes, run a batch trade decision on these three Base tokens — 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 0x4200000000000000000000000000000000000006, and 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb — for a $5,000 trade size, checking the last 500 blocks, and tell me which ones are in the buy-safe queue and which to avoid."},{"title":"Autonomous agent portfolio screening","prompt":"Screen up to 5 Base ERC20 tokens I'm watching and give me a prioritized ranked list with risk breakdowns so I know which ones my agent should act on first — use a $200 intended trade size and sample 5 details per token."},{"title":"Single token liquidity and safety check","prompt":"Is it safe to buy this Base token at 0x4200000000000000000000000000000000000006 with $10,000? Give me the full risk breakdown, execution plan, and tell me which queue it falls into — buy-safe, watch, or avoid."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:41:32.567Z","isFirstParty":false,"canonicalSlug":"xx402-base-token-batch-trade-decision-api-0c217ea0"}