Find investor beliefs or inspect a full record
Returns compact, filterable, point in time summaries of released investor beliefs. Use belief_id for decision_review (current evidence comparison or an explicit review gap) and the complete record with its documented investor twin: source linked memories, stated conditions, separate author and condition timestamps, and a versioned snapshot hash. Optional scenario contains up to eight condition status assumptions; JSON encode it in the REST query. Scenarios do not change evidence or predict the investor’s response. Use view=entities with optional q and kind to discover released subjects and security listings, then entity_id for their cited belief inventory. Non-stock belief_id reads expose author conditions and explicit market capability gaps; scenario and investor twins remain listing-only. Use changed_since to find changed beliefs and person_id with ticker or entity_id to inspect an investor’s recorded history. A cursor freezes collection query state and as_of. When the ordered change feed is released, use view=changes with exactly one ticker, entity_id, belief_id or corpus=released selector. Drain continuation_cursor before saving polling_checkpoint; next poll uses checkpoint. If status=resync_required, repeat the explicit selector with resync=true, drain its authorized inventory, then save its checkpoint. Keep author publication, engine assessment and customer availability distinct. No portfolio upload or broker action is required. Disabled or uninitialized history cannot issue a checkpoint.
Authorizations
Developer API key created through /auth.md. Never paste it into a retail chat.
Headers
Stable 1–128 character ID for an idempotent retry. Reuse the same value only for the same logical request.
128^[A-Za-z0-9._~:+/=-]+$Query Parameters
1 - 32^(?:(?:\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))$Page size; defaults to 5. Use the returned cursor for more.
1 <= x <= 501 - 20481 - 128bullish, bearish, mixed, neutral, non_directional, unknown forming, active, strengthened, weakened, reversed, resolved, abandoned, unknown 1 - 128Find initial research, author revisions, condition checks/plans or released outcomes becoming available after this cutoff. Keeps author dates and stance separate from system activity. Release changes and a complete ordered event-history checkpoint are not yet included.
^(?:(?:\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))$Canonical subject ID. Use view=entities to discover IDs.
^([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)$Discover released canonical subjects, including non-ticker research.
entities, changes 1 - 2048"released"1 - 80company, instrument, commodity, macro_variable, industry, sector, theme, country, geography, person, policy, event_series, event_occurrence, currency, index 1 - 128Use a visual_id returned by this belief's visuals.descriptors to inspect one saved visual.
^[a-f0-9]{64}$Continue visual descriptors using next_visual_offset; requires belief_id and cannot accompany visual_id.
0 <= x <= 9007199254740991Use a region_id returned in the selected visual's regions to retrieve structured data.
^[a-f0-9]{64}$Continue a selected visual's region descriptors using next_region_offset.
0 <= x <= 9007199254740991Zero-based starting row or chart-point index in the selected region.
0 <= x <= 999Rows or chart points per read; defaults to 50, maximum 100.
1 <= x <= 100Response
Successful read only response
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
"1"^(?:(?:\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))$^(?:(?:\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))$"beliefs"1
