get_news

Get SEC filing news · Free discovery Retrieves recent SEC filings for one verified ticker, including filing and acceptance dates, official links and the last observation time. Set include_earnings=true for issuer-announced earnings schedules where BeliefState has verified SEC evidence. Release dates and webcast times are separate. Free without using account allowance, credits or wallet payment. Missing or stale filing snapshots trigger a read-only SEC metadata lookup. Provider failure preserves stale or unavailable status.

Input parameters

Parameter	Type	Required	Description
`ticker`	string	Yes
`limit`	integer	No	min 1; max 10; default 5
`include_earnings`	boolean	No	Include issuer-announced earnings schedules supported by admitted SEC evidence.

Transports

MCP: tools/call with name get_news at https://beliefstate.ai/mcp (account access) or https://beliefstate.ai/v1/research/mcp (free discovery; no account or payment). See MCP integration.
x402 HTTP: POST https://beliefstate.ai/v1/research/news with the arguments as a JSON body. Free; no payment authorization.
Related REST resource: GET /v1/sources?view=news.

Example request

MCP

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

x402 HTTP

curl --request POST \
  --url 'https://beliefstate.ai/v1/research/news' \
  --header 'Content-Type: application/json' \
  --data '{"ticker":"NVDA","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