{"uid":"cap_rSnN08bnHQ-5lc0pm932x","slug":"demandex-opportunities-list-73398cd0","name":"DemandEx Opportunities List","description":"Paid ($0.02 USDC via x402). Returns up to 50 active opportunity cards in a category, each as a teaser ({ id, slug, title, category, score, signalCount, lastSeen }) plus its summary. Requires ?category=; ?minScore= optionally filters. A missing or unknown category returns a no-charge 400 that lists the valid categories; a valid category with no active cards yet (index still warming) returns a no-charge 503 corpus_warming instead of an empty charged list. Compute-first / settle-after — you are no…","url":"https://api.demandex.dev/v1/opportunities","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":["category"],"properties":{"category":{"type":"string","description":"Category slug (required). Unknown/missing → no-charge 400 listing valid categories."},"minScore":{"type":"number","maximum":100,"minimum":0,"description":"Optional minimum composite score (0-100) filter."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"charged":true,"category":"audio","fetchedAt":"2026-07-18T11:45:00.000Z","opportunities":[{"id":"ckxxxx","slug":"sony-wh1000xm5-replacement-headband","score":87.4,"title":"Sony WH-1000XM5 replacement headband","summary":"Owners repeatedly seek an aftermarket replacement headband after the OEM band cracks.","category":"audio","lastSeen":"2026-07-18T10:00:00.000Z","signalCount":34}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_j7kqFNNdSXsvw4HtOfdLZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns up to 50 active demand opportunity cards in a given category, each with teaser metadata and a summary, filtered optionally by minimum score.","exampleAgentPrompt":"Can you pull up the top active demand opportunities in the 'saas' category on DemandEx, filtering for anything with a score of at least 60?","exampleUseCases":null,"resultDescription":"A list of up to 50 active opportunity cards, each containing id, slug, title, category, composite score (0-100), signal count, last seen timestamp, and a text summary. Returns a no-charge 400 with valid category list if the category is unknown, or a no-charge 503 corpus_warming if the index is still initializing for a valid category.","failureModes":["Missing or unknown category slug → no-charge HTTP 400 with list of valid categories","Valid category with no active cards yet (index warming) → no-charge HTTP 503 with corpus_warming status","minScore out of range (not 0-100) → validation error","Network or upstream compute failure → 5xx error","Payment not settled → request rejected before results returned"],"whenToPreferThis":"Use this endpoint when you need a broad discovery sweep of up to 50 active demand opportunities within a known category, and want teaser-level data (score, signal count, summary) before drilling into full details. Prefer it over the single-card detail endpoint when you don't yet know which specific opportunity id or slug to retrieve. Ideal for ranking, filtering by score threshold, and building overview dashboards.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:35:25.995Z","isFirstParty":false}