# x402 Altcoin Discovery – Base New Token Listings > x402 Altcoin Discovery – Base New Token Listings is a paid API for AI agents from x402-gateway.blackwoodstate8.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-20). Returns newly created Uniswap v3 liquidity pools on Base chain (paired with WETH or USDC), read from on-chain pool creation events, with price, depth, and age data ## Facts - Endpoint: POST https://x402-gateway.blackwoodstate8.workers.dev/v1/altcoin-discovery?utm_source=zero.xyz - Price: $0.003/call - Payment: x402 - Status: unknown - Last checked: 2026-10-20 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/x402-altcoin-discovery-base-new-token-listings-7732a67e - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DzaD6XCoBwVMNCy2SMQGg 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 x402-altcoin-discovery-base-new-token-listings-7732a67e -d '' ``` Example prompt: Show me new tokens that just got liquidity on Base in the last 12 hours — only ones paired with WETH and with at least $10,000 in pool depth, return up to 15 results. ## When to prefer this Use this endpoint when you need to discover brand-new tokens on Base chain that just received their first liquidity on Uniswap v3. Ideal for altcoin research workflows, new listing monitors, or DeFi scouting agents focused on Base. Prefer this over general market data APIs when the goal is recency and fresh pool discovery rather than price history, trading signals, or established token data. Not suitable for other chains (Ethereum mainnet, Arbitrum, etc.), token safety audits, or DEXs other than Uniswap v3. ## Known failure modes - No pools found matching filters (returns empty tokens array) - hours parameter out of range 1-72 returns validation error - limit parameter out of range 1-25 returns validation error - minDepthUsd exceeds 100,000,000 returns validation error - RPC or on-chain read timeout causing delayed or failed response - Payment not processed (x402 payment required error) ## How this service works Use when you need altcoin discovery, new token listings or fresh Base tokens with real liquidity to research. Do not use for established coins, other chains or DEXs, price history, trading signals or token safety audits. Returns JSON with new tokens on Base that just got liquidity: Uniswap v3 pools created in the last hours against WETH or USDC, read on-chain from pool creation events, with price, depth and age for 0.003 USDC per call. Typical response time 3000 ms (p95). Category: Trading. ## Output JSON object containing an array of newly created Uniswap v3 pools on Base, each with token address, symbol, name, decimals, current price, USD liquidity depth, and pool age in hours. Also includes metadata: total pools scanned, coverage window, data source, and an optional suggested next call for chaining queries. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method", "bodyType", "body" ], "properties": { "body": { "type": "object", "required": [], "properties": { "hours": { "type": "integer", "maximum": 72, "minimum": 1, "description": "Look back this many hours for new pools, 1 to 72 (24 when omitted), e.g. 24" }, "limit": { "type": "integer", "maximum": 25, "minimum": 1, "description": "Tokens to return, 1 to 25 (10 when omitted), e.g. 5" }, "quote": { "enum": [ "any", "WETH", "USDC" ], "type": "string", "description": "Quote side of the pool (any when omitted), e.g. \"WETH\"" }, "minDepthUsd": { "type": "number", "maximum": 100000000, "minimum": 0, "description": "Minimum USD on the WETH or USDC side of the pool (5000 when omitted), e.g. 10000" } } }, "type": { "type": "string", "const": "http" }, "method": { "enum": [ "POST" ], "type": "string" }, "bodyType": { "enum": [ "json", "form-data", "text" ], "type": "string" } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "required": [ "tokens", "window", "coverage", "scannedPools", "source", "note" ], "properties": { "next": { "type": "object", "required": [ "service", "tool", "method", "url", "useWhen", "sample" ], "properties": { "url": { "type": "string", "description": "Paid route of the next call" }, "tool": { "type": "string", "description": "MCP tool name of the same call" }, "method": { "enum": [ "GET", "POST" ], "type": "string" }, "sample": { "type": "string", "description": "Free fixed sample of the whole family" }, "service": { "type": "string", "description": "Servic … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "note": "New tokens are read on-chain from Uniswap v3 PoolCreated events on Base, paired with WETH or USDC; depth is the WETH or USDC balance of the pool in USD and price comes from the pool itself (WETH priced by the WETH/USDC pool). A new pool says nothing about safety: check the contract, holders and liquidity locks before trading. Other DEXs (Uniswap v4, Aerodrome) are not read.", "source": "Uniswap v3 PoolCreated events and pool state on Base (on-chain)", "tokens": [ { "name": "MajorWOLF", "pool": "0x19d0203318e9889add539b5bf0e9b054d1f62889", "quote": "WETH", "token": "0xf8cfec7b01455831800c188715f4c43242f32b46", "symbol": "WLF", "feeTier": 3000, "ageHours": 1.9, "decimals": 18, "depthUsd": 11830, "priceUsd": 0.00118304, "createdBlock": 52776914 } ], "window": { "hours": 24, "toBlock": 52780295, "fromBlock": 52737095 }, "coverage": { "hours": 12, "fromBlock": 52758696 }, "scannedPools": 46 } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-altcoin-discovery-base-new-token-listings-7732a67e/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402-gateway.blackwoodstate8.workers.dev](https://www.zero.xyz/host/x402-gateway.blackwoodstate8.workers.dev/llms.txt)