etf_ holders
ETFs that hold this ticker, ordered by the ticker's weight within each (the reverse of ETF holdings). Filter with array operators in /v2/scan, e.g. 'SPY' = ANY(etf_holders) to find SPY constituents. Refreshed nightly post-close.
Facts
A string[] signal: screen on it with = ANY(…) or cardinality(…) (cardinality(etf_holders) > 100). It's null on tickers it doesn't apply to.
| type | string[] |
| refresh | post-close daily · 7:45 PM ET |
| asset classes | US equities |
| coverage | all tickers |
| history | live value only |
| nullable | yes |
Examples
Screen on it
curl -X POST "https://api.tickerbot.io/v2/scan" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{
"q": "cardinality(etf_holders) > 100"
}'Get an alert when a ticker starts matching
curl -X POST "https://api.tickerbot.io/v2/scan/subscribe" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{
"q": "cardinality(etf_holders) > 100",
"target_url": "https://example.com/hooks/tickerbot"
}'Returns 201 with the created webhook object; deliveries carry the tickers matching the condition at each evaluation.