自動売買のAPI設定でつまずく場所は、キーの権限、接続元の制限、資金の置き場所、約定直後の反映の4つにほぼ集まる。
どれもツールが壊れているわけではない。
取引所側とツール側の設定が、1か所だけ食い違っているために起きる。
この記事では、送金を終えて取引所に資産がある状態から、ツールが動かないときに確かめる順番と、本番の前に済ませておくことを整理する。
自動売買のAPI設定でつまずくのはどこなのか
止まる場所は、キーを作る段階、接続する段階、注文を出す段階、約定した後の段階の4つに分けられる。
どこで止まっているかが分かれば、確かめる場所は1つに絞れる。
APIとは、取引所の外にあるプログラムが、取引所に注文や残高の確認を頼むための窓口のことだ。
自動売買のツールは、窓口を通してあなたの口座を操作する。
起きていることから、止まった段階を当てる
まず、ツールの画面で何が起きているかを見る。
症状ごとに疑う場所は決まっている。
| 起きていること | 疑う場所 |
|---|---|
| キーを入れても認証で弾かれる | キーの写し間違い、権限の不足 |
| 認証は通るのに接続を拒否される | 接続元の制限、パソコンの時計 |
| 残高が0と表示される | 資金を置いている口座の区分 |
| 注文だけが通らない | 銘柄の書き方、注文の数量、権限 |
| 新規は通るのに決済の注文が失敗する | 約定直後の反映待ち |
エラー文は読み飛ばさずに翻訳する
ツールが出すエラー文は英語で表示されることが多い。
読み飛ばしたくなるが、場所を当てる一番の手がかりになる。
signature、permission、IP、balance、timestampのような単語が入っていれば、それだけで見当がつく。
署名、権限、接続元、残高、時刻のどれで止まったかが分かる。
APIキーを作るとき、どこで間違えやすいのか
キーを作る段階の間違いは、控え方と権限の付け方でほぼ決まる。
作る前にツールの説明書で必要な権限を確かめておけば、作り直しは1回で済む。
シークレットキーは作った画面で控える
APIキーは、公開してよいキーと、他人に見せてはいけないシークレットキーの2本1組でできている。
ツールは2本を使って、あなた本人の依頼だと取引所に示す。
取引所によっては、シークレットキーは作った画面を閉じるともう表示されない。
控え損ねたら、探すよりもキーを削除して作り直すほうが早い。
権限は取引まで付けて、出金は付けない
キーを作る画面では、キーに許す操作を選ぶ。
自動売買に必要な権限は限られている。
- 読み取りの権限は、残高や注文の状況を確かめるのに使う
- 取引の権限は、売買の注文を出すのに使う
- 出金の権限は、資産を外へ送るためのもので、自動売買には使わない
見落としやすいのが先物の権限だ。
現物と先物で権限が分かれている取引所では、先物の権限を付け忘れると現物の注文だけが通る。
先物で動かすツールなら、作る前に項目を確かめておく。
貼り付けたときに空白や改行が混ざる
キーをメモアプリに控えてから貼ると、前後に空白や改行が入ることがある。
見た目では分からないが、1文字でも余計に入れば認証は通らない。
公開キーとシークレットキーを逆の欄に入れる間違いもよく起きる。
認証で弾かれたら、まず貼り直しと欄の入れ替えを試す。
キーは正しいのに、接続を拒否されるのはなぜか
キーが合っていても接続を拒否されるなら、原因は接続元の制限か、パソコンの時計のずれのどちらかだ。
どちらもキーを作り直しても直らない。
IP制限と、ツールが動く場所を合わせる
IPアドレスは、インターネット上の住所にあたる番号だ。
IP制限を付けると、登録した住所から来た依頼だけを取引所が受け付けるようになる。
つまずくのは、登録した住所とツールが動く場所が違うときだ。
キーを自宅のパソコンで作り、自宅の住所を登録したのに、ツールは仮想専用サーバー（VPS）で動いている。
こうなると依頼はすべて拒否される。
VPSは、自宅のパソコンを点けっぱなしにしなくても、ツールを24時間動かせる借りたサーバーのことだ。
登録するのは、VPSの管理画面に表示される住所にする。
インターネット上で動くツールなら、提供元が案内している接続元を登録する。
パソコンの時計がずれている
APIへの依頼には、送った時刻が書き込まれる。
取引所は時刻が大きくずれた依頼を、古い依頼の使い回しとみなして弾く。
エラー文にtimestampやtimeが出ていたら、ツールが動くパソコンやVPSの時計を見る。
時刻を自動で合わせる設定を有効にすれば、多くはそれで直る。
接続できたのに注文が通らないのはなぜか
送金を終えた人が一番引っかかるのは、資金の置き場所だ。
入金した資金は現物の口座にあるのに、ボットは先物の口座を見ている。
ツールには残高が0と映り、注文はすべて断られる。
資金を、取引する口座の区分へ振り替える
取引所の中の口座は、現物用、先物用のように区分が分かれていることが多い。
送ってきた資産がどの区分に入ったかを確かめて、ボットが使う区分へ移す。
- 取引所の資産画面で、区分ごとの残高を開く
- ツールの説明書で、ボットが使う区分を確かめる
- 振替の画面で、資金をボットが使う区分へ移す
- ツールで残高を読み込み直し、数字が出るかを見る
銘柄の書き方と、注文の数量を合わせる
同じ銘柄でも、取引所によって書き方が違う。
区切りの記号が入るか入らないかだけで、存在しない銘柄として弾かれる。
ツールの設定は、取引所のAPIの書き方にそろえる。
注文の数量も見落としやすい。
銘柄ごとに受け付ける最小の数量と刻み幅が決まっており、下回ると注文は通らない。
数値は取引所の銘柄情報で確かめる。
約定した直後は、建玉の反映を待ってから次の注文を出す
建玉とは、買ったまま、あるいは売ったまま決済していない持ち高のことだ。
新規の注文は通るのに、決済や損切りの注文だけが失敗するなら、反映の遅れを疑う。
暗号資産に限った話ではない。
国内の証券会社のAPIでも、成行で約定した直後に持ち高がまだ反映されておらず、すぐ出した逆指値が通らなかったという問い合わせが開発者の間で上がっている。
対処は、約定のすぐ後に次の注文を出さないことだ。
持ち高が反映されたのを確かめてから損切りを出す処理を入れる。
失敗したら少し待って出し直す処理も入れておく。
本番の資金で動かす前に、何を確かめておけばよいか
本番の前にやることは、操作を1つずつ動かして確かめることと、止め方を先に決めておくことの2つだ。
全部をまとめて動かすと、どこで止まったのか分からなくなる。
最小の数量で、操作を1つずつ動かす
戦略をいきなり走らせず、APIの操作を1つずつ試す。
1つ通るたびに、取引所の画面でも同じ結果になっているかを見る。
- 残高を読み込み、取引所の画面の数字と一致するかを見る
- 最小の数量で、約定しない指値の注文を1本出す
- 出した注文を、ツールから取り消す
- 最小の数量で約定させ、決済の注文まで通す
- ツールの記録と、取引所の注文履歴を見比べる
3つ目の取り消しは飛ばしがちだが、外さないほうがいい。
注文を出せても取り消せないツールは、相場が動いたときに止められない。
止める手順と記録を先に用意する
ボットが思わぬ動きをしたときに、どこを押せば止まるかを先に決めておく。
慌てているときに説明書を読む余裕は無い。
- ツールの停止ボタンで、新しい注文を止める
- 取引所の画面で、残っている注文を取り消す
- 取引所の管理画面で、APIキーを無効にする
ツールの記録（ログ）も、ファイルに残す設定にしておく。
止まった時刻と直前のエラー文が残っていれば、次に同じところでつまずかずに済む。
APIを使わずに自動売買を始める道はあるか
ある。
取引所の画面に組み込まれたボットを使えば、キーの作成も接続元の登録もいらない。
ここまでの4つのつまずきのうち、キーと接続の2つが丸ごと無くなる。
外部ツールと内蔵ボットの違い
| 比べる点 | 外部ツールとAPI | 取引所の内蔵ボット |
|---|---|---|
| APIキー | 作成と管理が要る | 要らない |
| 設定する場所 | ツールと取引所の両方 | 取引所の画面だけ |
| 戦略の自由さ | 自分で組める | 用意された型から選ぶ |
| 動かす場所 | パソコンやVPSを用意する | 取引所の側で動く |
設定で止まり続けるなら、内蔵ボットで流れをつかむ
自分で組んだ戦略を動かしたいなら、外部ツールの自由さには代えがたい。
一方で、自動売買がどう注文を並べ、どう決済するかを先に体で覚えたいなら、内蔵ボットから入るほうが近道になる。
流れが分かってからAPIに戻れば、エラー文の意味も読みやすい。
たとえばBingXは、グリッドやマーチンゲールのボットを標準で備えており、仮想の資金で操作を試せるデモ取引も用意している。
よくある質問
キーを作り直したら、ツールの設定もやり直すのか
やり直す。
新しい2本のキーをツールに入れ直す。
古いキーは取引所の管理画面から削除しておく。
残したままだと、どのキーがどこで使われているのか分からなくなる。
出金の権限を付けないと、ボットは動かないのか
動く。
売買と残高の確認に必要なのは、読み取りと取引の権限だけだ。
出金の権限を求めてくるツールなら、何に使うのかを説明書で確かめてから決める。
自宅の回線で動かすとき、IP制限はどうすればよいか
自宅の回線は、接続元の番号が変わることがある。
変わると登録した住所と合わなくなり、ある日突然つながらなくなる。
止まったら今の接続元を確かめて登録し直す。
24時間動かすなら、接続元が固定されるVPSへ移すと止まりにくい。
ボットが止まっていたことに、後から気づいたらどうするか
先に取引所の画面で、残っている注文と持ち高を確かめる。
次にツールの記録で、止まった時刻と直前のエラー文を探す。
原因が分かるまでは再開しない。
この記事のポイント
- API設定のつまずきは、キー、接続、注文、約定後の4つの段階に分けて探す
- キーは作った画面でシークレットを控え、権限は読み取りと取引までにする
- 接続を拒否されたら、IP制限の登録先とパソコンの時計を見る
- 残高が0と出たら、資金を置いている口座の区分を確かめて振り替える
- 本番の前に、最小の数量で注文、取り消し、決済を1つずつ通しておく
暗号資産とブロックチェーンの可能性を追求するエミリー。
暗号資産投資、DeFi、NFT、WEB3、メタバースといった最先端分野を深く理解し、「エミリーズ・クリプト・インサイダー」を運営。
分かりやすい解説で、ブロックチェーン革命の潮流を一般に広めることを目指す。初心者から上級者まで、最新情報を求めるすべての人に役立つ情報発信を心がけている。