基本面

基差数据

接口名称

basis

接口描述

基差数据接口

请求参数

参数名	说明	举例
variety	品种编码	RB
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
trans_date	date	查询日期
spot	float	现货价格
basis	float	基差，基差 = 现货价格 - 期货价格
basis_rate	float	基差率，基差率 = (现货价格 - 期货价格) / 现货价格 x 100%

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
basis_df = pro.basis(variety="RB", date="2018-08-08")
print(basis_df)

返回示例

                 basis
trans_date  2018-08-08
spot              4429
basis              193
basis_rate     4.35764

基差数据(按天)

接口名称

basis_all

接口描述

基差数据(按天)接口

请求参数

参数名	说明	举例
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
trans_date	date	查询日期
spot	float	现货价格
basis	float	基差，基差 = 现货价格 - 期货价格
basis_rate	float	基差率，基差率 = (现货价格 - 期货价格) / 现货价格 x 100%

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
basis_all_df = pro.basis_all(date="2018-08-08")
print(basis_all_df)

返回示例

                     A          AL  ...          ZC          ZN
spot              3560       14300  ...         611       21920
basis             -229        -195  ...        -5.8         395
trans_date  2018-08-08  2018-08-08  ...  2018-08-08  2018-08-08
basis_rate   -6.432584   -1.363636  ...   -0.949264    1.802007

期限结构

接口名称

term_structure

接口描述

期限结构接口

请求参数

参数名	说明	举例
variety	品种编码	RB
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
code	string	合约代号
close	float	收盘价

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
term_structure_df = pro.term_structure(variety="RB", date="2018-08-08")
print(term_structure_df)

返回示例

    close    code
0    4200  rb1808
1    4322  rb1809
2    4236  rb1810
3    4191  rb1811
4    4139  rb1812
5    4094  rb1901
6    4017  rb1902
7    3987  rb1903
8    3977  rb1904
9    3918  rb1905
10   3889  rb1906
11   3881  rb1907

库存数据

参数类型一

接口名称

inventory

接口描述

库存数据接口-参数类型一

请求参数

参数名	说明	举例
variety	品种编码	RB
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
trans_date	date	查询日期
vol	float	库存数据量

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
inventory_df = pro.inventory(variety="RB", date="2018-08-08")
print(inventory_df)

返回示例

             inventory
trans_date  2018-08-08
vol             605.76

参数类型二

接口名称

inventory

接口描述

库存数据接口-参数类型二

请求参数

参数名	说明	举例
variety	品种编码	RB
year	查询年份	2019
week_number	该年第几周	10

返回参数

参数名	类型	说明
trans_date	date	查询日期
vol	float	库存数据量

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
inventory_df = pro.inventory(variety="RB", year="2019", week_number="10")
print(inventory_df)

返回示例

             inventory
trans_date  2019-03-07
vol            1326.64

库存数据(天/年)

参数类型一

接口名称

inventory_all

接口描述

库存数据接口(天/年)-参数类型一

请求参数

参数名	说明	举例
date	查询日期	2018-08-10

返回参数

参数名	类型	说明
trans_date	date	查询日期
vol	float	库存数据量

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
inventory_all_df = pro.inventory_all(date="2018-08-10")
print(inventory_all_df)

返回示例

                    CU          AL  ...           L          JM
trans_date  2018-08-10  2018-08-10  ...  2018-08-10  2018-08-10
vol             604762     2059678  ...         399     1919.01

参数类型二

接口名称

inventory_all

接口描述

库存数据接口(天/年)-参数类型二

请求参数

参数名	说明	举例
year	查询年份	2019
week_number	该年第几周	10

返回参数

参数名	类型	说明
trans_date	date	查询日期
vol	float	库存数据量

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
inventory_all_df = pro.inventory_all(year="2019", week_number="10")
print(inventory_all_df)

返回示例

                    CU          AL  ...          FU          JM
trans_date  2019-03-08  2019-03-08  ...  2019-03-07  2019-03-08
vol             401281     1960940  ...      20.334      1961.1

库存数据(最新)

接口名称

inventory_new

接口描述

库存数据-按品种返回最新库存数据

请求参数

参数名	说明	举例
-	-	-

返回参数

参数名	类型	说明
trans_date	date	查询日期
vol	float	库存数据量

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
inventory_new_df = pro.inventory_new()
print(inventory_new_df)

返回示例

                    EG          SS  ...           C           P
