Theia Insights

Given a company, return its exposure across every TIIC entry at one specific level. Input: a Theia `company_id` (resolve via `search` or `lookup_company` first) and the TIIC level (1 = sector, 2 = industry, 3 = sub-industry, 4 = major theme, 5 = micro theme). Returns a flat list of exposures, sorted descending. For a hierarchical sector → industry → sub-industry → major-theme breakdown (rendered as a nested donut), use `get_company_tiic_hierarchy` instead. For the reverse direction — companies exposed to a given theme/sector/industry — use `get_tiic_item_exposed_companies` instead.

get_company_tiic_exposures

Fetch a single item from the Theia Insights Industry Classification (TIIC) taxonomy by its level and ID.

get_tiic_item

List every entry in the Theia Insights Industry Classification (TIIC) taxonomy at a given level. Levels: 1 = sector, 2 = industry, 3 = sub-industry, 4 = major theme, 5 = micro theme. Use this to explore what's available at a given level of granularity.

get_tiic_taxonomy

Fetch a Theme Watch Index (TWI) time series for a major theme (TIIC level 4 only — not available for other levels), region, and time period. Returns `daily_returns` and a `cumulative_returns` convenience series. When the default index is appropriate, pass `index: 'investment'`. If the caller wants returns over a window not provided, cumulate the daily returns yourself.

get_twi_index_values

Same data as `get_twi_rankings` (top N + bottom N themes by TWI return at a single point in time), rendered as a divergent horizontal bar chart — winners as positive bars to the right, losers as negative bars to the left, on a shared focal-period axis. Pick this when the user explicitly asks for a chart, visualisation, or bar plot of theme performance. For a tabular ranked list, use `get_twi_rankings`.

get_twi_rankings_chart

Rank Theia Insights major themes (TIIC level 4 only) by Theme Watch Index (TWI) returns over a time period. Returns BOTH the top N and bottom N performers in one call, each with return summaries across all standard time periods. Default index is 'investment'. Good for 'which themes performed best/worst this year' questions — don't call this twice for top and bottom; a single call returns both. Renders as two stacked ranked tables (Top N, Bottom N). For a divergent bar chart visualisation of the same data, use `get_twi_rankings_chart` instead.

get_twi_rankings

Fetch a company by its Theia company ID.

get_company

Given a company, return its TIIC exposures rolled up across four levels: sector → industry → sub-industry → major theme. Each non-leaf node's exposure is the sum of its children's, so the breakdown is self-consistent at every level. Renders as a nested-donut visualisation (one ring per level). Pick this when the user asks for an exposure breakdown, classification map, or visual decomposition of what a company does. For a flat single-level listing, use `get_company_tiic_exposures` instead.

get_company_tiic_hierarchy

List the available regions for Theme Watch Indices (TWI) queries — e.g. 'US', 'Global', 'AMER', 'APAC'.

get_twi_regions

List the available time periods for Theme Watch Indices (TWI) queries — e.g. '1M', '3M', '6M', 'YTD', '1Y', '5Y', '10Y'.

get_twi_time_periods