OKX で過去の先物注文を表示する方法

OKX Web インターフェイス経由で過去の先物注文にアクセスする

1. OKX アカウントにログインし、先物取引セクションに移動します。

2. 取引インターフェースの上部にある「注文」タブをクリックします。

3. 「履歴」サブタブを選択して、完了、キャンセル、期限切れの先物注文を表示します。

4. 日付範囲フィルタを使用して、取得の開始タイムスタンプと終了タイムスタンプを指定します。デフォルトのウィンドウは過去 90 日間をカバーします。

5. BTC-USDT-SWAP や ETH-USDT-QUARTER などの金融商品フィルターを適用して、契約タイプと原資産ごとに結果を絞り込みます。

REST API経由で先物注文履歴を取得する

1. 有効な認証情報を使用してpython-okxからTradeAPIクラスを初期化し、運用環境用にflag='0'を設定します。

2. get_orders_history_archiveメソッドを呼び出し、 instType='SWAP' 、 instId='BTC-USDT-SWAP' 、およびlimit=100などのパラメータを渡します。

3. beforeパラメータを使用して応答をページ分割します。値は各バッチの最も古いレコードのordIdフィールドから抽出されます。

4. 返された JSON 構造を解析します。各エントリには、 ordId 、 px 、 sz 、 side 、 state 、 fillSz 、 avgPx 、およびts (ミリ秒のタイムスタンプ) が含まれます。

5. デフォルトの降順ソートを逆にした後、生の応答を時系列順に保存し、連続するページ間のts値のギャップをチェックして完全性を検証します。

データの整合性と時間範囲の制約

1. OKX は Web インターフェイス上で先物注文履歴を最大180 日間保持しますが、API アクセスは機関層アカウントの場合は365 日間延長されます。

2. 90 日より古いレコードには明示的なinstType指定が必要です。省略すると、 instIdが指定されていても空のデータが返されます。

3. stateフィールドには、 filled 、 cancel 、 partial_filled 、 expired 、 failedなどの値が含まれます。 failed は、マージン不足または無効なパラメーターによる注文の拒否を示します。

4. タイムスタンプは常に UTC であり、夏時間に合わせて調整されません。ローカル時間の変換は、Python のdatetime.timezone.utcを使用してクライアント側で処理する必要があります。

5. 注文 ID は、先頭にORDが付き、その後に 18 文字の英数字が続く不変の文字列です。バッチ間での数値順序の保証はありません。

履歴順序の取得中によくある落とし穴

1. get_orders_history_archiveの代わりにget_orders_historyを使用すると、ページネーションの試行に関係なく、最新の 90 日のみが得られます。

2. 無効なbefore値 (存在しないordIdや 365 日より古い ordId など) を渡すと、エラー コード50015 (「無効な before パラメーター」) がトリガーされます。

3. instIdを指定するときにinstTypeを省略すると、明示的な検証エラーがスローされるのではなく、空のdata配列を含む HTTP 200 が返されます。

4. flag='1' (デモ モード) と本番のinstId値を混在させると、サイレント不一致が発生します。デモ モードで行われた注文は、実際の口座履歴エンドポイントには表示されません。

5. 約定された注文のfillSz szと等しいと仮定すると、清算トリガーの約定による部分約定は無視されます。この場合、連鎖的な市場の影響によりfillSz元のszを超える可能性があります。

よくある質問

Q: API キーなしで過去の先物注文を取得できますか?いいえ。 /api/v5/trade/orders-history-archiveにあるすべてのエンドポイントにはOK-ACCESS-KEY 、 OK-ACCESS-SIGN 、 OK-ACCESS-TIMESTAMP 、 OK-ACCESS-PASSPHRASEを含む完全な認証が必要です。パブリック エンドポイントは注文履歴を公開しません。

Q: orders-historyとorders-history-archive両方の応答に同じordIdが表示されるのはなぜですか?これは、注文が過去 90 日以内に行われた場合に発生し、アーカイブ保持の対象にもなります。システムは二重インデックスを維持しますが、重複するレコードについては両方のエンドポイントで同一のペイロード コンテンツを保証します。

Q: get_orders_history_archive呼び出しにレート制限はありますか?はい。エンドポイントは、IP アドレスごとに2 秒あたり 20 のリクエストを強制します。これを超えると、必須の一時停止期間を示すRetry-Afterヘッダーを含む HTTP 429 がトリガーされます。

Q: 逆指値注文はトリガーされなかった場合でも注文履歴に表示されますか?はい。トリガーされていない条件付き注文は、手動で削除された場合はstate='canceled'で履歴に残り、有効期限を過ぎてもアクティブな場合はstate='pending'で履歴に残ります。有効期限は配置中に上書きされない限り、デフォルトで 30 日間になります。