These endpoints provide the dictionaries and filter dimensions that the rest of the platform depends on. They are usually the first supporting APIs you integrate before building instrument search or market-aware UX.
Market basics
GET
/api/v1/marketsList supported markets
listMarkets
This endpoint does not define request parameters.
| Status | Description | Schema |
|---|---|---|
| 200 | Market collection | MarketCollectionResponse |
| 401 | Unauthorized | ErrorResponse |
MarketCollectionResponse
| Field | Type | Required | Description |
|---|---|---|---|
| data | Array<Market> | Yes | — |
| data[].id | MarketId | Yes | — |
| data[].name | string | Yes | — |
| meta | Meta | Yes | — |
| meta.next_cursor | string | null | Yes | — |
| links | SelfLinks | Yes | — |
| links.self | string | Yes | — |
GET
/api/v1/markets/{market}Get one market
getMarket
| Status | Description | Schema |
|---|---|---|
| 200 | Market resource | MarketResponse |
| 401 | Unauthorized | ErrorResponse |
| 404 | Resource not found | ErrorResponse |
Trading calendar
GET
/api/v1/markets/{market}/trading-daysList trading days for one market
listTradingDays
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| market | path | MarketId | Yes | — |
| from | query | string (date) | No | — |
| to | query | string (date) | No | — |
| page[size] | query | integer (default 100) | No | — |
| Status | Description | Schema |
|---|---|---|
| 200 | Trading day collection | TradingDayCollectionResponse |
| 400 | Invalid request parameters | ErrorResponse |
| 401 | Unauthorized | ErrorResponse |
| 404 | Resource not found | ErrorResponse |
TradingDayCollectionResponse
| Field | Type | Required | Description |
|---|---|---|---|
| data | Array<TradingDay> | Yes | — |
| data[].market | MarketId | Yes | — |
| data[].date | string (date) | Yes | — |
| meta | Meta | Yes | — |
| meta.next_cursor | string | null | Yes | — |
| links | SelfLinks | Yes | — |
| links.self | string | Yes | — |
Typical uses:
- validate a requested date before querying market data
- power trading-day pickers in UI
- avoid calling time-series endpoints on closed-market dates
Sector and industry classifications
GET
/api/v1/classifications/sectorsList sector classifications
listSectors
| Status | Description | Schema |
|---|---|---|
| 200 | Sector collection | ClassificationCollectionResponse |
| 401 | Unauthorized | ErrorResponse |
GET
/api/v1/classifications/primary-industriesList primary industries
listPrimaryIndustries
| Status | Description | Schema |
|---|---|---|
| 200 | Primary industry collection | ClassificationCollectionResponse |
| 401 | Unauthorized | ErrorResponse |
ClassificationCollectionResponse
| Field | Type | Required | Description |
|---|---|---|---|
| data | Array<Classification> | Yes | — |
| data[].id | string | Yes | — |
| data[].name | string | Yes | — |
| data[].type | string | Yes | — |
| meta | Meta | Yes | — |
| meta.next_cursor | string | null | Yes | — |
| links | SelfLinks | Yes | — |
| links.self | string | Yes | — |
Initialize sector filtersbash
curl https://heliumlabz.com/api/v1/classifications/sectors \
-H "X-API-Key: $ASHARE_API_KEY"