{"uid":"cap_uILad23O3OCt8ij4SYLhj","slug":"beliefstate-stock-overview-brief-a0877cec","name":"BeliefState Stock Overview Brief","description":"Investor research and stock analysis for AI trading agents. This route buys up to five cited overview views for 0.02 USDC, with historical cutoffs. Discover all 16 research tools, their exact prices, free coverage and wallet MCP in the free catalog. Catalog: https://beliefstate.ai/v1/research. Full schemas: https://beliefstate.ai/openapi.json.","url":"https://beliefstate.ai/v1/brief/NBIS?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","queryParams","pathParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"pathParams":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9.-]{0,14}$","maxLength":15,"minLength":1,"description":"Released stock ticker from GET /v1/tickers."}},"additionalProperties":false},"queryParams":{"type":"object","required":[],"properties":{"as_of":{"type":"string","format":"date-time","maxLength":35},"detail":{"type":"string","const":"overview"},"max_results":{"type":"integer","maximum":5,"minimum":1}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","$comment":"Permissive discovery projection. Complete response contract: https://beliefstate.ai/openapi.json#/components/schemas/X402BriefOverview","required":["schema_version","view","generated_at","as_of","security","coverage","views","citations"],"properties":{"view":{"type":"string","const":"overview"},"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))$"},"views":{"type":"array","items":{"type":"object","required":["belief_id","person","direction","summary","source_citation_id"],"properties":{"person":{"type":"object","required":["id","name","handle"],"properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"handle":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"additionalProperties":false},"summary":{"type":"object","required":["text","truncated"],"properties":{"text":{"type":"string","minLength":1},"truncated":{"type":"boolean"}},"additionalProperties":false},"belief_id":{"type":"string","minLength":1},"direction":{"enum":["bullish","bearish","mixed","unclear"],"type":"string"},"source_citation_id":{"type":"string","minLength":1}},"additionalProperties":{}}},"coverage":{"type":"object","required":["released_record_count","returned_view_count","omitted_record_count","detail_available"],"properties":{"detail_available":{"type":"boolean","const":true},"returned_view_count":{"type":"integer","maximum":9007199254740991,"minimum":0},"omitted_record_count":{"type":"integer","maximum":9007199254740991,"minimum":0},"released_record_count":{"type":"integer","maximum":9007199254740991,"minimum":0}},"additionalProperties":false},"security":{"type":"object","required":["id","ticker","name"],"properties":{"id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"ticker":{"type":"string","minLength":1}},"additionalProperties":false},"citations":{"type":"array","items":{"type":"object","required":["citation_id","source_url","observed_at"],"properties":{"source_url":{"type":"string","format":"uri"},"citation_id":{"type":"string","minLength":1},"observed_at":{"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":{}}},"generated_at":{"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))$"},"schema_version":{"type":"string","const":"1"}},"additionalProperties":{}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_nyYsreMnKlzjG-4_ukmjt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns up to 5 cited analyst/investor thesis views (bull or bear) with supporting evidence for a given stock ticker, as of a specified date.","exampleAgentPrompt":"Pull up to 5 cited analyst overview views on NBIS from BeliefState — show me who's bullish or bearish and why, as of today.","exampleUseCases":[{"title":"Pre-trade analyst consensus check","prompt":"Before I buy NBIS, can you get me the latest overview brief from BeliefState — I want to see what top analysts are saying, up to 5 views with their citations."},{"title":"Historical thesis snapshot for backtesting","prompt":"Pull the BeliefState overview brief for NBIS as of January 1, 2024 — I need to see what analysts believed at that point in time, with their sources cited."},{"title":"Automated stock research for AI trading agent","prompt":"For my trading pipeline, fetch up to 3 cited analyst theses on NBIS from BeliefState right now so I can assess directional sentiment before executing."}],"resultDescription":"A JSON object containing a list of up to 5 analyst/investor 'views' for the requested ticker, each with: the analyst's identity (name, handle, id), their directional stance (bull/bear), a summary of their thesis, a citation ID linking to the source, and metadata including the schema version, generation timestamp, as-of cutoff date, and security/coverage info.","failureModes":["Ticker not in BeliefState coverage universe — returns empty views or 404","as_of date set to future or outside historical data range — may return no results","max_results exceeds allowed maximum of 5 — validation error","Payment not fulfilled (x402 protocol) — 402 Payment Required response","Malformed ticker format not matching pattern — 400 validation error","Rate limiting or wallet balance insufficient for 0.02 USDC charge"],"whenToPreferThis":"Choose this endpoint when you need cited, attributed analyst and investor theses for a specific stock with directional (bull/bear) labels and traceable sources. It is ideal for AI trading agents that require interpretable, sourced research rather than raw price data or unattributed sentiment scores. Prefer it over generic news APIs when you need structured investment opinions with named analysts and as-of date precision.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:36:53.727Z","isFirstParty":false,"canonicalSlug":"beliefstate-stock-overview-brief-a0877cec"}