# BeliefState Get Belief Relationships

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

Traverses a knowledge graph of analyst research beliefs to find relationships and connections between entities, up to a specified depth and edge count.

## Facts

- Endpoint: POST https://beliefstate.ai/v1/research/get_belief_relationships?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-relationships-8516fb2f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W6h8HjjOH0D0-Hx99XutX

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-relationships-8516fb2f -d '<json body>'
```

Example prompt: Using BeliefState, find the belief relationships starting from entity ID 3fa85f64-5717-4562-b3fc-2c963f66afa6 and belief ID 'bull-case-nvda-2024', going up to 2 levels deep with a budget of 50 edges, as of October 1st 2024.

## When to prefer this

Choose this endpoint when you need to traverse and map the relationship graph between analyst beliefs and specific entities in BeliefState's research knowledge base. It is ideal for discovering multi-hop reasoning chains, tracing how a thesis connects to outcomes, or understanding the network of relationships around a specific belief — especially when you need point-in-time historical snapshots via the as_of parameter. Prefer this over single-entity lookup endpoints when the connectivity or relational structure between beliefs and entities is what matters.

## Known failure modes

- Invalid belief_id or non-existent belief returns empty or error response
- from_entity_id UUID not found in the knowledge graph returns no results
- edge_budget exhausted before full traversal completes, truncating results
- max_depth exceeds maximum allowed value of 3 returns validation error
- Malformed UUID format for entity IDs returns schema validation error
- as_of date in the future or before data availability window returns empty results
- Payment failure (x402) prevents 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 versioned JSON envelope containing the belief relationship graph traversal results, including the schema version, generation timestamp, and as-of date. The full response includes edges and nodes connecting analyst beliefs and entities discovered during traversal within the specified depth and edge constraints.

## 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",
     "required": [
      "belief_id",
      "from_entity_id",
      "max_depth",
      "edge_budget"
     ],
     "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))$"
      },
      "belief_id": {
       "type": "string",
       "maxLength": 128,
       "minLength": 1
      },
      "max_depth": {
       "type": "integer",
       "maximum": 3,
       "minimum": 1
      },
      "edge_budget": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1
      },
      "to_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)$"
      },
      "from_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)$"
      }
     },
     "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_belief_relationships?schema=output",
     "required": [
      "schema_version",
      "generated_at",
      "as_of"
     ],
     "properties": {
      "as_of": {
       "type": "string",
       "format": "date-time"
      },
      "generated_a
… (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-relationships-8516fb2f/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)