get_catalysts

Get case catalysts · $0.02 per call (x402, USDC) Retrieves evidence-linked catalysts for one company, research subject, investment case or the explicitly selected released corpus. Returns recorded conditions, lifecycle status, dates and supporting evidence. Useful for checking which thesis events remain pending, were met or missed, or have been superseded. Filter by investor, source, publication dates or status. Unassessed conditions retain unknown status. Continue with the returned cursor and unchanged filters.

Input parameters

Parameter	Type	Required	Description
`ticker`	string	No	min length 1; max length 32
`entity_id`	string	No
`belief_id`	string	No
`corpus`	string	No
`person_id`	string	No
`source_id`	string	No
`object_status`	string	No
`published_from`	string	No
`published_through`	string	No
`as_of`	string	No
`limit`	integer	No	min 1; max 50
`cursor`	string	No	max length 4096

Transports

MCP: tools/call with name get_catalysts 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_catalysts 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_catalysts",
    "arguments": {
      "ticker": "NBIS",
      "limit": 5
    }
  }
}

x402 HTTP

curl --request POST \
  --url 'https://beliefstate.ai/v1/research/get_catalysts' \
  --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