# bsv

**Repository Path**: ragnaros27/bsv

## Basic Information

- **Project Name**: bsv
- **Description**: No description available
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2019-12-06
- **Last Updated**: 2024-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

主要功能
-------------
下载国内四大期货交易所历史持仓与成交排名数据。



脚本执行时间
-------------

如果进行每日更新，则更新脚本的启动时间设置在当日下午五点之后，非交易日无数据。



交易所数据区别
----------------

- CFFEX同一交易日所有品种持仓排名数据不在同一个页面呈现，以各自品种分开呈现；
- INE暂无SC品种成交持仓排名数据公布；
- DCE通过下载压缩包并解析txt文件来获取单个交易日数据，但部分交易日压缩包无数据；
- CZCE网页结构不统一，需要区别对待，公布品种级别的汇总数据。



交易所公布标准
--------------

- SHFE
    http://www.shfe.com.cn/statements/decl/911319239.html
- CFFEX
    单边持仓达到1万手以上（含）和当月合约前20名结算会员的成交量、持仓量
- DCE
    根据相关规则，期货品种信息公布活跃月份（双边持仓量大于、等于2万手）合约，期权品种信息公布活跃月份（标的期货合约双边持仓量大于、等于2万手）合约系列 。
- CZCE
    暂无，待补充



变量名称
------------

``交易所`` 

abbr | fullname
:-: | :-: 
SHFE | Shanghai Futures Exchange|
CFFEX | China Financial Futures Exchange|
DCE | Dalian Commodity Exchange|
CZCE | Zhengzhou Commodity Exchange| 

``代码字段`` 

| 代码 |  字段  |
| :--: | :----: |
|  hp  | 持仓量 |
|  v   | 成交量 |
|  b   |  买持  |
|  s   |  卖持  |

``返回字段`` 

| 代码     |      字段      | 格式 |
| :------- | :------------: | ---: |
| tday     |     交易日     |  str |
| ex       |     交易所     |  str |
| code     |    品种代码    |  str |
| product  |    品种中文    |  str |
| contract |    合约代码    |  str |
| symbol   | 成交/买持/卖持 |  str |
| rank     |      排名      |  int |
| member   |    会员单位    |  str |
| value    |    合约手数    |  int |
| Change   |     变化量     |  int |



## 部署运行

1. 创建虚拟环境

   ```bash
   virtualenv venv
   ```

2. 使用豆瓣源，安装python依赖，以windows为例

   ```
   venv\Scripts\activate.bat
   pip install --index-url https://pypi.doubanio.com/simple --trusted-host pypi.doubanio.com bsv
   ```

3. 运行测试代码，如果遇到模块导入问题，可以尝试在venv\Lib\site-packages\目录下新建.pth文件夹，将绝对路径

   ```
   python .\tests\bundle.py print-bsv -s 20210428 -e 20210428 -x DCE
   ```