# x402stock Float Data API

> x402stock Float Data API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-21).

Returns the free float share count and float percentage for a given US stock ticker symbol

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/float/%7Bticker%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-float-data-api-c4a08846
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DoKrrz4fjRGbWZUjyEbsw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402stock-float-data-api-c4a08846
```

Example prompt: What's the current free float and restricted share percentage for GME?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-float-data-api-c4a08846/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)