# x402stock Short Volume Data API

> x402stock Short Volume Data 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-08).

Returns FINRA short sale volume data for a US stock ticker, including short volume ratio, exempt/non-exempt volumes, and per-venue breakdowns across NYSE, Nasdaq Carteret, Nasdaq Chicago, and ADF.

## Facts

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

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-volume-data-api-272e8ce7
```

Example prompt: What's the short volume ratio for AAPL right now, and can you show me the last 10 days of short volume history including how it breaks down across NYSE, Nasdaq, and ADF venues?

## When to prefer this

Use this endpoint when you need FINRA-sourced short sale volume data for US-listed equities and ETFs, especially when you want per-venue breakdowns (NYSE, Nasdaq, ADF) and historical short volume ratios without managing API keys or subscriptions — paying only $0.02 USDC per call via x402 on Base.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty data
- Limit parameter out of range (must be between 1 and 100) returns validation error
- Payment not completed via x402/USDC results in 402 Payment Required response
- Data may be delayed or unavailable for very thinly traded or OTC-only securities
- No API key or account provided causes 402 before data is served

## 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 with the ticker, data source, as-of timestamp, and a data object containing: count of records, the latest trading day's short volume, total volume, exempt volume, non-exempt volume, short volume ratio (as a percentage), and per-venue volumes (NYSE, Nasdaq Carteret, Nasdaq Chicago, ADF), plus a history array of the same fields for prior dates.

## 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": [
            "date",
            "total_volume",
            "short_volume",
            "exempt_volume",
            "non_exempt_volume",
            "short_volume_ratio",
            "venues"
           ],
           "properties": {
            "date": {
             "type": "string"
            },
            "venues": {
             "type": "object",
             "required": [
              "nyse",
              "nasdaq_carteret",
              "nasdaq_chicago",
              "adf"
             ],
             "properties": {
              "adf": {
               "anyOf": [
                {
                 "type": "number"
                },
                {
                 "type": "null"
                }
               ]
              },
              "nyse": {
               "anyOf": [
                {
                 "type": "number"
                },
                {
                 "type": "null"
                }
               ]
              },
              "nasdaq_chicago": {
               "anyOf": [
                {
                 "type": "number"
                },
        
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "count": 1,
   "latest": {
    "date": "2026-05-29",
    "venues": {
     "adf": 0,
     "nyse": 665260,
     "nasdaq_chicago": 48267,
     "nasdaq_carteret": 6563392
    },
    "short_volume": 7276919,
    "total_volume": 18774437,
    "exempt_volume": 106446,
    "non_exempt_volume": 7170473,
    "short_volume_ratio": 38.76
   },
   "history": [
    {
     "date": "2026-05-29",
     "venues": {
      "adf": 0,
      "nyse": 665260,
      "nasdaq_chicago": 48267,
      "nasdaq_carteret": 6563392
     },
     "short_volume": 7276919,
     "total_volume": 18774437,
     "exempt_volume": 106446,
     "non_exempt_volume": 7170473,
     "short_volume_ratio": 38.76
    }
   ]
  },
  "as_of": "2026-05-29T00:00:00.000Z",
  "source": "x402stock",
  "ticker": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-short-volume-data-api-272e8ce7/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)