{"uid":"cap_DoKrrz4fjRGbWZUjyEbsw","slug":"x402stock-float-data-api-c4a08846","name":"x402stock Float 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/float/%7Bticker%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"note":null,"free_float":405527132,"effective_date":"2026-05-20","free_float_percent":90.4,"restricted_percent":9.6},"as_of":"2026-05-20","source":"x402stock","ticker":"GME"}},"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":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r3dbBj6ezNXxImVUvvRe7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the free float share count and float percentage for a given US stock ticker symbol","exampleAgentPrompt":"What's the current free float and restricted share percentage for GME?","exampleUseCases":[{"title":"Meme stock float analysis","prompt":"What's the free float count and float percentage for GME right now? I want to know how many shares are actually freely tradable versus restricted."},{"title":"Short squeeze candidate screening","prompt":"Can you pull the free float data for AMC — specifically the total free float shares and what percent of shares are restricted? I'm evaluating short squeeze potential."},{"title":"Portfolio risk assessment","prompt":"I need the float details for NVDA — how many shares are in the free float and what percentage of total shares are restricted as of today?"}],"resultDescription":"Returns a JSON object with the ticker symbol, free float share count (integer), free float percentage, restricted share percentage, the effective date of the data, any applicable notes, and the data source (x402stock).","failureModes":["Invalid or unknown ticker symbol returns an error or empty data","Ticker for non-US or delisted securities may not return data","Data may lag real-time corporate actions like secondary offerings or buybacks","Network or payment failure via x402/USDC may prevent the call from completing"],"whenToPreferThis":"Use this endpoint when you need programmatic, pay-per-call access to stock float data without managing API keys or subscriptions — ideal for AI agents doing one-off lookups on US equities, evaluating short squeeze conditions, or enriching stock profiles with share structure data. Prefer this over subscription-based financial data providers when you need lightweight, on-demand float lookups billed in USDC via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:30:18.787Z","isFirstParty":false,"canonicalSlug":"x402stock-float-data-api-c4a08846"}