trans_date  2023-03-03  2023-03-03  ...  2023-02-22  2023-02-03
vol             106.98     1015318  ...       446.6      102.79

利润数据

接口名称

profit

接口描述

利润数据接口

请求参数

参数名	说明	举例
variety	品种编码	RB
date	查询日期	2018-12-08

返回参数

参数名	类型	说明
trans_date	date	查询日期
profit	float	利润，折盘面价格
profit_rate	float	利润率

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
profit_df = pro.profit(variety="RB", date="2019-12-12")
print(profit_df)

返回示例

                 profit
trans_date   2019-12-12
profit              559
profit_rate       16.58

利润数据(天)

接口名称

profit_all

接口描述

利润数据(天)接口

请求参数

参数名	说明	举例
date	查询日期	2018-12-08

返回参数

参数名	类型	说明
trans_date	date	查询日期
profit	float	利润，折盘面价格
profit_rate	float	利润率

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
profit_all_df = pro.profit_all(date="2019-12-12")
print(profit_all_df)

返回示例

    trans_date profit profit_rate
RB  2019-12-12    559       16.58
HC  2019-12-12    399       11.33

现货贸易商报价

接口名称

trader_prices

接口描述

现货贸易商报价接口

请求参数

参数名	说明	举例
variety	品种编码	RB
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
name	string	品种名称
price	float	贸易商报价
band	string	品牌
model	string	型号、规格
unit	string	单位

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
trader_prices_df = pro.trader_prices(variety="RB", date="2020-03-30")
print(trader_prices_df)

返回示例

  band                      model name  price unit
0   永钢  品种:Ⅲ级螺纹钢;牌号:HRB400;规格:Φ16  螺纹钢   3500  元/吨
1   永钢  品种:Ⅲ级螺纹钢;牌号:HRB400;规格:Φ16  螺纹钢   3440  元/吨
2   永钢  品种:Ⅲ级螺纹钢;牌号:HRB400;规格:Φ16  螺纹钢   3440  元/吨
3   中新  品种:Ⅲ级螺纹钢;牌号:HRB400;规格:Φ16  螺纹钢   3320  元/吨
4   镔鑫  品种:Ⅲ级螺纹钢;牌号:HRB400;规格:Φ16  螺纹钢   3380  元/吨
5   永钢  品种:Ⅲ级螺纹钢;牌号:HRB400;规格:Φ16  螺纹钢   3470  元/吨
6   中天  品种:Ⅲ级螺纹钢;牌号:HRB400;规格:Φ16  螺纹钢   3490  元/吨
7   长达  品种:Ⅲ级螺纹钢;牌号:HRB400;规格:Φ16  螺纹钢   3400  元/吨
8   兴鑫  品种:Ⅲ级螺纹钢;牌号:HRB400;规格:Φ16  螺纹钢   3380  元/吨

现货贸易商报价(天)

接口名称

trader_prices_all

接口描述

现货贸易商报价(天)接口

请求参数

参数名	说明	举例
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
name	string	品种名称
price	float	贸易商报价
band	string	品牌
model	string	型号、规格
unit	string	单位

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
trader_prices_all_df = pro.trader_prices_all(date="2020-03-30")
print(trader_prices_all_df)

返回示例

      name   price  band          model unit
0     石油焦   780.0  东明石化         级别:合格品  元/吨
1     石油焦  1450.0  京博石化         级别:合格品  元/吨
2     石油焦  1000.0  华星集团         级别:合格品  元/吨
3     石油焦  1100.0  垦利石化         级别:合格品  元/吨
4     石油焦  1580.0  富宇化工         级别:合格品  元/吨
   ...     ...   ...            ...  ...
1002   废钢  2370.0  江西萍钢  品种:重废;厚度:≥6mm  元/吨
1003   废钢  2440.0  济钢闽源  品种:重废;厚度:≥6mm  元/吨
1004   废钢  2460.0  浙江元立  品种:重废;厚度:≥6mm  元/吨
1005   废钢  2550.0   粤裕丰  品种:重废;厚度:≥6mm  元/吨
1006   废钢  2490.0  福建三钢  品种:重废;厚度:≥6mm  元/吨

跨期套利数据

接口名称

intertemporal_arbitrage

接口描述

跨期套利数据接口

请求参数

