# BeliefState Get Belief Risks

> BeliefState Get Belief Risks 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 AI-curated risk factors associated with analyst research theses, filterable by ticker, severity, entity, and date

## Facts

- Endpoint: POST https://beliefstate.ai/v1/research/get_belief_risks?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-belief-risks-3cb022f6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NkNrQtQzAXJOcKnYZYx4g

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-belief-risks-3cb022f6 -d '<json body>'
```

Example prompt: Pull all high-severity analyst-identified risks from BeliefState for AAPL as of 2025-01-01, and return up to 20 results.

## When to prefer this

Use this endpoint when you need structured, severity-tagged risk data derived from top analyst research theses for a specific company or investment belief. It is preferable when you need dated, filterable, paginated risk intelligence rather than raw news sentiment or unstructured analyst commentary. Particularly valuable for AI agents building investment risk dashboards or automating due diligence workflows.

## Known failure modes

- Invalid UUID format for belief_id, entity_id, person_id, or source_id returns a validation error
- Invalid datetime format for as_of or published_from fields causes schema rejection
- Limit value outside 1–50 range is rejected
- Unknown ticker symbol may return empty results rather than an error
- Expired or missing x402 payment token results in a 402 Payment Required error
- Cursor string exceeding 4096 characters is rejected

## 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 paginated list of analyst-identified belief risks, each associated with a specific thesis or entity, including severity level, dated evidence, and metadata such as publication timestamp, schema version, and cursor for pagination.

## 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))$"
      },
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1
      },
      "corpus": {
       "type": "string",
       "const": "released"
      },
      "cursor": {
       "type": "string",
       "maxLength": 4096
      },
      "ticker": {
       "type": "string",
       "maxLength": 32,
       "minLength": 1
      },
      "severity": {
       "enum": [
        "low",
        "medium",
        "high"
       ],
       "type": "string"
      },
      "belief_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)$"
      },
      "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)$"
      },
      "person_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)$"
      },
      "source_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)$"
      },
      "object_status": {
       "type": "string"
      },
      "published_from": {
       "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}-(
… (truncated)
```

## 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-belief-risks-3cb022f6/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)