get_economic_calendar

Get economic calendar · $0.02 per call (x402, USDC) Retrieves retained US economic events in one ticker research scope. Filter by event text, region, scheduled/reported/unconfirmed state and scheduled-date bounds. Returns typed actual, previous, consensus and forecast literals, revision markers, native times and source support; an unverified timezone stays unknown. Current requests recheck stale mirror metadata; historical and pinned reads never refresh. This is retained calendar context, with snapshot freshness separate from event time. Continue with the returned snapshot, cutoff, filters and cursor or next_offset.

Input parameters

Parameter	Type	Required	Description
`cursor`	string	No	Archive continuation token; reuse with snapshot ID/hash, as_of and unchanged filters. max length 4096
`ticker`	string	Yes
`as_of`	string	No	Availability cutoff, separate from event/period filters. Historical reads never refresh.
`snapshot_id`	string	No	Pin continuation to the returned snapshot ID; reuse with snapshot_hash and as_of.
`snapshot_hash`	string	No
`filters_sha256`	string	No	Reuse the returned filter hash unchanged with continuation pages.
`offset`	integer	No	min 0; max 10000000
`limit`	integer	No	Matching typed observations per page; default32. min 1; max 100
`max_snapshot_age_hours`	number	No	Requested verification-age tolerance: default1hour for retained archives,24hours for closing-price references. Record dates and publication cadence are separate. max 87600
`date_from`	string	No	Inclusive native date lower bound, selected by date_field.
`date_to`	string	No	Inclusive native date upper bound, selected by date_field.
`date_field`	”scheduled” \| “report”	No	Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar.
`event_contains`	string	No	min length 1; max length 128
`region`	string	No	min length 1; max length 16
`state`	”scheduled” \| “reported” \| “unconfirmed”	No

Transports

MCP: tools/call with name get_economic_calendar 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_economic_calendar with the arguments as a JSON body. An unpaid request returns an HTTP 402 payment quote.

Example request

MCP

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

x402 HTTP

curl --request POST \
  --url 'https://beliefstate.ai/v1/research/get_economic_calendar' \
  --header 'Content-Type: application/json' \
  --data '{"ticker":"NVDA"}'

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

All research tools

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

get_economic_calendar

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