get_short_activity

Get short activity · $0.02 per call (x402, USDC) Retrieves retained short-interest and short-volume history for one ticker. Select family and date bounds; short_interest uses settlement periods, while short_volume uses observation dates. Returns typed outstanding short shares, average daily volume and days to cover, or daily short/exempt/total volumes, with exact source support. Short volume does not establish an outstanding position. Current requests recheck stale mirror metadata; historical and pinned reads never refresh. Continue with the returned snapshot, as_of, filters and cursor or next_offset; coverage gaps remain explicit.

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” \| “observation”	No	Date meaning; defaults to period for facts/macro/holdings/returns, event for insider trades, observation for options/short volume, scheduled for calendar.
`family`	”short_interest” \| “short_volume”	No

Transports

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

x402 HTTP

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