股票数据

股票数据模块的方法返回 pandas DataFrame，方便进行数据分析。

公司信息

overview()

获取公司概览信息。返回结构为 {"items": [company, ...]}，每个 company 下有 stockList 数组。

# 通过股票代码查询（支持多个，逗号分隔）
result = client.stock.overview(symbols="AAPL,00700")
companies = result.get("items", [result]) if isinstance(result, dict) else result
for company in companies:
    for stock in company.get("stockList", []):
        print(stock["symbol"], stock.get("stock_name"), stock.get("ipo_date"))

# 通过股票名称查询
result = client.stock.overview(names="腾讯,苹果")

symbols

string

股票代码（不含市场前缀），支持多个用逗号分隔，如 AAPL,00700。与 names 至少提供一个

names

string

股票名称，支持多个用逗号分隔，如 腾讯,苹果

返回值

dict

{"items": [...]} 结构。每个 item 包含 country、city、fiscal_year_end、stockList 等字段；stockList 是股票列表，每项含 symbol、stock_name、market、ipo_date、industry_HS_1 等

批量查询 IPO 日期、市值等量化字段时，建议用 client.quant.factors_compute(formula="LISTING_DATE") 或 "CIRCULATING_MARKET_CAP"，单次调用即可处理全市场，比循环调用 overview 快得多。

shareholders()

获取主要股东列表。

shareholders = client.stock.shareholders("AAPL")
for holder in shareholders:
    print(holder["name"], holder["percent"])

# 获取流通股东
outstanding = client.stock.shareholders("AAPL", type="outstanding_shareholders", limit=20)

symbol

string

required

股票代码

type

string

default:"shareholders"

股东类型：shareholders（全部股东）或 outstanding_shareholders（流通股东）

limit

integer

default:"10"

返回股东数量上限

返回值

list[dict]

股东列表，包含 name, holdings, percent, date 等

财务报表

income_statement()

获取利润表数据。

income = client.stock.income_statement(
    symbol="AAPL",
    period="quarterly",
    limit=8
)
print(income[["revenue", "net_income", "eps"]].head())

symbol

string

required

股票代码

period

string

default:"annual"

报告期间：annual（年报）或 quarterly（季报）

limit

int

default:"8"

返回期数

start_date

str

开始日期，格式：YYYY-MM-DD

end_date

str

结束日期，格式：YYYY-MM-DD

calendar

str

default:"fiscal"

日历类型：calendar（公历）或 fiscal（财年）

fiscal_year

str

指定财年，如 2023

fiscal_quarter

str

指定财季（Q1, Q2, Q3, Q4, FY, H1, Q3 (9 months)）

返回值

DataFrame

利润表数据，以日期为索引，包含 revenue, gross_profit, operating_income, net_income, eps 等列

balance_sheet()

获取资产负债表数据。

balance = client.stock.balance_sheet("AAPL", period="annual")
print(balance[["total_assets", "total_liabilities", "total_equity"]].head())

symbol

string

required

股票代码

period

string

default:"annual"

报告期间：annual 或 quarterly

limit

int

default:"8"

返回期数

start_date

str

开始日期，格式：YYYY-MM-DD

end_date

str

结束日期，格式：YYYY-MM-DD

calendar

str

default:"fiscal"

日历类型：calendar（公历）或 fiscal（财年）

fiscal_year

str

指定财年，如 2023

fiscal_quarter

str

指定财季（Q1, Q2, Q3, Q4, FY）

返回值

DataFrame

资产负债表数据

cashflow_statement()

获取现金流量表数据。

cashflow = client.stock.cashflow_statement("AAPL")
print(cashflow[["operating_cashflow", "investing_cashflow", "financing_cashflow"]].head())

symbol

string

required

股票代码

period

string

default:"annual"

报告期间：annual、quarterly 或 cumulative quarterly

limit

int

default:"8"

返回期数

start_date

str

开始日期，格式：YYYY-MM-DD

end_date

str

结束日期，格式：YYYY-MM-DD

calendar

str

default:"fiscal"

日历类型：calendar（公历）或 fiscal（财年）

fiscal_year

str

指定财年，如 2023

fiscal_quarter

str

指定财季（Q1, Q2, Q3, Q4, FY, H1, Q3 (9 months)）

返回值

DataFrame

现金流量表数据

revenue_breakdown()

获取营收分解数据。

breakdown = client.stock.revenue_breakdown("AAPL", limit=6)
print(breakdown)

symbol

string

required

股票代码

period

str

报告周期，如 FY（全年）、Q2（二季度）

limit

int

default:"6"

返回记录数

start_date

str

开始日期，格式：YYYY-MM-DD

end_date

str

结束日期，格式：YYYY-MM-DD

fiscal_year

str

指定财年，如 2023

返回值

DataFrame

营收分解数据

行情数据

quote()

获取股票行情数据（当前和历史价格）。

quote = client.stock.quote(
    symbol="AAPL",
    start_date="2024-01-01",
    end_date="2024-06-30"
)
print(quote[["close", "volume", "market_cap"]].tail())

