{"uid":"cap_kRfUsH3souHav0TLDLTkD","slug":"gloom-short-volume-data-api-66763e5b","name":"Gloom Short Volume Data API","description":"Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.","url":"https://api.gloom.sh/v1/short-volume?utm_source=zero.xyz","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"],"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"}}}}},"responseSchema":{"type":"json","example":{"data":[{"date":"2026-09-21","symbol":"AAPL","markets":["B"],"fetchedAt":"2026-09-22T00:00:00.000Z","shortVolume":"5442428.346356","totalVolume":"12178460.751537","ratioPercent":44.68896732,"refreshFailed":false,"shortExemptVolume":"23826","unavailableReason":null}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4D00kBlDuFYPq8z3C3BeF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns short volume, total volume, and short ratio data for one or more stock symbols on a given date","exampleAgentPrompt":"Can you pull the latest short volume data for AAPL and TSLA from Gloom — I want to see the short volume, total volume, and what percentage was short?","exampleUseCases":[{"title":"Short squeeze research for retail trader","prompt":"What's the short volume ratio for GME and AMC right now? I'm trying to see if there's elevated short selling pressure before deciding on a trade."},{"title":"Daily short volume monitoring for portfolio","prompt":"Pull the short volume stats from Gloom for my watchlist — NVDA, AMD, and MSFT — so I can see which ones have the highest short volume percentage today."},{"title":"Algorithmic signal generation for quant strategy","prompt":"Get me the short volume and total volume numbers for SPY for today from Gloom — I need the ratio percent to feed into my momentum signal model."}],"resultDescription":"Returns an array of records per symbol, each containing: the date, stock symbol, market codes, short volume (shares), total volume (shares), short-to-total ratio as a percentage, short exempt volume, whether a refresh failed, and the timestamp when data was fetched. Example: AAPL with shortVolume ~5.4M out of totalVolume ~12.2M = 44.7% ratio.","failureModes":["Missing or invalid 'symbols' query parameter returns an error","Symbol not found or unsupported ticker may return empty data array","refreshFailed: true in response indicates upstream data fetch issue for that symbol","Rate limiting or payment failure (x402) may block request","Invalid date or no data available for requested date returns empty results"],"whenToPreferThis":"Choose this endpoint when you need daily short volume statistics for specific US equities, especially short volume ratios and exempt volume breakdowns. Prefer this over general market data APIs when the specific metric needed is short selling activity or short interest pressure. It is particularly useful for quantitative strategies, short squeeze research, or monitoring unusual short selling patterns in individual stocks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:43.357Z","isFirstParty":false,"canonicalSlug":"gloom-short-volume-data-api-66763e5b"}