QJ//BOUNDED QUERY · OFFLINE

Short Interest State

Return bounded official FINRA consolidated short-interest observations and optional Nasdaq Trader Reg SHO threshold-list membership. Semi-monthly short interest is not daily short volume.

OFFLINE/v1/query/short-interest-stateOAUTH · agents:query$0.02 · X402/2

CONTRACT

Paid bounded short interest state

Skill: qj-short-interest-state
Route: /v1/query/short-interest-state
Identity: OAUTH · agents:query
Price: $0.02 · X402/2

GOVERNED METHOD

Exact MCP evidence path

api.finra.get_short_interestqj-api-mcp
api.nasdaqtrader.get_regsho_threshold_listqj-api-mcp

No direct database, provider API or private service access. Missing coverage remains missing—it is never turned into a negative fact.

INVOKE

Call the bounded resource

Register an OAuth client, request scope agents:query, then call the route with its bearer token. The first unauthorised call returns the exact x402 v2 payment challenge.

REQUEST

{
  "ticker": "AAPL",
  "includeRegSho": true
}

ILLUSTRATIVE RESPONSE SHAPE · NOT LIVE MARKET DATA

{
  "schemaVersion": "qj-agents.short-interest-state.v1",
  "skillId": "qj-short-interest-state",
  "priceUsd": "0.02",
  "status": "complete | partial",
  "query": {
    "ticker": "AAPL",
    "includeRegSho": true
  },
  "facts": {
    "example": "live fields are returned here"
  },
  "interpretation": [],
  "coverage": [
    {
      "tool": "api.finra.get_short_interest",
      "status": "ok"
    }
  ],
  "toolsUsed": [
    "api.finra.get_short_interest",
    "api.nasdaqtrader.get_regsho_threshold_list"
  ],
  "asOf": "ISO-8601 source timestamp",
  "freshness": {
    "status": "fresh | stale | unknown"
  },
  "lineageRefs": [
    "source and materialization references"
  ]
}