# BeliefState Get Research Brief

> BeliefState Get Research 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).

Retrieves an AI-synthesized investment research brief for a given stock ticker or entity, including analyst theses, dated evidence, and outcome tracking.

## Facts

- Endpoint: POST https://beliefstate.ai/v1/research/get_brief?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-get-research-brief-b5bf0abf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3FcpR2YsBN9GvbXJmFM8P

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-get-research-brief-b5bf0abf -d '<json body>'
```

Example prompt: Pull me the full BeliefState research brief for NVDA as of today — I want the detailed view with all analyst theses and evidence.

## When to prefer this

Use this endpoint when you need structured, AI-synthesized analyst research briefs for publicly traded companies or known entities, particularly when you want dated evidence and outcome tracking rather than raw news or price data. Prefer over general web search when you need curated, top-analyst-sourced investment theses with historical snapshots via as_of dating.

## Known failure modes

- Invalid or unknown ticker returns empty or error response
- Malformed entity_id UUID returns validation error
- as_of date outside available data range returns no results
- max_results exceeding 20 returns validation error
- Missing required body fields returns 400-level error
- Payment failure (x402) blocks access to the endpoint

## How this service works

The first AI-powered platform for top analyst research. Get theses from top analysts, dated evidence, and available outcomes for your AI.

## Output

Returns a JSON envelope with schema_version, generated_at timestamp, and as_of date, wrapping analyst research content including investment theses from top analysts, dated supporting evidence, and tracked outcomes for the requested ticker or entity. Detail level controls depth (overview, full, or current). Pagination supported via cursor.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "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))$"
      },
      "cursor": {
       "type": "string",
       "maxLength": 4096
      },
      "detail": {
       "enum": [
        "overview",
        "full",
        "current"
       ],
       "type": "string"
      },
      "ticker": {
       "type": "string",
       "maxLength": 32,
       "minLength": 1
      },
      "entity_id": {
       "type": "string",
       "format": "uuid",
       "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
       "description": "Released subject ID returned by search_entities."
      },
      "max_results": {
       "type": "integer",
       "maximum": 20,
       "minimum": 1
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "POST"
    },
    "bodyType": {
     "type": "string",
     "const": "json"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "$comment": "Envelope excerpt only. Complete response schema: https://beliefstate.ai/v1/research/get_brief?schema=output",
     "required": [
      "schema_version",
      "generated_at",
      "as_of"
     ],
     "properties": {
      "as_of": {
       "type": "string",
       "format": "date-time"
      },
      "generated_at": {
       "type": "string",
       "format": "date-time"
      },
      "schema_version": {
       "type": "string",
       "const": "1"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-10-24T00:00:00.000Z",
  "generated_at": "2026-10-24T00:00:00.000Z",
  "schema_version": "1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beliefstate-get-research-brief-b5bf0abf/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)