１．はじめに

２．リリース＆改定情報

３．ご利用方法

４．ご利用にあたって

５．マニュアル

６．サンプルプログラム

７．その他

１．はじめに

１．目的
　このページは立花証券・ｅ支店システム（以下ｅ支店と呼ぶ）の
　アプリケーションプログラミングインタフェース（以下ＡＰＩと呼ぶ）専用ページです。

　本ＡＰＩを利用することでご自分で作成したプログラムからｅ支店に注文発注ができます。

　例えば、ご自分で注文受発注用の自動売買ロボットプログラム等を開発し、
　プログラムから注文受発注を行うことが可能となります。

　従来ブラウザでご利用いただいておりますｅ支店・ＰＣブラウザ画面
　（以下ｅ支店・標準Ｗｅｂと呼ぶ）の操作による注文受発注機能を、
　本ＡＰＩを利用しプログラムにて行うことが可能となります。

　ＡＰＩのご利用は無料で個人や投資家の皆様に株価（４本値、板、
　日足等過去約２０年分を蓄積するヒストリカル情報など）、
　日本株のニュース等の情報取得のためのインタフェース機能を提供します。

２．特徴
　本ＡＰＩの特徴としては、通常の要求＆応答方式のＡＰＩ（以下 REQUEST I/F と呼ぶ）とは別に、
　リアルタイム株価ボードシステムの開発で培ったノウハウを利用し
　注文約定等通知データをリアルタイム配信するＡＰＩ（以下 EVENT I/F と呼ぶ）を合わせて兼ね備えている点です。

　従来よくある REQUEST I/F のみのＡＰＩの場合、
　注文入力後に注文照会を何度も呼び出すことで約定したかどうかを確認する（ポーリング方式）必要があるため
　利用するにも手間がかかる上、システム的にも負荷がかかり、利用者もＡＰＩ提供側にも使いにくいＡＰＩでした。

　本ＡＰＩではポーリング方式の欠点を克服するため導入した EVENT I/F を利用することで、
　毎回ＡＰＩを呼び出す（ポーリングする）ことなく
　ｅ支店システムから約定等通知をリアルタイム（イベント方式）で受信し
　市場での約定等状態をいち早くプログラムで検知することが可能になります。

３．概要
　本ＡＰＩはインターネット経由でｅ支店システムのＷｅｂサーバに接続することで利用できます。
　（１）認証 I/F
　　・プロトコル　：HTTPS GET（ｖ４ｒ８から HTTPS POST もサポート）
　　・データ形式　：JSON
　　・日本語コード：ShiftJIS
　（２）REQUEST I/F
　　・プロトコル　：HTTPS GET（ｖ４ｒ８から HTTPS POST もサポート）
　　・データ形式　：JSON
　　・日本語コード：ShiftJIS
　（３）EVENT I/F（HTTP Protocol 版）
　　・プロトコル　：HTTPS GET (Chunk Responce)
　　・データ形式　：専用形式
　　・日本語コード：ShiftJIS
　（４）EVENT I/F（WebSocket Protocol 版）（ｖ４ｒ７からサポート）
　　・プロトコル　：HTTPS 1.1 GET (Handshake and Switching Protocols Responce) ＋ WebSocket Protocol
　　・データ形式　：専用形式（（３）準拠）
　　・日本語コード：ShiftJIS
　　※（４）は（３）と同情報を異 Protocol で取り扱うＩ／Ｆです。
　　※WebSocket Protocol の詳細は RFC 6455 等を参照。

４．提供機能
　本ＡＰＩでは以下機能を提供します。
　（１）認証機能（認証 I/F）
　　・ログイン
　　・ログアウト
　（２）業務機能（REQUEST I/F）
　　・株式新規注文
　　・株式訂正注文
　　・株式取消注文（含む一括取消）
　　・現物保有銘柄一覧
　　・信用建玉一覧
　　・買余力
　　・建余力＆本日維持率
　　・売却可能数量
　　・注文一覧
　　・注文約定一覧（詳細）
　　・可能額サマリー
　　・可能額推移
　　・現物株式買付可能額詳細
　　・信用新規建て可能額詳細
　　・リアル保証金率
　（３）マスタ機能（REQUEST I/F）
　　・株式銘柄マスタ問合取得
　　・株式銘柄市場マスタ問合取得
　　・先物銘柄マスタ問合取得
　　・オプション銘柄マスタ問合取得
　　・指数銘柄マスタ問合取得
　　・為替銘柄マスタ問合取得
　　・日付情報問合取得
　　・呼値情報問合取得
　　・代用掛目情報問合取得
　　・株式銘柄別・市場別規制情報問合取得
　　・派生銘柄別・市場別規制情報問合取得
　　・保証金マスタ問合取得
　　・取引所エラー等理由コード情報問合取得
　　・ニュース問合取得
　　・銘柄詳細情報問合取得
　　・証金残情報問合取得
　　・信用残情報問合取得
　　・逆日歩情報問合取得
　（４）時価情報機能（REQUEST I/F）
　　・時価情報問合取得
　　・蓄積情報問合取得
　（５）注文約定通知（EVENT I/F）
　　・注文約定等通知
　　・ｅ支店システム、システムステータス（開局、閉局等）
　　・ｅ支店システム、運用ステータス（注文受付開始、終了等）
　　・リアルタイム株価ボード・時価
　　・リアルタイム株価ボード・ニュース

