{"uid":"cap_0xBZmXEjUecA7lmJO177M","slug":"x402stock-short-interest-api-d1a95cc1","name":"x402stock Short Interest 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-interest/%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":["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"},"avg_daily_volume":{"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":{"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"}},"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_PqN-gaO8TPa7kjpIAG9di","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 short interest data for a US stock ticker, including shares short, average daily volume, and days-to-cover ratio over time.","exampleAgentPrompt":"What's the latest short interest data for GME — how many shares are shorted and what's the days-to-cover ratio?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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)"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:49:26.430Z","isFirstParty":false}