OKXでの自動取引にAPIを使用する方法

OKX APIは、RESTおよびWebSocketインターフェイスを介した自動取引を可能にし、安全なHMAC認証を備えた注文配置、リアルタイムデータストリーミング、およびアカウント管理を可能にします。

2025/08/07 17:21

自動取引のためのOKX APIを理解する

OKX APIは、ユーザーが取引戦略を自動化し、リアルタイム市場データにアクセスし、プログラムでアカウントを管理するための強力なインターフェイスを提供します。自動取引を開始する前に、OKXが提供するAPIの種類を理解することが不可欠です。このプラットフォームは、 REST API 、 WebSocket API 、およびWeb3.js APIをサポートしており、最初の2つは自動取引に最も関連性があります。 REST APIを使用すると、HTTPリクエストを使用して注文、残高を確認し、履歴データを取得できます。 WebSocket APIにより、市場データのリアルタイムストリーミング、注文の更新、およびレイテンシの低下でのアカウントの変更が可能になります。

開始するには、OKXアカウントからAPIキーを生成する必要があります。アカウント設定の下にあるAPI管理セクションに移動します。ここでは、セキュリティ用の名前、パスフレーズ、およびバインディングIPアドレスを指定することにより、新しいAPIキーを作成します。不正使用を防ぐために、特定のIPSへのアクセスを制限することが重要です。生成されたキーは、 APIキー、シークレットキー、パスフレーズの3つのコンポーネントで構成されています。これらは、取引口座への完全なアクセスを許可するため、安全に保管する必要があります。

開発環境を設定します

OKX APIを効果的に使用するには、適切な開発環境が必要です。ほとんどの開発者は、ライブラリのシンプルさと豊富なエコシステムのためにPythonを使用しています。 Python（できればバージョン3.8以降）をインストールし、依存関係を管理するように仮想環境をセットアップします。 PIPを使用して、HTTP通信のrequestsやWebSocket接続を処理するためのwebsocketsなどの必要なパッケージをインストールします。

 pip install requests websockets

次に、API資格情報を安全に保存する構成ファイル（ config.pyなど）を作成します。メインスクリプトのキーをハードコードしないでください。構成には以下を含める必要があります。

• APIキー
• 秘密の鍵
• パスフレーズ
• ベースURL （例： https://www.okx.com

バージョンコントロールを使用している場合は、このファイルが.gitignoreに追加されていることを確認してください。これにより、機密データの偶発的な暴露が防止されます。

OKX APIを使用してリクエストを認証します

OKXは、リクエスト認証にHMAC-SHA256暗号化を使用します。すべてのプライベートAPI要求には、特定のフィールドのヘッダーが含まれている必要があります： OK-ACCESS-KEY 、 OK-ACCESS-SIGN 、 OK-ACCESS-TIMESTAMP 、およびOK-ACCESS-PASSPHRASE 。署名は、タイムスタンプ、HTTPメソッド、エンドポイントパス、およびリクエスト本体（存在する場合）を連結して、シークレットキーで署名することにより生成されます。

Pythonで署名を生成する方法は次のとおりです。

 import hmac
 import hashlib
 import json def generate_signature（タイムスタンプ、メソッド、url、body、secret_key）：





message = timestamp + method + url + (json.dumps(body) if body else '') mac = hmac.new(bytes(secret_key, 'utf-8'), bytes(message, 'utf-8'), hashlib.sha256) return mac.hexdigest()
この関数をAPIラッパーに含めてください。タイムスタンプはISO形式でなければなりません（例： 2024-04-05T12:00:00.000Z ）。認証エラーを回避するために、システムクロックがUTCと同期されていることを常に確認してください。
 
REST APIを介して注文を配置します
取引を自動的に実行するには、 Place Order Endpointを使用します。エンドポイントURLは/api/v5/trade/orderです。必要なパラメーターを含むJSONボディを使用してPOSTリクエストを送信する必要があります。
 
Instid ：機器ID（例、 BTC-USDT-SWAP ）
 TDMODE ：トレードモード（ cash 、 isolated 、またはcross ）
 ordtype ：注文タイプ（ limit 、 market 、 post_onlyなど）
 SZ ：注文サイズ
PX ：価格（制限注文に必要）
例リクエストボディ：
 
