{"uid":"cap_W6h8HjjOH0D0-Hx99XutX","slug":"beliefstate-get-belief-relationships-8516fb2f","name":"BeliefState Get Belief Relationships","description":"The first AI-powered platform for top analyst research. Get theses from top analysts, dated evidence, and available outcomes for your AI.","url":"https://beliefstate.ai/v1/research/get_belief_relationships?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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_at":{"type":"string","format":"date-time"},"schema_version":{"type":"string","const":"1"}}}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-10-24T00:00:00.000Z","generated_at":"2026-10-24T00:00:00.000Z","schema_version":"1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M-3aJu4APc_bNFtq6Ssuv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Traverses a knowledge graph of analyst research beliefs to find relationships and connections between entities, up to a specified depth and edge count.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Tracing analyst thesis chains for a stock","prompt":"Using BeliefState, show me all the belief relationships linking from analyst entity 3fa85f64-5717-4562-b3fc-2c963f66afa6 through belief 'ai-infrastructure-thesis-2024' up to 3 levels deep with an edge budget of 75, so I can see how the bull case connects to NVIDIA."},{"title":"Point-in-time belief graph snapshot","prompt":"Pull the BeliefState belief relationships for belief ID 'rate-cut-impact-2023' starting from entity 3fa85f64-5717-4562-b3fc-2c963f66afa6, max depth 2, edge budget 30, as of December 31st 2023 so I can see what the analyst network looked like at year-end."},{"title":"Checking connection between two research entities","prompt":"On BeliefState, find if and how entity 3fa85f64-5717-4562-b3fc-2c963f66afa6 connects to entity 550e8400-e29b-41d4-a716-446655440000 under belief 'ev-sector-outlook', using a max depth of 2 and up to 40 edges."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:36:32.862Z","isFirstParty":false,"canonicalSlug":"beliefstate-get-belief-relationships-8516fb2f"}