RIKYUでは、取引所が提供するCSVだけでなく、RIKYU独自の「カスタムフォーマット（共通CSV）」を使って取引データを取り込めます。
自分で作成したCSVをアップロードすることで、入出金・売買・スワップ・送付などの取引をRIKYUに登録できます。
📝 事前準備
CSVファイルを取り込むには、事前に対象ウォレット（取引所/口座）がRIKYUに作成済みである必要があります。ウォレット登録の流れはウォレット登録の基本的な流れをご確認ください。
事前に確認すること（推奨）
- まずは テンプレートCSVをダウンロード して、内容を編集して取り込むのがおすすめです
- テンプレートは CSV / Excel（
.xlsx）の両方 をダウンロードできます - Excel形式（
.xlsx/.xls）のアップロードにも対応しています - まずは少量（数行）で取り込み、問題なく反映されることを確認してから行数を増やしてください
カスタムフォーマット（共通CSV）の仕様
ファイル形式
- アップロードできる形式:
.csv/.xlsx/.xls- Excel（
.xlsx/.xls）はアップロード後に変換され、取り込まれます
- Excel（
- CSVの場合
- 1行目: ヘッダー（固定）
- 2行目以降: 取引データ
💾 テンプレート（標準フォーマット）
カスタムフォーマットのテンプレートをダウンロードして編集できます。
ヘッダー（1行目・固定）
以下のヘッダーを 順番も含めて完全一致 させてください（列名の変更、順序変更、列の増減は不可）。
日時,取引タイプ,取引通貨(+),取引量(+),取引通貨(-),取引量(-),取引時価,手数料通貨,手数料数量,コメント各列の意味
| 列 | 項目 | 必須 | 説明 |
|---|---|---|---|
| 1 | 日時 | ✅ | 取引日時（推奨: YYYY/MM/DD HH:mm:ss） |
| 2 | 取引タイプ | ✅ | 取引の種類（表記は完全一致、詳細は「対応している取引タイプ」を参照） |
| 3 | 取引通貨(+) | 条件付き | 受け取った通貨（受取側） |
| 4 | 取引量(+) | 条件付き | 受け取った数量（受取側） |
| 5 | 取引通貨(-) | 条件付き | 支払った通貨（支払側） |
| 6 | 取引量(-) | 条件付き | 支払った数量（支払側） |
| 7 | 取引時価 | 任意 | 円換算の時価（未入力の場合はシステム側で推定されることがあります） |
| 8 | 手数料通貨 | 任意 | 手数料の通貨（空欄可） |
| 9 | 手数料数量 | 任意 | 手数料の数量（空欄/0 は手数料なし扱い） |
| 10 | コメント | 任意 | メモ（任意の文字列） |
入力ルール（重要）
- 列数は常に 10列 にしてください
- 数量は数値で入力してください（例:
0.01）1,000のような桁区切り（カンマ）は使用しないでください
- 0件（ヘッダーしかないCSV）は取り込めません
- 取引通貨のシンボルは大文字と小文字を識別しません
- 存在しないシンボルの場合、トークン情報を解決できず、その行が取り込まれない（スキップされる）ことがあります
- コメントにカンマ（
,）が含まれる場合は、CSVの一般的なルールに従い 二重引用符"で囲ってください - 行の途中に不要な改行が混ざると、取り込みエラーの原因になります
⚠️ (+) / (-) のどちらを入れればよいか
取引タイプによって、(+) と (-) のどちら、もしくは両方が必要かが異なります。+は増加分。-は減少分を表します。
対応している取引タイプ
取引タイプには、RIKYUが対応している名称を入力します（表記揺れがあると認識されません）。 迷う場合は、まず取引種別の一覧をご確認ください。
代表例:
- 交換・売買:
FTスワップ/ラップ/FT購入/FT売却 - 入出金・移動:
受取/送付/Fiat入金/Fiat出金/贈与 - 収入:
売上/エアドロップ/報酬/ステーキング報酬 - 支出:
支払い/寄付 - デリバティブ:
ポジション利確/ポジション損切/デリバティブ収入/デリバティブ支出 - ステーキング等:
ステーキング預入/ステーキング解除/貸付/貸付解除/流動性提供/流動性解除/借入/返済
よく使う記入例
FT購入（JPYでBTCを購入）
日時,取引タイプ,取引通貨(+),取引量(+),取引通貨(-),取引量(-),取引時価,手数料通貨,手数料数量,コメント
2024/04/07 00:11:25,FT購入,BTC,0.01,JPY,100000,100000,JPY,0,現物購入送付（ETHを外部へ送金、手数料あり）
日時,取引タイプ,取引通貨(+),取引量(+),取引通貨(-),取引量(-),取引時価,手数料通貨,手数料数量,コメント
2024/04/08 10:00:00,送付,,,ETH,0.5,,ETH,0.001,出庫受取（エアドロップ等）
日時,取引タイプ,取引通貨(+),取引量(+),取引通貨(-),取引量(-),取引時価,手数料通貨,手数料数量,コメント
2024/04/09 12:00:00,受取,ABC,100,,,,,,エアドロップRIKYUへ取り込む（アップロード）手順
CSVをインポートからカスタムCSVを登録してください。
よくあるエラーと対処
「ファイルの形式が正しくありません」
原因例:
- アップロードできる形式（
.csv/.xlsx/.xls）ではない - ヘッダーが一致していない（列名、順番、列数）
対処:
- 「ヘッダー（1行目・固定）」の行をコピーして、完全一致 させてください
「CSVのデータが不正です」
原因例:
- 10列になっていない（カンマ不足/過剰）
- 行の途中に不要な改行が混ざっている
- コメント列にカンマが含まれているのに、二重引用符で囲っていない
対処:
- 各行の列数（10列）や、改行・二重引用符の崩れがないか確認してください
- CSVの調整が難しい場合は、Excel形式（
.xlsx/.xls）でのアップロードもお試しください
取り込まれない行がある（エラーにならない）
原因例:
- 取引タイプが未対応、または表記が一致していない
- (+) / (-) / 手数料のいずれも空で、取引内容が特定できない
対処:
- 取引タイプの表記を取引種別の一覧に合わせてください
- 取引タイプに応じて必要な (+) / (-) を入力してください
よくある質問（FAQ）
Q. 取引時価は必須ですか？
A. 任意です。未入力の場合、システム側で時価を推定します。時価の精度が重要な場合は入力を推奨します。
Q. 手数料がない場合はどう書けばいいですか？
A. 手数料数量を空欄または 0 にしてください（手数料通貨も空欄でOKです）。
Q. 日時のおすすめ形式は？
A. YYYY/MM/DD HH:mm:ss（24時間表記）を推奨します（例: 2024/04/07 00:11:25）。
次のステップ
- ウォレット登録の基本的な流れ: ウォレット登録とCSVインポートの全体像
- 取引管理画面の基本的な使い方: 取り込んだ取引データの確認・管理
- ウォレット同期のトラブルシューティング: 同期できない/データが出ない場合