{"uid":"cap_Rb9xifZVrMd5iWQJtcTCh","slug":"x402stock-short-volume-data-api-272e8ce7","name":"x402stock Short Volume Data API","description":"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.","url":"https://x402stock.xyz/api/v1/short-volume/%7Bticker%7D","method":"GET","headers":{},"bodySchema":{"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"},{"type":"null"}]},"nasdaq_carteret":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"short_volume":{"type":"number"},"total_volume":{"type":"number"},"exempt_volume":{"type":"number"},"non_exempt_volume":{"type":"number"},"short_volume_ratio":{"type":"number"}},"additionalProperties":false},{"type":"null"}]},"history":{"type":"array","items":{"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"},{"type":"null"}]},"nasdaq_carteret":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"short_volume":{"type":"number"},"total_volume":{"type":"number"},"exempt_volume":{"type":"number"},"non_exempt_volume":{"type":"number"},"short_volume_ratio":{"type":"number"}},"additionalProperties":false}}},"additionalProperties":false},"as_of":{"type":"string"},"source":{"type":"string","const":"x402stock"},"ticker":{"type":"string"},"feedback":{"type":"object","required":["endpoint","method","free","note"],"properties":{"free":{"type":"boolean"},"note":{"type":"string"},"method":{"type":"string","const":"POST"},"endpoint":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hBJt3hiUI3a5mYHjEDiF3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T12:50:11.239Z","isFirstParty":false}