戻る ２．リリース＆改定情報

2026.08.29 ｅ支店・ＡＰＩ（ｖ４ｒ１０）リリース
　　　　１．ｅ支店・ＡＰＩ（ｖ４ｒ１０）リリース
　　　　　　２０２６年０７月２９日に告知いたしましたｅ支店・ＡＰＩ（ｖ４ｒ１０）を平行リリースいたします。

　　　　２．変更概要
　　　　　（１）〜（３）は告知をご参照願います。
　　　　　（４）．その他
　　　　　　　・本専用ページ「１．はじめに」、４．提供機能、（３）マスタ機能の記載変更。
　　　　　　　・本専用ページ「３．ご利用方法」、１．記載追記、４．、７．、９．記載変更。
　　　　　　　・本専用ページ「４．ご利用にあたって」、２．（３）を追記。
　　　　　　　・本専用ページ「５．マニュアル」を修正、リンク先資料の一部を（ｖ４ｒ１０）に最新化。
　　　　　　　・本専用ページ「６．サンプルプログラム」を本バージョン用に対応、時価情報取得表示サンプルを廃止。
　　　　　　　・本バージョン用 JSON 引数項目名称・番号変換用プログラム mfds_json_api_compress_v4r10.js を公開。

　　　　【今後の予定】
　　　　　１．０９月２７日、ｅ支店・ＡＰＩ（ｖ４ｒ９）廃止
　　　　　２．０９月２７日、信用残情報問合取得・項目名称変更（マニュアル）
　　　　　　　東証の該当情報配信仕様（週単位から日単位）変更により該当Ｉ／Ｆ（の変更はありません）の項目名称を変更。
　　　　　　　東証が予定どおり０９月２８日にリリースした場合、１６：００頃に配信予定。


2026.07.29 ｅ支店・ＡＰＩ（ｖ４ｒ１０）リリース、（ｖ４ｒ９）廃止告知
　　　　システム負荷低減を目的とし、
　　　　マスタ等情報の取得方式を従来のＩ／Ｆから各個別情報毎問合取得Ｉ／Ｆに仕様変更いたします。

　　　　その対応として
　　　　１．ｅ支店・ＡＰＩ（ｖ４ｒ１０）（平行）リリース
　　　　２．ｅ支店・ＡＰＩ（ｖ４ｒ９）廃止
　　　　の実施を予定しております。

　　　　その間ｖ４ｒ９からｖ４ｒ１０への移行期間としますので
　　　　ご利用者様にはご対応のほど、よろしくお願いいたします。

　　　　ｅ支店・ＡＰＩ専用ページはｖ４ｒ１０リリースに同期し４ｒ１０用に変更となりますので
　　　　ｖ４ｒ９用のサンプル等が必要な場合、それまでに入手利用をお願いいたします。

　　　　１．ｖ４ｒ１０（平行）リリース。
　　　　　　２０２６年０８月２９日、ｅ支店・ＡＰＩ（ｖ４ｒ１０）を（平行）リリース致します。

　　　　２．ｖ４ｒ９廃止
　　　　　　２０２６年０９月２７日、ｅ支店・ＡＰＩ（ｖ４ｒ９）を廃止致します。

