{"uid":"cap_3FcpR2YsBN9GvbXJmFM8P","slug":"beliefstate-get-research-brief-b5bf0abf","name":"BeliefState Get Research Brief","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_brief?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","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"}}}}}}},"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_hSiYVweKizZJZGs4uWPvE","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":"Retrieves an AI-synthesized investment research brief for a given stock ticker or entity, including analyst theses, dated evidence, and outcome tracking.","exampleAgentPrompt":"Pull me the full BeliefState research brief for NVDA as of today — I want the detailed view with all analyst theses and evidence.","exampleUseCases":[{"title":"Pre-earnings analyst consensus check","prompt":"Before TSLA earnings tomorrow, get me the full analyst research brief from BeliefState so I can see what top analysts currently believe and what evidence they're citing."},{"title":"Historical investment thesis snapshot","prompt":"Get me the BeliefState research brief for AAPL as of January 1st, 2025 — I want the overview detail level so I can compare analyst sentiment to where it is now."},{"title":"Due diligence on unfamiliar company","prompt":"I'm looking at a company with entity ID 3fa85f64-5717-4562-b3fc-2c963f66afa6 on BeliefState — can you fetch the full research brief so I can review the analyst theses and outcomes before I invest?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:36:12.051Z","isFirstParty":false,"canonicalSlug":"beliefstate-get-research-brief-b5bf0abf"}