get_macro_context

Get macroeconomic context · $0.02 per call (x402, USDC) Retrieves retained government macroeconomic observations in one ticker research scope. Filter by native series_ids, agency, measurement_names and period dates; returns typed values, units, seasonal bases, scales, native periods and source support. Supported archive formats cover Treasury, NY Fed, BLS, BEA, EIA, CFTC and metadata-qualified Federal Reserve Board series; other admitted context is explicitly bounded. Macro backdrop does not establish company exposure or a historical data vintage; FRED and rights-held series are unavailable. Current requests recheck stale mirror metadata; historical/pinned reads remain fixed. 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`	”period”	No	Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar.
`series_ids`	array of string	No
`agency`	string	No	min length 1; max length 128
`measurement_names`	array of string	No	Exact native measurements, such as a Treasury maturity column.

Transports

MCP: tools/call with name get_macro_context 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_macro_context 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_macro_context",
    "arguments": {
      "ticker": "NVDA"
    }
  }
}

x402 HTTP

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

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