get_changes

Get research changes · $0.02 per call (x402, USDC) Retrieves the ordered research change journal for a company, subject, case or explicitly selected released corpus. Returns dated events, citations and available before/after values, separating author revisions, distribution changes and calculated publication outcomes. Use domain=author_view for investor-view changes and revision_only=true for authored revisions only; get_brief provides a current synthesis. Preserve publication, observation and availability clocks. Drain a requested window with unchanged selectors; its continuation cursor differs from the completed next-poll checkpoint. Coverage and resynchronization gaps remain explicit.

Input parameters

Parameter	Type	Required	Description
`person_id`	string	No
`source_id`	string	No
`domain`	”author_view” \| “author_condition” \| “engine_assessment” \| “calculated_publication_outcome” \| “distribution” \| “identity_resolution” \| “provenance” \| “engine_quality” \| “engine_plan”	No
`event_kind`	string	No	min length 1; max length 80
`revision_only`	boolean	No
`ticker`	string	No
`entity_id`	string	No
`belief_id`	string	No
`corpus`	string	No
`cursor`	string	No	min length 1; max length 2048
`checkpoint`	string	No	min length 1; max length 2048
`resync`	boolean	No
`as_of`	string	No
`changed_since`	string	No
`limit`	integer	No	min 1; max 50

Transports

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

x402 HTTP

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