メインコンテンツへスキップ
見出し画像
Photo byakanemachi

ウィブル証券OpenAPIで米国株の自動売買を行う

    (2026年8月26日追記:公式ドキュメントとSDKが全面刷新されたため、本記事の依存パッケージとコードを新しい公式SDK「webull-openapi-python-sdk」に対応させました。また、米国株のオプション取引(単一レグ)にもAPI経由で対応されています)

    (2025年9月25日追記:API v2に対応し、日本株現物も取引可能になりました。また、指値位置のパラメーターを追加しました)

    こんにちは、日本爆損防止委員会です。

    当会は、ここ数年でにわかに盛り上がりを見せる株・暗号資産・FX等の金融商品取引により、取り返しのつかない爆損をしてしまう人を無くすことを目的とし、発信活動をしています。

    以前、日本株の自動売買を行う方法について記事を書かせていただきました。

    爆損をしないためには、金融商品トレードなんぞから離れるのが一番です。

    しかし、相場に脳をやられてしまった方々は金融市場から離れることはできないでしょう…。そこで、やるならせめて自動売買にしておきましょうというのが、前回の日本株の自動売買の記事と、今回の記事に共通するメッセージです。

    期待値の高いトレードロジックがあり、自動売買を実装することができれば、多少は長く相場に関わることができるでしょう。

    今回は米国株編です。

    現在(2025年4月22日)、トランプ関税により米国株をはじめとするリスク資産は大変なことになっていますが、中長期で見れば買い時の可能性はそれなりにあるんじゃないかと思います。でもいつ相場が回復するのかわからないので、何かやるならコツコツと現物株を買っていくのがいい気がします。

    そこで今回は、ウィブル証券のOpenAPIを用いて、米国株を現物取引で自動売買する方法を共有します。

    米国株、と書きましたが、ウィブル証券はETFも取り扱っているため、現在イケイケのゴールド(のETF)も取引可能です。実際、この記事ではゴールドETF(IAU)をOpenAPIから購入するbotを実装します。このbotを定期的に動かすことで、ドルコスト平均法を実行できます。

    「ドルコスト平均法って要は積立でしょ?わざわざプログラミングしてbot作らなくても、大手の証券会社でポチポチすればできるじゃん」

    と思われた方、全くもってその通りです!

    ただ、botにすると成行注文だけでなく指値注文もできたり、発注のタイミングも任意にカスタマイズできます。また、ドルコスト平均法以外の取引手法をbot化したくなったときの下地にもなりますから、所謂botterの方にはやっといても良いのかなと思います。米国のマーケットはね、でっかいですからね。

    (注)この記事は金融に関するアドバイスではありません
    (注)この記事は裁量取引も自動売買も推奨しません
    (注)この記事に書かれているコードを用いて得られたあらゆる結果に、当方は責任を持ちません

    ウィブル証券とは

    米国の証券会社です。つい最近Nasdaqに上場してましたね。

    The trading experience you deserve, courtesy of @WebullGlobal. 🐂

    ⚡️ Webull is now #NasdaqListed. pic.twitter.com/HhdAlxirzB

    — Nasdaq Exchange (@NasdaqExchange) April 16, 2025

    この記事はあくまで米国株現物取引botを作ることが目的であり、ウィブル証券のプロモーションではありません。詳しくは公式ウェブサイトをご覧いただき、口座を開設するかはご自身でご判断ください。私は単に米国株をAPIで取引したくて口座を作りました。

    ウィブル証券のOpenAPIについて

    PythonとJavaのSDKが用意されており、ドキュメントも(英語ですが)かなりわかりやすいと思います。

    上記リンクから、API利用環境の構築手順及びAPIでの注文発注までの流れ​を日本語で説明したpdfも閲覧することができます。
    (2026年8月追記:ドキュメントサイトが全面リニューアルされ、構築手順は公式ドキュメントの Getting Startedに集約されました)

    画像
    公式構築マニュアル

    Pythonのダウンロードから始まるので、かなり優しいチュートリアルですね。

    画像
    構築マニュアルp1

    この公式構築マニュアルと、OpenAPIのドキュメントを反復横跳びすることで、米国株自動売買botを作ることができます。

    日本株の自動売買をするために以前ご紹介したkabustation APIは、ローカルPC (windowsのみ可) で専用アプリケーションの立ち上げを挟む必要があり、紹介しておいてなんですが正直使い勝手はよくないです。

    一方、ウィブル証券のOpenAPIはそういった煩わしいことなく、公式ウェブサイト上で発行したAPI keyとSecretがあればlinux環境でも自動売買botを動かすことができるのがいいですね。仮想通貨botを作るのと全く同じノリでbotが作れます。

    現在(2025年4月22日)、米国現物株しかOpenAPIでは取引できませんが、今後は信用取引やオプション取引もOpenAPIを通じてできるようになることを期待しています。

    利用するには、ウィブル証券に口座を開設し、OpenAPI利用申請を行うことが必要です。

    画像
    https://www.webull.co.jp/center/openapi/steps

    一方でお伝えしないといけないのは、OpenAPIでは現在のところsecretの有効期限が45日しか選べません(2026年8月追記:現在の公式ドキュメントからは有効期限に関する記載が見つかりません。最新の公式サイトでご確認ください)。

    画像

    つまり少なくとも45日に1度はウェブサイトからログインして、新たなsecretを発行する手続きが必要になります。OpenAPIの登録画面の、「Keyのリセット」からsecretの再発行ができます。

    画像

    ここは面倒なので、手動でやらなくて済む方法を取り入れて欲しいですね。

    OpenAPIでゴールドETFを購入する

    それでは早速botを実装していきましょう。私は悲しいことにpythonしか書けませんので、公式のpython SDKを利用します。Pythonの環境設定はそれだけで記事が書けてしまいますので割愛します。私はuvがいいと思います。

    (2026年8月追記:公式SDKが一新され、現在は下記の一つをインストールするだけでOKです。旧webull-python-sdk-*系パッケージはレガシー扱いなので注意してください)

    "webull-openapi-python-sdk>=2.0",

    Pythonスクリプト自体は、転売等の面倒な事態を避けるため有料とさせていただきますが、botの仕様は公開します。手っ取り早く動くものが欲しい方はご購入いただきたいですが、この仕様と公式OpenAPIのドキュメントをなんらかのAIに読ませれば、たぶん同等のものはできると思います。

    実行すると、デフォルトではIAU (iSharesのゴールドETF)に買い付けを行うことができます。もちろん、それ以外の米国ETF・株も指定できますし、買付予算も設定できます。cron等でこのbotを定期実行することを想定しています。

    画像
    実行結果例

    注意点としては、現状API経由での注文はドル建てしか受け付けられていないため、ウィブル証券に入金後にドルに振替していただく必要があります。円高のときを見計らってやりましょう。

    今回実装したbotですが、主な機能と処理の流れは以下の通りです。

    主な機能

    • ドルコスト平均法の実装

    • 一定金額(デフォルト$100)を定期的に特定の銘柄(デフォルトはIAU:金ETF)にOpenAPIから発注

    • 市場価格または指値注文による購入をサポート

    • 銘柄、カテゴリ、金額、戦略などのパラメータをコマンドラインから指定可能

    • OpenAPIのpython SDKを用いたwrapperクラスを実装しており、別の取引戦略に横展開可能

    注文戦略

    • market戦略:現在の市場価格で注文

    • limit戦略:過去30日間高値の80%で指値注文を設定(コモディティはかなりボラティリティが高いので、強欲な指値設定をしています。もちろんスクリプトの該当箇所の数字をいじれば変更可能です)

    処理の流れ

    • 環境変数からWebull APIキーとシークレットを読み込み

    • Webullクライアントを初期化

    • アカウント情報の取得

    • アカウントIDの確認

    • 現在の注文状況の取得

    • 同じ銘柄の既存注文のキャンセル

    • 利用可能な資金(予算)の確認

    • 市場データの取得

    • 対象銘柄の価格データ(OHLCV)を取得

    • 現在価格の確認

    • 注文数量の計算

    • 固定金額を現在価格で割って購入数量を決定

    • 最低1株以上になるよう調整

    こうして書き出してみると、簡単なbotでもやることはかなりありますね…。

    個人的な推しは、OpenAPIのwrapperクラスが実装できたことで、今後の色々な取引戦略の実装が楽になったことですね。現物株だとできることは限られてしまうかもしれませんが、信用取引やオプション取引が今後API経由でできるようになれば、可能性は大きく広がります。米国のマーケットはね、でっかいですからね。

    ここまで読んでいただき、ありがとうございました。皆さんが爆損なく人生を謳歌できますことを心より願っております。

    この記事はnoteマネーにピックアップされました

    noteマネー 今週の特集「AI株を占うエヌビディア決算」
     
     
    爆損に苦しむ人がこれ以上増えないよう、株・為替・暗号資産の取引とそれに伴う行動心理について発信しています。X(旧Twitter)はやっていません。

    あなたへのおすすめ