Fundamentals REST endpoints

How it works

Values are maintained continuously by our aggregation layer and served from TickerLayer storage, so responses are fast and unaffected by upstream conditions. Share-structure figures (float, shares outstanding, short interest, volumes) refresh daily; company profile fields (name, venue, sector, industry, country) refresh monthly. Every item carries its own as_of vintage, which tracks the share-structure figures and only advances when they are genuinely refreshed.

Share-structure figures are also written as one set, never mixed across refreshes. If an upstream restatement temporarily leaves one of them unavailable, the whole set keeps its previous values and its previous as_of rather than pairing a new count with an older one. That is what makes float_ratio and short_float_ratio safe to rely on.

Responses never contain null: a field our aggregation layer has no reliable value for is omitted from the payload. Ratios such as float_ratio and short_float_ratio are computed from the counts in the same payload, so they are always internally consistent.

Depositary receipts get one extra safeguard. Reference data for them often arrives denominated in the issuer's home-market ordinary shares rather than the receipts that actually trade, and sometimes at a stale vintage on top. We cross-check every reported count against the listing's market cap and live traded price; a count that fails is withheld, and the payload instead carries shares_listed_est and free_float_est, listing-level estimates clearly named as such. Filter on the reported fields when you need exact counts, and fall back to the estimates when you only need the order of magnitude, as in low-float screening.

curl -sS "https://api.tickerlayer.com/fundamentals/stocks/US:KO" \
  -H "x-api-key: <YOUR_API_KEY>"

{
  "symbol": "US:KO",
  "base_symbol": "KO",
  "market": "US",
  "company": "The Coca-Cola Company",
  "exchange": "NYSE",
  "mic": "XNYS",
  "country": "United States",
  "country_code": "US",
  "sector": "Consumer Defensive",
  "industry": "Beverages - Non-Alcoholic",
  "security_type": "Common Stock",
  "employees": 65900,
  "market_cap": 388735324105,
  "shares_total": 4303000000,
  "free_float": 3874015338,
  "float_ratio": 0.9003,
  "short_interest": 44821363,
  "short_float_ratio": 0.0116,
  "days_to_cover": 2.56,
  "insider_ownership": 0.099,
  "institutional_ownership": 0.686,
  "adv_10d": 12690023,
  "adv_90d": 15906204,
  "beta": 0.342,
  "as_of": "2026-08-20T11:56:49.392Z"
}

curl -sS "https://api.tickerlayer.com/fundamentals/stocks?symbols=US:KO,US:SOUN,US:ZZZZ" \
  -H "x-api-key: <YOUR_API_KEY>"

{
  "count": 2,
  "items": [
    { "symbol": "US:KO", "free_float": 3874015338, "shares_total": 4303000000, "...": "..." },
    { "symbol": "US:SOUN", "free_float": 400969014, "shares_total": 411574436, "...": "..." }
  ],
  "missing": ["US:ZZZZ"]
}

curl -sS "https://api.tickerlayer.com/fundamentals/stocks?limit=1000" \
  -H "x-api-key: <YOUR_API_KEY>"

{
  "market": "US",
  "count": 1000,
  "items": [ { "symbol": "US:A", "...": "..." } ],
  "next_cursor": "US:AVGO"
}

Field reference

Identity fields are always present; every other field is optional and omitted when unknown. Ownership fields are fractions between 0 and 1.