Perly は CSV ファイルから取引履歴をインポートします。CSV は主要な取引所であればどこでも用意しているエクスポート形式で、API キーも OAuth による認可も継続的な接続も必要としない唯一の形式です。ここでは Coinbase から履歴を取り出す方法と、インポートする前に確認しておきたい点を説明します。
エクスポートの手順
- ウェブ版の Coinbase にログインします。
- プロフィールメニューを開き、Statements を探します（Coinbase では Reports と呼ばれていた時期もあり、プロフィールメニューと Settings のあいだで何度か場所も移っていますが、同じ機能です）。
- Transactions のステートメントを選び、資産を Bitcoin に指定するか、すべての資産のままにして、期間を選びます。初めて全履歴をインポートする場合は「All time」を選んでください。
- レポートを作成し、CSV でダウンロードします。Coinbase では PDF も選べますが、インポートに使えるのは CSV です。
- インポートする前に、一度ファイルを開いて確認します。Coinbase は取引 1 件につき 1 行を書き出し、種別を示す列（buy、sell、send、receive）があります。インポートに必要なのは buy と sell の行です。
取引所の画面構成やメニュー名は変わることがあります。上記の表記が見当たらない場合でも機能自体はなくなっていないので、取引所のヘルプで「export history CSV」と検索してください。
インポートする前に
- Coinbase と Coinbase Advanced（旧 Pro）の履歴は別々に管理されています。両方で取引していた場合は、両方ともエクスポートしてインポートしてください。そうしないと、もう一方で約定した取引がすべて取得原価から漏れてしまいます。
- Coinbase の CSV には小計、手数料、合計が含まれますが、1 コインあたりの価格は明記されず、ほかの値から算出されていることがあります。行の内容を信頼する前に、数量 × 価格に手数料を加えた額が合計と一致するかを確認してください。
- リワード、通貨の変換、送金は、買いでも売りでもありません。インポートするのは売買の取引だけにしてください。それ以外はウォレット内の資金の移動であり、ポジションの変化ではありません。
インポートで行われること
Perly は列を自動で判別し、書き込む予定の行をすべて表示したうえで、重複の可能性がある行に印を付けてチェックを外しておきます。確認するまで何も書き込まれません。信頼できない台帳は台帳がないよりも悪く、台帳が信頼を失ういちばんの近道は、確認なしに行われるインポートだからです。その後、取得原価、損益、ROI が全履歴から計算し直されます。計算の仕組みは 平均取得原価法と FIFO で説明しています。