get_cases

Get investment cases · $0.02 per call (x402, USDC) Retrieves dated investment cases for one company or research subject, with optional investor, direction and time filters. Returns attributed thesis records, case IDs, dates, citations and coverage information. Useful for building a research inventory or finding additional cases beyond a brief. Use get_brief for an ordinary overview and get_search_results for a thesis or topic question. Continue a requested inventory with unchanged selectors and its returned cursor.

Input parameters

Parameter	Type	Required	Description
`ticker`	string	No	min length 1; max length 32
`entity_id`	string	No	Released subject ID returned by get_subjects.
`person_id`	string	No	min length 1; max length 128
`direction`	”bullish” \| “bearish” \| “mixed” \| “neutral” \| “non_directional” \| “unknown”	No
`status`	”forming” \| “active” \| “strengthened” \| “weakened” \| “reversed” \| “resolved” \| “abandoned” \| “unknown”	No
`time_horizon`	string	No	min length 1; max length 128
`changed_since`	string	No	Find 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.
`as_of`	string	No
`limit`	integer	No	Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next_cursor and the same ticker/entity_id. REST supports larger pages. min 1; max 50
`cursor`	string	No	min length 1; max length 2048

Transports

MCP: tools/call with name get_cases at https://beliefstate.ai/mcp (account access) or https://beliefstate.ai/v1/research/mcp (wallet access). See MCP integration.
x402 HTTP: POST https://beliefstate.ai/v1/research/get_cases with the arguments as a JSON body. An unpaid request returns an HTTP 402 payment quote.
Related REST resource: GET /v1/beliefs.

Example request

MCP

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_cases",
    "arguments": {
      "ticker": "NBIS",
      "limit": 5
    }
  }
}

x402 HTTP

curl --request POST \
  --url 'https://beliefstate.ai/v1/research/get_cases' \
  --header 'Content-Type: application/json' \
  --data '{"ticker":"NBIS","limit":5}'

The example shows request shape only. Identifiers are placeholders, not records.

Contract version: 2026-11-08. Input parameters and tool metadata come from the shared executable catalog. REST API version: v1.

Get Started

Core Concepts

Guides

Reference

Endpoints

Research tools

Input parameters

Transports

Example request

MCP

x402 HTTP

​Input parameters

​Transports

​Example request

​MCP

​x402 HTTP

​Related

Input parameters

Transports

Example request

MCP

x402 HTTP

Related