API キーの作成、権限の選択、IP ホワイトリストの設定から、注文が拒否されたときの各エラーコードの意味と対処まで。
OKX の口座をまだお持ちでない方はOKX に登録
OKX API は、プログラムが OKX の口座と直接やり取りするための窓口です。残高や建玉の確認、発注、取り消しまで、ウェブを開かずにできます。自動売買プログラムは API を通じてルールどおりに発注します。
API を使うには、まずキーを作ります。プログラムはこのキーで「この口座から許可を受けている」ことを証明します。キーで何ができるかは、作成時にどの権限を付けたかで決まります。
三つそろえて自動売買プログラムに渡します。一つでも欠けると接続できません。
OKX の公式 API FAQ によると、取引または出金権限を持ち IP を設定していないキーは、14 日間動きがないと自動で削除されます。IP を設定すればキーは放置で失効せず、キーを手に入れた人がほかの場所から使うこともできません。一つのキーに設定できる IP は最大 20 個です。
設定するのは「プログラムを動かすマシン」のグローバル IP で、スマホや普段ネットに使っている IP ではありません。自宅回線の IP は変わることがあり、変わったら新しい IP をホワイトリストに追加します。
Blave Agent なら、クラウドサーバーの接続画面にサーバーの IP が表示されるので、そのまま入力します。デスクトップ版は設定を求めませんが、設定しない場合は 14 日ルールを忘れずに。
自動売買でよく出るエラーをまとめました。意味は OKX 公式 API ドキュメントに従い(51008 は Blave の発注プログラムの分類に従っています)、対処は一般的な目安です。
| コード | 意味 | 対処 |
|---|---|---|
| 一つ目:キーと権限の問題。接続時や発注時にすぐ拒否されます | ||
| 50111 | API キーが無効 | 貼り間違いや前後の余分な空白がないか確認 |
| 50113 | 署名が無効 | たいていシークレットキーの貼り間違い。貼り直す |
| 50105 | パスフレーズが違う | キー作成時に自分で決めたもの。ログインパスワードではない |
| 50110 | IP がホワイトリストにない | プログラムを動かすマシンの新しい IP をホワイトリストに追加 |
| 50119 | キーが存在しない | 削除された可能性あり(14 日ルールなど)。作り直す |
| 50100 | API が凍結されている | OKX のサポートに問い合わせる |
| 二つ目:キーは問題ないのに、その注文自体が通らない | ||
| 51010 | 現在の口座モードでは非対応 | Spot mode では先物を取引できない。口座モード設定で先物に対応したモードに変更 |
| 51008 | 証拠金不足 | 資金を追加するか、戦略の金額を下げる |
| 51020 | 最小注文数量を下回っている | 戦略の金額を上げるか、最小単位の小さい銘柄にする |
| 50102 | リクエストのタイムスタンプが期限切れ | プログラムを動かすマシンの時計がずれている。自動時刻同期をオンにする |
| 三つ目:結果が分からない。最も注意が必要です | ||
| 50004 | API リクエストのタイムアウト | 再送せず、まず注文を確認 |
| 51149 | 注文のタイムアウト | 再送せず、まず注文を確認 |
| 50001 | サービスが一時的に利用できない | 再送せず、まず注文を確認 |
| 50026 | システムエラー | 再送せず、まず注文を確認 |
OKX のドキュメントには、50004 と 51149 は「リクエストの成功も失敗も意味しない」とはっきり書かれています。注文はすでに約定しているかもしれず、そのまま再送すると二重に発注されます。Blave Agent はこの四つのコードでは同じ注文を再送しません。先物の成行注文は約定したかどうかを確認してから次の動きを決め、それ以外の注文は止まって報告し、自動では再試行しません。
自分で OKX API を使うプログラムを書く場合、ここが最も事故の起きやすいところです。
上のエラー処理は、50102 のときに OKX と自動で時刻を合わせることや、タイムアウト後に再送しないことも含めて、Blave Agent の発注プログラムで対応済みです。API キー、シークレットキー、パスフレーズを「自動売買 › 口座を接続 › OKX」に貼り付ければ、戦略がルールどおりに OKX で発注します。
実口座につなぐ前に、ペーパートレードでしばらく動かすのがおすすめです。API キーは不要で、初期資金は 100,000 USDT です。
デスクトップ版をダウンロード詳しい手順は〈取引所の発注用 API キーを設定する〉を、アイデア探しから本番運用までの流れは〈OKX 自動売買:アイデア探しからバックテスト、本番運用まで〉をご覧ください。
API キーに有効期限はある?
IP を設定したキーは放置しても失効しません。取引または出金権限があり IP を設定していないキーは、14 日間動きがないと削除されます。
パスフレーズを忘れたら?
復元はできません。このキーを削除して作り直し、新しい三つをプログラムに貼り直してください。
注文が最もタイムアウトしやすい時間帯は?
OKX は毎日 8:00、16:00、24:00(台湾時間、UTC+8)を避けるよう勧めています。資金調達料の精算時間で、サーバー負荷が最も高くなります。
API キーは口座の取引権限そのものなので、信頼できないサイトやプログラムには貼らないでください。出金権限は絶対に付けず、使わなくなったキーは削除します。自動売買で損失が消えるわけではなく、ルールどおりに執行するだけです。レバレッジを使えば損失も膨らみます。