# Market Intelligence API – Opportunities Scanner

> Market Intelligence API – Opportunities Scanner 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).

Scans across crypto and tokenized US stock assets to surface ranked trading opportunities based on on-chain buy/sell pressure, momentum, and volume anomalies within a configurable time window.

## Facts

- Endpoint: GET https://api.marketintelligenceapi.com/api/v1/agent/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-scanner-2a87d948
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0bRIpAy2RnV6N3qG5Hwww

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-scanner-2a87d948
```

Example prompt: Scan the market right now and show me the top-ranked assets with unusual buying activity — I want to see buy pressure, momentum scores, and any risk factors like upcoming macro events, focusing on crypto over a 15-minute window.

## When to prefer this

Use this endpoint when an agent needs a broad market scan to discover which assets are worth investigating right now, rather than analyzing a specific known symbol. It is the right choice when the user's question is open-ended ('what should I trade?', 'what is moving?') rather than symbol-specific. Prefer this over the pre-trade or candles endpoints when no specific ticker has been chosen yet. It is especially valuable for systematic screening workflows that feed into downstream pre-trade checks.

## Known failure modes

- No opportunities match the objective and filter thresholds — results array is empty with filteredOut counts explaining why
- Stale data if signal age exceeds acceptable freshness — check signalAgeSeconds in dataQuality
- Low organicSharePercent may indicate wash trading or low-quality signal pools
- Insufficient pool coverage — freshPools count is low, reducing signal reliability
- Payment not processed or x402 authentication failure returns 402 error
- Invalid objective or parameter values return 4xx validation error

## How this service works

Pay-per-call market intelligence for AI agents across crypto, US and European stocks, rates and FX: on-chain buy/sell pressure, trading decisions from $0.05, token risk checks on six chains, webhook alerts, pre-trade verdicts, technicals, perps funding, smart money, SEC and ESEF fundamentals, insider trades, European short interest, ECB rates and FX, datasets and news.

## Output

A ranked list of assets (crypto or tokenized stocks) matching the specified objective, each with a score, direction (BULLISH/BEARISH), signal type, buy pressure percentage, momentum score, volume multiple, confidence score, confirming and conflicting evidence sources, risk factors (e.g. macro events), signal track record hit rate, and a link to a pre-trade check endpoint for follow-up. Also includes overall market context (regime, session) and metadata about how many symbols were scanned and filtered out.

## 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-scanner-2a87d948/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)
