Initial commit with translated description
This commit is contained in:
207
references/futures_api.md
Normal file
207
references/futures_api.md
Normal file
@@ -0,0 +1,207 @@
|
||||
# Tushare 期货接口文档
|
||||
|
||||
官方文档: https://tushare.pro/document/2?doc_id=134
|
||||
|
||||
## 基础信息接口
|
||||
|
||||
### fut_basic - 期货合约基础信息
|
||||
|
||||
**输入参数**：
|
||||
|
||||
| 名称 | 类型 | 必选 | 描述 |
|
||||
|------|------|------|------|
|
||||
| exchange | str | N | 交易所代码 |
|
||||
| fut_type | str | N | 合约类型 (1: 普通合约 2: 主力合约) |
|
||||
|
||||
**输出字段**：
|
||||
|
||||
| 名称 | 类型 | 描述 |
|
||||
|------|------|------|
|
||||
| ts_code | str | 合约代码 |
|
||||
| symbol | str | 交易标的 |
|
||||
| exchange | str | 交易所 |
|
||||
| name | str | 合约名称 |
|
||||
| fut_code | str | 合约标码 |
|
||||
| multiplier | float | 合约乘数 |
|
||||
| trade_unit | str | 交易单位 |
|
||||
| per_unit | float | 最小变动价位 |
|
||||
| delivery_date | str | 交割日期 |
|
||||
| delist_date | str | 最后交易日期 |
|
||||
| list_date | str | 上市日期 |
|
||||
| last_ddate | str | 最后交割日 |
|
||||
| trade_time_desc | str | 交易时间描述 |
|
||||
|
||||
## 行情接口
|
||||
|
||||
### fut_daily - 期货日线行情
|
||||
|
||||
**输入参数**：
|
||||
|
||||
| 名称 | 类型 | 必选 | 描述 |
|
||||
|------|------|------|------|
|
||||
| trade_date | str | N | 交易日期 |
|
||||
| ts_code | str | N | 合约代码 |
|
||||
| exchange | str | N | 交易所 |
|
||||
| start_date | str | N | 开始日期 |
|
||||
| end_date | str | N | 结束日期 |
|
||||
|
||||
**输出字段**：
|
||||
|
||||
| 名称 | 类型 | 描述 |
|
||||
|------|------|------|
|
||||
| ts_code | str | 合约代码 |
|
||||
| trade_date | str | 交易日期 |
|
||||
| pre_close | float | 昨收盘价 |
|
||||
| pre_settle | float | 昨结算价 |
|
||||
| open | float | 开盘价 |
|
||||
| high | float | 最高价 |
|
||||
| low | float | 最低价 |
|
||||
| close | float | 收盘价 |
|
||||
| settle | float | 结算价 |
|
||||
| change1 | float | 涨跌1（收盘价-昨结算价） |
|
||||
| change2 | float | 涨跌2（结算价-昨结算价） |
|
||||
| vol | float | 成交量（手） |
|
||||
| amount | float | 成交金额（万元） |
|
||||
| oi | float | 持仓量（手） |
|
||||
| oi_chg | float | 持仓量变化 |
|
||||
| exchange | str | 交易所 |
|
||||
|
||||
### fut_holding - 每日持仓排名
|
||||
|
||||
**输入参数**：
|
||||
|
||||
| 名称 | 类型 | 必选 | 描述 |
|
||||
|------|------|------|------|
|
||||
| trade_date | str | N | 交易日期 |
|
||||
| symbol | str | N | 合约代码（不带年份月份） |
|
||||
| exchange | str | N | 交易所 |
|
||||
|
||||
**输出字段**：
|
||||
|
||||
| 名称 | 类型 | 描述 |
|
||||
|------|------|------|
|
||||
| trade_date | str | 交易日期 |
|
||||
| symbol | str | 合约符号 |
|
||||
| broker | str | 期货公司会员 |
|
||||
| vol | int | 成交量 |
|
||||
| vol_chg | int | 成交量变动 |
|
||||
| long_hld | int | 多单持仓 |
|
||||
| long_chg | int | 多单持仓变动 |
|
||||
| short_hld | int | 空单持仓 |
|
||||
| short_chg | int | 空单持仓变动 |
|
||||
| exchange | str | 交易所 |
|
||||
|
||||
### fut_wsr - 期货仓单日报
|
||||
|
||||
**输入参数**：
|
||||
|
||||
| 名称 | 类型 | 必选 | 描述 |
|
||||
|------|------|------|------|
|
||||
| trade_date | str | N | 交易日期 |
|
||||
| symbol | str | N | 合约代码 |
|
||||
| exchange | str | N | 交易所 |
|
||||
|
||||
**输出字段**：
|
||||
|
||||
| 名称 | 类型 | 描述 |
|
||||
|------|------|------|
|
||||
| trade_date | str | 交易日期 |
|
||||
| symbol | str | 合约代码 |
|
||||
| wsr_num | int | 仓单数量 |
|
||||
| wsr_num_chg | int | 仓单数量变化 |
|
||||
| wsr_unit | str | 仓单单位 |
|
||||
| close | float | 收盘价 |
|
||||
| exchange | str | 交易所 |
|
||||
|
||||
### fut_settle - 期货结算参数
|
||||
|
||||
**输入参数**：
|
||||
|
||||
| 名称 | 类型 | 必选 | 描述 |
|
||||
|------|------|------|------|
|
||||
| trade_date | str | N | 交易日期 |
|
||||
| exchange | str | N | 交易所 |
|
||||
|
||||
**输出字段**：
|
||||
|
||||
| 名称 | 类型 | 描述 |
|
||||
|------|------|------|
|
||||
| trade_date | str | 交易日期 |
|
||||
| ts_code | str | 合约代码 |
|
||||
| exchange | str | 交易所 |
|
||||
| settle | float | 结算价 |
|
||||
| trading_fee_rate | float | 交易手续费率 |
|
||||
| trading_fee | float | 交易手续费 |
|
||||
| delivery_fee | float | 交割手续费 |
|
||||
| min_price_chg | float | 最小变动价位 |
|
||||
|
||||
## 期货代码说明
|
||||
|
||||
### 交易所代码
|
||||
|
||||
| 代码 | 交易所 | 主要品种 |
|
||||
|------|--------|----------|
|
||||
| SHFE | 上海期货交易所 | 铜、铝、锌、黄金、原油、螺纹钢 |
|
||||
| DCE | 大连商品交易所 | 豆粕、豆油、铁矿石、焦炭、玉米 |
|
||||
| CZCE | 郑州商品交易所 | 棉花、白糖、PTA、菜粕、甲醇 |
|
||||
| CFFEX | 中国金融期货交易所 | 沪深300、中证500、国债期货 |
|
||||
| INE | 上海国际能源交易中心 | 原油期货 |
|
||||
| GFEX | 广州期货交易所 | 工业硅、碳酸锂 |
|
||||
|
||||
### 常见品种代码
|
||||
|
||||
| 品种 | 代码 | 交易所 |
|
||||
|------|------|--------|
|
||||
| 铜 | CU | SHFE |
|
||||
| 铝 | AL | SHFE |
|
||||
| 锌 | ZN | SHFE |
|
||||
| 黄金 | AU | SHFE |
|
||||
| 白银 | AG | SHFE |
|
||||
| 原油 | SC | INE |
|
||||
| 螺纹钢 | RB | SHFE |
|
||||
| 热轧卷板 | HC | SHFE |
|
||||
| 天然橡胶 | RU | SHFE |
|
||||
| 豆粕 | M | DCE |
|
||||
| 豆油 | Y | DCE |
|
||||
| 棕榈油 | P | DCE |
|
||||
| 铁矿石 | I | DCE |
|
||||
| 焦炭 | J | DCE |
|
||||
| 焦煤 | JM | DCE |
|
||||
| 玉米 | C | DCE |
|
||||
| 棉花 | CF | CZCE |
|
||||
| 白糖 | SR | CZCE |
|
||||
| PTA | TA | CZCE |
|
||||
| 甲醇 | MA | CZCE |
|
||||
| 菜粕 | RM | CZCE |
|
||||
| 玻璃 | FG | CZCE |
|
||||
| 纯碱 | SA | CZCE |
|
||||
| 沪深300指数期货 | IF | CFFEX |
|
||||
| 中证500指数期货 | IC | CFFEX |
|
||||
| 上证50指数期货 | IH | CFFEX |
|
||||
| 10年期国债期货 | T | CFFEX |
|
||||
| 5年期国债期货 | TF | CFFEX |
|
||||
|
||||
### 合约代码格式
|
||||
|
||||
期货合约代码由 **品种代码 + 到期年月** 组成：
|
||||
|
||||
- `CU2403` - 2024年3月到期的铜合约
|
||||
- `RB2405` - 2024年5月到期的螺纹钢合约
|
||||
- `IF2403` - 2024年3月到期的沪深300股指期货
|
||||
|
||||
主力合约通常用 `.SHF`, `.DCE`, `.CZC`, `.CFX` 后缀表示：
|
||||
- `CU.SHF` - 铜主力合约（上期所）
|
||||
- `M.DCE` - 豆粕主力合约（大商所）
|
||||
- `IF.CFX` - 沪深300主力合约（中金所）
|
||||
|
||||
## 交易时间
|
||||
|
||||
### 日盘（上午 + 下午）
|
||||
- 上午：09:00 - 10:15, 10:30 - 11:30
|
||||
- 下午：13:30 - 15:00
|
||||
|
||||
### 夜盘（部分品种）
|
||||
- 21:00 - 23:00（有色金属、黑色系等）
|
||||
- 21:00 - 02:30（原油、贵金属等）
|
||||
|
||||
具体交易时间因品种而异，请参考各交易所规定。
|
||||
Reference in New Issue
Block a user