　　　　３．変更概要
　　　　　（１）．廃止Ｉ／Ｆ
　　　　　　　・マスタ情報ダウンロード・・・・・・・・・・CLMEventDownload
　　　　　　　・マスタ情報問合取得・・・・・・・・・・・・CLMMfdsGetMasterData
　　　　　　　・ニュースヘッダー問合取得・・・・・・・・・CLMMfdsGetNewsHead
　　　　　　　・ニュースボディー問合取得・・・・・・・・・CLMMfdsGetNewsBody
　　　　　（２）．追加Ｉ／Ｆ
　　　　　　　・株式銘柄マスタ問合取得・・・・・・・・・・CLMStkGetIssueMstKabu
　　　　　　　・株式銘柄市場マスタ問合取得・・・・・・・・CLMStkGetIssueSizyouMstKabu
　　　　　　　・オプション銘柄マスタ問合取得・・・・・・・CLMStkGetIssueMstOp
　　　　　　　・先物銘柄マスタ問合取得・・・・・・・・・・CLMStkGetIssueMstSak
　　　　　　　・指数銘柄マスタ問合取得・・・・・・・・・・CLMStkGetIssueMstIndex
　　　　　　　・為替銘柄マスタ問合取得・・・・・・・・・・CLMStkGetIssueMstFx
　　　　　　　・取引所エラー等理由コード情報問合取得・・・CLMStkGetOrderErrReason
　　　　　　　・日付情報問合取得・・・・・・・・・・・・・CLMStkGetDateZyouhou
　　　　　　　・呼値情報問合取得・・・・・・・・・・・・・CLMStkGetYobine
　　　　　　　・代用掛目情報問合取得・・・・・・・・・・・CLMStkGetDaiyouKakeme
　　　　　　　・株式銘柄別・市場別規制情報問合取得・・・・CLMStkGetIssueSizyouKiseiKabu
　　　　　　　・派生銘柄別・市場別規制情報問合取得・・・・CLMStkGetIssueSizyouKiseiHasei
　　　　　　　・保証金マスタ問合取得・・・・・・・・・・・CLMStkGetHosyoukinMst
　　　　　　　・ニュース問合取得・・・・・・・・・・・・・CLMMfdsGetNews
　　　　　（３）．廃止情報
　　　　　　　・システムステータス、運用ステータス等は EVENT I/F をご利用願います。
　　　　　　　・各情報内の不要項目を削除。


＊＊＊＊　以下過去履歴　＊＊＊＊
2026.06.27 ｅ支店・ＡＰＩ（ｖ４ｒ８）、廃止
2026.05.16 ｅ支店・ＡＰＩ（ｖ４ｒ９）、リリース
2026.04.26 ｅ支店・ＡＰＩ（ｖ４ｒ９）、リリース延期
2026.03.27 ｅ支店・ＡＰＩ（ｖ４ｒ９）、リリース、（ｖ４ｒ８）廃止告知
2025.11.29 ｅ支店・ＡＰＩ（ｖ４ｒ７）、廃止
2025.09.27 ｅ支店・ＡＰＩ（ｖ４ｒ８）、リリース、（ｖ４ｒ６）廃止
2025.07.26 ｅ支店・ＡＰＩ（ｖ４ｒ７）、保守リリース
2025.05.31 ｅ支店・ＡＰＩ（ｖ４ｒ７）、リリース、（ｖ４ｒ５）廃止
2025.04.25 ｅ支店・ＡＰＩ（ｖ４ｒ７）、リリース、（ｖ４ｒ５）廃止告知
2025.02.22 ｅ支店・ＡＰＩ（ｖ４ｒ６）、リリース、情報問合取得Ｉ／Ｆ追加。
2025.01.29 ｅ支店・ＡＰＩ（ｖ４ｒ６）、リリース告知
2024.11.03 ｅ支店・ＡＰＩ（ｖ４ｒ５）、保守リリース
2024.03.31 ｅ支店・ＡＰＩ（ｖ４ｒ５）、保守リリース、EVENT I/F・通知項目追加。
2023.12.31 ｅ支店・ＡＰＩ（ｖ４ｒ５）、リリース、（ｖ４ｒ「３４」）廃止
2023.12.15 ｅ支店・ＡＰＩ（ｖ４ｒ５）、デモ環境先行リリース
2023.10.02 ｅ支店・ＡＰＩ（ｖ４ｒ５）、リリース告知、新ＮＩＳＡ（成長枠）対応
2023.07.22 ｅ支店・ＡＰＩ（ｖ４ｒ４）、リリース（2023.12.31 廃止）
2023.05.20 ｅ支店・ＡＰＩ（ｖ４ｒ３）、保守リリース、マスタダウンローﾄﾞ機能
2023.04.01 ｅ支店・ＡＰＩ（ｖ４ｒ２）、廃止
2022.11.19 ｅ支店・ＡＰＩ（ｖ４ｒ３）、リリース（2023.12.31 廃止）、（ｖ４ｒ１）廃止
2022.09.21 ｅ支店・ＡＰＩ（ｖ４ｒ２）、デモ環境、ｅ支店・ＡＰＩ（テスト環境）公開
2022.09.03 ｅ支店・ＡＰＩ（ｖ４ｒ２）、保守リリース、注文一括取消機能追加対応
2022.06.06 ｅ支店・ＡＰＩ（ｖ４ｒ２）、保守リリース、東証障害時対応
2022.04.02 ｅ支店・ＡＰＩ（ｖ４ｒ２）、保守リリース、東証再編対応
2021.10.15 ｅ支店・ＡＰＩ（ｖ４ｒ２）、保守リリース、EXECL(VBA) 利用サンプル公開
2021.06.27 ｅ支店・ＡＰＩ（ｖ４ｒ２）、リリース（2023.04.01 廃止）、（ｖ４）廃止
2021.04.25 ｅ支店・ＡＰＩ（ｖ４ｒ１）、デモ環境、標準Ｗｅｂ等画面（テスト環境）リリース
2021.02.13 ｅ支店・ＡＰＩ（ｖ４ｒ１）、リリース（2022.11.19 廃止）
2020.11.22 ｅ支店・ＡＰＩ（ｖ３系）、廃止
2020.10.24 ｅ支店・ＡＰＩ（ｖ４）、リリース（2021.06.27 廃止）
2020.09.26 ｅ支店・ＡＰＩ（ｖ３ｒ３）、リリース（2020.11.22 廃止）
2020.09.26 ｅ支店・ＡＰＩ（ｖ３ｒ２）、リリース（2020.11.22 廃止）
2020.08.21 ｅ支店・ＡＰＩ（ｖ３）、リリース（2020.11.22 廃止）
2020.07.25 ｅ支店・ＡＰＩ（ｖ２）、リリース（2020.08.21 廃止）
2020.07.14 ｅ支店・ＡＰＩ（ｖ２）、立花証券・ｅ支店・ＡＰＩ専用ページ（本ページ）公開
2020.07.13 ｅ支店・ＡＰＩ（ｖ２）（公開バージョン）開発
2020.06.29 ｅ支店・ＡＰＩ（ｖ１）（実験バージョン）開発

