tsl-devkit/docs/tsl/syntax_book/function/financial/futures.md

1549 lines
42 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#### 期货
##### 内容
- 涨跌停板幅度
- 基本信息
- 仓单日报
- 期货保证金
- 期货手续费
- 期货代码
- 期货到期日
- 结算会员成交持仓排名
- 成交持仓排名
- 期现指标
- 国债期货可交割债券
##### 涨跌停板幅度
###### 内容
- futureslimitsischanged
- futureslimitschangecount
- futureslimitschangecount2
- futureslimitsrange
###### futureslimitsischanged
用途:判断涨跌停板幅度是否发生变动。
参数:无(使用 pn_stock/pn_date
返回是否发生变动1/0
###### futureslimitschangecount
用途:统计涨跌停板幅度变动次数。
参数:无(使用 pn_stock/pn_date
返回:变动次数。
###### futureslimitschangecount2
用途:统计涨跌停板幅度变动次数(扩展口径)。
参数:无(使用 pn_stock/pn_date
返回:变动次数。
###### futureslimitsrange
用途:获取指定日的涨跌停板幅度(%)。
参数:无(使用 pn_stock/pn_date
返回:涨跌停板幅度(%)。
算法取变动日小于endT的涨跌停板幅度(%)数据并依变动日降序排列,
取第一个数据。
##### 基本信息
###### 内容
- futuresmultiplierendt
- Futuresdeliverydateendt
- FuturesDeliveryDateEndT2
- FuturesLastDateEndT
- 中间函数
- FuturesTickSizeEndT
- FuturesMinimumTradingMarginRateEndT
- FuturesPriceUpperLimitEndT
- FuturesPriceLowerLimitEndT
###### futuresmultiplierendt
用途:获取指定合约在指定日的合约乘数。
参数:无(使用 pn_stock/pn_date
返回:合约乘数。
范例
```tsl
// 计算期货合约FB2009在20190920的合约乘数。
SetSysParam(pn_stock(), "FB2009");
endt := 20200920T;
SetSysParam(pn_date(), endt);
return FuturesMultiplierEndT(); // 结果500
```
###### Futuresdeliverydateendt
用途:获取指定合约在指定日的交割日。
参数:无(使用 pn_stock/pn_date
返回:交割日。
###### FuturesDeliveryDateEndT2
用途:获取真实合约在指定日的交割日。
参数:无(使用 pn_stock/pn_date
返回:交割日。
范例
```tsl
// IF01在20201207的真实合约的交割日
SetSysParam(pn_stock(), "IF01");
SetSysParam(pn_date(), 20201207T);
return FuturesDeliveryDateEndT2(); // 返回20201218
```
###### FuturesLastDateEndT
用途:获取指定合约最后交易日。
参数:无(使用 pn_stock
返回:最后交易日。
范例
```tsl
// 得到CU2101的最后交易日
SetSysParam(pn_stock(), "CU2101");
return FuturesLastDateEndT(); // 返回20210115
```
###### 中间函数
####### 内容
- Futuresbivalue
####### Futuresbivalue
用途:中间函数:获取期货基本信息原始值。
参数:
- args内部调用参数按系统约定
返回:基本信息值。
###### FuturesTickSizeEndT
用途:获取指定合约在指定日的最小变动价位。
参数:无(使用 pn_stock/pn_date
返回:最小变动价位。
范例
```tsl
// "OI1807"在2018-05-20的最小变动价位
SetSysParam(pn_stock(), "OI1807");
SetSysParam(pn_date(), 20180520T);
return FuturesTickSizeEndT();
// 结果1
```
###### FuturesMinimumTradingMarginRateEndT
用途:获取指定合约在指定日的最低交易保证金率(%)。
参数:无(使用 pn_stock/pn_date
返回:最低交易保证金率(%)。
范例
```tsl
// "bc2401"在2023-12-15的最低交易保证金(%)
SetSysParam(pn_stock(), "bc2401");
SetSysParam(pn_date(), 20231215T);
return FuturesMinimumTradingMarginRateEndT();
// 结果5.0
```
###### FuturesPriceUpperLimitEndT
用途:获取指定合约在指定日的每日涨停幅度(%)。
参数:无(使用 pn_stock/pn_date
返回:涨停幅度(%)。
范例
```tsl
// "OI1807"在2018-06-29的每日价格最大波动上限(%)
SetSysParam(pn_stock(), "OI1807");
SetSysParam(pn_date(), 20180629T);
return FuturesPriceUpperLimitEndT();
// 结果4.0
```
###### FuturesPriceLowerLimitEndT
用途:获取指定合约在指定日的每日跌停幅度(%)。
参数:无(使用 pn_stock/pn_date
返回:跌停幅度(%)。
范例
```tsl
// "OI1807"在2018-06-29的每日价格最大波动下限(%)
SetSysParam(pn_stock(), "OI1807");
SetSysParam(pn_date(), 20180629T);
return FuturesPriceLowerLimitEndT();
// 结果:-4.0
```
##### 仓单日报
###### 内容
- GetFuturesDailyWarehouse
- FuturesWarehouseVol
- FuturesWarehouseChange
- FuturesWarehouseRatio
- FuturesWarehouseRatio2
- FuturesTheWarehouseVolRatio
- FuturesWarehousePredictionVol
- 中间函数
###### GetFuturesDailyWarehouse
用途:获取指定品种在日期区间内的仓单日报。
参数:
- begt起始日期
- endt结束日期
- out_table输出表
返回是否查询成功1/0
范例
```tsl
// 获取"CF"品种一段时间的仓单日报
SetSysParam(pn_stock(), "CF");
begt := 20140415T;
endt := 20140419T;
ret := GetFuturesDailyWarehouse(begt, endt, out_table);
if ret then
return out_table;
return "获取数据失败";
```
###### FuturesWarehouseVol
用途:获取指定仓库的仓单总量。
参数:
- warehouse_name仓库名称
返回:仓单总量。
范例
```tsl
// 返回截止日为20200518仓库国储天威关于SN的仓单总量
SetSysParam(pn_stock(), 'sn');
SetSysParam(pn_date(), 20200518T);
return FuturesWarehouseVol("国储天威");
```
###### FuturesWarehouseChange
用途:获取指定仓库/地区的仓单净变动量。
参数:
- warehouse_name仓库名称
- region地区名称
返回:仓单净变动量。
范例
```tsl
// 返回截止日为20200518上期所-上海地区关于SN的仓单净变动量
SetSysParam(pn_stock(), 'sn');
SetSysParam(pn_date(), 20200518T);
return FuturesWarehouseChange("", "上海");
```
###### FuturesWarehouseRatio
用途:获取仓单占比(%)。
参数:无(使用 pn_stock/pn_date
返回:仓单占比(%)。
范例
```tsl
// 返回截止日为20200518关于SN的仓单占比(%)
SetSysParam(pn_stock(), 'sn');
SetSysParam(pn_date(), 20200518T);
return FuturesWarehouseRatio();
```
###### FuturesWarehouseRatio2
用途:获取指定仓库的仓单变比(%)。
参数:
- warehouse_name仓库名称
返回:仓单变比(%)。
范例
```tsl
// 返回截止日为20200518仓库国储天威关于SN的仓单变比(%)
SetSysParam(pn_stock(), 'sn');
SetSysParam(pn_date(), 20200518T);
return FuturesWarehouseRatio2("国储天威");
```
###### FuturesTheWarehouseVolRatio
用途:获取指定仓库占该地区仓单总量比(%)。
参数:
- warehouse_name仓库名称
返回:仓单占比(%)。
范例
```tsl
// 返回截止日为20200518仓库国储天威关于SN占该地区仓单总量比(%)
SetSysParam(pn_stock(), 'sn');
SetSysParam(pn_date(), 20200518T);
return FuturesTheWarehouseVolRatio("国储天威");
```
###### FuturesWarehousePredictionVol
用途:获取有效预报总量。
参数:无(使用 pn_stock/pn_date
返回:有效预报总量。
范例
```tsl
// 返回截止日为20200518关于SR白糖的有效预报总量
SetSysParam(pn_stock(), 'SR');
SetSysParam(pn_date(), 20200518T);
return FuturesWarehousePredictionVol();
```
###### 中间函数
####### 内容
- FuturesRegion
- FuturesWarehouse
####### FuturesRegion
用途:获取指定仓库所在地区。
参数:
- warehouse_name仓库名称
返回:地区名称。
范例
```tsl
// 获取"CU"品种"南储仓储"所在地区
SetSysParam(pn_stock(), "CU");
SetSysParam(pn_date(), 20210401T);
return FuturesRegion("南储仓储");
// 广东
```
####### FuturesWarehouse
用途:获取指定仓库在指定地区的仓单数量(类型由 flag 指定)。
参数:
- flag类型标记按示例传入
- warehouse_name仓库名称
- region地区名称
返回:仓单数量。
范例
```tsl
SetSysParam(pn_stock(), 'cu');
SetSysParam(pn_date(), 20210401T);
return FuturesWarehouse(0, '南储仓储', '广东');
// 结果15087
```
##### 期货保证金
###### 内容
- FuturesTradingMarginRate
- FuturesMaintenanceMarginRate
###### FuturesTradingMarginRate
用途:获取指定日交易保证金率(按类型标记)。
参数:
- date日期
- flag类型标记按示例传入
返回:交易保证金率(%)。
范例
```tsl
// 计算cu1404 在2014年3月31日的交易保证金率-投机买保证金率(%)。
SetSysParam(pn_stock(), "cu1404");
return FuturesTradingMarginRate(IntToDate(20140331), 0);
```
结果10
###### FuturesMaintenanceMarginRate
用途:获取指定日结算保证金率(按类型标记)。
参数:
- date日期
- flag类型标记按示例传入
返回:结算保证金率(%)。
范例
```tsl
// 计算cu1404 在2014年3月31日的结算保证金率-投机买保证金率(%)。
SetSysParam(pn_stock(), "cu1404");
return FuturesMaintenanceMarginRate(IntToDate(20140331), 0);
```
结果15
##### 期货手续费
###### 内容
- FuturesFeeRate
- FuturesFeeAmount
- futuresspfeeunit
- futuresspfeecost
###### FuturesFeeRate
用途:获取指定日手续费率(交易额万分之)。
参数:
- date日期
- flag类型标记按示例传入
返回:手续费率(万分之)。
范例
```tsl
// 计算cu1404 在2014年3月28日的开仓手续费(交易额万分之)。
SetSysParam(pn_stock(), "cu1404");
return FuturesFeeRate(IntToDate(20140328), 0);
```
结果0.5(交易额万分之)
###### FuturesFeeAmount
用途:获取指定日手续费金额(元/手)。
参数:
- date日期
- flag类型标记按示例传入
返回:手续费金额(元/手)。
范例
范例一:
```tsl
// 计算cu1404 在2014年3月28日的开仓手续费(元/手)。
SetSysParam(pn_stock(), "cu1404");
return FuturesFeeAmount(IntToDate(20140328), 0);
```
结果0 (元/手)
范例二:
```tsl
// 根据期货手续费(交易额万分之)和期货手续费(元/手)计算cu1404 在2014年3月28日交易手续费。
vol1 := 10; // 交易张数
price := 3000; // 交易价格
SetSysParam(pn_stock(), "cu1404");
contractunit := base(703007); // 合约乘数
// 期货手续费(金额法)
fee_rate := FuturesFeeRate(IntToDate(20140328), 0);
fee_1 := (vol1 * price * contractunit) / 10000 * fee_rate;
// 期货手续费(数量法)
fee_amount := FuturesFeeAmount(IntToDate(20140328), 0);
fee_2 := vol1 * fee_amount;
return fee_1 + fee_2;
```
结果7.5(元)
###### futuresspfeeunit
用途:获取期货手续费计费单位。
参数:无(使用 pn_stock/pn_date
返回:计费单位标记。
###### futuresspfeecost
用途:获取期货手续费计费成本参数。
参数:无(使用 pn_stock/pn_date
返回:计费成本参数。
##### 期货代码
###### 内容
- FuturesCodeToPZ
- GetFuturesBkbydate
- FuturesAllPZCode
- FuturesContinueCode
- FuturesContinueCode1
- FuturesContinueCode2
- FuturesContinueCode3
- FuturesIndexCode
- Futurescodetopzendt
- GetFuturesDerivedIDByEndt
- FuturesContinueCode4
- FuturesIDToCZL
- FuturesSettlement
###### FuturesCodeToPZ
用途:合约代码转换为品种代码。
参数:
- code合约代码按系统日期 pn_date 处理)
返回:品种代码。
范例
```tsl
// 得到连豆一连一合约代码对应的品种代码
return FuturesCodeToPZ('LXA01'); // 返回'A'
```
###### GetFuturesBkbydate
用途:获取指定日期仍在市交易的合约列表。
参数:
- categories类别/品种列表
- endt日期
返回:合约列表。
范例
```tsl
// 取2020-2-1日所有期货还在市交易的合给
return GetFuturesBkbydate('国内商品期货;国债期货;股指期货', 20200201T);
// 取2020-2-1日沪深300指数期货与10年期国债期货品种中还在市交易的合约
return GetFuturesBkbydate('沪深300指数;10年期国债', 20200201T);
// 取2020-2-1日大连商品交易所还在市交易的合约
return GetFuturesBkbydate('大连商品交易所', 20200201T);
```
###### FuturesAllPZCode
用途:获取全部期货品种及主力/连续线代码表。
参数:无。
返回:品种代码表。
范例
```tsl
return FuturesAllPZCode();
```
| 品种代码 | 变动日 | 品种名称 | 主力代码 | 主力代码2 | 次主力代码 | 指数线代码 | 连续代码 | 连一代码 | 连二代码 | 连三代码 | 连四代码 |
| -------- | -------- | ------------ | -------- | --------- | ---------- | ---------- | -------- | -------- | -------- | -------- | -------- |
| A | 20020315 | 黄大豆1号 | ZLA10 | ZLA00 | ZLA11 | QIA10 | LXA00 | LXA01 | LXA02 | LXA03 | LXA04 |
| AD | 20250610 | 铸造铝合金 | ZLAD10 | ZLAD00 | ZLAD11 | QIAD10 | LXAD00 | LXAD01 | LXAD02 | LXAD03 | LXAD04 |
| AG | 20120510 | 白银 | ZLAG10 | ZLAG00 | ZLAG11 | QIAG10 | LXAG00 | LXAG01 | LXAG02 | LXAG03 | LXAG04 |
| AL | 19920528 | 铝 | ZLAL10 | ZLAL00 | ZLAL11 | QIAL10 | LXAL00 | LXAL01 | LXAL02 | LXAL03 | LXAL04 |
| AO | 20230619 | 氧化铝 | ZLAO10 | ZLAO00 | ZLAO11 | QIAO10 | LXAO00 | LXAO01 | LXAO02 | LXAO03 | LXAO04 |
| AP | 20171222 | 苹果 | ZLAP10 | ZLAP00 | ZLAP11 | QIAP10 | LXAP00 | LXAP01 | LXAP02 | LXAP03 | LXAP04 |
| AU | 20080109 | 黄金 | ZLAU10 | ZLAU00 | ZLAU11 | QIAU10 | LXAU00 | LXAU01 | LXAU02 | LXAU03 | LXAU04 |
| B | 20041222 | 黄大豆2号 | ZLB10 | ZLB00 | ZLB11 | QIB10 | LXB00 | LXB01 | LXB02 | LXB03 | LXB04 |
| BB | 20131206 | 胶合板 | ZLBB10 | ZLBB00 | ZLBB11 | QIBB10 | LXBB00 | LXBB01 | LXBB02 | LXBB03 | LXBB04 |
| BC | 20201119 | 国际铜 | ZLBC10 | ZLBC00 | ZLBC11 | QIBC10 | LXBC00 | LXBC01 | LXBC02 | LXBC03 | LXBC04 |
| BR | 20230728 | 丁二烯橡胶 | ZLBR10 | ZLBR00 | ZLBR11 | QIBR10 | LXBR00 | LXBR01 | LXBR02 | LXBR03 | LXBR04 |
| BU | 20131009 | 沥青 | ZLBU10 | ZLBU00 | ZLBU11 | QIBU10 | LXBU00 | LXBU01 | LXBU02 | LXBU03 | LXBU04 |
| BZ | 20250708 | 纯苯 | ZLBZ10 | ZLBZ00 | ZLBZ11 | QIBZ10 | LXBZ00 | LXBZ01 | LXBZ02 | LXBZ03 | LXBZ04 |
| C | 20040922 | 玉米 | ZLC10 | ZLC00 | ZLC11 | QIC10 | LXC00 | LXC01 | LXC02 | LXC03 | LXC04 |
| CF | 20040601 | 棉花 | ZLCF10 | ZLCF00 | ZLCF11 | QICF10 | LXCF00 | LXCF01 | LXCF02 | LXCF03 | LXCF04 |
| CJ | 20190430 | 红枣 | ZLCJ10 | ZLCJ00 | ZLCJ11 | QICJ10 | LXCJ00 | LXCJ01 | LXCJ02 | LXCJ03 | LXCJ04 |
| CS | 20141219 | 玉米淀粉 | ZLCS10 | ZLCS00 | ZLCS11 | QICS10 | LXCS00 | LXCS01 | LXCS02 | LXCS03 | LXCS04 |
| CU | 19930301 | 铜 | ZLCU10 | ZLCU00 | ZLCU11 | QICU10 | LXCU00 | LXCU01 | LXCU02 | LXCU03 | LXCU04 |
| CY | 20170818 | 棉纱 | ZLCY10 | ZLCY00 | ZLCY11 | QICY10 | LXCY00 | LXCY01 | LXCY02 | LXCY03 | LXCY04 |
| EB | 20190926 | 苯乙烯 | ZLEB10 | ZLEB00 | ZLEB11 | QIEB10 | LXEB00 | LXEB01 | LXEB02 | LXEB03 | LXEB04 |
| EC | 20230818 | SCFIS欧线 | ZLEC10 | ZLEC00 | ZLEC11 | QIEC10 | LXEC00 | LXEC01 | LXEC02 | LXEC03 | LXEC04 |
| EG | 20181210 | 乙二醇 | ZLEG10 | ZLEG00 | ZLEG11 | QIEG10 | LXEG00 | LXEG01 | LXEG02 | LXEG03 | LXEG04 |
| FB | 20131206 | 纤维板 | ZLFB10 | ZLFB00 | ZLFB11 | QIFB10 | LXFB00 | LXFB01 | LXFB02 | LXFB03 | LXFB04 |
| FG | 20121203 | 玻璃 | ZLFG10 | ZLFG00 | ZLFG11 | QIFG10 | LXFG00 | LXFG01 | LXFG02 | LXFG03 | LXFG04 |
| FU | 20040825 | 燃料油 | ZLFU10 | ZLFU00 | ZLFU11 | QIFU10 | LXFU00 | LXFU01 | LXFU02 | LXFU03 | LXFU04 |
| HC | 20140321 | 热轧卷板 | ZLHC10 | ZLHC00 | ZLHC11 | QIHC10 | LXHC00 | LXHC01 | LXHC02 | LXHC03 | LXHC04 |
| I | 20131018 | 铁矿石 | ZLI10 | ZLI00 | ZLI11 | QII10 | LXI00 | LXI01 | LXI02 | LXI03 | LXI04 |
| IC | 20150416 | 中证500指数 | ZLIC10 | ZLIC00 | ZLIC11 | QIIC10 | LXIC00 | LXIC01 | LXIC02 | LXIC03 | |
| IF | 20100416 | 沪深300指数 | ZLIF10 | ZLIF00 | ZLIF11 | QIIF10 | LXIF00 | LXIF01 | LXIF02 | LXIF03 | |
| IH | 20150416 | 上证50指数 | ZLIH10 | ZLIH00 | ZLIH11 | QIIH10 | LXIH00 | LXIH01 | LXIH02 | LXIH03 | |
| IM | 20220722 | 中证1000指数 | ZLIM10 | ZLIM00 | ZLIM11 | QIIM10 | LXIM00 | LXIM01 | LXIM02 | LXIM03 | |
| J | 20110415 | 焦炭 | ZLJ10 | ZLJ00 | ZLJ11 | QIJ10 | LXJ00 | LXJ01 | LXJ02 | LXJ03 | LXJ04 |
| JD | 20131108 | 鸡蛋 | ZLJD10 | ZLJD00 | ZLJD11 | QIJD10 | LXJD00 | LXJD01 | LXJD02 | LXJD03 | LXJD04 |
| JM | 20130322 | 焦煤 | ZLJM10 | ZLJM00 | ZLJM11 | QIJM10 | LXJM00 | LXJM01 | LXJM02 | LXJM03 | LXJM04 |
| JR | 20131118 | 粳稻 | ZLJR10 | ZLJR00 | ZLJR11 | QIJR10 | LXJR00 | LXJR01 | LXJR02 | LXJR03 | LXJR04 |
| L | 20070731 | 聚乙烯 | ZLL10 | ZLL00 | ZLL11 | QIL10 | LXL00 | LXL01 | LXL02 | LXL03 | LXL04 |
| LC | 20230721 | 碳酸锂 | ZLLC10 | ZLLC00 | ZLLC11 | QILC10 | LXLC00 | LXLC01 | LXLC02 | LXLC03 | LXLC04 |
| LG | 20241118 | 原木 | ZLLG10 | ZLLG00 | ZLLG11 | QILG10 | LXLG00 | LXLG01 | LXLG02 | LXLG03 | LXLG04 |
| LH | 20210108 | 生猪 | ZLLH10 | ZLLH00 | ZLLH11 | QILH10 | LXLH00 | LXLH01 | LXLH02 | LXLH03 | LXLH04 |
| LR | 20140708 | 晚籼稻 | ZLLR10 | ZLLR00 | ZLLR11 | QILR10 | LXLR00 | LXLR01 | LXLR02 | LXLR03 | LXLR04 |
| LU | 20200622 | 低硫燃料油 | ZLLU10 | ZLLU00 | ZLLU11 | QILU10 | LXLU00 | LXLU01 | LXLU02 | LXLU03 | LXLU04 |
| M | 20000717 | 豆粕 | ZLM10 | ZLM00 | ZLM11 | QIM10 | LXM00 | LXM01 | LXM02 | LXM03 | LXM04 |
| MA | 20140617 | 甲醇 | ZLMA10 | ZLMA00 | ZLMA11 | QIMA10 | LXMA00 | LXMA01 | LXMA02 | LXMA03 | LXMA04 |
| NI | 20150327 | 镍 | ZLNI10 | ZLNI00 | ZLNI11 | QINI10 | LXNI00 | LXNI01 | LXNI02 | LXNI03 | LXNI04 |
| NR | 20190812 | 20号胶 | ZLNR10 | ZLNR00 | ZLNR11 | QINR10 | LXNR00 | LXNR01 | LXNR02 | LXNR03 | LXNR04 |
| OI | 20120716 | 菜籽油 | ZLOI10 | ZLOI00 | ZLOI11 | QIOI10 | LXOI00 | LXOI01 | LXOI02 | LXOI03 | LXOI04 |
| OP | 20250910 | 胶版印刷纸 | ZLOP10 | ZLOP00 | ZLOP11 | QIOP10 | LXOP00 | LXOP01 | LXOP02 | LXOP03 | LXOP04 |
| P | 20071029 | 棕榈油 | ZLP10 | ZLP00 | ZLP11 | QIP10 | LXP00 | LXP01 | LXP02 | LXP03 | LXP04 |
| PB | 20110324 | 铅 | ZLPB10 | ZLPB00 | ZLPB11 | QIPB10 | LXPB00 | LXPB01 | LXPB02 | LXPB03 | LXPB04 |
| PF | 20201012 | 短纤 | ZLPF10 | ZLPF00 | ZLPF11 | QIPF10 | LXPF00 | LXPF01 | LXPF02 | LXPF03 | LXPF04 |
| PG | 20200330 | 液化石油气 | ZLPG10 | ZLPG00 | ZLPG11 | QIPG10 | LXPG00 | LXPG01 | LXPG02 | LXPG03 | LXPG04 |
| PK | 20210201 | 花生 | ZLPK10 | ZLPK00 | ZLPK11 | QIPK10 | LXPK00 | LXPK01 | LXPK02 | LXPK03 | LXPK04 |
| PL | 20250722 | 丙烯 | ZLPL10 | ZLPL00 | ZLPL11 | QIPL10 | LXPL00 | LXPL01 | LXPL02 | LXPL03 | LXPL04 |
| PM | 20120117 | 普麦 | ZLPM10 | ZLPM00 | ZLPM11 | QIPM10 | LXPM00 | LXPM01 | LXPM02 | LXPM03 | LXPM04 |
| PP | 20140228 | 聚丙烯 | ZLPP10 | ZLPP00 | ZLPP11 | QIPP10 | LXPP00 | LXPP01 | LXPP02 | LXPP03 | LXPP04 |
| PR | 20240830 | 瓶片 | ZLPR10 | ZLPR00 | ZLPR11 | QIPR10 | LXPR00 | LXPR01 | LXPR02 | LXPR03 | LXPR04 |
| PS | 20241226 | 多晶硅 | ZLPS10 | ZLPS00 | ZLPS11 | QIPS10 | LXPS00 | LXPS01 | LXPS02 | LXPS03 | LXPS04 |
| PX | 20230915 | 对二甲苯 | ZLPX10 | ZLPX00 | ZLPX11 | QIPX10 | LXPX00 | LXPX01 | LXPX02 | LXPX03 | LXPX04 |
| RB | 20090327 | 螺纹钢 | ZLRB10 | ZLRB00 | ZLRB11 | QIRB10 | LXRB00 | LXRB01 | LXRB02 | LXRB03 | LXRB04 |
| RI | 20120724 | 早籼稻 | ZLRI10 | ZLRI00 | ZLRI11 | QIRI10 | LXRI00 | LXRI01 | LXRI02 | LXRI03 | LXRI04 |
| RM | 20121228 | 菜籽粕 | ZLRM10 | ZLRM00 | ZLRM11 | QIRM10 | LXRM00 | LXRM01 | LXRM02 | LXRM03 | LXRM04 |
| RR | 20190816 | 粳米 | ZLRR10 | ZLRR00 | ZLRR11 | QIRR10 | LXRR00 | LXRR01 | LXRR02 | LXRR03 | LXRR04 |
| RS | 20121228 | 油菜籽 | ZLRS10 | ZLRS00 | ZLRS11 | QIRS10 | LXRS00 | LXRS01 | LXRS02 | LXRS03 | |
| RU | 19931101 | 天然橡胶 | ZLRU10 | ZLRU00 | ZLRU11 | QIRU10 | LXRU00 | LXRU01 | LXRU02 | LXRU03 | LXRU04 |
| SA | 20191206 | 纯碱 | ZLSA10 | ZLSA00 | ZLSA11 | QISA10 | LXSA00 | LXSA01 | LXSA02 | LXSA03 | LXSA04 |
| SC | 20180326 | 原油 | ZLSC10 | ZLSC00 | ZLSC11 | QISC10 | LXSC00 | LXSC01 | LXSC02 | LXSC03 | LXSC04 |
| SF | 20140808 | 硅铁 | ZLSF10 | ZLSF00 | ZLSF11 | QISF10 | LXSF00 | LXSF01 | LXSF02 | LXSF03 | LXSF04 |
| SH | 20230915 | 烧碱 | ZLSH10 | ZLSH00 | ZLSH11 | QISH10 | LXSH00 | LXSH01 | LXSH02 | LXSH03 | LXSH04 |
| SI | 20221222 | 工业硅 | ZLSI10 | ZLSI00 | ZLSI11 | QISI10 | LXSI00 | LXSI01 | LXSI02 | LXSI03 | LXSI04 |
| SM | 20140808 | 锰硅 | ZLSM10 | ZLSM00 | ZLSM11 | QISM10 | LXSM00 | LXSM01 | LXSM02 | LXSM03 | LXSM04 |
| SN | 20150327 | 锡 | ZLSN10 | ZLSN00 | ZLSN11 | QISN10 | LXSN00 | LXSN01 | LXSN02 | LXSN03 | LXSN04 |
| SP | 20181127 | 纸浆 | ZLSP10 | ZLSP00 | ZLSP11 | QISP10 | LXSP00 | LXSP01 | LXSP02 | LXSP03 | LXSP04 |
| SR | 20060106 | 白糖 | ZLSR10 | ZLSR00 | ZLSR11 | QISR10 | LXSR00 | LXSR01 | LXSR02 | LXSR03 | LXSR04 |
| SS | 20190925 | 不锈钢 | ZLSS10 | ZLSS00 | ZLSS11 | QISS10 | LXSS00 | LXSS01 | LXSS02 | LXSS03 | LXSS04 |
| T | 20150320 | 10年期国债 | ZLT10 | ZLT00 | ZLT11 | QIT10 | LXT00 | LXT01 | LXT02 | | |
| TA | 20061218 | PTA | ZLTA10 | ZLTA00 | ZLTA11 | QITA10 | LXTA00 | LXTA01 | LXTA02 | LXTA03 | LXTA04 |
| TF | 20130906 | 5年期国债 | ZLTF10 | ZLTF00 | ZLTF11 | QITF10 | LXTF00 | LXTF01 | LXTF02 | | |
| TL | 20230421 | 30年期国债 | ZLTL10 | ZLTL00 | ZLTL11 | QITL10 | LXTL00 | LXTL01 | LXTL02 | | |
| TS | 20180817 | 2年期国债 | ZLTS10 | ZLTS00 | ZLTS11 | QITS10 | LXTS00 | LXTS01 | LXTS02 | | |
| UR | 20190809 | 尿素 | ZLUR10 | ZLUR00 | ZLUR11 | QIUR10 | LXUR00 | LXUR01 | LXUR02 | LXUR03 | LXUR04 |
| V | 20090525 | 聚氯乙烯 | ZLV10 | ZLV00 | ZLV11 | QIV10 | LXV00 | LXV01 | LXV02 | LXV03 | LXV04 |
| WH | 20120724 | 强麦 | ZLWH10 | ZLWH00 | ZLWH11 | QIWH10 | LXWH00 | LXWH01 | LXWH02 | LXWH03 | LXWH04 |
| WR | 20090327 | 线材 | ZLWR10 | ZLWR00 | ZLWR11 | QIWR10 | LXWR00 | LXWR01 | LXWR02 | LXWR03 | LXWR04 |
| Y | 20060109 | 豆油 | ZLY10 | ZLY00 | ZLY11 | QIY10 | LXY00 | LXY01 | LXY02 | LXY03 | LXY04 |
| ZC | 20150518 | 动力煤 | ZLZC10 | ZLZC00 | ZLZC11 | QIZC10 | LXZC00 | LXZC01 | LXZC02 | LXZC03 | LXZC04 |
| ZN | 20070326 | 锌 | ZLZN10 | ZLZN00 | ZLZN11 | QIZN10 | LXZN00 | LXZN01 | LXZN02 | LXZN03 | LXZN04 |
###### FuturesContinueCode
用途:获取连续合约代码。
参数:无(使用 pn_stock
返回:连续合约代码。
范例
```tsl
// 得到CU2101的连续代码
SetSysParam(pn_stock(), 'CU2101');
return FuturesContinueCode(); // 返回'LXCU00'
```
###### FuturesContinueCode1
用途:获取连一合约代码。
参数:无(使用 pn_stock
返回:连一合约代码。
范例
```tsl
// 得到CU2101的连一代码
SetSysParam(pn_stock(), 'CU2101');
return FuturesContinueCode1(); // 返回'LXCU01'
```
###### FuturesContinueCode2
用途:获取连二合约代码。
参数:无(使用 pn_stock
返回:连二合约代码。
范例
```tsl
// 得到CU2101的连二代码
SetSysParam(pn_stock(), 'CU2101');
return FuturesContinueCode2(); // 返回'LXCU02'
```
###### FuturesContinueCode3
用途:获取连三合约代码。
参数:无(使用 pn_stock
返回:连三合约代码。
范例
```tsl
// 得到CU2101的连三代码
SetSysParam(pn_stock(), "CU2101");
return FuturesContinueCode3(); // 返回"LXCU03"
```
###### FuturesIndexCode
用途:获取指数线代码。
参数:无(使用 pn_stock
返回:指数线代码。
范例
```tsl
// 得到IF00的指数线代码
SetSysParam(pn_stock(), 'IF00');
return FuturesIndexCode(); // 返回'IFInd'
```
###### Futurescodetopzendt
用途:将合约代码转换为指定日品种代码。
参数:
- code合约代码按系统日期 pn_date 处理)
返回:品种代码。
范例
```tsl
// 得到连豆一连一合约代码对应的品种代码
return Futurescodetopzendt("LXA01"); // 返回"A"
```
###### GetFuturesDerivedIDByEndt
用途:获取指定日指定类型的衍生合约品种代码。
参数:
- endt日期
- future_type期货类型标记
- id_type返回类型标记
返回:品种代码列表。
范例
```tsl
// 指定日已上市的股指期货的品种代码
endt := 20240201T;
future_type := 1;
id_type := 0;
return GetFuturesDerivedIDByEndt(endt, future_type, id_type);
// array("IC","IF","IH","IM")
```
###### FuturesContinueCode4
用途:获取连四合约代码。
参数:无(使用 pn_stock
返回:连四合约代码。
范例
```tsl
// 得到CU2101的连四代码
SetSysParam(pn_stock(), "CU2101");
return FuturesContinueCode4();
// 返回"LXCU04"
```
###### FuturesIDToCZL
用途:获取次主力线代码。
参数:无(使用 pn_stock
返回:次主力线代码。
范例
```tsl
// cu2401的次主力线代码
SetSysParam(pn_stock(), "cu2401");
return FuturesIDToCZL();
// 返回ZL100003
```
###### FuturesSettlement
用途:计算指定时刻的实时结算价。
参数:无(使用 pn_stock/pn_date
返回:结算价。
算法
1、有成交
成交量加权中金所1小时其余当天
2、无成交
中金所:
当日结算价=该合约上一交易日结算价+基准合约当日结算价-基准合约上一交易日结算价
其中,基准合约为当日有成交的离交割月最近的合约。
无基准合约,交易所有权决定当日结算价
其余:
1有买卖报价mid(买价、卖价、上日结算价)
2收盘前持续报价涨跌停价以涨跌停价,持续时间大商所一整天单边报价其余前5分钟单边报价。
31寻找有成交量的近月合约作为活跃合约A 郑商所寻找有成交的远月合约作为活跃合约A
A结算价的涨跌幅<=该合约涨跌停板该合约结算价该上一交易日的结算价×1±合约A结算价的涨跌幅度
A结算价的涨跌幅>该合约涨跌停板该合约结算价该上一交易日的结算价×1±该结算价的涨跌停幅度
注:最活跃月份合约是指当日“成交量×交易单位”的值最大的合约,
若存在两个及以上合约“成交量×交易单位”的值一致的情况,则取其中最近到期月份合约为最活跃月份合约。
2无成交合约
结算价=上一交易日结算价
注意事项1、集合竞价时返回0。
2、期货交割期间可能会有较大误差。范例
```tsl
// "sc2506"在2025-04-14 11:00:00的实时结算价
SetSysParam(pn_stock(), "sc2506");
SetSysParam(pn_date(), StrToDateTime('2025-04-14 11:00:00'));
return FuturesSettlement(); // 结果468.8
```
##### 期货到期日
###### 内容
- qh_LastTradeDay
- FuturesDeliveryDaysbyEndt
###### qh_LastTradeDay
用途:获取合约最后交易日。
参数:
- code合约代码
返回:最后交易日。
范例
```tsl
// 查询IF1210的最后交易日
return qh_LastTradeDay('IF1210');
// 结果41201即2012-10-19
```
###### FuturesDeliveryDaysbyEndt
用途:获取指定日距交割日的交易天数。
参数:
- code合约代码
- endt日期
返回:交易天数。
范例
```tsl
// 获取CU2101在2020-3-20日距离交割日的交易天数
return FuturesDeliveryDaysbyEndt('CU2101', 20200320T);
// 返回209
```
##### 结算会员成交持仓排名
###### 内容
- 指定日
- 区间
###### 指定日
####### 内容
- futuresmtpsumnvolgrow
- futuresmtpnonoigrow
- futuresmtpinstitutoigrow
- futuresmtpsumnoigrow
- futuresmtpinstitutvolgrow
- futuresmtpnonvolgrow
- FuturesMTPSumNPercent
- FuturesMTPSumNVol
- FuturesMTPNoNOIPercent
- FuturesMTPNoNPercent
- FuturesMTPInstitutPercent
- FuturesMTPInstitutOI
- FuturesMTPInstitutOIRank
- FuturesMTPInstitutOIPercent
- FuturesMTPNoNOI
- FuturesMTPInstitutNetOI
- FuturesMTPSumNOI
- FuturesMTPSumNOIPercent
- FuturesMTPNoNName
- FuturesMTPInstitutRank
- FuturesMTPNoNVol
- FuturesMTPInstitutVol
- FuturesMTPNoNOIName
- 中间函数
####### futuresmtpsumnvolgrow
用途:指定日成交量前 N 名合计变动。
参数:
- args内部调用参数按系统约定
返回:成交量合计变动值。
####### futuresmtpnonoigrow
用途:指定日持仓量排名第 N 的变动。
参数:
- args内部调用参数按系统约定
返回:持仓量变动值。
####### futuresmtpinstitutoigrow
用途:指定日指定结算会员持仓量变动。
参数:
- args内部调用参数按系统约定
返回:持仓量变动值。
####### futuresmtpsumnoigrow
用途:指定日持仓量前 N 名合计变动。
参数:
- args内部调用参数按系统约定
返回:持仓量合计变动值。
####### futuresmtpinstitutvolgrow
用途:指定日指定结算会员成交量变动。
参数:
- args内部调用参数按系统约定
返回:成交量变动值。
####### futuresmtpnonvolgrow
用途:指定日成交量排名第 N 的变动。
参数:
- args内部调用参数按系统约定
返回:成交量变动值。
####### FuturesMTPSumNPercent
用途:指定日成交量排名前 N 名占比合计。
参数:
- endt交易日期
- n名次
返回:成交量占比合计(%)。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPSumNPercent(20240201T, 3);
// 结果57.27
```
####### FuturesMTPSumNVol
用途:指定日成交量排名前 N 名合计。
参数:
- endt交易日期
- n名次
返回:成交量合计值。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPSumNVol(20240201T, 3);
// 结果45405
```
####### FuturesMTPNoNOIPercent
用途:指定日持仓量排名第 N 的占比。
参数:
- endt交易日期
- n名次
- flag类型标记按示例传入
返回:持仓量占比(%)。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPNoNOIPercent(20240201T, 3, 1);
// 结果7.78
```
####### FuturesMTPNoNPercent
用途:指定日成交量排名第 N 的占比。
参数:
- endt交易日期
- n名次
返回:成交量占比(%)。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPNoNPercent(20240201T, 3);
// 结果6.83
```
####### FuturesMTPInstitutPercent
用途:指定日指定结算会员成交量占比。
参数:
- endt交易日期
- institution结算会员名称
返回:成交量占比(%)。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPInstitutPercent(20240201T, '东证期货');
// 结果29.36
```
####### FuturesMTPInstitutOI
用途:指定日指定结算会员持仓量。
参数:
- endt交易日期
- institution结算会员名称
- flag类型标记按示例传入
返回:持仓量。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPInstitutOI(20240201T, '东证期货', 1);
// 结果18349
```
####### FuturesMTPInstitutOIRank
用途:指定日指定结算会员持仓量排名。
参数:
- endt交易日期
- institution结算会员名称
- flag类型标记按示例传入
返回:持仓量排名(整数)。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPInstitutOIRank(20240201T, '东证期货', 1);
// 结果2
```
####### FuturesMTPInstitutOIPercent
用途:指定日指定结算会员持仓量占比。
参数:
- endt交易日期
- institution结算会员名称
- flag类型标记按示例传入
返回:持仓量占比(%)。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPInstitutOIPercent(20240201T, '东证期货', 1);
// 结果17.62
```
####### FuturesMTPNoNOI
用途:指定日持仓量排名第 N 的持仓量。
参数:
- endt交易日期
- n名次
- flag类型标记按示例传入
返回:持仓量。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPNoNOI(20240201T, 1, 1);
// 结果20302
```
####### FuturesMTPInstitutNetOI
用途:指定日指定结算会员净持仓量。
参数:
- endt交易日期
- institution结算会员名称
返回:净持仓量。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPInstitutNetOI(20240201T, '东证期货');
// 结果11783
```
####### FuturesMTPSumNOI
用途:指定日持仓量排名前 N 名合计。
参数:
- endt交易日期
- n名次
- flag类型标记按示例传入
返回:持仓量合计值。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPSumNOI(20240201T, 1, 1);
// 结果20302
```
####### FuturesMTPSumNOIPercent
用途:指定日持仓量排名前 N 名占比合计。
参数:
- endt交易日期
- n名次
- flag类型标记按示例传入
返回:持仓量占比合计(%)。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPSumNOIPercent(20240201T, 1, 1);
// 结果19.49
```
####### FuturesMTPNoNName
用途:指定日成交量排名第 N 的结算会员名称。
参数:
- endt交易日期
- n名次
返回:结算会员名称。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPNoNName(20240201T, 1);
// 结果:东证期货
```
####### FuturesMTPInstitutRank
用途:指定日指定结算会员成交量排名。
参数:
- endt交易日期
- institution结算会员名称
返回:成交量排名(整数)。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPInstitutRank(20240201T, '东证期货');
// 结果1
```
####### FuturesMTPNoNVol
用途:指定日成交量排名第 N 的成交量。
参数:
- endt交易日期
- n名次
返回:成交量。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPNoNVol(20240201T, 1);
// 结果23278
```
####### FuturesMTPInstitutVol
用途:指定日指定结算会员成交量。
参数:
- endt交易日期
- institution结算会员名称
返回:成交量。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPInstitutVol(20240201T, '东证期货');
// 结果23278
```
####### FuturesMTPNoNOIName
用途:指定日持仓量排名第 N 的结算会员名称。
参数:
- endt交易日期
- n名次
- flag类型标记按示例传入
返回:结算会员名称。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesMTPNoNOIName(20240201T, 2, 2);
// 结果:银河期货
```
####### 中间函数
######## 内容
- FuturesMTPGetData
- FuturesMTPGetDataQJ
- FuturesMTPInstitutValue
- FuturesMTPSumNVolValue
- FuturesMTPNoNVolValue
######## FuturesMTPGetData
用途:获取指定标的的成交持仓排名数据表。
参数:
- code合约或品种代码
- endt交易日期
- item_name指标名称
返回:结果表。
范例
```tsl
return FuturesMTPGetData('TF2403', 20240201T, '成交量排名');
```
######## FuturesMTPGetDataQJ
用途:获取指定标的区间内的成交持仓排名数据表。
参数:
- code合约或品种代码
- begt起始日期
- endt结束日期
- flag类型标记按示例传入
返回:结果表。
范例
```tsl
return FuturesMTPGetDataQJ('TF2403', 20240201T, 20240202T, 0);
```
######## FuturesMTPInstitutValue
用途:获取指定结算会员的成交持仓指标值。
参数:
- code合约或品种代码
- endt交易日期
- institution结算会员名称
- item_name指标名称
- flag类型标记按示例传入
返回:指标值。
范例
```tsl
return FuturesMTPInstitutValue('TF2403', 20240201T, '东证期货', '数量', 0);
// 结果23278
```
######## FuturesMTPSumNVolValue
用途:获取成交量排名前 N 名的指定指标值。
参数:
- code合约或品种代码
- endt交易日期
- n名次
- item_name指标名称
- flag类型标记按示例传入
返回:指标值。
范例
```tsl
return FuturesMTPSumNVolValue('TF2403', 20240201T, 1, '数量', 0);
// 结果23278
```
######## FuturesMTPNoNVolValue
用途:获取成交量排名第 N 名的指定指标值。
参数:
- code合约或品种代码
- endt交易日期
- n名次
- item_name指标名称
- flag类型标记按示例传入
返回:指标值。
范例
```tsl
return FuturesMTPNoNVolValue('TF2403', 20240201T, 1, '数量', 0);
// 结果23278
```
###### 区间
####### 内容
- futuresmtpavgvol
- futuresmtpavgoi
####### futuresmtpavgvol
用途:获取区间平均成交量。
参数:
- args内部调用参数按系统约定
返回:区间平均成交量。
####### futuresmtpavgoi
用途:获取区间平均持仓量。
参数:
- args内部调用参数按系统约定
返回:区间平均持仓量。
##### 成交持仓排名
###### 内容
- GetFuturesTradeRankingByDate
###### GetFuturesTradeRankingByDate
用途:获取指定日成交持仓排名数据。
参数:
- endt交易日期
- out_table输出表
返回是否查询成功1/0
范例
```tsl
SetSysParam(pn_stock(), 'IF1508');
GetFuturesTradeRankingByDate(20150722T, t);
return t;
```
##### 期现指标
###### 内容
- FuturesBasis
- FuturesPremiumRate
- FuturesSpotAmountRatio
###### FuturesBasis
用途:获取基差(期货价格-现货价格)。
参数:无(使用 pn_stock/pn_date
返回:基差值。
算法期货价格 - 现货价格范例
```tsl
// IC00在20230403的基差
SetSysParam(pn_stock(), "IC00");
SetSysParam(pn_date(), 20230403T);
return FuturesBasis();
// 结果:-63.8073
```
###### FuturesPremiumRate
用途:获取升贴水率(可按年化口径)。
参数:
- flag类型标记按示例传入
返回:升贴水率(%)。
算法(期货价格-现货价格)/现货价格\*100
年化算法:(期货价格-现货价格)/现货价格*100/(交割日-系统日期)*365
范例
```tsl
// IC00在20230331的年化升贴水率。
SetSysParam(pn_stock(), "IC00");
SetSysParam(pn_date(), 20230403T);
return FuturesPremiumRate(1);
// 结果:-4.9069948819003
```
###### FuturesSpotAmountRatio
用途:获取期现成交金额比。
参数:无(使用 pn_stock/pn_date
返回:期现成交金额比。
算法期货价格成交金额/现货价格成交金额范例
```tsl
// IC00在20230331的期现成交比
SetSysParam(pn_stock(), "IC00");
SetSysParam(pn_date(), 20230403T);
return FuturesSpotAmountRatio();
// 结果0.0914685663852422
```
##### 国债期货可交割债券
###### 内容
- FuturesDeliverBondNum
- FuturesIsDeliverBond
- FuturesConverFactor
- 中间函数
###### FuturesDeliverBondNum
用途:获取可交割债券数量。
参数:无(使用 pn_stock
返回:可交割债券数量。
范例
```tsl
SetSysParam(pn_stock(), "TF2012");
return FuturesDeliverBondNum();
// 结果6
```
###### FuturesIsDeliverBond
用途:判断债券是否可交割。
参数:
- bond_id债券代码
返回是否可交割1/0
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesIsDeliverBond("BK210007");
// 结果1
```
###### FuturesConverFactor
用途:获取可交割债券转换因子。
参数:
- bond_id债券代码
返回:转换因子。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesConverFactor("BK210007");
// 结果1
```
###### 中间函数
####### 内容
- FuturesDeliverBondValue
####### FuturesDeliverBondValue
用途:获取可交割债券相关指标值。
参数:
- bond_id债券代码
返回:指标值。
范例
```tsl
SetSysParam(pn_stock(), 'TF2403');
return FuturesDeliverBondValue("BK210007");
```