EN

API 文档

股票数据

股票接口覆盖证券基础信息、行情、K 线、公司资料以及更深层的财务和股东相关数据。

打开 llm.txt

股票是覆盖最完整的数据域。建议把接入分成三层:先接证券主数据,再接行情与 K 线,最后按业务需要接公司资料、财务、股东与资金流等扩展接口。

证券主数据

GET/api/v1/equities

List equities

listEquities

名称位置类型必填说明
marketqueryMarketId
boardqueryBoardId
codequerystring
namequerystring
page[size]queryinteger (default 100)
状态码说明Schema
200Equity collectionInstrumentCollectionResponse
400Invalid request parametersErrorResponse
401UnauthorizedErrorResponse

InstrumentCollectionResponse

字段类型必填说明
dataArray<Instrument>
data[].idstring
data[].codestring
data[].exchangeMarketId
data[].marketstring
data[].asset_classequity | index | fund
data[].boardstring
data[].namestring
metaMeta
meta.next_cursorstring | null
linksSelfLinks
links.selfstring
GET/api/v1/equities/{instrument_id}

Get one equity

getEquity

状态码说明Schema
200Equity resourceInstrumentResponse
401UnauthorizedErrorResponse
404Resource not foundErrorResponse

行情与时间序列

GET/api/v1/equities/{instrument_id}/quotes

List equity quotes

listEquityQuotes

名称位置类型必填说明
instrument_idpathstring
fromquerystring (date-time)
toquerystring (date-time)
datequerystring (date)
page[size]queryinteger (default 100)
状态码说明Schema
200Quote collectionQuoteCollectionResponse
400Invalid request parametersErrorResponse
401UnauthorizedErrorResponse

QuoteCollectionResponse

字段类型必填说明
dataArray<Quote>
data[].instrument_idstring
data[].marketstring
data[].asset_classstring
data[].timestampstring (date-time)
data[].pricestring | null
data[].openstring | null
data[].highstring | null
data[].lowstring | null
data[].previous_closestring | null
data[].amountstring | null
data[].volumestring | null
data[].changestring | null
data[].change_percentstring | null
metaMeta
meta.next_cursorstring | null
linksSelfLinks
links.selfstring
GET/api/v1/equities/{instrument_id}/bars

List equity bars

listEquityBars

名称位置类型必填说明
instrument_idpathstring
intervalqueryIntervalId
adjustmentqueryAdjustmentId
fromquerystring (date-time)
toquerystring (date-time)
datequerystring (date)
page[size]queryinteger (default 100)
状态码说明Schema
200Bar collectionBarCollectionResponse
400Invalid request parametersErrorResponse
401UnauthorizedErrorResponse

BarCollectionResponse

字段类型必填说明
dataArray<Bar>
data[].instrument_idstring
data[].marketstring
data[].asset_classstring
data[].intervalIntervalId
data[].adjustmentAdjustmentId
data[].timestampstring (date-time)
data[].trade_datestring (date)
data[].openstring
data[].highstring
data[].lowstring
data[].closestring
data[].volumestring
data[].amountstring
data[].previous_closestring | null
metaMeta
meta.next_cursorstring | null
linksSelfLinks
links.selfstring
拉取日线 K 线bash
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"

公司与基本面

GET/api/v1/equities/{instrument_id}/company-profile

Get company profile

getCompanyProfile

状态码说明Schema
200Company profile resourceCompanyProfileResponse
401UnauthorizedErrorResponse
404Resource not foundErrorResponse

CompanyProfileResponse

字段类型必填说明
dataCompanyProfile
data.instrument_idstring
data.namestring | null
data.market_namestring | null
data.listed_datestring | null (date)
data.principalstring | null
data.organization_typestring | null
data.phonestring | null
data.emailstring | null
data.ipo_datestring | null (date)
data.previous_closestring | null
data.upper_limit_pricestring | null
data.lower_limit_pricestring | null
data.face_valuestring | null
data.total_valuestring | null
data.price_tickstring | null
data.is_suspendedboolean | null
linksSelfLinks
links.selfstring
GET/api/v1/equities/{instrument_id}/financial-statements/balance-sheets

List balance sheets

listBalanceSheets

状态码说明Schema
200Balance sheet collectionBalanceSheetCollectionResponse
400Invalid request parametersErrorResponse
401UnauthorizedErrorResponse
GET/api/v1/equities/{instrument_id}/financial-indicators

List financial indicators

listFinancialIndicators

状态码说明Schema
200Financial indicator collectionFinancialIndicatorCollectionResponse
400Invalid request parametersErrorResponse
401UnauthorizedErrorResponse

扩展覆盖

除上面的核心接口外,股票数据域还覆盖:

  • 逐笔成交:listEquityTrades
  • 技术指标:listEquityTechnicalIndicators
  • 资金流:listCapitalFlows
  • 涨跌停:listPriceLimits
  • 分红与盈利预测:listDividendslistEarningsForecasts
  • 管理层、股本、股东、机构持仓:相关 history / shareholders / holdings 接口
  • 股票池与成分:listPoolTypeslistPoolConstituents

接入建议

如果你的场景是行情页、选股页或回测,通常先接 listEquities + listEquityQuotes + listEquityBars 就足够起步。只有在需要公司画像或财务分析时,再逐步引入公司资料和基本面接口。