戻る ３．ご利用方法

１．利用設定
　　ｅ支店・ＡＰＩのご利用には
　　（１）標準Ｗｅｂ、パスキー登録の実施
　　（２）ｅ支店・ＡＰＩ・利用設定の実施
　　（３）公開鍵暗号化方式の秘密キー・公開キーの作成、及び公開キーの登録
　　が必須です。
　　※（２）、（３）については標準Ｗｅｂ・お客様情報、ｅ支店・ＡＰＩ利用設定のリンクから該当画面を開き操作します。
　　※（３）の秘密キー、公開キーについては利用者自身で作成（利用設定画面の操作でも作成機能を提供）し、
　　　秘密キーは利用者自身で管理、公開キーはｅ支店システムに登録し利用します。

２．認証機能（認証 I/F）
　　認証用ＵＲＬへ認証要求を送信し結果を応答で受信します。
　　応答が正常の場合、５種類の仮想ＵＲＬ（REQUEST、MASTER、PRICE、EVENT、EVENT-WebSocket）を返します。
　　応答がエラーの場合はエラーコードにより理由を判断します。
　　※各種書面（金商法交付書面等）が未読の場合、応答が正常でも仮想ＵＲＬが発行されない（ｅ支店・ＡＰＩが利用できない）ため
　　　標準Ｗｅｂにて既読操作をお願いいたします。

３．業務機能（REQUEST I/F）
　　本機能を利用する場合２．で取得した仮想ＵＲＬ（REQUEST）へ該当要求を送信し結果を応答で受信します。
　　※REQUEST I/F は一問一答（要求送信後応答を待ち次の要求を送信する）方式（利用者側での使い方に対する制限）となります。
　　※HTTP プロトコルを利用したインタフェースであるため、使い方により同時並列に要求は出せてしまいますが、
　　　その場合の動作保証はできませんのでご注意下さい。

４．マスタ機能（REQUEST I/F）
　　本機能を利用する場合２．で取得した仮想ＵＲＬ（MASTER）へ該当要求を送信し結果を応答で受信します。
　　※REQUEST I/F は一問一答（要求送信後応答を待ち次の要求を送信する）方式（利用者側での使い方に対する制限）となります。
　　※HTTP プロトコルを利用したインタフェースであるため、使い方により同時並列に要求は出せてしまいますが、
　　　その場合の動作保証はできませんのでご注意下さい。

　　弊社で発注可能な銘柄情報や各種規制情報、値幅情報等発注機能に関する各種付帯情報など
　　お客様が発注用アプリケーション等を構築され時に、予め入力チェック等に必要な情報の取得が本機能でできます。
　　※入力チェック等については本ＡＰＩの注文入力各機能で実装のため、お客様のプログラムにてチェック機能の実装無しでも
　　　本システムによりチェックを行いますが、本情報の取得により事前にお客様プログラムにてチェックすることも可能です。

