View as markdown
Endpoints · Tickers

ETF sector breakdown

GEThttps://api.tickerbot.io/v2/tickers/{ticker}/sectors

Returns an ETF's sector weights, heaviest first — always complete, since sector breakdowns are small.

Query parameters

stringrequired

ETF symbol. Case-insensitive.

Returns

as_ofstring

Server time this response was assembled (ISO 8601).

tickerstring

The ETF you asked for.

is_etfboolean

Whether the symbol is an ETF, from the instrument type on its ticker record.

countnumber

Sectors returned.

sectorsarray

Sector weights, heaviest first, in the vendor's ETF-profile vocabulary.

Status codes

200
Success — the response shape is documented under Returns above.
400
Invalid ticker (malformed symbol).
404
not_found — the symbol is not in the tracked universe. A tracked non-ETF answers 200 with is_etf: false instead.

Notes

  • is_etf reports whether the symbol is an ETF, from the instrument type on its ticker record. For a non-ETF it is false and sectors is empty; is_etf: true with count: 0 means a real ETF whose sector data has not been ingested yet.
  • These sector NAMES are the vendor's ETF-profile vocabulary (INFORMATION TECHNOLOGY, CONSUMER DISCRETIONARY, MATERIALS), NOT the values the sector column carries on a ticker row (Technology, Consumer Cyclical, Basic Materials). The two taxonomies line up conceptually but not as strings, so passing a value from here into ?sector= on All symbols — or into a q= filter — matches nothing and returns an empty result rather than an error.
  • Sector data comes from a nightly post-close vendor refresh (AlphaVantage ETF profiles) — expect it to be up to a day behind.