# 期货增值数据函数（付费）
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 时, 返回报错。