よくある質問
Q1: アドレスをホワイトリストに追加しても出金できない
原因：
1. 出金ページのホワイトリストとAPI出金ホワイトリストは互いに独立しています。
2. [出金ページ] > [出金アドレス管理]で追加されたアドレスはAPI出金には適用されません。
解決策：
- API出金ホワイトリスト管理ページにアクセス: https://www.coinex.com/apikey
- 出金アドレスをAPI専用ホワイトリストに追加してください。
Q2: access_id not exist エラー
一般的な原因：
(1) 新しく作成されたAPIキーは、通常、有効になるまで約10分かかります。作成直後にAPIを呼び出すと、このエラーが発生する可能性があります。
(2) 不正確なaccess_id。
(3) 無効なサイン認証。
(4) 不正確なリクエストヘッダー。
解決策：
(1) [CoinEx API ドキュメント]を参照して、HTTP認証リクエストの構築方法を学んでください。
(2) デモ：
Q3: 3008/4001 service unavailable エラー
原因：サーバー負荷が高い期間に注文をキャンセルする際に、このエラーが発生する可能性があります。
解決策：
(1) 重要な注文のキャンセルを優先してください。
(2) 1〜2秒後に再試行してください。
(3) レスポンスがcode: 0を返しても注文がキャンセルされない場合：
- 完全なリクエストとレスポンスを記録してください。
- カスタマーサポートに連絡し、メイン/サブアカウント情報を提供して支援を求めてください。
Q4: パラメータエラー
原因：これは通常、アップロードされたパラメータがAPIドキュメントで指定されたタイプと一致しない場合に発生します。
解決策：POST /spot/cancel-orderエンドポイントを例にとると：
(1) APIドキュメントのパラメータ名とタイプを厳密に比較してください。
(2) 数値型と文字列型の違いに特に注意してください。
Q5: APIのレート制限は何ですか？
レート制限は短期レート制限と長期レート制限に分かれており、レスポンスヘッダーで識別できます：
1. 短期レート制限：X-RateLimit-Limitの値が0より大きい場合、短期レート制限はトリガーされていません。
短期制限はトークンバケットメカニズムを使用し、メインアカウントとサブアカウントで独立したレート制限があります。
- トリガー後の一般的なエラー：コード：213、4213
- メッセージ：Please don't try too frequently.
2. 長期レート制限：X-RateLimit-LongPeriod-{period}-Remainingが返された場合、長期レート制限がトリガーされています。システムはユーザーのリクエスト量と品質を評価し、より長い期間にわたるリクエスト総数に制限を課すかどうかを決定します。トリガー後、すべてのエンドポイント（注文キャンセルを除く）のリクエストレートは1秒あたり1リクエストに制限されます。
- 一般的なエラー：コード：213、4213
- レスポンスヘッダーによる追加判断が必要。
その他のよくある質問
Q1: APIリクエストのレイテンシーを減らすには？
サーバーはAWS東京にデプロイされており、クロスリージョンロードバランシングをサポートしています。レイテンシーを最小限に抑えるために、近くのリージョンを選択できます。
利用可能なゾーン：
- ap-northeast-1a
- ap-northeast-1c
- ap-northeast-1d
Q2: API出金に2FAは必要ですか？
セキュリティ上の理由から：
1. API出金を使用する前に、ログインして2FAで認証する必要があります。
2. [出金ホワイトリスト]に出金アドレスを追加した後、さらなる2FA認証なしでAPI出金を開始できます。
Q3: 出金ホワイトリストアドレスをAPIで追加できますか？
現在、APIを介した出金ホワイトリストアドレスの追加はサポートされていません。[API管理] > [出金ホワイトリスト]に移動して、手動またはバッチでアドレスを追加してください。
Q4: サイン不正確エラー
解決策：
1. access_idとsecret_keyが正しく設定されているかどうかを確認してください。
2. リクエストボディとサイン生成に使用されるパラメータが同一であるかどうかを確認してください。リクエストパラメータを文字列として前処理し、サイン前後の一貫性を確保してください。
3. サイン用にサードパーティライブラリを使用している場合は、適切に設定されていることを確認してください。
Q5: Tonce check error - Correct tonce should be within one minute of the current time
解決策：
(1) すべてのAPIリクエストのタイムスタンプがミリ秒単位であることを確認してください。
例：
(2) コンピュータで自動時間同期が有効になっていることを確認してください。
Q6: 先物口座の実際の使用可能残高と純資産価値を取得するには？
(1) /assets/futures/balanceエンドポイントを使用して、availableフィールドを取得します。これは先物口座の現在の使用可能残高を示します。
(2) API エンドポイントは現在、アカウントの純資産価値を返すことをサポートしていません。 純資産価値は、実現済みおよび未実現の損益の合計です。
(3) 未実現損益は固定値ではなく、ポジションの変動により変動する可能性があります。正確な結果を得るには手動計算が必要です。
(4) 計算式については、「リニア契約の口座収入とPNLの計算方法」のドキュメントを参照してください。
Q7: WebSocket APIから返されるデータをどのように処理しますか？
WebSocket APIは圧縮されたJSON文字列形式でデータを返すため、使用前に解凍する必要があります（例：gzipモジュールを使用）。
よくあるエラー：
utf-8 codecはposition 1のバイト0x8bをデコードできません：無効な開始バイト
Q8: サードパーティの税金プラットフォームがエラーを報告した場合はどうすればよいですか？
V1サービスは2024年9月25日に終了しました。エラーは、プラットフォームがコードをV2にアップグレードしていないことが原因である可能性があります。関連する税金プラットフォームにサポートを依頼してください。
Q9: WebSocket接続が成功したことをどのように確認しますか？
サブスクリプションに成功すると、サブスクリプション結果のレスポンスが受信されます。
その後、サブスクライブしたメッセージの更新を受信します：
Q10: なぜWebSocket接続が自動的に切断されるのですか？接続を維持するにはどうすればよいですか？
(1) WebSocketの切断は通常、ネットワークの問題が原因です。ネットワーク接続が安定しているかどうかを確認してください。
(2) WebSocket接続を維持するには、server.pingを使用して接続を維持する必要があります。
(3) 1分間サーバーとの通信がない場合、WebSocket接続は自動的に切断されます。接続をアクティブに保つために、ping インターフェースを通じて60秒以内の送信間隔を設定することをお勧めします。
その他のAPIエラーについては、ここをクリックしてカスタマーサポートに連絡し、問題解決のために以下の情報を提供してください：
(1) メインアカウントのメールアドレスまたはサブアカウントのユーザー名。
(2) 完全なリクエストとレスポンスの詳細。
重要：不必要な損失を避けるため、エラーメッセージ内のaccess_idとsecret_keyを共有しないでください。