{"uid":"cap_FdXO9Fg_qcgq86EBCa3UD","slug":"market-intelligence-api-opportunities-finder-caef0e72","name":"Market Intelligence API – Opportunities Finder","description":"Crypto trading opportunity scanner: name a goal (unusual_buying, unusual_selling, breakout, breakdown, crowded_positioning, smart_money_accumulation/distribution) and constraints, get ranked symbols with evidence for and against by source, risk factors, data quality and the signal's live hit rate. GET or POST JSON. Use to find trades matching a goal in one call.","url":"https://api.marketintelligenceapi.com/api/v1/intelligence/opportunities?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"window":{"enum":["1m","5m","15m"],"type":"string","description":"Aggregation window of the signal: 1m, 5m or 15m"},"include":{"type":"string","description":"Comma-separated: metrics, evidence, risk_factors, data_quality, track_record, market_context (default all)"},"universe":{"type":"string","description":"Comma-separated symbols (max 100); omit for all covered symbols"},"objective":{"enum":["unusual_buying","unusual_selling","breakout","breakdown","crowded_positioning","smart_money_accumulation","smart_money_distribution"],"type":"string","description":"What to look for"},"assetClass":{"enum":["crypto","us_equity","perp_only"],"type":"string","description":"Asset class filter: crypto, us_equity or perp_only"},"maxResults":{"type":"integer","maximum":50,"minimum":1,"description":"Maximum number of ranked results (1-50)"},"minVolumeUsd":{"type":"number","description":"USD traded in the window"},"minConfidence":{"type":"number","maximum":100,"minimum":0,"description":"Minimum signal confidence (0-100)"},"minBuyPressure":{"type":"number","maximum":100,"minimum":50,"description":"Pressure on the objective's side (sell pressure for selling objectives)"},"minVolumeMultiple":{"type":"number","description":"Volume vs the symbol's own baseline"},"minIndependentSources":{"type":"integer","maximum":3,"minimum":1,"description":"Distinct sources confirming the direction"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"description":"Example JSON response returned by this endpoint"}},"additionalProperties":true}},"additionalProperties":false},"responseSchema":{"type":"json","example":{"asOf":"2026-09-25T11:00:00Z","window":"15m","matches":1,"results":[{"rank":1,"price":2692.07,"score":78,"signal":"BUYING_ACTIVITY","symbol":"ETHUSD","metrics":{"volumeUsd":3400000,"buyPressure":72.4,"momentumScore":66.1,"volumeMultiple":2.8,"confidenceScore":96},"direction":"BULLISH","eventType":"BULLISH_ACCUMULATION","nextCalls":{"preTradeCheck":"/api/v1/intelligence/pre-trade?symbol=ETHUSD&side=buy&window=15m"},"assetClass":"crypto","dataQuality":{"freshPools":28,"signalAgeSeconds":38,"sourcesAvailable":["spot_dex_flow","perp_positioning","smart_money"],"organicSharePercent":67},"riskFactors":[{"type":"macro_event","detail":"US CPI in 45 min","severity":"MEDIUM"}],"confirmingSources":["spot_dex_flow","smart_money"],"supportingEvidence":[{"type":"buy_pressure","unit":"percent of organic aggressor volume","detail":"Buy pressure 72.4% over 15m (55+ bullish, 45- bearish)","source":"spot_dex_flow","direction":"BULLISH","observedValue":72.4}],"conflictingEvidence":[],"signalTrackRecord1h":{"signal":"BUYING_ACTIVITY","evaluated":145,"hitRatePercent":71.7,"sufficientSample":true},"independentSourcesConfirming":2}],"objective":"unusual_buying","algoVersion":"opportunities-v1-2026-09-25","filteredOut":{"volume_not_unusual":15,"buy_pressure_below_minBuyPressure":88},"marketContext":{"regime":"MIXED","usMarketSession":"REGULAR"},"symbolsScanned":104}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Z3kmtBm7_-QN33pGfwiEu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds and ranks trading symbols matching a named objective (e.g. unusual_buying, smart_money_accumulation) with evidence, risk factors, and live signal hit rates in a single call.","exampleAgentPrompt":"Scan the market for unusual_buying opportunities right now — give me ranked crypto and equity symbols with supporting evidence, risk factors, and the signal's live hit rate over the past hour.","exampleUseCases":[{"title":"Crypto smart money accumulation alert","prompt":"Find me crypto symbols where smart money accumulation is happening right now — rank them by confidence and tell me what evidence supports each signal and what the hit rate has been over the last hour."},{"title":"Pre-news breakout scanner for equities","prompt":"Scan US equities for breakout signals with at least moderate confidence before the market opens — I want to see which symbols are showing unusual buying, any macro risk factors nearby, and how reliable the breakout signal has been recently."},{"title":"Crowded positioning risk check","prompt":"Are there any assets right now showing crowded_positioning signals? I want to see the top ranked symbols, what sources are confirming it, and any risk factors I should know about before considering a trade."}],"resultDescription":"Returns a ranked list of symbols matching the requested objective, each with a score, direction (BULLISH/BEARISH), price, volume multiple, buy/sell pressure percentage, confidence score, confirming and conflicting evidence by independent source, data quality metrics (freshness, organic share, sources available), risk factors (type, detail, severity), and the signal's historical hit rate. Also includes market context (regime, session), algorithm version, filter counts, and a next-step pre-trade check URL for each result.","failureModes":["No symbols match the objective and constraints — returns empty results array with filteredOut counts","Invalid objective name returns a 400 error","Stale data or insufficient fresh pools may lower confidence scores or reduce results","Rate limiting or payment failure returns 402 or 429","Macro events in progress may suppress signals or elevate risk factor severity"],"whenToPreferThis":"Use this endpoint when you need to discover trading opportunities across a universe of symbols in a single call, rather than analyzing one symbol at a time. It is the right choice when you want goal-oriented scanning (name an objective like unusual_buying or smart_money_accumulation), need ranked results with evidence for and against from independent sources, want live signal hit rates to assess reliability, and need risk factors surfaced automatically. Prefer this over the pre-trade or single-symbol endpoints when you don't yet know which symbol to focus on.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:51:42.816Z","isFirstParty":false,"canonicalSlug":"market-intelligence-api-opportunities-finder-caef0e72"}