# Market Intelligence API – Decision Endpoint

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

Synthesizes order flow, technicals, smart money, SEC fundamentals, insiders, derivatives positioning, market risk, and news into a single actionable trade verdict with conviction score and volatility-sized trade plan for a given symbol or market-wide.

## Facts

- Endpoint: GET https://api.marketintelligenceapi.com/api/v1/decision/:symbol?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-intelligence-api-decision-endpoint-b9da8584
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uxiNugOoAzGSlyOzbfhXc

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-decision-endpoint-b9da8584
```

Example prompt: Should I buy ETHUSD right now? Pull in all signals — order flow, technicals, smart money, insider activity, and news — and give me a verdict with conviction and a volatility-sized trade plan, plus what would flip the view.

## When to prefer this

Choose this endpoint when you need a single, definitive, multi-pillar trade decision rather than raw data from one source. It is ideal for agents that need to act immediately and want one answer with evidence, rather than assembling signals manually. Prefer it over individual data endpoints (order flow alone, technicals alone) when the user wants a combined verdict. Use the market-wide call (no symbol) when assessing overall risk appetite before sizing any position.

## Known failure modes

- Symbol not covered by any data source — returns an error or empty coverage
- Network or upstream data provider outage causing partial or failed response
- Payment not completed (x402) — endpoint returns 402 Payment Required
- Invalid symbol format — returns validation error
- Rate limiting or quota exceeded for the account

## How this service works

Trading decision for a crypto asset or stock ($1): every dataset (order flow, technicals, smart money, SEC fundamentals, insiders, perp positioning, market risk, news) aggregated by rules into an action with conviction, evidence per pillar, a volatility-sized trade plan and what would change the view. Free live hit rate at /api/v1/decision/track-record. No symbol = market-wide stance.

## Output

Returns a single actionable verdict (e.g. BUY / BUY_SMALL / WAIT / SELL) with a conviction score, structured evidence summaries for each data pillar (order flow, technicals, smart money, SEC fundamentals, insiders, derivatives positioning, market risk, news), a volatility-calibrated trade plan (entry, target, stop), and a list of conditions that would change the current view. If no symbol is provided, returns a market-wide stance.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "examples": [
        "ETHUSD"
       ],
       "description": "Crypto pair (ETHUSD), US ticker (NVDA) or ISIN (FR0000131906): any symbol covered by at least one source (/coverage, SEC, ESEF)."
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "side": {
       "enum": [
        "buy",
        "sell"
       ],
       "type": "string",
       "description": "Optional side to get a GO / GO_SMALL / WAIT / NO_GO answer"
      },
      "format": {
       "enum": [
        "detailed",
        "compact"
       ],
       "type": "string",
       "description": "compact drops evidence text and method to save LLM context"
      },
      "include": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Modules to use, comma-separated (default all): order_flow, technicals, smart_money, fundamentals, insiders, derivatives_positioning, market_risk, news,…"
      }
     },
     "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-intelligence-api-decision-endpoint-b9da8584/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)