{"uid":"cap_VFfEm3M1YEtDZ2bv9KT8i","slug":"x402-market-signals-api-15cd072a","name":"x402 Market Signals API","description":"Paid deterministic utility APIs settled in native USDC on Base.","url":"https://x402-url-evidence.vercel.app/api/market-signals","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":{"properties":{"limit":{"type":"integer","maximum":10,"minimum":1},"query":{"type":"string","maxLength":80}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"dataThin":true,"gapSignals":[{"term":"protocol","offerMentions":0,"requestMentions":1}],"generatedAt":"2026-07-20T00:00:00.000Z","marketplace":{"sampledOpenRequests":1,"sampledUniqueOffers":20},"organicPurchases":{"niches":[],"matchingAgents":2}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_m0Pnm5HVMjf1mqxu0EGS6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns demand/supply gap signals for a search query by analyzing open requests and offers in the x402 marketplace, identifying underserved niches and matching agents.","exampleAgentPrompt":"Search the x402 marketplace for supply-demand gaps around 'data enrichment' and show me up to 5 gap signals so I can see which terms have more buyer requests than available offers.","exampleUseCases":[{"title":"Discover underserved agent service niches","prompt":"Look at the x402 marketplace for gaps around 'image generation' — I want to know which terms buyers are requesting that nobody is offering yet, up to 10 signals."},{"title":"Validate new API product demand","prompt":"Before I build a new translation API on x402, can you check if there are open buyer requests for 'translation' with more demand than supply? Give me up to 5 gap signals."},{"title":"Competitive research on marketplace coverage","prompt":"I'm trying to understand how saturated the x402 market is for 'weather data' — pull market signals for that query with a limit of 3 and tell me how many unique offers versus open requests exist."}],"resultDescription":"Returns a JSON object containing: a list of gap signals (each with a term, offer mention count, and request mention count), a generatedAt timestamp, marketplace sampling stats (open requests and unique offers sampled), organic purchase data with matching agent count and niche breakdowns, and a dataThin flag indicating whether sufficient data was available for reliable signals.","failureModes":["Payment not received or x402 payment header missing — returns 402 Payment Required","Query string exceeds 80-character limit — returns 400 validation error","Limit integer outside 1–10 range — returns 400 validation error","Insufficient marketplace data for query — returns dataThin: true with sparse or empty gap signals","Method not POST — returns 405 Method Not Allowed","Malformed JSON body — returns 400 parse error"],"whenToPreferThis":"Choose this endpoint when you need to identify supply-demand imbalances in the x402 agent marketplace for a specific keyword or topic. It is purpose-built for x402 ecosystem intelligence — use it when you want to discover which service niches are under-supplied relative to buyer demand, validate product ideas before building, or find competitive opportunities in the paid-API agent economy. Prefer it over general web search or trend tools when your question is specifically about x402 marketplace coverage and agent purchasing behavior.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:36:22.595Z","isFirstParty":false}