Get Supply Float

GET/v1/cryptodata/supply/float

Circulating float and dilution overhang for every tracked coin. Ranked by **ascending float** — the tightest floats first, because that is the end of the distribution where supply is the story. A coin trading at a 23% float with three times its market cap still locked is a different instrument from one that is fully distributed. - `float_pct` (0..1) — circulating ÷ `supply_basis`. - `supply_basis` — **which denominator was used**: `max_supply` when the token is genuinely capped, else `total_supply`. `max_supply` is absent for over half the universe, and "share of max" and "share of total" are different claims, so this is stated rather than assumed. - `locked_supply` / `locked_usd` — what is not yet circulating. - `dilution_overhang` — locked value as a multiple of current market cap. - `next_unlock` — the soonest dated cliff, with same-day tranches summed and priced (`usd`, `pct_of_float`, `pct_of_market_cap`). - `unlock_coverage` — `tracked` or `not_tracked`. **A null `next_unlock` with `not_tracked` does NOT mean the token has no unlock scheduled**; it means no schedule is published for it in our source. Do not read it as "safe". Defaults to a **$500M market-cap floor**: below it a "tight float" is usually a nominal `total_supply` rather than a real vesting schedule, and those artifacts otherwise dominate the top of an ascending-float ranking. Pass `min_market_cap=0` for the unfiltered set — the rows are still computed, they are just not what the default board is for. Free tier returns the top 25 rows; Pro and above get the full board and the filters.

# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/cryptodata/supply/float"

# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/cryptodata/supply/float" -H "PAYMENT-SIGNATURE: $X402_PAYMENT"

// npm i @x402/fetch @x402/core @x402/evm viem
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = x402Client.fromConfig({ schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(PRIVATE_KEY)) }] });
const pay = wrapFetchWithPayment(fetch, client);
const data = await (await pay("https://api.realtimeapi.ai/v1/cryptodata/supply/float")).json();
console.log(data);

# pip install x402 eth-account requests
from eth_account import Account
from x402.clients.requests import x402_requests

session = x402_requests(Account.from_key(PRIVATE_KEY))
print(session.get("https://api.realtimeapi.ai/v1/cryptodata/supply/float").json())

curl "https://api.realtimeapi.ai/v1/cryptodata/supply/float" -H "X-API-Key: $RTAPI_KEY"