このページでは、bitFlyer(ビットフライヤー)の取引履歴ファイルの取得方法を紹介します。
【ファイルのダウンロードがお済みの方】
ダウンロードしたファイルをクリプタクトにアップロードする際、取引日時の古い順にファイルをアップロードください。詳細は以下のヘルプページをご確認ください。
目次
1．取引履歴の自動対応状況
クリプタクトが対応しているファイルの種類は、『対応取引所・ブロックチェーン』の画面からご確認いただけます。（該当の取引所をクリックください）
詳細な取引種類の対応状況については、以下のヘルプページをご確認ください。
bitFlyer（ビットフライヤー）の履歴の対応状況
本ヘルプページの方法でダウンロードしたファイルに記載があり、クリプタクト（第三者）側でどのような取引内容か判断できる場合は、クリプタクトに自動で反映されます。ただし、取引所の仕様により、取引所のファイルに取引履歴が含まれていない・内容が不明確な場合は反映できません。そのため、APIやファイルのどちらにも対応していない取引履歴については、お手数ですがカスタムファイルでのアップロードをお願いします。
カスタムファイルの作成方法
2．注意事項
2-1．取引内容に応じてどちらかのファイルをダウンロード
- ＦX／先物取引無し：「すべてのお取引」 のファイル
- ＦX／先物取引有り：「すべてのお取引」、「Lightningの全履歴」、「証拠金の履歴」、「充当履歴」のファイル
2-2．bitFlyer Lightning Futures（ビットコイン先物）満期処理について
bitFlyer Lightning Futuresの取引を開始し、満期日までにクローズしなかった場合、クリプタクトでは自動的に”SETTLE”という取引を追加し、クローズ処理を行います。
この際の価格は、 Lightning Futuresの説明 に沿って、クリプタクトにて、満期日の日本時間12時05分のbitFlyer BTCJPY取引価格を取得し利用しています。
2-3．Lightning FX の廃止およびbitFlyer Crypto CFD の開始に伴うご確認とご対応のお願い
現在、bitFlyerのサイトで、Lightning FXからbitFlyer Crypto CFDに移行される履歴のファイルの取得ができないと認識しております。そのため、Lightning FXが廃止される2024年3月28日18時時点で、Lightning FXで建玉（買いまたは売り）を持っていた方は、クリプタクトではLightning FXの建玉をCFDに引き継ぐような処理になっていないため、本来の計算結果とは異なる結果となってしまいます。
＜お客様へご対応のお願い＞
Lightning FXが廃止される2024年3月28日18時時点で、Lightning FXで建玉（買いまたは売り）を持っていた方は、カスタムファイルで以下の履歴をカスタムファイルでアップロードしてください。まずは、サンプルファイル（英語）をダウンロードし、サンプルファイルに手動で「DerivType」と「DerivDetials」の列を追加してください。
1-1. カスタムファイルのサンプル
カスタムファイルのアップロード方法
①FXのクローズ履歴をアップする
| Timestamp | Action | Source | Base |
DerivType |
DerivDetails | Volume | Price | Counter | Fee | FeeCcy | Comment |
| 2024/3/28 18:00:00 | SELL | bitflyer | BTC | fx | bitFlyer | ※参照 | ※参照 | JPY | 0 | JPY | 任意 |
※Timestamp: 取引日時は、Lightning FX廃止日である2024/03/28 18:00（JST）とする方法がございます。
※Action: 廃止日に保有していた建玉をご確認ください。「買い」でお持ちの場合は、「SELL（売り）」のクローズ履歴をアップください。
※Volume:「サマリー」画面の「年別」で2024年度のBTC/FX/bitFlyerの「期末時点のポジション」を入力ください。
※Price: ご自身でご判断いただければと存じますが、「サマリー」画面の「年別」で2024年度のBTC/FX/bitFlyerの「期末の平均取得単価」を記載する方法がございます。
②上記の履歴とは別に、cfdのオープン履歴をアップする
| Timestamp | Action | Source | Base |
DerivType |
DerivDetails | Volume | Price | Counter | Fee | FeeCcy | Comment |
| 2024/3/28 21:00:00 | BUY | bitflyer | BTC | cfd | bitFlyer | ※参照 | ※参照 | JPY | 0 | JPY | 任意 |
※Timestamp: 取引日時は、bitFlyer Crypto CFDの開始日である2024/03/28 21:00（JST）としていただく方法があるかと存じます。
※Action: ①でSELLの場合は「BUY（買い）」のオープン履歴をアップください。①がBUYの場合は「SELL」としてください。
※Volume: ①のVolumeをご参照ください。
※Price: ①のPriceをご参照ください。
3．bitFlyerの取引履歴のダウンロード方法
１．メニューにてお取引レポートを選択し、お取引レポートのダウンロードをクリック
２．お取引レポート画面を下にスクロール後、取引状況に応じて、必要な取引履歴のレポート作成を申請
- ＦＸ／先物取引がない場合 「すべてのお取引」のファイルを取得してください。
- ＦＸ／先物取引がある場合 「すべてのお取引」、「Lightning の全履歴」、「証拠金の履歴」、「充当履歴」の４つのファイルを取得してください。
３．ダウンロード準備が完了したら、bitFlyerの登録アドレスに完了のメールが届きます。メールに記載されているURLよりログイン後、「ダウンロード」をクリック
4．bitFlyerのファイルをクリプタクトにアップロードする
こちらの画面から取引所を選択し、一致するアップロードボックスにファイルをアップする。