symbol

string

required

股票代码

start_date

str

开始日期，格式：YYYY-MM-DD

end_date

str

结束日期，格式：YYYY-MM-DD

返回值

DataFrame

股票行情数据，包含 close, volume, market_cap, pe, ps 等

index_quote()

获取指数行情数据。

# 获取恒生指数行情
index = client.stock.index_quote(
    symbol="HSI",
    start_date="2024-01-01",
    end_date="2024-06-30"
)
print(index[["stock_price", "stock_change_percent"]].tail())

# 获取标普500指数
spx = client.stock.index_quote("SPX")

symbol

string

required

指数代码，如 HSI（恒生指数）, SPX（标普500）, DJI（道琼斯）

start_date

str

开始日期，格式：YYYY-MM-DD

end_date

str

结束日期，格式：YYYY-MM-DD

返回值

DataFrame

指数行情数据

指数和行业

index_constituents()

获取指数成分股列表。

# 获取沪深300指数成分股
csi300 = client.stock.index_constituents("000300")
print(csi300[["market", "symbol"]])

# 获取创业板指数成分股
chinext = client.stock.index_constituents("399006")

symbol

string

required

指数代码，如 000300（沪深300）, 000016（上证50）, 399006（创业板指）

返回值

DataFrame

成分股列表，包含 market, symbol 等

index_tracking_funds()

获取指数跟踪基金列表。

# 获取沪深300指数跟踪基金
funds = client.stock.index_tracking_funds("000300")
print(funds[["symbol", "short_name", "name"]])

# 获取中证500指数跟踪基金
funds = client.stock.index_tracking_funds("000905")

symbol

string

required

指数代码，如 000300（沪深300）, 000016（上证50）, 000905（中证500）

返回值

DataFrame

跟踪基金列表，包含 symbol, short_name, name 等

industry_constituents()

获取行业成分股列表。

# 获取中国军工行业成分股
stocks = client.stock.industry_constituents("cn", "军工")
print(stocks[["symbol", "name", "industry_one_level_name"]])

# 使用特定分类标准
stocks = client.stock.industry_constituents("cn", "军工", type="sw")

market

string

required

股票市场：cn（中国）, hk（香港）, us（美国）

name

string

required

行业名称，如 军工, Technology

type

string

行业分类类型：

CN: sw（申万，默认）, wind
HK: hs（恒生，默认）
US: GICS（默认）

返回值

DataFrame

成分股列表，包含 symbol, name, industry_one_level_name, industry_second_level_name, industry_third_level_name 等

日历

earnings_calendar()

财报日历。

calendar = client.stock.earnings_calendar(
    market="us",
    start_date="2024-01-01",
    end_date="2024-01-31"
)

market

string

required

股票市场：cn, hk, us

start_date

str

开始日期

end_date

str

结束日期

symbol

str

指定股票代码

ipo_calendar_hk()

港股 IPO 日历。

ipos = client.stock.ipo_calendar_hk(status="Filing")

status

string

default:"Filing"

IPO 状态：Filing（申报）, Hearing（聆讯）, Priced（定价）

ipo_calendar_cn()

A 股（沪深北）IPO 日历。所有参数均为可选，不传则返回全部。

ipos = client.stock.ipo_calendar_cn(
    market="SH",
    start_date="2026-01-01",
    end_date="2026-06-20",
    status="listed"
)

market

string

股票市场：SH（沪市）, SZ（深市）, BJ（北交所）。默认全部

start_date

str

开始日期（YYYY-MM-DD）

end_date

str

结束日期（YYYY-MM-DD）

status

string

IPO 状态：listed（已上市）, delisted（已退市）, currently_issuing（发行中）, deferred_issuance（暂缓发行）, issuance_complete（发行完成）。默认全部

使用说明

文档接口

量化分析

智能体

MCP

SDK

股票数据

公司信息

overview()

shareholders()

财务报表

income_statement()

balance_sheet()

cashflow_statement()

revenue_breakdown()

行情数据

quote()

index_quote()

指数和行业

index_constituents()

index_tracking_funds()

industry_constituents()

日历

earnings_calendar()

ipo_calendar_hk()

ipo_calendar_cn()

​公司信息

​overview()

​shareholders()

​财务报表

​income_statement()

​balance_sheet()

​cashflow_statement()

​revenue_breakdown()

​行情数据

​quote()

​index_quote()

​指数和行业

​index_constituents()

​index_tracking_funds()

​industry_constituents()

​日历

​earnings_calendar()

​ipo_calendar_hk()

​ipo_calendar_cn()

公司信息

overview()

shareholders()

财务报表

income_statement()

balance_sheet()

cashflow_statement()

revenue_breakdown()

行情数据

quote()

index_quote()

指数和行业

index_constituents()

index_tracking_funds()

industry_constituents()

日历

earnings_calendar()

ipo_calendar_hk()

ipo_calendar_cn()