{
 'instid'： 'btc-usdt-swap'、
 'tdmode'： 'Cross'、
 'ordtype'： 'limit'、
 'SZ'： '0.001'、
 'px'： '60000'
 }

requestsライブラリを使用してリクエストを送信します。

 import requests
 from config import API_KEY, SECRET_KEY, PASSPHRASE url = 'https://www.okx.com/api/v5/trade/order'
ヘッダー= {





'OK-ACCESS-KEY': API_KEY, 'OK-ACCESS-PASSPHRASE': PASSPHRASE, 'Content-Type': 'application/json'
 }
 
body = {
 
'instId': 'BTC-USDT-SWAP', 'tdMode': 'cross', 'ordType': 'limit', 'sz': '0.001', 'px': '60000'
 }
 
タイムスタンプ= '2024-04-05T12：00：00.000Z'
 signature = generate_signature（timestamp、 'post'、 '/api/v5/trade/order'、body、secret_key）
 
ヘッダー['ok-access-sign'] =署名
ヘッダー['ok-access-timestamp'] =タイムスタンプ
 
応答= requests.post（url、headers = headers、json = body）
 print（respons.json（））

codeとmsgの応答を確認してください。 0のcodeは成功を示します。

WebSocketを使用したストリーミング市場データ

リアルタイムの取引決定については、OKXのWebSocketAPIに接続します。これにより、注文書、取引、注文ステータスに関するライブアップデートを受信できます。 websocketsライブラリを使用して、 wss://ws.okx.com:8443/ws/v5/public for public channelsまたはwss://ws.okx.com:8443/ws/v5/private for privateデータへの接続を確立します。

ティッカーまたは深度チャネルを購読して、価格の変化を監視します。

 import asyncio
 import websockets
 import json async def risten_to_ticker（）：





uri = 'wss://ws.okx.com:8443/ws/v5/public' async with websockets.connect(uri) as websocket: subscribe_message = { 'op': 'subscribe', 'args': [ { 'channel': 'tickers', 'instId': 'BTC-USDT' } ] } await websocket.send(json.dumps(subscribe_message)) while True: response = await websocket.recv() data = json.loads(response) if 'data' in data: print('Latest price:', data['data'][0]['last'])
このCoroutineを実行して、継続的に更新を受信します。切断を処理し、堅牢性のために再接続ロジックを実装します。
 
リスクの管理と監視注文
自動取引には絶え間ない監視が必要です。 Get Orderの詳細エンドポイント（ /api/v5/trade/order ）を使用して、 ordIdによる特定の注文のステータスを確認します。キャンセル注文のエンドポイント（ /api/v5/trade/cancel-order ）を使用して注文をキャンセルします。
 
すべてのアクションを記録するためにロギングを実装してください。
 
import logging
 logging.basicconfig（filename = 'trading.log'、level = logging.info）
 
logging.info（f'order placed：{respons.json（）} '）

失敗した要求または予期しない価格の動きのアラートを設定します。損失がしきい値を超える場合、サーキットブレーカーを使用して取引を停止します。

よくある質問

2要素認証（2FA）を有効にせずにOKX APIを使用できますか？

いいえ。セキュリティ上の理由から、OKXはAPIキーを作成する前に、アカウントで2FAを有効にする必要があります。これにより、不正アクセスに対する追加の保護層が追加されます。

OKX APIにはどのレート制限が適用されますか？

OKXは、要求の種類に基づいてレート制限を強制します。パブリックエンドポイントでは、IPあたり2秒あたり最大20回のリクエストが許可されています。プライベートエンドポイントは、APIキーごとに2秒あたり6つのリクエストに制限されています。これらの制限を超えると、 429エラーが発生します。

TestNetはOKX API開発に利用できますか？

はい。 OKXは、別のベースURLを介してアクセスできるデモトレーディング環境を提供します： https://www.okx.com 。実際の資金を危険にさらすことなく、取引をシミュレートできます。構成のベースURLを切り替え、デモ固有のAPIキーを使用します。

APIのダウンタイムまたは接続損失を処理するにはどうすればよいですか？

指数バックオフで再試行ロジックを実装します。 WebSocket接続については、 closeイベントを聞いて、遅延後に再接続を試みます。中断から回復するために、注文状態をローカルに保存します。