Axiora 的很多接口共用一套参数习惯，比如 instrument_id、from、to、date、interval、page_size。先理解这些约定，后面看股票、指数、基金接口会轻松很多。
路径参数与查询参数
GET
/api/v1/markets/{market}/trading-daysList trading days for one market
listTradingDays
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| market | path | MarketId | 是 | — |
| from | query | string (date) | 否 | — |
| to | query | string (date) | 否 | — |
| page[size] | query | integer (default 100) | 否 | — |
- 路径参数通常用来表示资源身份，例如
market、instrument_id、indicator - 查询参数通常用来做过滤、时间范围、返回规模控制
- 同一个字段名在多个 endpoint 上语义保持一致，应优先复用同一套调用方式
时间与日期范围
GET
/api/v1/equities/{instrument_id}/barsList equity bars
listEquityBars
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| instrument_id | path | string | 是 | — |
| interval | query | IntervalId | 是 | — |
| adjustment | query | AdjustmentId | 否 | — |
| from | query | string (date-time) | 否 | — |
| to | query | string (date-time) | 否 | — |
| date | query | string (date) | 否 | — |
| page[size] | query | integer (default 100) | 否 | — |
时间类参数主要分两种：
- 日期：适合交易日、财务期、日级范围
- 日期时间：适合分时、逐笔、技术指标点位等更细粒度的数据
实践上建议：
- 先从短时间窗口开始调试
- 再逐步扩大范围
- 对高频或大规模数据，显式指定
interval、from和to
curlbash
curl "https://heliumlabz.com/api/v1/equities/000001.SZ/bars?interval=1d&from=2026-01-01&to=2026-03-01" \
-H "X-API-Key: $ASHARE_API_KEY"分页与结果规模
很多集合接口会在返回体里带 meta 和 links。这意味着你不应该假设一次请求就能取完所有结果，尤其是在时间序列和列表型接口上。
Meta
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| next_cursor | string | null | 是 | — |
SelfLinks
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| self | string | 是 | — |
推荐做法
把 page_size 当成吞吐和稳定性之间的平衡旋钮，而不是一味拉大。对长区间拉取，建议使用分页或分段时间窗口，避免一次请求承载过多结果。