{"uid":"cap_DzaD6XCoBwVMNCy2SMQGg","slug":"x402-altcoin-discovery-base-new-token-listings-7732a67e","name":"x402 Altcoin Discovery – Base New Token Listings","description":"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.","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/altcoin-discovery?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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":"Service id of the suggested next paid call"},"useWhen":{"type":"string","description":"When the next call is the right one"}},"description":"Suggested next paid call in the same family (call it in a loop when the task continues)","additionalProperties":false},"note":{"type":"string"},"source":{"type":"string"},"tokens":{"type":"array","items":{"type":"object","required":["token","symbol","name","decimals","quote","pool","feeTier","createdBlock","ageHours","priceUsd","depthUsd"],"properties":{"name":{"type":["string","null"]},"pool":{"type":"string"},"quote":{"enum":["WETH","USDC"],"type":"string"},"token":{"type":"string"},"symbol":{"type":["string","null"]},"feeTier":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"ageHours":{"type":"number"},"decimals":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"depthUsd":{"type":"number"},"priceUsd":{"type":"number"},"createdBlock":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":false}},"window":{"type":"object","required":["hours","fromBlock","toBlock"],"properties":{"hours":{"type":"number"},"toBlock":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"fromBlock":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":false},"coverage":{"type":"object","required":["fromBlock","hours"],"properties":{"hours":{"type":"number"},"fromBlock":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":false},"scannedPools":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":false}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jAVzTf38BmgQSiqnLPby2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Early altcoin research dashboard","prompt":"Find me the 10 newest tokens on Base that got Uniswap v3 liquidity in the last 6 hours — any quote token, minimum $5,000 pool depth — so I can research which ones are worth looking at."},{"title":"USDC-paired new token scan","prompt":"What new tokens on Base have been paired with USDC on Uniswap v3 in the last 48 hours with at least $20,000 in liquidity? Give me up to 25 results."},{"title":"Hourly fresh launch monitor","prompt":"Pull the freshest Base token launches from the last 1 hour on Uniswap v3 — WETH pairs only, no minimum depth filter, just show me the top 5 newest pools."}],"resultDescription":"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.","failureModes":["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)"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:30:20.892Z","isFirstParty":false,"canonicalSlug":"x402-altcoin-discovery-base-new-token-listings-7732a67e"}