shares_outstanding
Total shares outstanding.
At a glance
| Type | bigint |
| Group | Fundamentals |
| Category | Share structure & ownership |
| Unit | shares |
| Update cadence | post-close daily |
| Universe | all tickers |
| History | none — live row only, not historized (no as-of reads) |
| Nullable | yes — NULL where not applicable |
How the equity is divided and held: share counts, float and its tags, insider/institutional ownership, ETF holders.
Query it
Every applicable form factor, grouped by endpoint family. Swap YOUR_KEY for the value from /dashboard/keys. Response payloads are real captures, sampled 2026-08-18 and trimmed — your run's values and dates will differ.
Use signals /v2/signals/{signal}
One signal across the market: who matches now, who matched then, and a push when someone starts. Docs →
curl -G "https://api.tickerbot.io/v2/signals/shares_outstanding" \
--data-urlencode "condition=> 1937600000" \
-H "Authorization: Bearer YOUR_KEY"{
"as_of": "2026-08-18T00:25:47.805Z",
"signal": "shares_outstanding",
"condition": "> 1937600000",
"universe": null,
"count": 2,
"results": [
{
"ticker": "NVDA",
"name": "Nvidia Corp",
"value": 24200000000
},
{
"ticker": "ABEV",
"name": "AMBEV S.A.",
"value": 15763664889
}
]
}curl -X POST "https://api.tickerbot.io/v2/signals/shares_outstanding/subscribe" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{"condition": "> 1937600000", "target_url": "https://example.com/hooks/tickerbot"}'Returns 201 with the created webhook — the same shape as GET /v2/webhooks/{id}, plus a one-time signing_secret for HMAC verification.
Use scan /v2/scan
The whole market through a WHERE clause — this signal composed freely with any other column. Docs →
curl -G "https://api.tickerbot.io/v2/scan" \
--data-urlencode "q=shares_outstanding IS NOT NULL" \
-d "order=shares_outstanding" -d "columns=shares_outstanding" \
-H "Authorization: Bearer YOUR_KEY"{
"as_of": "2026-08-18T00:25:48.102Z",
"query": {
"q": "shares_outstanding IS NOT NULL",
"limit": 2,
"order": "shares_outstanding",
"dir": "desc",
"fields": [
"shares_outstanding"
],
"full": false,
"universe": null,
"asset_class": null
},
"count": 2,
"results": [
{
"ticker": "NVDA",
"name": "Nvidia Corp",
"asset_class": "stocks",
"asset_type": "CS",
"price": 225.125,
"day_change_pct": -0.0002,
"gap_pct": 0.0036,
"relative_volume": null,
"market_cap": 5453600360000,
"shares_outstanding": 24200000000
},
{
"ticker": "ABEV",
"name": "AMBEV S.A.",
"asset_class": "stocks",
"asset_type": "ADRC",
"price": 2.776,
"day_change_pct": -0.0086,
"gap_pct": -0.0036,
"relative_volume": null,
"market_cap": 43175995951,
"shares_outstanding": 15763664889
}
]
}curl -X POST "https://api.tickerbot.io/v2/scan/subscribe" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{"q": "shares_outstanding > 1937600000", "target_url": "https://example.com/hooks/tickerbot"}'Returns 201 with the created webhook object; deliveries carry the tickers matching the condition at each evaluation.
Same grammar on scan and webhooks. This column is live-tense only — it isn't historized, so ?asof= reads and series pulls don't carry it.