{"uid":"cap_yJxSpjVfkSoZmiRXdYtsO","slug":"beliefstate-get-belief-changes-b74ba57c","name":"BeliefState Get Belief Changes","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_changes?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},"corpus":{"type":"string","const":"released"},"cursor":{"type":"string","maxLength":2048,"minLength":1},"domain":{"enum":["author_view","author_condition","engine_assessment","calculated_publication_outcome","distribution","identity_resolution","provenance","engine_quality","engine_plan"],"type":"string"},"resync":{"type":"boolean"},"ticker":{"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)$"},"checkpoint":{"type":"string","maxLength":2048,"minLength":1},"event_kind":{"type":"string","maxLength":80,"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))$"},"revision_only":{"type":"boolean"}},"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_changes?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_1EEv8vthqTl7_H2E3vs8t","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 a paginated feed of changes to analyst belief records, filterable by ticker, domain, entity, person, or source, as of a given timestamp.","exampleAgentPrompt":"Pull the latest belief changes for ticker AAPL from BeliefState as of today, using the 'engine_assessment' domain, and give me up to 20 results.","exampleUseCases":[{"title":"Monitor analyst thesis shifts on a stock","prompt":"Check BeliefState for any belief changes on NVDA since January 1st 2025 — use the engine_assessment domain and give me up to 50 results so I can see how analyst views have evolved."},{"title":"Incremental sync of research updates","prompt":"I need to sync any new analyst belief changes from BeliefState since my last checkpoint — use this checkpoint token 'cp_abc123xyz' for the released corpus and return up to 25 records."},{"title":"Track specific analyst's changing views","prompt":"Fetch belief changes from BeliefState for person ID '550e8400-e29b-41d4-a716-446655440000' as of 2025-06-01T00:00:00Z, domain set to author_view, limit 10 — I want to see how this analyst's positions have shifted."}],"resultDescription":"A JSON object containing a list of belief change records timestamped with as_of and generated_at fields, a schema_version, and optionally a cursor or checkpoint for pagination. Each record reflects a detected change in an analyst's belief across the requested domain (e.g. engine_assessment, author_view, distribution).","failureModes":["Invalid UUID format for belief_id, entity_id, person_id, or source_id returns a validation error","as_of timestamp not in strict ISO 8601 UTC format causes schema rejection","limit outside 1–50 range returns a constraint violation","Unknown domain enum value returns a 400 bad request","Expired or invalid cursor causes pagination failure","No matching records returns empty result set","Malformed checkpoint string causes sync error"],"whenToPreferThis":"Use this endpoint when you need to incrementally track or detect changes in analyst beliefs over time — especially for building change-detection pipelines, syncing new research updates since a known checkpoint, or monitoring how analyst views on specific tickers or entities shift. Prefer this over a bulk fetch endpoint when you need delta/change-aware data rather than a full snapshot of current beliefs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:39:21.947Z","isFirstParty":false,"canonicalSlug":"beliefstate-get-belief-changes-b74ba57c"}