kabu API × Node.jsの環境構築に入る前に理解すべきこと
kabuステーション API を Node.js で使いたいけど、どこから始めればいいか分からない…。
そんな初心者の方に向けて、 Node.js を使い、 kabuステーション API と連携した 自動売買 やデータ取得を始めたい方へ、Windows環境でのセットアップ手順をわかりやすく解説します。
この記事はこんな方に向けています
- Node.js （JavaScript）を使って kabuステーション API での 自動売買 を始めたい初心者の方
- Windows環境で Node.js のセットアップから API 接続までの手順を知りたい方
- kabuステーション API の基本的な使い方や認証の流れを理解したい方
- JavaScriptや Node.js に触れたことはあるが、 自動売買 システム構築の具体的な入口を知りたい方
注意：
kabuステーション はWindows専用のアプリケーションです。Macでの利用には 仮想環境 などの追加準備が必要になります。
詳しくは【こちらの記事】をご参照ください。
1. Node.jsとは？JavaScriptとの違いとkabu API利用の前提知識
Node.js は、サーバーサイドでJavaScriptを動かすための実行環境です。ブラウザで使うJavaScriptとは異なり、ファイル操作やHTTP通信、 API 接続などが可能です。
✅ kabuステーションAPIにNode.jsを使う理由
- HTTPリクエストによる API 呼び出しが簡単
- 環境構築がシンプル
- JavaScriptベースのため学習コストが低い
JavaScriptでの運用にあたって注意点もあるため、こちらも参考にしてください。
kabuステーションAPIをNode.jsで使うための前提条件と注意点
以下のことが済んでいる前提で進めます。
- kabuステーション がインストール済みで起動中
- API 利用申請済み
- API パスワードを登録済み
まだ準備ができていない場合は、先に以下の記事をご覧ください：
2. Node.jsをWindowsにインストールする方法【初心者向け】
✅ 手順：
- 公式サイトから「LTS版（推奨版）」をダウンロード
- インストーラーを実行し、すべてデフォルト設定でインストール
- ターミナル（PowerShellやコマンドプロンプト）で以下を確認：
インストール後、以下のコマンドで動作確認：
node -v
npm -vバージョンが表示されればOKです。
3. プロジェクトフォルダと初期化（npm init）
任意の作業フォルダを作り、 Node.js のプロジェクトを初期化します。
mkdir kabu-api-test
cd kabu-api-test
npm init -y4. kabuステーション APIで通信するためのaxios導入
必要パッケージのインストール（ axios ）
API
通信には axios を使うのが一般的で、扱いやすく初心者にもおすすめです。
npm install axios5. kabuステーションAPIとの接続テスト（認証トークンの取得）
kabuステーション では、ローカルPC上の API サーバー（ポート18080/18081）を通じてリクエストを送ります。
✅ APIのベースURL
環境 | ベースURL |
|---|---|
本番用 | http://localhost:18080/kabusapi |
検証用 | http://localhost:18081/kabusapi |
auth.js というファイルを作成し、以下の内容をコピー＆ペースト：
// ※このコードはNode.js実行環境（ローカル）でのみ動作します。
// ブラウザでは使えません。
const axios = require("axios");
const data = {
APIPassword: "your_password", // 実際のAPIパスワードに置き換えてください
// APIPassword: '********' // (検証用・本番用があります)
};
const url = "http://localhost:18081/kabusapi/token"; // 検証用
// const url = 'http://localhost:18080/kabusapi/token'; // 本番用
axios
.post(url, data, {
headers: {
"Content-Type": "application/json",
},
})
.then((response) => {
console.log("ステータス:", response.status, response.statusText);
console.log("レスポンスヘッダー:", response.headers);
console.log("レスポンスデータ:", response.data);
})
.catch((error) => {
if (error.response) {
console.error("APIエラー:", error.response.status, error.response.data);
} else {
console.error("通信エラー:", error.message);
}
});
コマンドプロンプトまたはPowerShellで以下を実行：
node auth.js- kabuステーション は 起動中かつログイン済みである必要があります。
- 「 API の利用を許可する」にもチェックが入っているか確認してください。
レスポンスデータ: { ResultCode: 0, Token: '************' }これで
API
の認証
トークン
が取得できました。
この
トークン
を利用して以降の
API
リクエスト（発注、情報取得など）が可能になります。
FAQ: よくある質問
Q: Pythonじゃなくてもいいんですか？
A: はい、問題ありません。kabuステーション APIはREST形式のAPIであり、HTTPリクエストを送信できる言語であれば利用できます。Pythonがよく紹介されますが、Node.jsやC#、Javaなどでも同様に実装可能です。
この記事では、Webとの親和性が高く、JavaScript経験者が入りやすいという理由からNode.jsを採用しています。将来的にWebhook連携やWebアプリ化を考えている場合も、JavaScriptベースで構築しておくと拡張しやすいというメリットがあります。
👉️ JavaScript（Node.js）でAPI運用する場合の注意点まとめ
Q: トークンは毎回取得する必要がありますか？
A: はい、必要です。kabuステーション のAPIトークンはセッション単位で発行される仕組みになっています。そのため、kabuステーションを再起動した場合やログアウトした場合、一定時間が経過した場合などにはトークンが無効になります。
検証段階では手動取得でも問題ありませんが、実運用で自動売買を行う場合はトークンを自動で再取得する処理を組み込むのが一般的です。
👉️ より汎用的な実装コードはこちらでも紹介しています。
Q: MacではkabuステーションAPIは使えませんか？
A: 基本的に、kabuステーション はWindows専用のアプリケーションです。APIはローカルで起動しているkabuステーションと通信する仕組みのため、Mac単体では利用できません。
Macで利用する場合は、Windowsの仮想環境を構築するか、Windows搭載PCを別途用意する必要があります。クラウド上のWindows環境を使うという選択肢もありますが、いずれにしてもWindows環境が前提になります。
👉️ Mac上の仮想化方法などはこちら
次のステップへ（注文・データ取得・自動売買）
ここまでで環境構築と接続確認は完了です。
認証が確認できれば以下のような操作に進めます：
- 発注 API で株を売買する
- 保有銘柄や残高を取得
また、まだ kabuステーション API の申請やアプリのダウンロードが終わっていない方は、以下の記事を参考にしてください。
✅️ 補足：環境構築や運用設計が不安な方へ
- 「自分でコードを書いて検証する時間がない」
- 「まずは安定した環境で運用を始めたい」
という方は、実運用環境を構築済みの形で導入する方法もあります。
👉 実際に触れるデモはこちら
👉 FO（Flex Order）導入・構築サービスを見る
📌 この記事で基本の仕組みは理解できたかと思います。
より実践的に、 TradingView の Webhook から kabuステーション API で株を発注する構成を構築したい方は、以下の記事をご覧ください。
で学ぶ
