{"uid":"cap_tAQffForOvs9A-OsxnEqL","slug":"beliefstate-get-beliefs-4a092bde","name":"BeliefState Get Beliefs","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_beliefs?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))$"},"limit":{"type":"integer","maximum":50,"minimum":1},"cursor":{"type":"string","maxLength":2048,"minLength":1},"status":{"enum":["forming","active","strengthened","weakened","reversed","resolved","abandoned","unknown"],"type":"string"},"ticker":{"type":"string","maxLength":32,"minLength":1},"direction":{"enum":["bullish","bearish","mixed","neutral","non_directional","unknown"],"type":"string"},"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."},"person_id":{"type":"string","maxLength":128,"minLength":1},"time_horizon":{"type":"string","maxLength":128,"minLength":1},"changed_since":{"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))$"}},"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_beliefs?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_6IuHZW_fKu4hGJOciw7eZ","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 paginated analyst investment theses (beliefs) with directional sentiment, status, and dated evidence, filterable by ticker, entity, analyst, direction, time horizon, and status.","exampleAgentPrompt":"Pull up the active bullish analyst beliefs on NVDA from BeliefState as of today — give me up to 20 results with their theses and evidence.","exampleUseCases":[{"title":"Screen stocks by analyst conviction direction","prompt":"Get me all the active bearish analyst beliefs on TSLA from BeliefState, up to 50 results, as of right now — I want to see what top analysts are saying against it."},{"title":"Monitor recent analyst thesis changes","prompt":"Show me any analyst beliefs that have changed since last Monday at midnight UTC, filtering for weakened or reversed theses — I want to catch any major analyst flip-flops."},{"title":"Research analyst stance before earnings","prompt":"Before the earnings call, pull all active and strengthened analyst beliefs on AAPL from BeliefState, limit 25, so I can see the current analyst consensus going in."}],"resultDescription":"A JSON object containing a paginated list of analyst beliefs (investment theses) with their directional sentiment (bullish/bearish/mixed/neutral), status (forming/active/strengthened/weakened/reversed/resolved/abandoned/unknown), supporting dated evidence, time horizon, and available outcomes, along with an as-of timestamp and schema version.","failureModes":["Invalid ticker format returns a 400 validation error","Malformed entity_id UUID fails schema validation","Invalid datetime format for as_of or changed_since causes a 400 error","Limit outside 1–50 range is rejected","No matching beliefs returns an empty result set rather than an error","Payment failure (x402) results in a 402 response before data is returned","Cursor value from a prior page may expire or become invalid"],"whenToPreferThis":"Use this endpoint when you need structured, filterable analyst investment theses with directional sentiment and status history for AI-driven trading or research workflows. Prefer it over general financial news APIs when you specifically need curated top-analyst thesis-level research with evidence and outcomes, and need to filter by direction, status, or time horizon programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:37:12.414Z","isFirstParty":false,"canonicalSlug":"beliefstate-get-beliefs-4a092bde"}