{"uid":"cap_deLK3Xuqe7FAHpmKUsAhG","slug":"x402-token-liquidity-pulse-2322f722","name":"x402 Token Liquidity Pulse","description":"Machine-readable pay-per-request intelligence for autonomous agents on Base mainnet. x402 v2 resources expose deterministic decisions, market demand signals, payment preflight checks, repository intelligence, crypto catalysts, OpenAPI integration analysis and token liquidity signals.","url":"https://agent-economy-signal-x402-mainnet.bronzetti-andrea.workers.dev/premium/token-liquidity-pulse","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Token symbol or contract address."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":"BRETT","status":"LIQUID","product":"Token Liquidity Pulse","version":"1.0.0","price_usd":0.005,"best_market":{"chain":"base","price_usd":0.12,"liquidity_usd":250000,"volume_24h_usd":900000},"next_action":"MARKET_IS_LIQUID_ENOUGH_FOR_FURTHER_ANALYSIS","valid_for_seconds":300}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pClsL0SS6y2ywrUXL8QiT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time liquidity status, best market price, 24h volume, and a next-action recommendation for a given token symbol or contract address on Base mainnet, gated by a $0.005 USDC micropayment.","exampleAgentPrompt":"Check whether BRETT has enough liquidity to trade right now on Base — I need the best market price, 24h volume, and a recommendation on whether to proceed.","exampleUseCases":[{"title":"Pre-trade liquidity check for DeFi bot","prompt":"Before my agent executes a swap, check if BRETT on Base is liquid enough — I need the current liquidity depth, 24h volume, and a go/no-go signal."},{"title":"Token liquidity screening for portfolio agent","prompt":"Screen DEGEN for liquidity on Base mainnet — give me the best market price, how deep the market is in USD, and whether it's safe to enter a position."},{"title":"Real-time liquidity alert for trading dashboard","prompt":"Is the token at contract address 0x532f27101965dd16442E59d40670FaF5eBB142E4 currently liquid on Base? I want the liquidity status and next recommended action."}],"resultDescription":"A JSON object containing: the query token, a liquidity status label (e.g. LIQUID), the best market chain and price in USD, total liquidity in USD, 24h trading volume in USD, a machine-readable next-action string (e.g. MARKET_IS_LIQUID_ENOUGH_FOR_FURTHER_ANALYSIS), and a validity window in seconds (typically 300s). Priced at $0.005 USDC per call via x402.","failureModes":["Payment not included or invalid — 402 response requiring x402 USDC micropayment on Base","Unknown or unrecognized token symbol — empty or error result","Token exists but has no liquidity data — status may return ILLIQUID or error","Contract address malformed — query rejected","Stale data if called near the 300-second validity boundary","Worker downtime or upstream data provider outage — 5xx response"],"whenToPreferThis":"Use this endpoint when an AI agent needs a fast, pay-per-request, machine-readable liquidity signal for a Base-chain token before executing a trade or DeFi operation. It is ideal for autonomous agents that need deterministic go/no-go signals without maintaining their own market data infrastructure. Prefer this over general DEX APIs when you need a pre-packaged next-action recommendation and are already operating within the x402 micropayment ecosystem on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:41:53.943Z","isFirstParty":false}