RIKYUでウォレット同期時にエラーが発生した場合の詳細な対処法を説明します。エラーの種類別に原因と解決方法を解説し、スムーズな問題解決をサポートします。
API接続エラーの対処法
エラーの症状
- 取引所ウォレットで同期エラーが発生
- エラーメッセージに「API」「認証」「権限」などの文言が含まれる
- 同期ステータスが🔴エラーのまま変わらない
主な原因と対処法
取引所で設定したAPIキーの有効期限が過ぎている
- ウォレット管理画面でエラーのあるウォレットを確認
- **メニューアイコン（⋮）**をクリック
- **「API設定」**を選択
- APIキー情報を確認・更新
- APIキー（API Key）
- シークレット（Secret）
- パスフレーズ（該当する場合）
- **「保存」**をクリック
- 再同期を実行して正常性を確認
APIキーに取引履歴の読み取り権限が付与されていない
対処手順:
- 取引所のAPI設定画面で権限を確認
- 「取引履歴読み取り」「残高確認」権限を有効化
- 必要に応じてAPIキーを再発行
- RIKYUで再同期を実行
APIの呼び出し回数が取引所の制限を超えている
対処手順:
- 30分～1時間程度待機
- 手動で再同期を実行
- 頻繁に発生する場合はサポートに連絡
ブロックチェーンウォレットの接続エラーの対処法
エラーの症状
- オンチェーンウォレットで同期エラーが発生
- 一時的または継続的な同期停止
主な原因と対処法
ブロックチェーンネットワークまたはRIKYUサーバーの一時的な問題による同期失敗
対処手順:
- 30分～1時間程度待機
- 手動で再同期を実行
- 問題が解決しない場合は数時間後に再試行
- 24時間以上継続する場合はサポートに連絡
ウォレットアドレスの間違い
対処手順:正しいウォレットアドレスで再登録する
部分的な取引欠損の対処法
エラーの症状
- 取引所アプリのダッシュボードやブロックチェーンエクスプローラー(etherscanなど)で表示されている残高と、RIKYUの残高が異なる
主な原因と対処法
取引所のAPI制限により、古い取引や特定タイプの取引が取得できない
対処手順:
- 欠損期間を特定
- 取引所から該当期間のCSVをダウンロード
- RIKYUのCSVインポート機能で補完
- 重複チェックが正常に動作することを確認
CSV登録で取引を取得できていない期間がある
対処手順:
- 対象外取引を特定
- 古い取引（API制限以前）
- 特定の取引タイプ（先物、オプション等）
- レンディング・ステーキング取引
- 取引所から対象CSVをダウンロード
- CSVインポートで追加登録
RIKYUとウォレットアプリ間の差異確認方法
トークン残高の差異の確認
確認方法
-
実際のウォレット残高を確認
- MetaMask等のウォレットアプリ
- 取引所の資産画面
- ブロックチェーンエクスプローラー
-
RIKYU上の残高を確認
- ダッシュボード画面を開き、暗号資産一覧テーブルで残高を確認
🔐 Tips
トークンの金額ではなくトークンの数量残高を確認するようにしてください。 各サービスごとに時価レートの参照先や参照タイミングが異なること場合ズレが発生します。
時価レートに関する詳細は以下をご参照ください：
RIKYUの時価レート取得方法
差異が発生した場合の対処
| 考えられる原因 | 対処法 |
|---|---|
| 重複データの混入 | 重複取引の削除・修正 |
| 取引の取得漏れ | 欠損取引のCSV追加 |
| その通貨の同期エラー | 該当ウォレットの再同期 |
| 同期タイミングのズレ | 再同期後に再確認 |
取引内容の差異確認
重要な取引について個別に確認することで、データの正確性を保てます。
優先確認対象
- 高額取引
- 期末近辺の取引
- 特殊取引
- NFT関連取引
- DeFi関連取引（流動性提供等）
- ステーキング・レンディング
- エアドロップ
- 取引所とオンチェーンウォレット間の資金移動
確認方法
- RIKYUの取引管理画面で対象取引を検索
- 実際の取引記録と照合
- ウォレットの送受信履歴
- 取引所の取引履歴
- ブロックチェーンエクスプローラー
- 不一致があれば修正
- 取引タイプの変更
- 金額・数量の修正
- 取引日時の調整
よくある質問と解決策
Q: 同期エラーが繰り返し発生する
A: 以下を順番に確認してください
- APIキーの有効性と権限
- ネットワーク接続の安定性
- 取引所側のメンテナンス情報
- RIKYU側のシステム状況（サポートに確認）
Q: CSVインポート後も取引数が合わない
A: 以下の点を確認してください
- CSVフォーマットが正しいか
- 取引所固有の制限がないか
- 手動取引の登録が必要か
Q: 問題が解決しない場合はどうすれば？
A: サポートに連絡する際は以下の情報をお伝えください
- エラーメッセージの詳細
- 発生時刻
- 対象ウォレット名
- 行った対処法
- 環境（ブラウザ、OS等）