Skip to main content
Glama
xiaozhozho

akshare-mcp

by xiaozhozho
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

akshare_futures

Access Chinese and global futures data including real-time quotes, historical prices, contract specs, inventory, basis, and analytics from major exchanges.

Instructions

Chinese and global futures data: real-time/minute/daily quotes from major exchanges (SHFE, DCE, CZCE, CFFEX, GFEX, INE, COMEX), contract specifications and trading hours, warehousing/inventory data, basis and spread analysis, settlement prices, margin rates, open interest, COT reports, and professional analytics (qhkc series).

Available Methods

  • futures_comex_inventory(symbol='黄金') 东方财富网-数据中心-期货期权-COMEX库存数据

  • futures_comm_info(symbol='所有') 九期网-期货手续费

  • futures_comm_js(date='20260213') 金十财经-期货手续费

  • futures_contract_detail(symbol='AP2101') 查询期货合约详情

  • futures_contract_detail_em(symbol='v2602F') 查询期货合约详情

  • futures_contract_info_cffex(date='20240228') 中国金融期货交易所-数据-交易参数

  • futures_contract_info_czce(date='20240228') 郑州商品交易所-交易数据-参考数据

  • futures_contract_info_dce() 大连商品交易所-数据中心-业务数据-交易参数-合约信息

  • futures_contract_info_gfex() 广州期货交易所-业务/服务-合约信息

  • futures_contract_info_ine(date='20241129') 上海国际能源交易中心-业务指南-交易参数汇总(期货)

  • futures_contract_info_shfe(date='20240513') 上海期货交易所-交易所服务-业务数据-交易参数汇总查询

  • futures_dce_position_rank(date='20160919', vars_list=['IF', 'IC', 'IM', 'IH', 'T', 'TF', 'TS', 'TL', 'C', 'CS', 'A', 'B', 'M', 'Y', 'P', 'FB', 'BB', 'JD', 'L', 'V', 'PP', 'J', 'JM', 'I', 'EG', 'RR', 'EB', 'PG', 'LH', 'LG', 'BZ', 'WH', 'PM', 'CF', 'SR', 'TA', 'OI', 'RI', 'MA', 'ME', 'FG', 'RS', 'RM', 'ZC', 'JR', 'LR', 'SF', 'SM', 'WT', 'TC', 'GN', 'RO', 'ER', 'SRX', 'SRY', 'WSX', 'WSY', 'CY', 'AP', 'UR', 'CJ', 'SA', 'PK', 'PF', 'PX', 'SH', 'PR', 'PL', 'CU', 'AL', 'ZN', 'PB', 'NI', 'SN', 'AU', 'AG', 'RB', 'WR', 'HC', 'FU', 'BU', 'RU', 'SC', 'NR', 'SP', 'SS', 'LU', 'BC', 'AO', 'BR', 'EC', 'AD', 'OP', 'SI', 'LC', 'PS']) 大连商品交易所-每日持仓排名-具体合约

  • futures_dce_position_rank_other(date='20160104') 大连商品交易所-每日持仓排名-具体合约-补充

  • futures_delivery_czce(date='20210112') 郑州商品交易所-月度交割查询

  • futures_delivery_dce(date='202312') 大连商品交易所-交割统计

  • futures_delivery_match_czce(date='20210106') 郑州商品交易所-交割配对

  • futures_delivery_match_dce(symbol='a') 大连商品交易所-交割配对表

  • futures_delivery_shfe(date='202312') 上海期货交易所-交割情况表

  • futures_display_main_sina() 新浪主力连续合约品种一览表

  • futures_fees_info() openctp 期货交易费用参照表

  • futures_foreign_commodity_realtime(symbol) 新浪-外盘期货-行情数据

  • futures_foreign_commodity_subscribe_exchange_symbol() 需要订阅的行情的代码

  • futures_foreign_detail(symbol='ZSD') foreign futures contract detail data

  • futures_foreign_hist(symbol='ZSD') 外盘期货-历史行情数据-日频率

  • futures_gfex_position_rank(date='20231113', vars_list=None) 广州期货交易所-日成交持仓排名

  • futures_gfex_warehouse_receipt(date='20240122') 广州期货交易所-行情数据-仓单日报

  • futures_global_hist_em(symbol='HG00Y') 东方财富网-行情中心-期货市场-国际期货-历史行情数据

  • futures_global_spot_em() 东方财富网-行情中心-期货市场-国际期货

  • futures_hist_daily_cffex(date='20260403') 中国金融期货交易所-交易所日交易数据

  • futures_hist_em(symbol='热卷主连', period='daily', start_date='19900101', end_date='20500101') 东方财富网-期货行情-行情数据

  • futures_hist_table_em() 东方财富网-期货行情-交易所品种对照表

  • futures_hog_core(symbol='外三元') 玄田数据-核心数据

  • futures_hog_cost(symbol='玉米') 玄田数据-成本维度

  • futures_hog_supply(symbol='猪肉批发价') 玄田数据-供应维度

  • futures_hold_pos_sina(symbol='成交量', contract='OI2501', date='20240223') 新浪财经-期货-成交持仓

  • futures_hq_subscribe_exchange_symbol() 将品种字典转化为 pandas.DataFrame

  • futures_index_ccidx(symbol='中证商品期货指数') 中证商品指数-商品指数-日频率

  • futures_inventory_99(symbol='豆一') 99 期货网-大宗商品库存数据

  • futures_inventory_em(symbol='a') 东方财富网-数据中心-期货库存数据

  • futures_main_sina(symbol='V0', start_date='19900101', end_date='22220101') 新浪财经-期货-主力连续日数据

  • futures_news_shmet(symbol='全部') 上海金属网-快讯

  • futures_rule(date='20231205') 国泰君安期货-交易日历数据表

  • futures_settle(date='20260119', market='CFFEX') 期货交易所结算参数

  • futures_settle_cffex(date='20260119') 中国金融期货交易所-结算参数

  • futures_settle_czce(date='20260119') 郑州商品交易所-结算参数

  • futures_settle_gfex(date='20260119') 广州期货交易所-结算参数

  • futures_settle_ine(date='20260119') 上海国际能源交易中心-结算参数

  • futures_settle_shfe(date='20260119') 上海期货交易所-结算参数

  • futures_settlement_price_sgx(date='20231107') 新加坡交易所-衍生品-历史数据-历史结算价格

  • futures_shfe_warehouse_receipt(date='20200702') 上海期货交易所指定交割仓库期货仓单日报

  • futures_spot_price(date='20240430', vars_list=['IF', 'IC', 'IM', 'IH', 'T', 'TF', 'TS', 'TL', 'C', 'CS', 'A', 'B', 'M', 'Y', 'P', 'FB', 'BB', 'JD', 'L', 'V', 'PP', 'J', 'JM', 'I', 'EG', 'RR', 'EB', 'PG', 'LH', 'LG', 'BZ', 'WH', 'PM', 'CF', 'SR', 'TA', 'OI', 'RI', 'MA', 'ME', 'FG', 'RS', 'RM', 'ZC', 'JR', 'LR', 'SF', 'SM', 'WT', 'TC', 'GN', 'RO', 'ER', 'SRX', 'SRY', 'WSX', 'WSY', 'CY', 'AP', 'UR', 'CJ', 'SA', 'PK', 'PF', 'PX', 'SH', 'PR', 'PL', 'CU', 'AL', 'ZN', 'PB', 'NI', 'SN', 'AU', 'AG', 'RB', 'WR', 'HC', 'FU', 'BU', 'RU', 'SC', 'NR', 'SP', 'SS', 'LU', 'BC', 'AO', 'BR', 'EC', 'AD', 'OP', 'SI', 'LC', 'PS']) 指定交易日大宗商品现货价格及相应基差

  • futures_spot_price_daily(start_day='20210201', end_day='20210208', vars_list=['IF', 'IC', 'IM', 'IH', 'T', 'TF', 'TS', 'TL', 'C', 'CS', 'A', 'B', 'M', 'Y', 'P', 'FB', 'BB', 'JD', 'L', 'V', 'PP', 'J', 'JM', 'I', 'EG', 'RR', 'EB', 'PG', 'LH', 'LG', 'BZ', 'WH', 'PM', 'CF', 'SR', 'TA', 'OI', 'RI', 'MA', 'ME', 'FG', 'RS', 'RM', 'ZC', 'JR', 'LR', 'SF', 'SM', 'WT', 'TC', 'GN', 'RO', 'ER', 'SRX', 'SRY', 'WSX', 'WSY', 'CY', 'AP', 'UR', 'CJ', 'SA', 'PK', 'PF', 'PX', 'SH', 'PR', 'PL', 'CU', 'AL', 'ZN', 'PB', 'NI', 'SN', 'AU', 'AG', 'RB', 'WR', 'HC', 'FU', 'BU', 'RU', 'SC', 'NR', 'SP', 'SS', 'LU', 'BC', 'AO', 'BR', 'EC', 'AD', 'OP', 'SI', 'LC', 'PS']) 指定时间段内大宗商品现货价格及相应基差

  • futures_spot_price_previous(date='20240430') 具体交易日大宗商品现货价格及相应基差

  • futures_spot_stock(symbol='能源') 东方财富网-数据中心-现货与股票

  • futures_spot_sys(symbol='铜', indicator='市场价格') 生意社-商品与期货-现期图

  • futures_stock_shfe_js(date='20240419') 金十财经-上海期货交易所指定交割仓库库存周报

  • futures_symbol_mark() 期货的品种和代码映射

  • futures_to_spot_czce(date='20231228') 郑州商品交易所-期转现统计

  • futures_to_spot_dce(date='202312') 大连商品交易所-期转现

  • futures_to_spot_shfe(date='202312') 上海期货交易所-期转现

  • futures_warehouse_receipt_czce(date='20251103') 郑州商品交易所-交易数据-仓单日报

  • futures_warehouse_receipt_dce(date='20251027') 大连商品交易所-行情数据-统计数据-日统计-仓单日报

  • futures_zh_daily_sina(symbol='RB0') 中国各品种期货日频率数据

  • futures_zh_minute_sina(symbol='IF2008', period='1') 中国各品种期货分钟频率数据

  • futures_zh_realtime(symbol='PTA') 期货品种当前时刻所有可交易的合约实时数据

  • futures_zh_spot(symbol='V2309', market='CF', adjust='0') 期货的实时行情数据

  • get_cffex_daily(date='20100416') 中国金融期货交易所-日频率交易数据

  • get_cffex_rank_table(date='20190805', vars_list=['IF', 'IC', 'IM', 'IH', 'T', 'TF', 'TS', 'TL', 'C', 'CS', 'A', 'B', 'M', 'Y', 'P', 'FB', 'BB', 'JD', 'L', 'V', 'PP', 'J', 'JM', 'I', 'EG', 'RR', 'EB', 'PG', 'LH', 'LG', 'BZ', 'WH', 'PM', 'CF', 'SR', 'TA', 'OI', 'RI', 'MA', 'ME', 'FG', 'RS', 'RM', 'ZC', 'JR', 'LR', 'SF', 'SM', 'WT', 'TC', 'GN', 'RO', 'ER', 'SRX', 'SRY', 'WSX', 'WSY', 'CY', 'AP', 'UR', 'CJ', 'SA', 'PK', 'PF', 'PX', 'SH', 'PR', 'PL', 'CU', 'AL', 'ZN', 'PB', 'NI', 'SN', 'AU', 'AG', 'RB', 'WR', 'HC', 'FU', 'BU', 'RU', 'SC', 'NR', 'SP', 'SS', 'LU', 'BC', 'AO', 'BR', 'EC', 'AD', 'OP', 'SI', 'LC', 'PS']) 中国金融期货交易所前 20 会员持仓排名数据明细

  • get_czce_daily(date='20050525') 郑州商品交易所-日频率-量价数据

  • get_dce_daily(date='20251027') 大连商品交易所日交易数据

  • get_dce_rank_table(date='20230706', vars_list=['IF', 'IC', 'IM', 'IH', 'T', 'TF', 'TS', 'TL', 'C', 'CS', 'A', 'B', 'M', 'Y', 'P', 'FB', 'BB', 'JD', 'L', 'V', 'PP', 'J', 'JM', 'I', 'EG', 'RR', 'EB', 'PG', 'LH', 'LG', 'BZ', 'WH', 'PM', 'CF', 'SR', 'TA', 'OI', 'RI', 'MA', 'ME', 'FG', 'RS', 'RM', 'ZC', 'JR', 'LR', 'SF', 'SM', 'WT', 'TC', 'GN', 'RO', 'ER', 'SRX', 'SRY', 'WSX', 'WSY', 'CY', 'AP', 'UR', 'CJ', 'SA', 'PK', 'PF', 'PX', 'SH', 'PR', 'PL', 'CU', 'AL', 'ZN', 'PB', 'NI', 'SN', 'AU', 'AG', 'RB', 'WR', 'HC', 'FU', 'BU', 'RU', 'SC', 'NR', 'SP', 'SS', 'LU', 'BC', 'AO', 'BR', 'EC', 'AD', 'OP', 'SI', 'LC', 'PS']) 大连商品交易所前 20 会员持仓排名数据明细, 由于交易所网站问题, 需要 20200720 之后才有数据

  • get_futures_daily(start_date='20220208', end_date='20220208', market='CFFEX') 交易所日交易数据

  • get_gfex_daily(date='20221223') 广州期货交易所-日频率-量价数据

  • get_ine_daily(date='20241129') 上海国际能源交易中心-日频率-量价数据

  • get_qhkc_fund_bs(date='20190924', url='https://qhkch.com/ajax/fund_bs_pie.php') 奇货可查-资金-净持仓分布

  • get_qhkc_fund_money_change(date='20190924', url='https://qhkch.com/ajax/fund_deal_pie.php') 奇货可查-资金-成交额分布

  • get_qhkc_fund_position(date='20190924', url='https://qhkch.com/ajax/fund_position_pie.php') 奇货可查-资金-总持仓分布

  • get_qhkc_index(name='奇货商品', url='https://www.qhkch.com/ajax/index_show.php') 奇货可查-指数-指数详情

  • get_qhkc_index_profit_loss(name='奇货商品', url='https://qhkch.com/ajax/indexes_profit_loss.php', start_date='', end_date='') 奇货可查-指数-盈亏详情

  • get_qhkc_index_trend(name='奇货商品', url='https://qhkch.com/ajax/indexes_trend.php') 奇货可查-指数-大资金动向

  • get_rank_sum(date='20210525', vars_list=['IF', 'IC', 'IM', 'IH', 'T', 'TF', 'TS', 'TL', 'C', 'CS', 'A', 'B', 'M', 'Y', 'P', 'FB', 'BB', 'JD', 'L', 'V', 'PP', 'J', 'JM', 'I', 'EG', 'RR', 'EB', 'PG', 'LH', 'LG', 'BZ', 'WH', 'PM', 'CF', 'SR', 'TA', 'OI', 'RI', 'MA', 'ME', 'FG', 'RS', 'RM', 'ZC', 'JR', 'LR', 'SF', 'SM', 'WT', 'TC', 'GN', 'RO', 'ER', 'SRX', 'SRY', 'WSX', 'WSY', 'CY', 'AP', 'UR', 'CJ', 'SA', 'PK', 'PF', 'PX', 'SH', 'PR', 'PL', 'CU', 'AL', 'ZN', 'PB', 'NI', 'SN', 'AU', 'AG', 'RB', 'WR', 'HC', 'FU', 'BU', 'RU', 'SC', 'NR', 'SP', 'SS', 'LU', 'BC', 'AO', 'BR', 'EC', 'AD', 'OP', 'SI', 'LC', 'PS']) 采集五个期货交易所前5、前10、前15、前20会员持仓排名数据

  • get_rank_sum_daily(start_day='20210510', end_day='20210510', vars_list=['IF', 'IC', 'IM', 'IH', 'T', 'TF', 'TS', 'TL', 'C', 'CS', 'A', 'B', 'M', 'Y', 'P', 'FB', 'BB', 'JD', 'L', 'V', 'PP', 'J', 'JM', 'I', 'EG', 'RR', 'EB', 'PG', 'LH', 'LG', 'BZ', 'WH', 'PM', 'CF', 'SR', 'TA', 'OI', 'RI', 'MA', 'ME', 'FG', 'RS', 'RM', 'ZC', 'JR', 'LR', 'SF', 'SM', 'WT', 'TC', 'GN', 'RO', 'ER', 'SRX', 'SRY', 'WSX', 'WSY', 'CY', 'AP', 'UR', 'CJ', 'SA', 'PK', 'PF', 'PX', 'SH', 'PR', 'PL', 'CU', 'AL', 'ZN', 'PB', 'NI', 'SN', 'AU', 'AG', 'RB', 'WR', 'HC', 'FU', 'BU', 'RU', 'SC', 'NR', 'SP', 'SS', 'LU', 'BC', 'AO', 'BR', 'EC', 'AD', 'OP', 'SI', 'LC', 'PS']) 采集四个期货交易所前 5、前 10、前 15、前 20 会员持仓排名数据

  • get_rank_table_czce(date='20251103') 郑州商品交易所前 20 会员持仓排名数据明细

  • get_receipt(start_date=None, end_date=None, vars_list=['IF', 'IC', 'IM', 'IH', 'T', 'TF', 'TS', 'TL', 'C', 'CS', 'A', 'B', 'M', 'Y', 'P', 'FB', 'BB', 'JD', 'L', 'V', 'PP', 'J', 'JM', 'I', 'EG', 'RR', 'EB', 'PG', 'LH', 'LG', 'BZ', 'WH', 'PM', 'CF', 'SR', 'TA', 'OI', 'RI', 'MA', 'ME', 'FG', 'RS', 'RM', 'ZC', 'JR', 'LR', 'SF', 'SM', 'WT', 'TC', 'GN', 'RO', 'ER', 'SRX', 'SRY', 'WSX', 'WSY', 'CY', 'AP', 'UR', 'CJ', 'SA', 'PK', 'PF', 'PX', 'SH', 'PR', 'PL', 'CU', 'AL', 'ZN', 'PB', 'NI', 'SN', 'AU', 'AG', 'RB', 'WR', 'HC', 'FU', 'BU', 'RU', 'SC', 'NR', 'SP', 'SS', 'LU', 'BC', 'AO', 'BR', 'EC', 'AD', 'OP', 'SI', 'LC', 'PS']) 大宗商品-注册仓单数据

  • get_roll_yield(date=None, var='BB', symbol1=None, symbol2=None, df=None) 指定交易日指定品种（主力和次主力）或任意两个合约的展期收益率

  • get_roll_yield_bar(type_method='var', var='RB', date='20201030', start_day=None, end_day=None) 展期收益率

  • get_shfe_daily(date='20220415') 上海期货交易所-日频率-量价数据

  • get_shfe_rank_table(date=None, vars_list=['IF', 'IC', 'IM', 'IH', 'T', 'TF', 'TS', 'TL', 'C', 'CS', 'A', 'B', 'M', 'Y', 'P', 'FB', 'BB', 'JD', 'L', 'V', 'PP', 'J', 'JM', 'I', 'EG', 'RR', 'EB', 'PG', 'LH', 'LG', 'BZ', 'WH', 'PM', 'CF', 'SR', 'TA', 'OI', 'RI', 'MA', 'ME', 'FG', 'RS', 'RM', 'ZC', 'JR', 'LR', 'SF', 'SM', 'WT', 'TC', 'GN', 'RO', 'ER', 'SRX', 'SRY', 'WSX', 'WSY', 'CY', 'AP', 'UR', 'CJ', 'SA', 'PK', 'PF', 'PX', 'SH', 'PR', 'PL', 'CU', 'AL', 'ZN', 'PB', 'NI', 'SN', 'AU', 'AG', 'RB', 'WR', 'HC', 'FU', 'BU', 'RU', 'SC', 'NR', 'SP', 'SS', 'LU', 'BC', 'AO', 'BR', 'EC', 'AD', 'OP', 'SI', 'LC', 'PS']) 上海期货交易所会员成交及持仓排名表

  • match_main_contract(symbol='cffex') 新浪财经-期货-主力合约

  • qhkc_tool_foreign(url='https://qhkch.com/ajax/toolbox_foreign.php') 奇货可查-工具-外盘比价

  • qhkc_tool_gdp(url='https://qhkch.com/dist/views/toolbox/gdp.html?v=1.10.7.1') 奇货可查-工具-各地区经济数据

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
dateNo
adjustNo
methodYes
periodNo
symbolNo
end_dateNo
start_dateNo
params_jsonNo{}

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Tool Definition Quality

