# BeliefState Stock Overview Brief

> BeliefState Stock Overview Brief is a paid API for AI agents from beliefstate.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Returns up to 5 cited analyst/investor thesis views (bull or bear) with supporting evidence for a given stock ticker, as of a specified date.

## Facts

- Endpoint: GET https://beliefstate.ai/v1/brief/NBIS?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beliefstate-stock-overview-brief-a0877cec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uILad23O3OCt8ij4SYLhj

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 beliefstate-stock-overview-brief-a0877cec
```

Example prompt: Pull up to 5 cited analyst overview views on NBIS from BeliefState — show me who's bullish or bearish and why, as of today.

## When to prefer this

Choose this endpoint when you need cited, attributed analyst and investor theses for a specific stock with directional (bull/bear) labels and traceable sources. It is ideal for AI trading agents that require interpretable, sourced research rather than raw price data or unattributed sentiment scores. Prefer it over generic news APIs when you need structured investment opinions with named analysts and as-of date precision.

## Known failure modes

- Ticker not in BeliefState coverage universe — returns empty views or 404
- as_of date set to future or outside historical data range — may return no results
- max_results exceeds allowed maximum of 5 — validation error
- Payment not fulfilled (x402 protocol) — 402 Payment Required response
- Malformed ticker format not matching pattern — 400 validation error
- Rate limiting or wallet balance insufficient for 0.02 USDC charge

## How this service works

Investor research and stock analysis for AI trading agents. This route buys up to five cited overview views for 0.02 USDC, with historical cutoffs. Discover all 16 research tools, their exact prices, free coverage and wallet MCP in the free catalog. Catalog: https://beliefstate.ai/v1/research. Full schemas: https://beliefstate.ai/openapi.json.

## Output

A JSON object containing a list of up to 5 analyst/investor 'views' for the requested ticker, each with: the analyst's identity (name, handle, id), their directional stance (bull/bear), a summary of their thesis, a citation ID linking to the source, and metadata including the schema version, generation timestamp, as-of cutoff date, and security/coverage info.

## 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",
    "queryParams",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "GET"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string",
       "pattern": "^[A-Za-z0-9][A-Za-z0-9.-]{0,14}$",
       "maxLength": 15,
       "minLength": 1,
       "description": "Released stock ticker from GET /v1/tickers."
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "as_of": {
       "type": "string",
       "format": "date-time",
       "maxLength": 35
      },
      "detail": {
       "type": "string",
       "const": "overview"
      },
      "max_results": {
       "type": "integer",
       "maximum": 5,
       "minimum": 1
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$comment": "Permissive discovery projection. Complete response contract: https://beliefstate.ai/openapi.json#/components/schemas/X402BriefOverview",
     "required": [
      "schema_version",
      "view",
      "generated_at",
      "as_of",
      "security",
      "coverage",
      "views",
      "citations"
     ],
     "properties": {
      "view": {
       "type": "string",
       "const": "overview"
      },
      "as_of": {
       "type": "string",
       "format": "date-time",
       "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
      },
      "views": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "belief_id",
         "person",
         "direction",
         "summary
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beliefstate-stock-overview-brief-a0877cec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from beliefstate.ai](https://www.zero.xyz/host/beliefstate.ai/llms.txt)