{"uid":"cap_l0DCWi7XDoGHo0MrWYQh9","slug":"beliefstate-get-research-visual-46a88ea4","name":"BeliefState Get Research Visual","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_research_visual?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":["visual_id"],"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},"region_id":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Use a region_id returned in the selected visual's regions to retrieve structured data."},"row_limit":{"type":"integer","maximum":100,"minimum":1,"description":"Rows or chart points per read; defaults to 50, maximum 100."},"visual_id":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Saved visual ID returned by list_research_visuals."},"row_offset":{"type":"integer","maximum":999,"minimum":0,"description":"Zero-based starting row or chart-point index in the selected region."},"region_offset":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Continue a selected visual's region descriptors using next_region_offset."},"context_assessment_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":"Open a neutral engine context assessment returned by a brief or ordered change. It is not an author Belief."}},"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_research_visual?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_YmRl4UclY9ewvLrs_f4GU","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 structured data from a saved analyst research visual, including chart points, table rows, or region descriptors with optional time-travel via as_of dating.","exampleAgentPrompt":"Pull the structured data from BeliefState visual ID a3f7c2...d9e1 — give me up to 50 rows starting from the beginning, and use the as-of date 2025-01-15T00:00:00Z so I get the analyst's view as it stood then.","exampleUseCases":[{"title":"Historical analyst thesis retrieval","prompt":"Grab the chart data from BeliefState visual 8bc4...f201 as it looked on 2024-06-30T00:00:00Z — I need 100 rows from row 0 so I can backtest against what analysts believed at that time."},{"title":"Paginated research table read","prompt":"I need to page through a large analyst research table on BeliefState — fetch rows 50 through 100 from visual ID 1d9a...4c77, using region ID 2e3f...8a01 to get the structured breakdown."},{"title":"Neutral context assessment view","prompt":"Open the neutral engine context assessment for BeliefState visual ID 7fa3...c82b using context assessment ID 550e8400-e29b-41d4-a716-446655440000 and give me the first 50 data points."}],"resultDescription":"Returns a JSON object containing the structured data for the requested visual, including an as_of timestamp, a generated_at timestamp, schema version, and the actual chart points or table rows (up to the requested row_limit) for the specified region. May also include next_region_offset for pagination.","failureModes":["Invalid visual_id format (not 64-char hex) returns validation error","visual_id not found returns 404 or empty result","region_id not matching a valid region of the visual returns error","row_offset exceeding available data returns empty rows","Invalid as_of datetime format returns schema validation error","Invalid context_assessment_id UUID format returns validation error","Payment failure via x402 protocol blocks access","Expired or unauthorized belief_id returns access denied"],"whenToPreferThis":"Use this endpoint when you have already identified a specific BeliefState research visual (via list_research_visuals) and need to retrieve its underlying structured data — chart points, table rows, or region descriptors. Prefer this over general research endpoints when you need paginated, time-stamped, or region-specific access to a saved analyst visual. Ideal when backtesting against historical analyst views using the as_of parameter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:39:16.715Z","isFirstParty":false,"canonicalSlug":"beliefstate-get-research-visual-46a88ea4"}