chapaty v0.1.0

Chapaty 是开源软件，用于在不同的市场上回测交易策略。您在 chapaty-ai 上的交易结果由该库计算。要使用此库，您需要提供自己的数据，并遵循以下历史数据的约定。

数据提供者和市场

目前支持以下数据提供者和市场。某些市场的历史市场数据可以追溯到2006年。

盈亏报告

当回测您的机器人时，Chapaty 将生成以下形式的盈亏报告。

性能报告

除了盈亏报告外，Chapaty 还会生成以下形式的性能报告。

交易分解报告

在Excel中打开数据

报告是简单的 .csv 文件，其中

• 列用逗号 , 分隔
• 浮点数使用小数点 .

如果您想用Excel打开一个报告，但没有得到格式良好的文件，请尝试以下步骤

1. 在简单的文本编辑器中打开 .csv 文件
2. 将所有 , 替换为 ;
3. 将所有 . 替换为 ,
4. 保存文件
5. 再次在Excel中打开文件

目录布局

所有数据都存储在Google Cloud Storage存储桶中。有两个存储桶。我们用一个存储桶来存储历史市场数据。我们有一个第二个存储桶来缓存计算结果以减少评估历史市场数据上机器人所需的时间。

历史市场数据

我们使用以下目录布局。这是为了说明目的，因为Google Cloud Storage没有文件夹或子文件夹。数据存储在 .csv 中，在 "bucket"/{provider}/{aggTrades | ohlc-{ts} | ...} 目录中。文件遵循严格的命名约定。

.
├── {provider}              # binance / cme / ...
    ├── aggTrades/         
    │   ├── {market}-aggTrades-{year}[-{month?}-{day?}].csv
    │   ├── btcusdt-aggTrades-2023-01.csv
    │   ├── ...        
    ├── ohlc/               # For ts in { 1w | 1d | 12h | 8h | 6h | 4h | 3h | 2h | 1h | 30m | 15m | 5m | 1m | 30s | 15s | 1s }
    │   ├── {market}-{ts}-{year}[-{month?}-{day?}].csv
    │   ├── btcusdt-1m-2023-01.csv
    │   ├── ...
    ├── ohlcv/              # For ts in { 1w | 1d | 12h | 8h | 6h | 4h | 3h | 2h | 1h | 30m | 15m | 5m | 1m | 30s | 15s | 1s }
    │   ├── {market}-{ts}-{year}[-{month?}-{day?}].csv
    │   ├── btcusdt-1m-2023-01.csv
    │   ├── ...
    ├── tick/               
        ├── {market}-tick-{year}[-{month?}-{day?}].csv
        ├── btcusdt-tick-2023-01.csv
        ├── ...

缓存数据

缓存数据存储在单独的存储桶中，遵循此目录布局。

.
├── {strategy}                              # ppp / magneto / postNews / ...
    ├── {market}                            # 6e / btcusdt / ...
        ├── {year}                          # 2023 / 2022 / ...
            ├── {time_interval}             # none / TimeFrame::to_string()
                ├── {time_frame}            # { 1w | 1d | 12h | 8h | 6h | 4h | 3h | 2h | 1h | 30m | 15m | 5m }
                    ├── aggTrades.csv       # Output of processed `.csv` files
                    ├── ohlc-{ts}.csv       # Output of processed `.csv` files
                    ├── ohlcv-{ts}.csv      # Output of processed `.csv` files
                    ├── tick.csv            # Output of processed `.csv` files
                    ├── tpo-{ts}.csv        # Output of processed `.csv` files
                    ├── vol-tick.csv        # Contains volume profile, which is computed by tick data
                    ├── vol-aggTrades.csv   # Contains volume profile, which is computed by aggTrades data
                    ├── ...

测试数据

我们维护一个额外的存储桶用于测试数据。目录布局与上述相同，有一个特殊的目录 ohter。

.
├── {...directory layout}
│
├── other                   # Special only directory
    ├── test_file1.csv      # Test files for unit tests
    ├── test_file2.csv      # ...
    ├── ...
    ├── gcp/                # Contains test files for the `gcp` module
    ├── market_profile/     # Contains test files for the `market_profile` module
    ├── ppp/                # Contains test files for the `ppp` module
    └── ...                 # etc.

从GCP下载

要从Google Cloud Platform下载多个文件，请按照以下步骤操作。

1. 打开gsutil命令行工具
2. 粘贴命令，例如 gsutil cp -r gs://bucket/folder .
3. 运行 $ zip - folder.zip folder/ 以压缩您的文件
4. 在gsutil命令行工具菜单中点击右上角带有三个点的按钮
5. 选择下载
6. 将您想下载的文件名 folder.zip 添加到文件路径