C2.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It fails to mention rate limits, authentication, error handling for invalid methods, or the statefulness of the tool. It only lists available methods without discussing side effects or limitations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is excessively long (100+ lines) and poorly structured for an AI agent. While front-loaded with a brief summary, it then dumps a massive list of methods with repetitive signatures. Each signature carries little incremental value. The description would benefit from grouping methods by category or providing a clearer dispatch pattern explanation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having an output schema, the description is incomplete for a tool with such high complexity. It does not explain how the dispatcher pattern works: e.g., setting the 'method' parameter selects a function, and its parameters are passed via the other top-level fields or params_json. The agent cannot reliably invoke the tool without guessing parameter mappings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It provides method signatures with example parameters (e.g., symbol='黄金') but does not explain how the top-level parameters (date, symbol, etc.) map to each method's arguments. The role of params_json is unclear. This leaves the agent guessing how to invoke specific methods.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it provides Chinese and global futures data across multiple categories (real-time quotes, contract specs, inventory, etc.). The tool name 'akshare_futures' helps distinguish it from siblings like akshare_stock_a. However, the massive list of methods clutters the purpose and could overwhelm an agent.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no explicit guidance on when to use this tool vs. alternatives. The description does not mention when not to use it or provide context for choosing between this and other akshare tools. Implicit differentiation from siblings is weak.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/xiaozhozho/akshare-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server