５．時価情報機能（REQUEST I/F）
　　本機能を利用する場合２．で取得した仮想ＵＲＬ（PRICE）へ該当要求を送信し結果を応答で受信します。
　　※REQUEST I/F は一問一答（要求送信後応答を待ち次の要求を送信する）方式（利用者側での使い方に対する制限）となります。
　　※HTTP プロトコルを利用したインタフェースであるため、使い方により同時並列に要求は出せてしまいますが、
　　　その場合の動作保証はできませんのでご注意下さい。

　　具体的には銘柄コード及び時価情報項目を複数指定することで、該当情報を問合取得することができます。
　　１要求では最大１２０までの銘柄コードが指定できます。
　　また指定取得できる時価情報項目は株価ボード・ＰＣ画面に表示している各項目になります。

６．注文約定通知（EVENT I/F）
　　本機能を利用する場合２．で取得した仮想ＵＲＬ（EVENT）へ該当要求を送信します。
　　※WebSocket 版利用の場合は仮想ＵＲＬ（EVENT-WebSocket）送信。
　　その後はｅ支店システムとの接続を維持したまま受信待ちとし、ｅ支店システムから通知データが送信される都度該当データを受信します。
　　※本Ｉ／Ｆは配信専用であるため、利用者側がデータを受信しない場合、ｅ支店システムは送信できるまで待つ仕様です。
　　　通知受信に関してはインターネットの経路、及び受信するハード性能に依存します（俗に言うところのベストエフォート送信です）。
　　※REQUEST I/F で注文入力要求、応答の送受信をした後 EVENT I/F でｅ支店システムからの注文受付等各種通知を送信する
　　　シーケンスですが、ｅ支店システムからお客様プログラムまでの間の通信環境やお客様プログラムの処理の都合により、
　　　応答や通知を受信または処理する順番が逆になるケースが想定されますのでご注意ください。
　　※e支店・ＡＰＩ（ｖ３ｒ２）よりリアルタイム株価ボードの時価通知機能をサポート（公開）致しましたが、
　　　時価については間引き処理をしています。
　　　また、お客様の通信環境等によりデータ受信が遅延する（時価が遅れて受信される）場合がありますので
　　　予めご注意願います。

７．仮想ＵＲＬについて
　　本ＡＰＩ利用時は認証し仮想ＵＲＬを取得する必要があります。
　　仮想ＵＲＬはｅ支店システムで生成するｅ支店システム内でユニーク（重複しない）となります。
　　仮想ＵＲＬは認証後毎回新たに作成すると共に、その時点で先認証で作成した仮想ＵＲＬは無効とします（１顧客１仮想ＵＲＬ）。
　　仮想ＵＲＬが無効になるタイミングは以下です。
　　・多重認証
　　・ログアウト
　　・ｅ支店システム閉局
　　・ｅ支店・利用設定画面で「利用する」から「利用しない」に設定変更
　　・ｅ支店・利用設定画面で「無効化」実施
　　・運営側の判断でｅ支店・ＡＰＩの利用ロック実施
　　仮想ＵＲＬは無効になると、それ以降ご利用でき（再度有効になり）ません。
　　無効となった仮想ＵＲＬに要求した場合、応答でエラーを返します。

　　仮想ＵＲＬは認証時、機能毎に５種類（仮想ＵＲＬ（REQUEST、MASTER、PRICE、EVENT、EVENT-WebSocket））取得します。
　　仮想ＵＲＬ REQUEST, MASTER, PRICE は REQUEST I/F（プロトコル）、EVENT、EVENT-WebSocket は EVENT I/F（プロトコル）で通信を行います。
　　REQUEST I/F 及び EVENT I/F は各１接続のみ利用可能（各１接続の範囲で同時（並列）利用ができます）が、無効化タイミングは同時です。

　　本ＡＰＩは HTTP プロトコル でインタフェースする性質上、
　　仮想ＵＲＬへのアクセスは通常のインターネットページの表示と同様、同時並列に要求を送信可能なインタフェースとなっています。
　　そのインタフェースは照会系機能についての性質であり、サーバへデータを入力する機能については顧客毎にシリアル処理（異なる性質の処理）のため
　　REQUEST I/F は一問一答（要求送信後応答を待ち次の要求を送信する）方式（利用者側での使い方に対する制限）となります。

　　またブラウザ等での自動再送処理等による同要求重複送信をｅ支店システム（受信側）で回避するため、要求データに設定する送信通番を
　　前受信要求．送信通番＞＝今受信要求．送信通番の場合、処理せずエラー応答を返します。

　　EVENT I/F は常時接続で１接続のみ受け付け、先要求は自動で切断します（後要求勝ち）が
　　接続を受け付けた時点で以前接続した処理が終了していない場合、
　　以前の処理（通信切断完了などの後処理）が終了するのを待ってから次の処理を開始しますので
　　切断処理（通信切断完了などの後処理）が終了してから次の接続処理を行うよう対応願います。

