GICS
GICS (Global Industry Classification Standard) is the sector taxonomy used across MarketDX. Endpoints let you browse the taxonomy, filter stocks by sector, and get sector-level context.
GICS codes are 2-, 4-, 6-, or 8-digit integers:
10— Energy (sector)1010— Energy Equipment & Services (industry group)101010— Oil, Gas & Consumable Fuels (industry)10101010— Integrated Oil & Gas (sub-industry)
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /v1/gics | List GICS nodes |
GET | /v1/gics/:code/stocks | Stocks in a GICS sector/industry |
GET | /v1/gics/:code/context | Sector context rail |
GET | /v1/gics/:code/tree | Hierarchical composition tree |
GET /v1/gics
List GICS taxonomy nodes with optional filters. Returns all nodes if no filters are provided.
| Parameter | Type | Description |
|---|---|---|
level | integer | Filter to nodes at this depth: 1 (sector), 2 (industry group), 3 (industry), 4 (sub-industry). |
sector | string | Filter to nodes under a specific 2-digit sector code (e.g. 10 = Energy, 45 = IT). |
All GICS sectors (tier 1)
GET /v1/gics?level=1
Industry groups within Technology (45)
GET /v1/gics?sector=45&level=2
Common GICS sector codes
| Code | Sector |
|---|---|
10 | Energy |
15 | Materials |
20 | Industrials |
25 | Consumer Discretionary |
30 | Consumer Staples |
35 | Health Care |
40 | Financials |
45 | Information Technology |
50 | Communication Services |
55 | Utilities |
60 | Real Estate |
GET /v1/gics/:code/stocks
Stocks classified under this GICS node. Country is required.
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | ✅ | ISO-2 country code (e.g. US, JP). |
exchange | string | — | Filter to a specific exchange code. |
domicile | string | — | Filter by country of incorporation. |
limit | integer | — | Page size. Default 20. |
offset | integer | — | Pagination offset. |
US semiconductor stocks (GICS 453010)
GET /v1/gics/453010/stocks?country=US
Japanese industrial companies
GET /v1/gics/20/stocks?country=JP&limit=50
GET /v1/gics/:code/context
The sector's context rail — a composed view over all stocks in the GICS node:
- Leaders — top stocks by market cap and recent performance
- In news — most news-impacted stocks
- Cross-asset — related commodities, currencies, and macro indicators
Uses the same shape as /v1/megatrends/:id/context. Cached 6 hours.
GET /v1/gics/45/context
GET /v1/gics/:code/tree
Hierarchical structure tree under this GICS code. Each node carries its aggregated USD market cap and company count. Use this to build composition charts (Sankey, treemap, bubble charts).
Cached 6 hours.
IT sector composition tree
GET /v1/gics/45/tree
Energy sub-industries
GET /v1/gics/10/tree