# x402stock Short Interest API

> x402stock Short Interest API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns short interest data for a US stock ticker, including shares short, average daily volume, and days-to-cover ratio over time.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/short-interest/%7Bticker%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-short-interest-api-d1a95cc1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0xBZmXEjUecA7lmJO177M

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402stock-short-interest-api-d1a95cc1
```

Example prompt: What's the latest short interest data for GME — how many shares are shorted and what's the days-to-cover ratio?

## When to prefer this

Use this endpoint when you need current or historical short interest metrics — shares sold short, average daily volume, and days-to-cover — for a specific US-listed equity. It is ideal for assessing short squeeze potential, bearish sentiment, or crowded short positions. Prefer over general market data APIs when short interest specifically is required, and when you need a pay-per-call model with no API key setup.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty data
- Ticker for non-US or OTC stock may not have data
- Rate limiting or payment failure (402) if USDC payment is not properly attached
- Limit parameter exceeding 100 returns a validation error
- Data may be delayed or only updated at FINRA settlement dates (bi-monthly)

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

Returns a JSON object containing the ticker symbol, an as_of timestamp, and a data object with: latest short interest record (settlement date, shares short, average daily volume, days-to-cover), plus a historical array of past records and a count of how many records are available.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 100,
       "exclusiveMinimum": 0
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "ticker",
      "data",
      "source",
      "as_of"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "count",
        "latest",
        "history"
       ],
       "properties": {
        "count": {
         "type": "number"
        },
        "latest": {
         "anyOf": [
          {
           "type": "object",
           "required": [
            "settlement_date",
            "short_interest",
            "avg_daily_volume",
            "days_to_cover"
           ],
           "properties": {
            "days_to_cover": {
             "type": "number"
            },
            "short_interest": {
             "type": "number"
            },
            "settlement_date": {
             "type": "string"
            },
            "avg_daily_volume": {
             "type": "number"
            }
           },
           "additionalProperties": false
          },
          {
           "type": "null"
          }
         ]
        },
        "history": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "settlement_date",
           "short_interest",
           "avg_daily_volume",
           "days_to_cover"
          ],
          "properties": {
           "days_to_cover": {
            "type": "number"
           },
           "short_interest": {
            "type": "number"
           },
           "settlement_date": {
            "type": "string"
           },
           
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "count": 1,
   "latest": {
    "days_to_cover": 2.39,
    "short_interest": 124500000,
    "settlement_date": "2026-05-15",
    "avg_daily_volume": 52000000
   },
   "history": [
    {
     "days_to_cover": 2.39,
     "short_interest": 124500000,
     "settlement_date": "2026-05-15",
     "avg_daily_volume": 52000000
    }
   ]
  },
  "as_of": "2026-05-15T00:00:00.000Z",
  "source": "x402stock",
  "ticker": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-short-interest-api-d1a95cc1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)