　　仮想ＵＲＬはログアウト等で無効化しない場合、最終的にｅ支店システム閉局時までｅ支店システム内で有効な状態として維持します。
　　仮想ＵＲＬを通して注文受発注を行うため、セキュリティ強化を考える場合、認証し必要機能を実施した後、ログアウトすることで
　　仮想ＵＲＬを無効化し、クライアントとｅ支店間のつながり（セッション）を無くすことができます（お客様の利用方法依存のため任意です）。
　　仮想ＵＲＬは意味のない（目で見える）文字列であり、該当文字については決まったフォーマット仕様はありません（任意で仕様が変わります）。

８．利用時間について
　　利用時間はｅ支店システムの稼働時間帯です。
　　ｅ支店システムの保守や障害等発生時は、ｅ支店・標準Ｗｅｂ同様本ＡＰＩもご利用頂けません。
　　本ＡＰＩはｅ支店システムのサブシステムであるため、ｅ支店システムが通常稼働していても
　　本ＡＰＩ用サブシステムが障害発生時はご利用頂けません。
　　このケースの場合、本ＡＰＩで発注した注文についてはｅ支店・標準Ｗｅｂの注文等照会機能によりご確認をお願いいたします。
　　また、その後の注文についての処理（訂正、取消など）についてはｅ支店・標準Ｗｅｂをご利用ください。

９．セキュリティー
　　本ＡＰＩ はインターネット経由でｅ支店口座をお持ちの全てのお客様向けにリリースを想定した機能ですが
　　バージョン（ｖ４ｒ９）から利用設定、及び公開鍵暗号化方式の導入等、セキュリティ―を強化しています（下記参照）。

　　本ＡＰＩはインターネット経由での接続を公開しお客様の責任でご利用頂くインタフェースです。
　　インターネット上の通信データのセキュリティー確保の意味ではｅ支店・標準Ｗｅｂ同様 SSL 通信の範囲となります。
　　インターネット上に流れる情報についてはインターネット上に公開される（インターネット上に情報が流れるため
　　物理的にはその経路上で他人に見られる可能がある）前提でご利用をお願いいたします。
　　※これは暗号化しても圧縮しても解読に時間がかかるかどうかの問題であり、インターネット上に情報を流したら見えてしまう性質上の問題です。

　　バージョン（ｖ４ｒ９）から公開鍵暗号化方式を導入し、セキュリティ―を強化しています。
　　バージョン（ｖ４ｒ９）からの対応として
　　・ｅ支店・ＡＰＩをご利用のお客様は新たに追加した利用設定画面（標準Ｗｅｂ・お客様情報のリンクから遷移）で
　　　ｅ支店・ＡＰＩの利用有無の選択（デフォルトは利用しない）を実施する。
　　・ｅ支店・ＡＰＩ．認証機能の変更（引数からログインＩＤ、パスワードを廃止、電話認証廃止（ｖ４ｒ８の廃止時）など）。
　　・ｅ支店・ＡＰＩ．ログインメール、及び設定変更メールの送信機能追加。
　　※ｅ支店・ＡＰＩ（ｖ４ｒ９）の変更概要につきましては別途「変更概要説明書」を参照願います。

戻る ４．ご利用にあたって

１．本ＡＰＩのご利用にはｅ支店の口座開設が必要となります。

２．ｅ支店の口座開設後、ｅ支店・標準Ｗｅｂにパスキーでログイン頂いた後に以下操作が必要になります。
　　（１）各種書面（金商法交付書面等）の確認
　　　　各種書面が未読の場合、ｅ支店・標準Ｗｅｂがご利用頂けないのと同様、本ＡＰＩもご利用頂けません。

　　（２）ｅ支店・ＡＰＩの利用設定
　　　　お客様情報・設定情報・ｅ支店・ＡＰＩ利用設定（リンク）からｅ支店・ＡＰＩ、利用設定画面へ遷移し、
　　　　ｅ支店・ＡＰＩ利用有無を「利用する」に選択、選択後表示される必須項目について設定する。

　　（３）秘密キー・公開キーの作成＆公開キーの登録
　　　　バージョン（ｖ４ｒ９）から採用しました公開鍵暗号化方式の導入により、
　　　　秘密キー・公開キーの作成、及び公開キーの登録（利用設定画面にて操作）が必須になります。

　　本ＡＰＩの機能はｅ支店・標準Ｗｅｂの一部機能について、
　　お客様の画面操作に代わり、お客様が開発したプログラムからｅ支店・標準Ｗｅｂの機能を実行するものです。

