Question

C++ 期货数据 API 包含在 3.5.18 版本及以上版本，不需要引入新库

fut_get_contract_info - 查询期货标准品种信息

查询交易所披露的期货标准品种的合约规格/合约文本

此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准

函数原型：

DataArray<FutContractInfo>* fut_get_contract_info(const char *product_codes);

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
product_codes	str	品种代码	Y	无	必填，交易品种代码，如：IF，AL 多个代码可用 ，多个标的代码必须用英文逗号分割，如：IF, AL

返回值：

FutContractInfo 结构数组，参见FutContractInfo定义与DataArray类的用法。

示例：

fut_get_contract_info("IF")

fut_get_transaction_rankings - 查询期货每日成交持仓排名

查询期货合约每日成交量/持买单量/持卖单量排名

此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准

函数原型：

DataArray<FutTransactionRankings>* fut_get_transaction_rankings(const char *symbols, const char *trade_date, const char *indicators = NULL);

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbols	str	期货合约代码	Y	无	期货合约代码, 必填，可输入多个，多个标的代码必须用英文逗号分割，如：SHFE.ag2212,SHFE.au2211
trade_date	str	交易日期	N	NULL	交易日期，%Y-%m-%d 格式
indicators	str	排名指标	N	NULL	用于排名的依据，可选： 'volume'-成交量排名 'long'-持买单量排名 'short'-持卖单量排名, 可输入多个，多个标的代码必须用英文逗号分割

返回值：

FutTransactionRankings 结构数组，参见FutTransactionRankings定义与DataArray类的用法。

示例：

fut_get_transaction_rankings("SHFE.ag2212,SHFE.au2211", "2022-10-10", "volume,long,short")

注意：

1. 当上一交易日没有进入前 20 名，ranking_change返回 0.

2. 数据日频更新，当日更新前返回前一交易日的排名数据，约在交易日 20 点左右更新当日数据。

fut_get_warehouse_receipt - 查询期货仓单数据

查询交易所在交易日期货品种的注册仓单数量、有效预报

此函数为掘金公版(专业版/机构版)函数，券商版以升级提示为准

• 期货仓单是指由期货交易所指定交割仓库，按照期货交易所指定的程序，签发的符合合约规定质量的实物提货凭证。记录了交易所所有期货实物的库存情况以及变更情况。

函数原型：

DataArray<FutWarehouseReceiptInfo>* fut_get_warehouse_receipt(const char *product_code, const char *start_date = NULL, const char *end_date = NULL);

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
product_code	str	品种代码	Y	无	必填，只能填写一个交易品种代码，如：AL
start_date	str	开始时间	N	NULL	开始时间日期，%Y-%m-%d 格式，默认NULL表示最新时间
end_date	str	结束时间	N	NULL	结束时间日期，%Y-%m-%d 格式，默认NULL表示最新时间

返回值：

FutWarehouseReceiptInfo 结构数组，参见FutWarehouseReceiptInfo定义与DataArray类的用法。

示例：

fut_get_warehouse_receipt("AL", "2023-06-20", "2023-06-29")

注意：

1. 支持郑商所、大商所、上期所和上海国际能源交易中心的期货品种。

2. 注册仓单数量每日更新，其余数据上期所一周一披露，郑商所一天一披露。

3. 当start_date 小于或等于 end_date 时, 取指定时间段的数据,当 start_date > end_date 时, 返回报错。

---