参数名	说明	举例
variety	品种编码	RB
code1	合约月份1	01
code2	合约月份2	05
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
trans_date	date	查询日期
code1	string	合约1
code2	string	合约2
close1	float	合约1价格
close2	float	合约2价格
spread	float	价差，合约1价格 - 合约2价格

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
intertemporal_arbitrage_df = pro.intertemporal_arbitrage(variety="RB", code1="01", code2="05", date="2018-08-08")
print(intertemporal_arbitrage_df)

返回示例

           intertemporal_arbitrage
trans_date              2018-08-08
code1                       rb1901
code2                       rb1905
close1                        4109
close2                        3930
spread                         179

自由价差数据

接口名称

free_spread

接口描述

自由价差数据接口

请求参数

参数名	说明	举例
variety1	品种编码1	RB
code1	合约月份1	01
variety2	品种编码2	HC
code2	合约月份2	01
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
trans_date	string	查询日期
code1	string	合约代号1
code2	string	合约代号2
code1_close	float	合约1价格
code2_close	float	合约2价格
spread	float	价差，合约1价格 - 合约2价格

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
free_spread_df = pro.free_spread(variety1="RB", code1="01", variety2="HC", code2="01", date="2018-08-08")
print(free_spread_df)

返回示例

            free_spread
trans_date   2018-08-08
code1            rb1901
code2            hc1901
code1_close        4094
code2_close        4100
spread               -6

自由价比数据

接口名称

free_ratio

接口描述

自由价比数据接口

请求参数

参数名	说明	举例
variety1	品种编码1	RB
code1	合约月份1	01
variety2	品种编码2	HC
code2	合约月份2	01
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
trans_date	string	查询日期
code1	string	合约代号1
code2	string	合约代号2
code1_close	float	合约1价格
code2_close	float	合约2价格
ratio	float	价比，合约1价格 / 合约2价格

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
free_ratio_df = pro.free_ratio(variety1="RB", code1="01", variety2="HC", code2="01", date="2018-08-08")
print(free_ratio_df)

返回示例

             free_ratio
trans_date   2018-08-08
code1            rb1901
code2            hc1901
code1_close        4094
code2_close        4100
ratio          0.998537

仓单数据

接口名称

warehouse_receipt

接口描述

仓单数据接口

请求参数

参数名	说明	举例
variety	品种编码	RB
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
trans_date	date	查询日期
total_vol	float	仓单数据
total_chge	float	仓单变化量

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
warehouse_receipt_df = pro.warehouse_receipt(variety="RB", date="2018-08-08")
print(warehouse_receipt_df)

返回示例

           warehouse_receipt
trans_date        2018-08-08
total_vol               3856
total_chge                 0

仓单汇总数据

接口名称

warehouse_receipt

接口描述

仓单汇总数据接口

请求参数

参数名	说明	举例
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
symbol	string	品种编码
total_vol	float	仓单数据
total_chge	float	仓单变化量

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
warehouse_receipt_sum_df = pro.warehouse_receipt(date="2018-08-08")
print(warehouse_receipt_sum_df)

返回示例

   symbol  total_chge  total_vol
0      RB           0       3856
1       J           0         10
2      HC           0        310
3      CF          39       9905
4      FG           0       1378
5      OI           0       4323
6      RM           0        200
7      SF           0        594
8      SR         402      37828
9      TA       -1009      11795
10     CU       -1658      79843
11     AL        1446     731544
12     ZN        -125       6950
13     PB         -25       7697
14     NI           0      15215
15     SN          29       5823
16     AU           0       1530
17     AG        1292    1394784
18     BU           0     128970
19     RU         720     491780
20      A           0      32586
21      C           0      37968
22     JD          -3          0
23      L           0        284
24      M           0       6543
25     PP           0        765
26      V           0        180
27      Y           0      33215
28     WH           0        414

虚实盘比数据

接口名称

virtual_real

接口描述

虚实盘比数据接口

请求参数

参数名	说明	举例
variety	品种编码	RB
code	合约月份	10
date	查询日期	2018-08-08

返回参数

参数名	类型	说明
trans_date	date	查询日期
code	string	合约代号
virtual	float	虚盘量
real	float	实盘量
rate	float	虚实盘比

示例代码

from qhsdk import pro_api
pro = pro_api(token="在此处输入您的token，可以通过联系管理员获取")
virtual_real_df = pro.virtual_real(variety="RB", code="10", date="2018-08-08")
print(virtual_real_df)

返回示例

           virtual_real
trans_date   2018-08-08
code             rb1810
virtual         1080026
real              385.6
rate             2800.9