OKX API の使い方:キー作成と権限設定から自動売買への接続まで

API キーの作成、権限の選択、IP ホワイトリストの設定から、注文が拒否されたときの各エラーコードの意味と対処まで。

最終更新 2026-11
開示:この記事の OKX 登録リンクは Blave の提携リンクです。リンク経由で登録すると、Blave が報酬を受け取ることがあります。

OKX の口座をまだお持ちでない方はOKX に登録

要点まとめ
  • OKX の API キーは API キー、シークレットキー、パスフレーズの三つでできています。パスフレーズは自分で決めるもので、忘れたらキーを削除して作り直すしかありません。
  • 自動売買に必要なのは Read と Trade の権限だけ。Withdraw は絶対に付けません。
  • 取引権限があり IP を設定していないキーは、14 日間動きがないと OKX に自動で削除されます。
  • 注文が 50004 や 51149 のタイムアウトになっても、約定していないとは限りません。まず注文を確認し、そのまま再送しないでください。

OKX API とは?

OKX API は、プログラムが OKX の口座と直接やり取りするための窓口です。残高や建玉の確認、発注、取り消しまで、ウェブを開かずにできます。自動売買プログラムは API を通じてルールどおりに発注します。

API を使うには、まずキーを作ります。プログラムはこのキーで「この口座から許可を受けている」ことを証明します。キーで何ができるかは、作成時にどの権限を付けたかで決まります。

OKX の API キーの作り方

OKX に登録する
出金権限は絶対に付けない。自動売買に必要なのは読み取りと取引だけです。キーが漏れても、出金権限がなければコインは動かせません。
  1. OKX にウェブでログインし、Profile → API and connections を開いて Create API key を押します。
  2. API キーの名前を入力し、口座と用途を選びます。
  3. IP ホワイトリストを設定します(次の節を参照)。
  4. 権限は Read と Trade にチェックし、Withdraw にはチェックしません。
  5. パスフレーズを設定して控えておきます。作成後は OKX で再表示されません。
  6. セキュリティ認証を済ませ、API キーとシークレットキーを控えて安全な場所に保管します。

三つそろえて自動売買プログラムに渡します。一つでも欠けると接続できません。

IP ホワイトリストは設定すべき?

OKX の公式 API FAQ によると、取引または出金権限を持ち IP を設定していないキーは、14 日間動きがないと自動で削除されます。IP を設定すればキーは放置で失効せず、キーを手に入れた人がほかの場所から使うこともできません。一つのキーに設定できる IP は最大 20 個です。

設定するのは「プログラムを動かすマシン」のグローバル IP で、スマホや普段ネットに使っている IP ではありません。自宅回線の IP は変わることがあり、変わったら新しい IP をホワイトリストに追加します。

Blave Agent なら、クラウドサーバーの接続画面にサーバーの IP が表示されるので、そのまま入力します。デスクトップ版は設定を求めませんが、設定しない場合は 14 日ルールを忘れずに。

OKX API のよくあるエラーコード

自動売買でよく出るエラーをまとめました。意味は OKX 公式 API ドキュメントに従い(51008 は Blave の発注プログラムの分類に従っています)、対処は一般的な目安です。

コード意味対処
一つ目:キーと権限の問題。接続時や発注時にすぐ拒否されます
50111API キーが無効貼り間違いや前後の余分な空白がないか確認
50113署名が無効たいていシークレットキーの貼り間違い。貼り直す
50105パスフレーズが違うキー作成時に自分で決めたもの。ログインパスワードではない
50110IP がホワイトリストにないプログラムを動かすマシンの新しい IP をホワイトリストに追加
50119キーが存在しない削除された可能性あり(14 日ルールなど)。作り直す
50100API が凍結されているOKX のサポートに問い合わせる
二つ目:キーは問題ないのに、その注文自体が通らない
51010現在の口座モードでは非対応Spot mode では先物を取引できない。口座モード設定で先物に対応したモードに変更
51008証拠金不足資金を追加するか、戦略の金額を下げる
51020最小注文数量を下回っている戦略の金額を上げるか、最小単位の小さい銘柄にする
50102リクエストのタイムスタンプが期限切れプログラムを動かすマシンの時計がずれている。自動時刻同期をオンにする
三つ目:結果が分からない。最も注意が必要です
50004API リクエストのタイムアウト再送せず、まず注文を確認
51149注文のタイムアウト再送せず、まず注文を確認
50001サービスが一時的に利用できない再送せず、まず注文を確認
50026システムエラー再送せず、まず注文を確認

OKX のドキュメントには、50004 と 51149 は「リクエストの成功も失敗も意味しない」とはっきり書かれています。注文はすでに約定しているかもしれず、そのまま再送すると二重に発注されます。Blave Agent はこの四つのコードでは同じ注文を再送しません。先物の成行注文は約定したかどうかを確認してから次の動きを決め、それ以外の注文は止まって報告し、自動では再試行しません。

自分で OKX API を使うプログラムを書く場合、ここが最も事故の起きやすいところです。

Blave Agent で OKX につなげば、ここを自分で処理しなくていい

上のエラー処理は、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 キーは口座の取引権限そのものなので、信頼できないサイトやプログラムには貼らないでください。出金権限は絶対に付けず、使わなくなったキーは削除します。自動売買で損失が消えるわけではなく、ルールどおりに執行するだけです。レバレッジを使えば損失も膨らみます。