{"uid":"cap_nqJ86HqHEcZ1LgY1Bx5xG","slug":"agents-x402stock-xyz-free-float-data-for-us-stock-ticker-a43aa8fc","name":"Free Float Data for US Stock Ticker","description":"Free float for a ticker — the share count genuinely available to trade, net of insider, strategic and restricted holdings — plus `free_float_percent` (0-100), the derived `restricted_percent`, and the `effective_date`. The correct denominator for squeeze and liquidity work: short interest as a percentage of float, not of shares outstanding. From x402stock","url":"https://agents.x402stock.xyz/api/v1/float/{ticker}","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"},"pathParams":{"type":"object","ticker":{"type":"string"}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false}}},"responseSchema":{"type":"object","required":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","required":["free_float","free_float_percent","restricted_percent","effective_date","note"],"properties":{"note":{"anyOf":[{"type":"string"},{"type":"null"}]},"free_float":{"anyOf":[{"type":"number"},{"type":"null"}]},"effective_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"free_float_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"restricted_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"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},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XGCYUKFeIEjKo1nflGjg4","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_FlRZeX-QPyO_WQtQd0SgL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns the freely tradable share count, free float percentage, restricted percentage, and effective date for a US-listed stock ticker.","exampleAgentPrompt":"What's the free float and restricted share percentage for GameStop (GME) right now — I need the accurate tradable share count and float percent for a short squeeze analysis?","exampleUseCases":[{"title":"Short squeeze ratio calculation","prompt":"I'm building a short squeeze screener. Can you pull the free float for AMC so I can compute short interest as a percentage of float rather than shares outstanding?"},{"title":"Liquidity check before a large trade","prompt":"Before I place a large block order in SPCE, can you look up the free float and free float percent so I can gauge how liquid this stock really is?"},{"title":"Insider lock-up analysis","prompt":"How much of RIVN's shares are restricted or held by insiders versus freely tradable? I need the restricted percent and free float figures from x402stock."}],"resultDescription":"Returns a JSON object with the ticker symbol, the absolute free float share count, free_float_percent (0-100 scale), restricted_percent (complement of float), effective_date of the data, an optional note, a source identifier ('x402stock'), and an as_of timestamp. Null values may be returned for any data field if unavailable.","failureModes":["Invalid or non-US ticker symbol returns null data fields with a note","Ticker not found in x402stock database returns nulls across data fields","Payment failure or insufficient funds results in HTTP 402 response","Network timeout or upstream data unavailability","Delisted or OTC ticker may return null or partial data"],"whenToPreferThis":"Choose this endpoint when you need the precise tradable share count net of insider, strategic, and restricted holdings — especially as the denominator for short interest ratios, squeeze scoring, or liquidity analysis. Prefer this over shares-outstanding figures whenever float-adjusted metrics are required. It is specifically designed for US-listed equities and returns the effective date so you know the data vintage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T12:39:38.800Z","isFirstParty":false}