　　そのため、本ＡＰＩのご利用はｅ支店・標準Ｗｅｂで上記確認を実施頂くことにより
　　本ＡＰＩを含むｅ支店のご利用によるリスクを全て許容して頂くことが前提となります。

　　また、各種書面については追加変更がありますので、その都度ｅ支店・標準Ｗｅｂにてご確認（許容）頂く必要があります。

３．新規、訂正、取消等の各注文入力機能には第二暗証番号が必要となります。
　　ｅ支店・標準Ｗｅｂ・お客様情報画面、第二暗証番号・暗証番号省略設定の有効、無効に関わらず
　　本ＡＰＩの各注文入力機能には第二暗証番号の引数設定が必須となります。

４．インサイダー申告頂きました銘柄につきましては本ＡＰＩからの新規注文入力機能、訂正注文入力機能はご利用頂けません。
　　ただし、取消注文入力機能については緊急性を考慮しご利用頂けるよう対処しております。
　　インサイダー申告銘柄の新規及び訂正注文入力につきましてはｅ支店・標準Ｗｅｂからのご利用をお願いいたします。

５．本ＡＰＩはお客様が（ご自身で）作成されたプログラムからの利用を想定したインタフェース（機能）の提供を目的としています。
　　そのため、各種注文入力機能等につきましてはｅ支店・標準Ｗｅｂの各種注文入力機能等にあります入力内容確認機能は
　　本ＡＰＩを利用するお客様側のプログラムで実施する前提で、お客様の確認後の入力内容を本ＡＰＩを通して入力頂くことになります。

　　本ＡＰＩを通して入力頂いた注文入力内容は弊社業務システムで必要な業務チェックをした後、
　　問題ない場合はそのまま市場へ取り次ぎ（発注）を行います。

６．当社システムのご利用に際し過負荷であると当社が判断した場合、口座利用を停止させて頂く場合がございます。

７．当社提供情報は、蓄積、編集および加工等は禁止しております。ご利用については当社規定の範囲内でご利用ください。

８．本ＨＰのマニュアル、及びサンプルプログラムを参照並びに解析頂きご利用ください。
　　本ＡＰＩのご利用に限らず、
　　一般的にＡＰＩと呼ばれるアプリケーションプログラミングインタフェースをご利用する観点での話にはなりますが、
　　一般的にＡＰＩを利用するには、システム開発経験（ＨＴＴＰ及びＪＳＯＮに関する知識、
　　インターネット経由での通信プログラム作成経験や開発能力）等、一定以上の開発能力が必要であり、
　　本ＡＰＩのサンプルプログラム、及びマニュアルを見て開発できる力量、技量が必要となりますので予めご留意願います。

９．流量制限
　　本ＡＰＩで注文入力の偏りを防ぎ各お客様に公平にご利用いただくため、
　　お客様からの要求受付に対し流量制限（秒１０件）をしております。

　　この値は、注文における設計上の上限です。
　　すべての要求をこの上限で可能とするキャパシティーを当社は用意できておりません。

　　システム全体に負荷が掛かるようなご利用がないようご協力をお願いいたします。

１０．利用監視
　　ｅ支店・ＡＰＩのサービスは全ての利用者様で共有利用となっておりますので
　　全ての利用者様に対し公平なサービスの提供が行えるよう対応しております。

　　そのため、負荷が大きいと判断した利用者様には現在個別にご連絡させて頂いておりますが
　　全ての利用者様に安全かつ公平なサービスを提供することが前提にありますので
　　ご協力のほど、よろしくお願い申し上げます。

戻る ６．サンプルプログラム

以下リンクをクリックするとｅ支店・ＡＰＩを利用したサンプルプログラムを表示します。
※本サンプルプログラムはｅ支店・ＡＰＩ（ｖ４ｒ１０）専用です。
　ｅ支店・ＡＰＩ（ｖ４ｒ９）ではご利用頂けませんのでご注意願います。

１．基本利用方法
２．EVENT IF WebSocket版
３．python 利用サンプル
　・e_api_sample.py (v4.10)
　・e_api_sample.txt (説明書)

１〜２の各サンプルページは右クリック（ページソースコード表示）で全て参照＆利用可能です。
ｅ支店・ＡＰＩを利用したプログラム開発の際、参考資料の１つとしてご利用下さい。
※サンプルプログラムはお客様がｅ支店・ＡＰＩを利用したプログラム開発をする目的のみに利用を許諾致します。
※サンプルプログラムは当社の都合により提供の停止を含む機能追加変更削除等を行いますので予めご了承下さい。

