auカブコム証券 kabuステーションAPI完全ガイド — 個人投資家向け株式自動売買APIの実装

API概要

kabuステーションAPI（kabu STATION API）は、三菱UFJ eスマート証券（旧auカブコム証券）が提供する個人投資家向けのプログラミング発注基盤。2020年8月リリース。

ユーザーのPC上で起動している「kabuステーション」がローカルHTTPサーバーとして動作し、REST API経由でデータ取得・注文執行を行う。OpenAPI 3.0仕様（v1.5）で定義されており、任意のプログラミング言語から利用可能。

利用条件・セットアップ

前提条件

1. 三菱UFJ eスマート証券の口座開設（無料）
2. kabuステーション Professional プラン以上の適用
3. kabuステーションAPI利用申し込み（Web上で完結、審査不要）

セットアップ手順

1. メンバーズサイト → 設定・申込 → らくらく電子契約 → 取引ツール → kabuステーションAPI利用設定
2. kabuステーション起動 → 右上「</>」アイコン右クリック → APIシステム設定
3. 「APIを利用する」にチェック → APIパスワード設定（英数字6〜16桁） → ソフトリミット金額設定
4. kabuステーション再起動（アイコン緑色で利用可能）

認証方式

トークンベース認証。/tokenエンドポイントにAPIパスワードを送信してトークンを取得し、以降のリクエストでX-API-KEYヘッダーに設定。

import requests

# トークン取得
res = requests.post("http://localhost:18080/kabusapi/token", json={
    "APIPassword": "your_api_password"
})
token = res.json()["Token"]

# 以降のリクエストにトークンを設定
headers = {"X-API-KEY": token}

エンドポイント一覧

発注系（秒間5件制限）

情報取得系（秒間10件制限）

取引余力系（秒間10件制限）

銘柄コード取得

PUSH配信用銘柄登録（秒間10件制限）

対応市場

発注リクエスト例

現物買い注文（指値）

order = {
    "Password": "trading_password",
    "Symbol": "7203",        # トヨタ自動車
    "Exchange": 1,           # 東証
    "SecurityType": 1,       # 株式
    "Side": "2",             # 買い（1=売り, 2=買い）
    "CashMargin": 1,         # 現物
    "DelivType": 2,          # お預り金
    "FundType": "AA",        # 信用代用
    "AccountType": 2,        # 特定口座
    "Qty": 100,              # 数量
    "Price": 2500,           # 指値価格
    "ExpireDay": 20260320,   # 期限
    "FrontOrderType": 20     # 指値（10=成行, 20=指値）
}

res = requests.post(
    "http://localhost:18080/kabusapi/sendorder",
    json=order,
    headers={"X-API-KEY": token}
)
print(res.json())
# {"ResultCode": 0, "OrderId": "20260314A01N06848002"}

注文種別コード（FrontOrderType）

板情報取得

res = requests.get(
    "http://localhost:18080/kabusapi/board/7203@1",
    headers={"X-API-KEY": token}
)
board = res.json()

レスポンスに含まれる主要フィールド：

WebSocket PUSH配信

接続

import asyncio
import websockets
import json

async def receive_push():
    uri = "ws://localhost:18080/kabusapi/websocket"
    async with websockets.connect(uri) as ws:
        while True:
            data = json.loads(await ws.recv())
            print(f"{data['Symbol']} {data['SymbolName']}: {data['CurrentPrice']}")

asyncio.run(receive_push())

PUSH配信前の銘柄登録

# 銘柄登録（最大50銘柄）
requests.put(
    "http://localhost:18080/kabusapi/register",
    json={"Symbols": [
        {"Symbol": "7203", "Exchange": 1},  # トヨタ
        {"Symbol": "9984", "Exchange": 1},  # ソフトバンクG
    ]},
    headers={"X-API-KEY": token}
)

PUSH配信にはオプション固有のグリークス（IV、デルタ、ガンマ、セータ、ベガ）も含まれる。

レート制限

超過時はエラーレスポンスが返される。

制約事項

• kabuステーションを起動しているPCと同一IPアドレスからのリクエストのみ受付（リモートアクセス不可）
• kabuステーションは常時起動が必要（Windows専用）
• 1PCにつき1インスタンスのみ起動可能
• 利用可能時間: 6:30〜翌6:15（毎日自動ログアウト）
• ソフトリミット（1日あたりの注文金額上限）の設定必須
• PUSH配信は最大50銘柄

SDK・ライブラリ

公式サンプル（GitHub: kabucom/kabusapi）

リポジトリ: 388スター、MITライセンス

非公式ライブラリ

• python-kabusapi（shirasublue/python-kabusapi）— REST + WebSocket対応、pip install requests websockets

手数料

他社API比較

結論: 個人投資家が株式自動売買APIを利用する場合、kabuステーションAPIが最も整備されている。公式ドキュメント・OpenAPI仕様・検証環境・サンプルコードが揃い、信用取引手数料無料の特典がある。主な制約はWindows PC上でのkabuステーション常時起動が必要な点。

リファレンス

• APIポータル: https://kabucom.github.io/kabusapi/ptal/
• APIリファレンス（Swagger UI）: https://kabucom.github.io/kabusapi/reference/index.html
• OpenAPI定義（YAML）: GitHub kabucom/kabusapi リポジトリ
• PUSH API仕様: https://kabucom.github.io/kabusapi/ptal/push.html
• 利用開始手順: https://kabucom.github.io/kabusapi/ptal/howto.html
• GitHub: https://github.com/kabucom/kabusapi