# PreReason Market Breadth Context API (cross.breadth)

> PreReason Market Breadth Context API (cross.breadth) is a paid API for AI agents from api.prereason.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11).

Returns cross-asset market breadth signals, risk appetite indicators, and sector rotation context across asset classes.

## Facts

- Endpoint: GET https://api.prereason.com/api/cross/breadth?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prereason-market-breadth-context-api-cross-breadth-157ff7d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dF7ZTpNHEodwEMpEo7HsK

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 prereason-market-breadth-context-api-cross-breadth-157ff7d4
```

Example prompt: Pull me the PreReason cross-asset breadth briefing for today — I want to know if markets are showing broad risk appetite or sector rotation, in markdown format so it's easy to read.

## When to prefer this

Use this endpoint when you need a broad, cross-asset view of market risk appetite and sector rotation — not Bitcoin-specific data. Prefer this over btc.* briefings when the question is about overall market participation, whether money is rotating between sectors, or whether risk appetite is expanding or contracting across asset classes. Ideal for macro context framing before diving into specific asset analysis.

## Known failure modes

- Missing or invalid 'briefing' query parameter returns a 400 error
- Requesting a date outside the allowed historical range for your tier returns an access error
- Requesting a Tier 2 briefing (cross.breadth) without the appropriate subscription tier returns a 402 or 403
- Invalid date format (not YYYY-MM-DD) returns a validation error
- Network or upstream data unavailability may return a 503

## How this service works

Market breadth and risk appetite. SPY, DXY, VIX sector signals. Equity and crypto breadth for portfolio allocation and risk assessment agents.

## Output

Returns a structured analysis including a market breadth context summary, signal labels (bullish/bearish/neutral), trend metrics, confidence scores, and a generated_at timestamp. Available in JSON or LLM-optimized markdown. Covers risk appetite across asset classes and sector rotation signals.

## Request schema (JSON Schema)

```json
{
 "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",
     "properties": {
      "date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "Historical date in YYYY-MM-DD format. A paid call serves today or any ?date= on record."
      },
      "format": {
       "enum": [
        "json",
        "markdown"
       ],
       "type": "string",
       "description": "Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "metrics": {
   "iwm": {
    "name": "iwm"
   },
   "qqq": {
    "name": "qqq"
   },
   "spy": {
    "name": "spy"
   },
   "bitcoin-price": {
    "name": "bitcoin-price"
   }
  },
  "briefing_used": "cross.breadth",
  "briefing_metadata": {
   "name": "Market Breadth",
   "description": "Breadth across S&P 500, Nasdaq, and small caps with Bitcoin correlation for each",
   "metrics_count": 4,
   "correlations_count": 3
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prereason-market-breadth-context-api-cross-breadth-157ff7d4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.prereason.com](https://www.zero.xyz/host/api.prereason.com/llms.txt)