# Gloom Short Interest Data API

> Gloom Short Interest Data API is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.06/call, status unknown (last checked 2026-11-01).

Returns short interest data for one or more stock symbols, including shares short, days-to-cover, and change percent.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/short-interest?utm_source=zero.xyz
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-short-interest-data-api-077bcab2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fR1r63WUL563S3XNIoLWm

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 gloom-short-interest-data-api-077bcab2
```

Example prompt: Can you pull the current short interest data for AAPL and TSLA — I want to see shares short, days to cover, and how much short interest changed recently?

## When to prefer this

Choose this endpoint when you need structured short interest metrics — shares short, days to cover, and change percent — for specific U.S. equity tickers. It is ideal for agents performing short squeeze screening, portfolio risk analysis, or monitoring bearish sentiment signals. Prefer this over general market data APIs when short-selling-specific fields like settlement date and days-to-cover are required.

## Known failure modes

- Missing or invalid 'symbols' query parameter returns an error
- Unknown or delisted ticker symbols may return empty data or null fields
- publishedAt field may be null for some records
- Rate limiting or payment failure (x402) if USDC payment is not processed
- Data may be delayed relative to official exchange settlement dates

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

Returns a JSON array of short interest records per symbol, each containing: symbol, issue name, shares short, previous shares short, change percent, days to cover, average daily volume, settlement date, published timestamp, and a revised flag indicating if the data was updated.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbols"
     ],
     "properties": {
      "symbols": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "symbol": "AAPL",
    "revised": true,
    "issueName": "Apple Inc. Common Stock",
    "daysToCover": 2.59,
    "publishedAt": null,
    "sharesShort": 113576032,
    "changePercent": 0.75,
    "settlementDate": "2026-01-15",
    "averageDailyVolume": 43772789,
    "previousSharesShort": 112730000
   }
  ]
 }
}
```

## More

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