期货
get_future_exchanges 获取期货交易所列表
QuoteClient.get_future_exchanges(sec_type=SecurityType.FUT, lang=None)
说明
获取期货交易所列表
请求频率
频率限制请参考:接口请求限制
参数
参量名 | 类型 | 描述 |
---|---|---|
sec_type | SecurityType | 使用 tigeropen.common.consts.SecurityType 下的枚举,默认 SecurityType.FUT,FUT表示期货,FOP表示期货期权 |
返回
pandas.DataFrame
结构如下:
COLUMN | 类型 | 描述 |
---|---|---|
code | str | 交易所代码 |
name | str | 交易所名称 |
zone | str | 交易所所在时区 |
示例
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.tiger_open_config import get_client_config
client_config = get_client_config(private_key_path='私钥路径', tiger_id='your tiger id', account='your account')
quote_client = QuoteClient(client_config)
exchanges = quote_client.get_future_exchanges()
# 打印第一个交易所的代码,名称,时区
exchange1 = exchanges.iloc[0]
print(f'code: {exchange1.code}, name: {exchange1.name}, zone: {exchange1.zone}')
返回示例
code name zone
0 CME 芝加哥商品交易所 America/Chicago
1 NYMEX 纽约商业交易所 America/New_York
2 COMEX 纽约商品交易所 America/New_York
3 SGX 新加坡交易所 Singapore
4 HKEX 香港交易所 Asia/Hong_Kong
5 CBOT 芝加哥期货交易所 America/Chicago
6 CBOEXBT 芝加哥期权交易所 America/Chicago
7 CMEBTC 芝加哥期货交易所 America/Chicago
8 OSE 大阪交易所 Asia/Tokyo
9 CBOE 芝加哥期權交易所 America/Chicago
get_future_contracts 获取交易所下的可交易合约
QuoteClient.get_future_contracts(exchange, lang=None)
说明
获取交易所下的可交易合约
遇到第一通知日、最后交易日如何处理:不管是进入第一通知日还是最后结算日后,主要交易月份都会转移到次月合约,使得将到期月份的流动性变差,因此建议不管是多单还是空单,在第一通知日前与最后交易日临近前,转仓或交易次月合约。
请求频率
频率限制请参考:接口请求限制
参数
参量名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
exchange | str | Yes | 交易所代码,如 'CBOE' |
返回
pandas.DataFrame
结构如下:
COLUMN | 类型 | 描述 |
---|---|---|
contract_code | str | 合约代码,如 VIX2208 |
type | str | 期货合约对应的交易品种,如 CL |
symbol | str | 对应的IB代码 |
name | str | 期货合约的名称 |
contract_month | str | 合约交割月份,如 202208,表示2022年8月 |
currency | str | 交易的货币类型 |
first_notice_date | str | 第一通知日,指实物交割合约可以进行实物交割的日期,合约在第一通知日后无法开多仓。已有的多仓会在第一通知日之前(通常为前三个交易日)会被强制平仓。非实物交割合约(如指数合约)该字段为空 |
last_bidding_close_time | str | 竞价截止时间 |
last_trading_date | str | 指合约到期月份最后交易的日期,最后交易日后尚未清算的期货合约,须通过相关『现货商品』或『现金结算』方式平仓,目前大部分期货商品最后交易日通常就是结算日。有些商品第一通知日跟最后交易日是同一天,如欧元 对于现金交割的期货只要没过最后交易时间都可以正常开仓,非现金交割的期货是按照最后交易时间和第一通知日其中较小者,在其前三个交易日开始就限制开仓 |
trade | bool | 是否可交易 |
continuous | bool | 是否为连续合约 |
multiplier | float | 合约乘数,期货价格乘以合约乘数后,才是合约的面值,可以根据实物价格除上合约乘数,估算期货的合理价格 |
min_tick | float | 期货价格变动的最小报价单位,比如当前期货价格为 2000,minTick为100,则正确的报价包括 2100,2200,而 2005不满足要求 |
示例
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.tiger_open_config import get_client_config
client_config = get_client_config(private_key_path='私钥路径', tiger_id='your tiger id', account='your account')
quote_client = QuoteClient(client_config)
contracts = quote_client.get_future_contracts('CME')
# 将合约代码设置为pandas DataFrame 索引,并查询字段
contract_nq2309 = contracts.set_index('contract_code').loc['NQ2309']
print(contract_nq2309.name) # 合约名称
print(contract_nq2309.multiplier) # 合约乘数
print(contract_nq2309.last_trading_date) # 最后交易日
返回示例
contract_code symbol type name contract_month multiplier exchange \
0 MXP1912 MXP MXP 比索1912 201912 500000.0 GLOBEX
1 MXP1909 MXP MXP 比索1909 201909 500000.0 GLOBEX
2 MEUR1909 M6E MEUR 微欧元1909 201909 12500.0 GLOBEX
3 ES1909 ES ES SP500指数1909 201909 50.0 GLOBEX
4 ES2003 ES ES SP500指数2003 202003 50.0 GLOBEX
currency first_notice_date last_bidding_close_time last_trading_date trade \
0 USD None None 20191216 True
1 USD None None 20190916 True
2 USD None None 20190916 True
3 USD None None 20190920 True
4 USD None None 20200320 True
continuous
0 False
1 False
2 False
3 False
4 False
get_future_contract 根据代码获取期货合约
说明
根据代码获取期货合约
请求频率
频率限制请参考:接口请求限制
参数
参量名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
contract_code | str | Yes | 期货合约对应的代码,如 CL2206 |
返回
pandas.DataFrame
结构如下:
COLUMN | 类型 | 描述 |
---|---|---|
contract_code | 合约代码,如 CL2112 | |
type | str | 期货合约对应的交易品种, 如 CL |
name | str | 期货合约的名称 |
contract_month | str | 合约交割月分,如 202112,表示2021年12月交割 |
currency | str | 交易的货币 |
first_notice_date | str | 第一通知日,指实物交割合约可以进行实物交割的日期,合约在第一通知日后无法开多仓。已有的多仓会在第一通知日之前(通常为前三个交易日)会被强制平仓。非实物交割合约(如指数合约)该字段为空 |
last_bidding_close_time | str | 竞价截止时间 |
last_trading_date | str | 指合约到期月份最后交易的日期,最后交易日后尚未清算的期货合约,须通过相关『现货商品』或『现金结算』方式平仓,目前大部分期货商品最后交易日通常就是结算日。有些商品第一通知日跟最后交易日是同一天,如欧元 对于现金交割的期货只要没过最后交易时间都可以正常开仓,非现金交割的期货是按照最后交易时间和第一通知日其中较小者,在其前三个交易日开始就限制开仓 |
trade | bool | 是否可交易 |
continuous | bool | 是否为连续合约 |
multiplier | float | 合约乘数,期货价格乘以合约乘数后,才是合约的面值,可以根据实物价格除上合约乘数,估算期货的合理价格 |
min_tick | float | 期货价格变动的最小报价单位,比如当前期货价格为 2000,minTick为100,则正确的报价包括 2100,2200,而 2005不满足要求 |
示例
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.tiger_open_config import get_client_config
client_config = get_client_config(private_key_path='私钥路径', tiger_id='your tiger id', account='your account')
quote_client = QuoteClient(client_config)
contract = quote_client.get_future_contract('VIX2206')
print(contract)
返回示例
contract_code symbol type name contract_month multiplier exchange currency first_notice_date last_bidding_close_time last_trading_date trade continuous min_tick
0 VIX2206 VIX VIX VIX波动率2206 202206 1000.0 CBOE USD None None 20220615 True False 0.05
get_current_future_contract 查询指定品种的当前合约
QuoteClient.get_current_future_contract(future_type, lang=None)
说明
查询指定品种的当前合约,即合约主连
请求频率
频率限制请参考:接口请求限制
参数
参量名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
future_type | str | Yes | 期货合约对应的交易品种,如 CL |
返回
pandas.DataFrame
结构如下:
COLUMN | 类型 | 描述 |
---|---|---|
contract_code | 合约代码,如 CL2112 | |
type | str | 期货合约对应的交易品种, 如 CL |
name | str | 期货合约的名称 |
contract_month | str | 合约交割月分,如 202112,表示2021年12月交割 |
currency | str | 交易的货币 |
first_notice_date | str | 第一通知日,指实物交割合约可以进行实物交割的日期,合约在第一通知日后无法开多仓。已有的多仓会在第一通知日之前(通常为前三个交易日)会被强制平仓。非实物交割合约(如指数合约)该字段为空 |
last_bidding_close_time | str | 竞价截止时间 |
last_trading_date | str | 指合约到期月份最后交易的日期,最后交易日后尚未清算的期货合约,须通过相关『现货商品』或『现金结算』方式平仓,目前大部分期货商品最后交易日通常就是结算日。有些商品第一通知日跟最后交易日是同一天,如欧元 对于现金交割的期货只要没过最后交易时间都可以正常开仓,非现金交割的期货是按照最后交易时间和第一通知日其中较小者,在其前三个交易日开始就限制开仓 |
trade | bool | 是否可交易 |
continuous | bool | 是否为连续合约 |
multiplier | float | 合约乘数,期货价格乘以合约乘数后,才是合约的面值,可以根据实物价格除上合约乘数,估算期货的合理价格 |
min_tick | float | 期货价格变动的最小报价单位,比如当前期货价格为 2000,minTick为100,则正确的报价包括 2100,2200,而 2005不满足要求 |
示例
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.tiger_open_config import get_client_config
client_config = get_client_config(private_key_path='私钥路径', tiger_id='your tiger id', account='your account')
quote_client = QuoteClient(client_config)
contracts = quote_client.get_current_future_contract('ES')
返回示例
contract_code type name contract_month currency first_notice_date \
0 ES1903 ES SP500指数1903 201903 USD 20190315
last_bidding_close_time last_trading_date trade continuous
0 0 20190315 True False
get_all_future_contracts 查询指定品种全部合约
QuoteClient.get_all_future_contracts(future_type, lang=None)
说明
查询指定品种的所有合约
请求频率
频率限制请参考:接口请求限制
参数
参量名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
future_type | str | Yes | 期货合约对应的交易品种,如 CL |
返回
pandas.DataFrame
结构如下:
COLUMN | 类型 | 描述 |
---|---|---|
contract_code | 合约代码,如 CL2112 | |
type | str | 期货合约对应的交易品种, 如 CL |
name | str | 期货合约的名称 |
contract_month | str | 合约交割月分,如 202112,表示2021年12月交割 |
currency | str | 交易的货币 |
first_notice_date | str | 第一通知日,指实物交割合约可以进行实物交割的日期,合约在第一通知日后无法开多仓。已有的多仓会在第一通知日之前(通常为前三个交易日)会被强制平仓。非实物交割合约(如指数合约)该字段为空 |
last_bidding_close_time | str | 竞价截止时间 |
last_trading_date | str | 指合约到期月份最后交易的日期,最后交易日后尚未清算的期货合约,须通过相关『现货商品』或『现金结算』方式平仓,目前大部分期货商品最后交易日通常就是结算日。有些商品第一通知日跟最后交易日是同一天,如欧元 对于现金交割的期货只要没过最后交易时间都可以正常开仓,非现金交割的期货是按照最后交易时间和第一通知日其中较小者,在其前三个交易日开始就限制开仓 |
trade | bool | 是否可交易 |
continuous | bool | 是否为连续合约 |
multiplier | float | 合约乘数,期货价格乘以合约乘数后,才是合约的面值,可以根据实物价格除上合约乘数,估算期货的合理价格 |
min_tick | float | 期货价格变动的最小报价单位,比如当前期货价格为 2000,minTick为100,则正确的报价包括 2100,2200,而 2005不满足要求 |
示例
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.tiger_open_config import get_client_config
client_config = get_client_config(private_key_path='private key path', tiger_id='your tiger id', account='your account')
quote_client = QuoteClient(client_config)
contracts = quote_client.get_all_future_contracts('CL')
返回示例
contract_code symbol type name contract_month multiplier exchange exchange_code currency first_notice_date last_bidding_close_time last_trading_date trade continuous min_tick
0 CL2304 CL CL WTI原油2304 202304 1000.0 NYMEX NYMEX USD 20230323 None 20230321 True False 0.01
1 CL2305 CL CL WTI原油2305 202305 1000.0 NYMEX NYMEX USD 20230424 None 20230420 True False 0.01
2 CL2306 CL CL WTI原油2306 202306 1000.0 NYMEX NYMEX USD 20230524 None 20230522 True False 0.01
3 CL2307 CL CL WTI原油2307 202307 1000.0 NYMEX NYMEX USD 20230622 None 20230620 True False 0.01
4 CL2308 CL CL WTI原油2308 202308 1000.0 NYMEX NYMEX USD 20230724 None 20230720 True False 0.01
5 CL2309 CL CL WTI原油2309 202309 1000.0 NYMEX NYMEX USD 20230824 None 20230822 True False 0.01
6 CL2310 CL CL WTI原油2310 202310 1000.0 NYMEX NYMEX USD 20230922 ```
get_future_trading_times 查询指定合约的交易时间
get_future_trading_times(contract_code, trading_date=None)
说明
查询指定合约的交易时间
请求频率
频率限制请参考:接口请求限制
参数
参量名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
contract_code | str | Yes | 合约代码,如CL1901 |
trading_date | int | Yes | 指定交易日的毫秒单位时间戳,如 1643346000000 |
返回
pandas.DataFrame
结构如下:
COLUMN | 类型 | 描述 |
---|---|---|
start | int | 交易开始时间 |
end | int | 交易结束时间 |
trading | bool | 是否为连续交易 |
bidding | bool | 是否为竞价交易 |
zone | str | 时区 |
示例
import pandas as pd
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.tiger_open_config import get_client_config
client_config = get_client_config(private_key_path='私钥路径', tiger_id='your tiger id', account='your account')
quote_client = QuoteClient(client_config)
times = quote_client.get_future_trading_times('CN1901', trading_date=1545049282852)
# 转换 start、end 的格式
times['zone_start'] = pd.to_datetime(times['start'], unit='ms').dt.tz_localize('UTC').dt.tz_convert(times['zone'][0])
times['zone_end'] = pd.to_datetime(times['end'], unit='ms').dt.tz_localize('UTC').dt.tz_convert(times['zone'][0])
返回示例
start end trading bidding zone
0 1545036600000 1545037200000 False True Singapore
1 1545093900000 1545094800000 False True Singapore
2 1545121800000 1545122100000 False True Singapore
3 1545037200000 1545079500000 True False Singapore
4 1545094800000 1545121800000 True False Singapore
get_future_bars 获取期货K线
QuoteClient.get_future_bars(identifiers, period=BarPeriod.DAY, begin_time=-1, end_time=-1, limit=1000)
说明
提供了热门合约近10年的日级别K线数据,以及全部合约2017年8月至今的分钟级数据。
返回结果是从endTime开始按时间倒序的数据集合。
对于1分钟K线,如果在这1分钟内没有成交,这一分钟K线数据会空缺;在最近的这一分钟内有成交后接口才能拉取到这1分钟的K线数据,如果在第50秒时产生第一笔交易,在50秒之前拉取不到最新点的数据。
请求频率
频率限制请参考:接口请求限制
参数
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
identifiers | list | Yes | 期货代码列表 |
begin_time | int | No | 开始时间,毫秒时间戳,查询结果包含该时间点,默认为:-1,begin_time和end_time默认都传-1时,会按照limit设置的条数返回 |
end_time | int | No | 截至时间, 毫秒时间戳,查询结果不包含该时间点,默认为:-1 |
period | BarPeriod | No | 获取的K线周期。默认 BarPeriod.DAY,可以使用 tigeropen.common.consts.BarPeriod 下提供的枚举常量,如 BarPeriod.DAY。 'day'/'week'/'month'/'year'/'1min'/'5min'/'15min'/'30min'/'60min' |
limit | int | No | 请求条数限制,默认1000,最大限制:1000 |
page_token | str | No | 分页token,记录分页的位置,上次请求返回的 next_page_token 可传入作为下次请求的起始标志,使用pageToken分页拉取数据时其他查询条件不能改变 |
返回pandas.DataFrame
各column 含义如下:
COLUMN | 类型 | 描述 |
---|---|---|
identifier | str | 期货合约代码 |
time | int | Bar对应的时间戳, 即Bar的结束时间。Bar的切割方式与交易所一致,以CN1901举例,T日的17:00至T+1日的16:30的数据会被合成一个日级Bar。 |
latest_time | int | Bar 最后的更新时间 |
open | float | 开盘价 |
high | float | 最高价 |
low | float | 最低价 |
close | float | 收盘价 |
settlement | float | 结算价,在未生成结算价时返回0 |
volume | int | 成交量 |
open_interest | int | 未平仓合约数量 |
next_page_token | str | 下一页的page token |
示例
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.tiger_open_config import get_client_config
client_config = get_client_config(private_key_path='私钥路径', tiger_id='your tiger id', account='your account')
quote_client = QuoteClient(client_config)
bars = quote_client.get_future_bars(['CN1901', 'MXP1903'],
begin_time=-1,
end_time=1545105097358)
print(bars)
# 打印 open 的值
print(bars['open'])
# 打印第一行 open 的值
print(bars['open'].loc[0])
** 返回示例 **
identifier time latest_time open high low close \
0 CN1901 1545035400000 1545035700002 11022.5 11097.5 109350 10940.0
1 CN1901 1544776200000 1544776168000 11182.5 11197.5 110025 11030.0
2 CN1901 1544689800000 1544689765000 11012.5 11252.5 110125 11212.5
3 CN1901 1544603400000 1544603321185 10940.0 11070.0 109400 11035.0
4 CN1901 1544517000000 1544516945000 10895.0 10962.5 108150 10942.5
settlement volume open_interest
0 10935.0 3872 15148
1 11042.5 1379 14895
2 11202.5 4586 12870
3 11032.5 3514 12237
4 10927.5 2378 10575
get_future_bar_by_page 分页获取期货K线
QuoteClient.get_future_bars_by_page(identifier, period=BarPeriod.DAY, begin_time=-1, end_time=-1, total=10000, page_size=1000, time_interval=2)
说明
获取期货K线
请求频率
频率限制请参考:接口请求限制
参数
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
identifier | str | Yes | 期货代码, 每次只能查单个标的 |
period | BarPeriod | No | 获取的K线周期。默认 BarPeriod.DAY,可以使用 tigeropen.common.consts.BarPeriod 下提供的枚举常量,如 BarPeriod.DAY。 'day'/'week'/'month'/'year'/'1min'/'5min'/'15min'/'30min'/'60min' |
begin_time | int | No | 开始时间,毫秒时间戳,查询结果包含该时间点,默认:-1,begin_time和end_time默认都传-1时,会按照limit设置的条数返回 |
end_time | int | No | 截至时间, 毫秒时间戳,查询结果不包含该时间点,默认:-1 |
total | int | No | 请求bar的总数,默认是:10000 |
page_size | int | No | 每页bar的数量,默认是:1000 |
time_interval | int | No | 每次请求的时间间隔,单位秒,默认是:2秒 |
返回pandas.DataFrame
各column 含义如下:
COLUMN | 类型 | 描述 |
---|---|---|
identifier | str | 期货合约代码 |
time | int | Bar对应的时间戳, 即Bar的结束时间。Bar的切割方式与交易所一致,以CN1901举例,T日的17:00至T+1日的16:30的数据会被合成一个日级Bar。 |
latest_time | int | Bar 最后的更新时间 |
open | float | 开盘价 |
high | float | 最高价 |
low | float | 最低价 |
close | float | 收盘价 |
settlement | float | 结算价,在未生成结算价时返回0 |
volume | int | 成交量 |
open_interest | int | 未平仓合约数量 |
next_page_token | str | 下一页的page token |
示例
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.tiger_open_config import get_client_config
client_config = get_client_config(private_key_path='私钥路径', tiger_id='your tiger id', account='your account')
quote_client = QuoteClient(client_config)
bars = quote_client.get_future_bars_by_page('CLmain',
end_time=1648526400000,
total=10,
page_size=4)
print(bars.head())
** 返回示例 **
identifier time latest_time open high low close settlement volume open_interest next_page_token
0 CLmain 1647378000000 1647377999000 102.28 102.58 93.53 95.18 96.44 297127 141240 ZnV0dXJlX2tsaW5lfENMbWFpbnxkYXl8MTY0ODUyNjQwMD...
1 CLmain 1647464400000 1647464399000 95.23 99.22 94.07 95.36 95.04 220577 119614 ZnV0dXJlX2tsaW5lfENMbWFpbnxkYXl8MTY0ODUyNjQwMD...
2 CLmain 1647550800000 1647550797000 95.34 104.24 94.85 103.62 102.98 129667 97283 ZnV0dXJlX2tsaW5lfENMbWFpbnxkYXl8MTY0ODUyNjQwMD...
3 CLmain 1647637200000 1647637192000 103.62 106.28 102.30 105.10 104.70 32312 280113 ZnV0dXJlX2tsaW5lfENMbWFpbnxkYXl8MTY0ODUyNjQwMD...
4 CLmain 1647896400000 1647896399000 103.62 111.08 102.47 110.93 109.97 187356 280043 ZnV0dXJlX2tsaW5lfENMbWFpbnxkYXl8MTY0ODUyNjQwMD...
5 CLmain 1647982800000 1647982795000 110.91 113.35 107.10 108.75 109.27 253043 293664 ZnV0dXJlX2tsaW5lfENMbWFpbnxkYXl8MTY0ODUyNjQwMD...
6 CLmain 1648069200000 1648069197000 108.85 115.40 108.38 114.35 114.93 224802 294597 ZnV0dXJlX2tsaW5lfENMbWFpbnxkYXl8MTY0ODUyNjQwMD...
7 CLmain 1648155600000 1648155599000 114.47 116.64 110.61 111.27 112.34 240864 292211 ZnV0dXJlX2tsaW5lfENMbWFpbnxkYXl8MTY0ODUyNjQwMD...
8 CLmain 1648242000000 1648241998000 111.75 114.12 108.68 112.60 113.90 253610 282247 ZnV0dXJlX2tsaW5lfENMbWFpbnxkYXl8MTY0ODUyNjQwMD...
9 CLmain 1648501200000 1648501199000 112.92 112.93 102.83 103.49 105.96 298655 282016 ZnV0dXJlX2tsaW5lfENMbWFpbnxkYXl8MTY0ODUyNjQwMD...
get_future_trade_ticks 获取期货逐笔成交
`` QuoteClient.get_future_trade_ticks(identifier, begin_index=0, end_index=30, limit=1000) `
说明
获取期货逐笔成交
请求频率
频率限制请参考:接口请求限制
参数
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
identifier | str | Yes | 期货代码 |
begin_index | int | Yes | 起始索引 |
end_index | int | Yes | 结束索引 |
limit | int | No | 返回条数限制,最多支持返回1000条逐笔记录 |
返回
pandas.DataFrame
各 column 含义如下:
参数名 | 类型 | 描述 |
---|---|---|
index | int | 索引值 |
time | int | 成交时间,精确到毫秒的时间戳 |
price | float | 成交价格 |
volume | int | 成交量 |
示例
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.tiger_open_config import get_client_config
client_config = get_client_config(private_key_path='私钥路径', tiger_id='your tiger id', account='your account')
quote_client = QuoteClient(client_config)
ticks = quote_client.get_future_trade_ticks('CN1901')
print(ticks)
返回示例
identifier index time price volume
0 CN1901 0 1547456400000 10607.50000 5
1 CN1901 1 1547456402000 10605.00000 6
2 CN1901 2 1547456407000 10602.50000 4
3 CN1901 3 1547456407000 10605.00000 2
4 CN1901 4 1547456424000 10602.50000 5
get_future_brief 获取期货最新行情
QuoteClient.get_future_brief(identifiers)
说明
获取期货最新行情,包括盘口数据,最新成交数据等
请求频率
频率限制请参考:接口请求限制
参数
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
identifiers | Yes | 期货代码列表,如 ['CL2201'] |
返回
pandas.DataFrame
各 column 含义如下:
COLUMN | 类型 | 描述 |
---|---|---|
identifier | str | 期货代码 |
ask_price | float | 卖价 |
ask_size | int | 卖量 |
bid_price | float | 买价 |
bid_size | int | 买量 |
pre_close | float | 前收价 |
latest_price | float | 最新价 |
latest_size | int | 最新成交量 |
latest_time | int | 最新价成交时间 |
volume | int | 当日累计成交手数 |
open_interest | int | 未平仓合约数量 |
open | float | 开盘价 |
high | float | 最高价 |
low | float | 最低价 |
limit_up | float | 涨停价 |
limit_down | float | 跌停价 |
示例
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.tiger_open_config import get_client_config
client_config = get_client_config(private_key_path='私钥路径', tiger_id='your tiger id', account='your account')
quote_client = QuoteClient(client_config)
briefs = quote_client.get_future_brief(['CN1901', 'MXP1903'])
print(briefs)
返回示例
identifier ask_price ask_size bid_price bid_size pre_close \
0 CN1901 10677.50000 13 10675.00000 145 None
1 MXP1903 0.05219 9 0.05218 3 None
latest_price latest_size latest_time volume open_interest \
0 10677.50000 2 1547519736000 111642 863308
1 0.05219 4 1547519636000 1706 190126
open high low limit_up limit_down
0 10607.50000 10707.50000 10572.50000 11670.0000 9550.0000
1 0.05223 0.05223 0.05216 0.0562 0.0482