# Market Intelligence API – Opportunities Finder

> Market Intelligence API – Opportunities Finder is a paid API for AI agents from api.marketintelligenceapi.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-10).

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.

## Facts

- Endpoint: GET https://api.marketintelligenceapi.com/api/v1/intelligence/opportunities?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-intelligence-api-opportunities-finder-caef0e72
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FdXO9Fg_qcgq86EBCa3UD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability market-intelligence-api-opportunities-finder-caef0e72
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
    }
   },
   "addit
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-intelligence-api-opportunities-finder-caef0e72/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.marketintelligenceapi.com](https://www.zero.xyz/host/api.marketintelligenceapi.com/llms.txt)