なお、
サンプルプログラムはお客様がｅ支店・ＡＰＩを利用したプログラム開発をする目的でｅ支店・ＡＰＩの使い方をその１例として参考提供することが目的ですので
サンプルプログラム（として提供する全てのソースコード）の使用（含む一部機能（クラス、メソッド、サブルーチン等を含む）の利用や流用等）の
実行により生じた全ての障害・損害・不具合等に関しては一切の責任を負いませんので、自己の判断、及び自己の責任においてご（参考）利用をお願いいたします。

戻る ７．その他

１．ネットワーク疎通確認
　　本ＡＰＩのご利用にはお客様のプログラム（以下クライアントと呼ぶ）から弊社本ＡＰＩプログラム（以下サーバと呼ぶ）に
　　インターネットを経由し HTTPS プロトコルで接続及びデータ通信をする必要があります。
　　お客様の契約先インターネット回線から不特定多数の回線業者のルータ等機器類を経由し
　　弊社契約先回線業者を通して弊社サーバに接続し
　　その逆をたどってお客様とのデータ通信を行うことで本ＡＰＩが機能いたします。
　　そのため本ＡＰＩをご利用前に、通信環境の確認として以下をお試しください。

　　（１）立花証券・ｅ支店・ＡＰＩ専用ページ（以下本ページと呼ぶ）の表示確認。
　　　　　本ページ（本記載内容）が見えていることで、クライアントからサーバまでのネットワーク的な疎通確認となります。
　　　　　本ページが見えている＝本ＡＰＩにアクセス可能、本ページが見えていない＝本ＡＰＩにアクセス不可能を意味しますので
　　　　　本ＡＰＩが使えない・・・とか本ＡＰＩに接続できない・・・と思う場合はこちらで判断ください。
　　　　　※ただし、サービス時間帯以外や休日の保守作業による休止時間帯を除きます。

　　（２）本専用ページまでのアクセス時間の確認。
　　　　　クライアントからサーバまでのアクセスが遅い・・・と感じられる場合は以下をお試しください。
　　　　　% wget https://kabuka.e-shiten.jp/e_api/mfds_json_api_sample.html -O output.html
　　　　　実行結果として転送バイト数、ページ取得 % と転送時刻 s などが表示されます。
　　　　　ちなみに、弊社社員の自宅ＰＣ（光回線）から試したところ 26054 バイト を 0.003 秒 で転送（アクセス時間 0.003 秒）した結果でした。
　　　　　結果はクライアント〜サーバ間のシステム構成やネットワーク環境に依存しますので上記の計測結果が遅いと感じられる場合は
　　　　　お客様のご利用ＰＣやシステム環境、通信環境等の見直しが必要となりますので予めご留意願います。
　　　　　※wget は linux のコマンドになりますので、windows をご利用の場合は windows で稼働するフリーの wget ソフト等を
　　　　　　インストール（フリーソフトのインストールや実行については自己責任でお願いいたします）しご確認ください。

２．サーバ障害対策
　　本ＡＰＩの稼働サーバは複数台を並列稼働し本ＡＰＩサービスの提供を行っております。
　　万が一その内の１台が障害で停止した場合は該当サーバを切り捨て他の稼働サーバで継続運用致します。
　　ただし、タイミングにより該当サーバへ処理を割り振られた本ＡＰＩの要求（応答受信前に障害発生）については
　　クライアントは HTTPS のレベルでエラーを検知（本ＡＰＩの応答は返らない）となります。
　　このケースにおいて該当要求が注文入力である場合は応答が返されないため注文入力可否が判定できませんので
　　本ＡＰＩの注文一覧、または標準Ｗｅｂの注文一覧にて該当注文が発注されたかどうかについてご確認をお願いいたします。
　　※ｅ支店システムが障害（例として基幹データベースの障害など）等の場合、各ＡＰＩはエラー応答(p_errno!=0)を返します。
　　※ｅ支店システムが閉局等の場合も同様に各ＡＰＩはエラー応答(p_errno!=0)を返します。
　　※ p_errno については「立花証券・ｅ支店・ＡＰＩ（ｖＮ[ｒＮ]）、REQUEST I/F、利用方法、データ仕様」参照。

３．ＵＲＬエンコード
　　本ＡＰＩは HTTP プロトコルでインタフェースする仕様上
　　お客様からの要求については URL に JSON 文字列として指定頂く仕様となっております。
　　そのため URL の記述仕様上意味を持つ文字（例：「#+/:=」等）は直接指定することができません。
　　それらにつきましてはＵＲＬエンコード（文字変換）を行い、ＵＲＬに指定可能なエンコード文字（列）として指定頂く必要があります。
　　例：「#」→「%23」、「+」→「%2B」、「/」→「%2F」、「:」→「%3A」、「=」→「%3D」など。
　　※通常の業務データ（注文入力等）では上記文字を指定することはありませんが、パスワード等は該当しますのでご注意ください。

戻る