# 相場データ関連
# Q1：登録失敗
A: 登録APIがエラーを返す場合、以下の2つのケースが一般的です。
登録枠不足：
登録枠のルールは登録枠 & 過去ローソク足データ枠を参照してください
登録権限不足：
登録をサポートする相場権限は下表の通りです
市場 商品 登録をサポートする相場権限 香港市場 株式 LV1, LV2, SF オプション LV1, LV2 先物 LV1, LV2 米国市場 株式 LV1, LV2 オプション LV1 先物 LV1, LV2 A株市場 株式 LV1 相場情報の利用権限の取得方法は相場情報の利用権限を参照してください
ご注意：アカウントが上記の権限を持っているのに登録に失敗する場合、他の端末に相場権限をキックアウトされている可能性があります。
# Q2：登録解除失敗
A: 登録後少なくとも1分経過してからでないと登録解除できません。
# Q3：登録解除成功したが枠が解放されない
A: すべての接続で該当相場の登録を解除して初めて枠が解放されます。
例：接続 A と接続 B の両方が HK.00700 の板情報を登録している場合、接続 A が登録解除しても、接続 B がまだデータを利用しているため、OpenD の枠は解放されません。すべての接続が HK.00700 の板情報を登録解除するまで解放されません。
# Q4：登録から1分未満でスクリプト接続をクローズした場合、枠は解放されますか？
A: されません。接続クローズ後、登録時間が1分未満の銘柄タイプは、1分経過後に自動的に登録解除され、対応する登録枠が解放されます。
# Q5：リクエスト頻度制限の具体的なロジックは？
A: 30秒以内に最大 n 回とは、1回目と n+1 回目のリクエストの間隔が30秒以上必要であることを意味します。
# Q6：ウォッチリストに銘柄を追加できないのはなぜ？
A: 上限を超えていないか確認し、一部のウォッチリスト銘柄を削除してみてください。
# Q7：OpenAPI の米国株株価情報とアプリの全米総合株価情報が異なるのはなぜ？
A: 米国株取引は多くの取引所に分散しているため、moomoo は2種類の米国株基本株価情報を提供しています。1つは Nasdaq Basic（Nasdaq 取引所の株価情報）、もう1つは全米総合株価情報（全米13取引所の株価情報）です。OpenAPI の米国正株相場は現在、行情カード購入による Nasdaq Basic のみサポートしており、全米総合株価情報はサポートしていません。そのため、アプリの全米総合株価情報行情カードと OpenAPI 用の Nasdaq Basic 行情カードを同時に購入している場合、アプリと OpenAPI で株価が異なる場合があります。
米国株の当日始値がクライアント表示と一致しない場合は、OpenAPI のリアルタイム上流相場が Nasdaq Basic データのみを取得しているためです。
# Q8：OpenAPI の行情カードはどこで購入できますか？
# Q9：リアルタイムデータの get APIのレスポンスが遅い場合があるのはなぜ？
A: リアルタイムデータの get APIは事前の登録が必要で、バックエンドから OpenD へのプッシュに依存します。登録直後にすぐ get APIでリクエストすると、OpenD がまだバックエンドからのプッシュを受信していない可能性があります。これを防ぐため、get APIには待機ロジックが組み込まれており、3秒以内にプッシュを受信すれば即座にスクリプトに返し、3秒を超えてもプッシュがない場合は空データを返します。
関連する get APIは get_rt_ticker、get_rt_data、get_cur_kline、get_order_book、get_broker_queue、get_stock_quote です。リアルタイムデータの get APIのレスポンスが遅い場合は、まず約定データがないことが原因でないか確認してください。
# Q10：OpenAPI 米国株 Nasdaq Basic 行情カード購入後に取得できるデータは？
A: Nasdaq Basic 行情カードの購入・有効化後、Nasdaq、NYSE、NYSE MKT 取引所に上場する有価証券（米国正株と ETF を含む。米国先物と米国オプションは含まない）のデータを取得できます。
サポートされるデータAPIは、スナップショット、過去ローソク足データ、リアルタイムティック登録、リアルタイム1段板情報登録、リアルタイムローソク足登録、リアルタイム株価情報登録、リアルタイム分時登録、到達価格アラートです。
# Q11：各相場商品の板情報は何段までサポートされていますか？
A:
| 相場商品 | LV1 | LV2 | SF |
|---|---|---|---|
| 香港株（正株、ワラント、CBBC、インラインワラントを含む） | / | 10 | フル板+1000件明細 |
| 香港株オプション先物 | 1 | 10 | / |
| 米国株（ETFを含む） | 1 | 60段 | / |
| 米国株オプション | 1 | / | / |
| 米国先物 | / | 40段 | / |
| A株 | 5 | / | / |
# Q12：行情カードを購入・有効化したのに、OpenD で相場権限がないのはなぜ？
A:
- OpenAPI の相場権限はアプリの権限と完全に同じではないため、一部の行情カードはアプリ端末のみ適用されます（例：OpenAPI 米国株行情カードは別途購入が必要）。購入した行情カードが OpenD に適用されるものか確認してください。
OpenAPI に適用されるすべての行情カードは「権限と制限」に掲載しています。こちらをクリックしてご確認ください。 - 行情カードの購入・有効化後は即座に反映されます。OpenD を再起動してから、権限状態を再確認してください。
# Q13：登録APIでリアルタイム相場を取得するには？
ステップ1：登録
銘柄コードとデータタイプを登録APIに渡して登録を完了します。
登録APIはリアルタイム株価情報、リアルタイム板情報、リアルタイムティック、リアルタイム分時、リアルタイムローソク足、リアルタイムブローカーキューデータの取得をサポートしています。登録成功後、OpenD は moomoo サーバーからリアルタイムデータのプッシュを継続的に受信します。
ご注意：登録枠は総資産、取引件数、取引量に応じて割り当てられます。具体的なルールは登録枠 & 過去ローソク足データ枠を参照してください。登録枠が不足している場合は、不要な登録が枠を占有していないか確認し、速やかに登録解除してください。
ステップ2：データ取得
登録プッシュのデータを OpenD からスクリプトに取得するには、以下の2つの方法があります。
方法1：リアルタイムデータコールバック
対応するコールバック関数を設定し、OpenD が受信したデータプッシュを非同期で処理します。
コールバック関数を設定すると、OpenD は受信したリアルタイムデータをすぐにスクリプトのコールバック関数にプッシュして処理します。
登録銘柄が活発な場合、プッシュデータ量が大きく頻度も高くなる可能性があります。OpenD からスクリプトへのプッシュ頻度を適度に下げたい場合は、OpenD 起動パラメータで API プッシュ頻度（qot_push_frequency）を設定することを推奨します。
方法1で使用するAPIは、リアルタイム株価情報コールバック、リアルタイム板情報コールバック、リアルタイムローソク足コールバック、リアルタイム分時コールバック、リアルタイムティックコールバック、リアルタイムブローカーキューコールバックです。
方法2：リアルタイムデータの取得
リアルタイムデータ取得APIを使用して、OpenD が受信した最新データをスクリプトに取得できます。この方法はより柔軟で、大量のプッシュを処理する必要がありません。OpenD がサーバーからのプッシュを継続受信していれば、必要な時にデータを取得できます。
OpenD が受信したプッシュデータから取得するため、このカテゴリのAPIには頻度制限がありません。
方法2で使用するAPIは、リアルタイム株価情報の取得、リアルタイム板情報の取得、リアルタイムローソク足の取得、リアルタイム分時の取得、リアルタイムティックの取得、リアルタイムブローカーキューの取得です。
# Q14：各マーケット状態はどの時間帯に対応しますか？
A:
| 市場 | 商品 | マーケット状態 | 時間帯（現地時間） |
|---|---|---|---|
| 香港市場 | 有価証券（株式、ETF、ワラント、CBBC、インラインワラントを含む） | * NONE：取引なし | CST 08:55 - 09:00 |
| * AUCTION：プレマーケットオークション | CST 09:00 - 09:20 | ||
| * WAITING_OPEN：寄付待ち | CST 09:20 - 09:30 | ||
| * MORNING：前場 | CST 09:30 - 12:00 | ||
| * REST: 昼休み | CST 12:00 - 13:00 | ||
| * AFTERNOON：後場 | CST 13:00 - 16:00 | ||
| * HK_CAS：香港株引け後オークション（CAS メカニズム対応のマーケット状態） | CST 16:00 - 16:08 | ||
| * CLOSED：引け | CST 16:08 - 08:55（T+1） | ||
| オプション、先物（日中取引のみ） | * NONE：オプション寄付待ち | CST 08:55 - 09:30 | |
| * MORNING：前場 | CST 09:30 - 12:00 | ||
| * REST: 昼休み | CST 12:00 - 13:00 | ||
| * AFTERNOON：後場 | CST 13:00 - 16:00 | ||
| * CLOSED：引け | CST 16:00 - 08:55（T+1） | ||
| 先物（日夜間取引） | * FUTURE_DAY_WAIT_FOR_OPEN：先物寄付待ち | 商品により取引時間が異なる | |
| * NIGHT_OPEN: 夜間取引時間帯 | |||
| * NIGHT_END：夜間取引終了 | |||
| * FUTURE_DAY_WAIT_FOR_OPEN：先物寄付待ち | |||
| * FUTURE_DAY_OPEN：日中取引時間帯 | |||
| * FUTURE_DAY_CLOSE：日中取引終了 | |||
| 米国市場 | 有価証券（株式、ETFを含む） | * PRE_MARKET_BEGIN：米国株プレマーケット取引時間帯 | EST 04:00 - 09:30 |
| * AFTERNOON：米国株通常取引時間帯 | EST 09:30 - 16:00 | ||
| * AFTER_HOURS_BEGIN：米国株アフターアワーズ取引時間帯 | EST 16:00 - 20:00 | ||
| * AFTER_HOURS_END：米国株アフターアワーズ終了 | EST 20:00 - 04:00（T+1） | ||
| * OVERNIGHT：米国株オーバーナイト取引時間帯 | EST 20:00 - 04:00（T+1） | ||
| オプション | * NONE：オプション寄付待ち | 商品により取引時間が異なる | |
| * REST：米指数オプション昼休み | |||
| * AFTERNOON：米国株通常取引時間帯 | |||
| * TRADE_AT_LAST：米指数オプション引け前取引時間帯 | |||
| * NIGHT：米指数オプション夜間取引時間帯 | |||
| * CLOSED：引け | |||
| 先物 | * FUTURE_SWITCH_DATE：米先物寄付待ち | 商品により取引時間が異なる | |
| * FUTURE_OPEN：米先物取引時間帯 | |||
| * FUTURE_BREAK：米先物中盤休憩 | |||
| * FUTRUE_BREAK_OVER：米先物休憩後取引時間帯 | |||
| * FUTURE_CLOSE：米先物終了 | |||
| A株市場 | 有価証券（株式、ETFを含む） | * NONE：取引なし | CST 08:55 - 09:15 |
| * Auction：プレマーケットオークション | CST 09:15 - 09:25 | ||
| * WAITING_OPEN：寄付待ち | CST 09:25 - 09:30 | ||
| * MORNING：前場 | CST 09:30 - 11:30 | ||
| * REST：昼休み | CST 11:30 - 13:00 | ||
| * AFTERNOON：後場 | CST 13:00 - 15:00 | ||
| * CLOSED：引け | CST 15:00 - 08:55（T+1） | ||
| シンガポール市場 | 先物 | * FUTURE_DAY_WAIT_FOR_OPEN：先物寄付待ち | 商品により取引時間が異なる |
| * NIGHT_OPEN：夜間取引時間帯 | |||
| * NIGHT_END：夜間取引終了 | |||
| * FUTURE_DAY_OPEN：日中取引時間帯 | |||
| * FUTURE_DAY_CLOSE：日中取引終了 | |||
| 日本市場 | 先物 | * FUTURE_DAY_WAIT_FOR_OPEN：先物寄付待ち | JST 16:25（T-1）- 16:30（T-1） |
| * NIGHT_OPEN：夜間取引時間帯 | JST 16:30（T-1） - 05:30 | ||
| * NIGHT_END：夜間取引終了 | JST 05:30 - 08:45 | ||
| * FUTURE_DAY_OPEN：日中取引時間帯 | JST 08:45 - 15:15 | ||
| * FUTURE_DAY_CLOSE：日中取引終了 | JST 15:15 - 16:25 |
# Q15：API パラメータの銘柄コード形式
A：
プログラミング言語によって必要な銘柄コードの形式が異なります。
Python ユーザー
銘柄コード code の形式：相場市場.コード。
例：テンセントホールディングスの場合、パラメータ code に 'HK.00700' を渡します。非 Python ユーザー
銘柄構造は Security を参照してください。
例：テンセントホールディングスの場合、パラメータ market に QotMarket_HK_Security、パラメータ code に '00700' を渡します。
確認方法：
アプリでコードと相場市場を確認：相場 > ウォッチリスト > すべて。
相場市場の定義はこちらを参照してください。
# Q16：権利落ち調整係数について
A：
# 概要
権利落ち調整とは、株価と出来高に対して権利・配当の修正を行い、株式の実際の騰落に基づいて株価チャートを描画し、出来高を同一株数基準に調整することです。
コーポレートアクション（株式分割、併合、株式配当、転換、新株割当、増資、配当金等）はいずれも株価に影響を与える可能性があり、権利落ち調整によって価格・出来高を調整し、コーポレートアクションの影響を排除して株価の連続性を保ちます。
# 用語解説
- コーポレートアクション：上場企業が行う、株価や株主のポジションに影響を与える株式関連の行為。
- 前方権利落ち調整：現在の株価を基準に、過去の株価に対して権利落ち調整を計算する。
- 後方権利落ち調整：過去の株価を基準に、以降の株価に対して権利落ち調整を計算する。
- 権利落ち調整係数：権利・配当修正比率。権利落ち調整後の価格およびポジション数量の計算に使用される。
- 権利落ち日：株主名簿確定日の翌営業日。権利落ち日に、証券取引所は権利落ち価格を算出し、投資家の寄付参考価格とする。株式配当が株主に分配される日を意味する。
# 権利落ち調整方法
主流の権利落ち調整計算方法にはイベント法と連乗法の2種類があり、OpenAPI では市場に応じて異なる計算方法を使用しています。
- イベント権利落ち調整法：権利落ち・配当落ちの各イベントを復元して調整する。2つの調整係数（調整係数 A と調整係数 B）があり、調整係数 B は主に現金配当の株価への影響を調整し、調整係数 A はその他のコーポレートアクションの影響を調整する。
- 連乗権利落ち調整法：調整係数を連乗する方式で調整する。調整係数 A のみ保持（または調整係数 B を 0 とする）し、調整係数 A = 権利落ち日前終値 / 権利・配当調整後の前終値。
ご注意
- OpenAPI は米国株の前方権利落ち調整に連乗法を使用し、調整係数 B を 0 とします。
- OpenAPI は米国株以外の銘柄（A株、香港株、シンガポール株等）および米国株の後方権利落ち調整にイベント法を使用します。
# 計算式
# 単回の権利落ち調整
- 前方権利落ち調整：
前方権利落ち調整価格 = 未調整価格 × 前方調整係数 A + 前方調整係数 B - 後方権利落ち調整：
後方権利落ち調整価格 = 未調整価格 × 後方調整係数 A + 後方調整係数 B
# 複数回の権利落ち調整
前方権利落ち調整：時間順に、計算日以降の調整係数をフィルタし、時間の早い調整係数から優先的に計算する。2回の調整を例として：
後方権利落ち調整：時間逆順に、計算日以前の調整係数をフィルタし、時間の遅い調整係数から優先的に計算する。2回の調整を例として：
# 例
# 単回の前方権利落ち調整の例
牧原股份を例とします。
- 調整係数は以下の通り：
| 権利落ち日 | 銘柄コード | 内容 | 前方調整係数 A | 前方調整係数 B |
|---|---|---|---|---|
| 2021/06/03 | SZ.002714 | 10株につき4株転換、14.61元配当（税込） | 0.71429 | -1.04357 |
- 未調整データは以下の通り：
| 日付 | 銘柄コード | 未調整終値 |
|---|---|---|
| 2021/06/02 | SZ.002714 | 93.11 |
| 2021/06/03 | SZ.002714 | 66.25 |
- 前方権利落ち調整データは以下の通り：
| 日付 | 銘柄コード | 前方調整済み終値 |
|---|---|---|
| 2021/06/02 | SZ.002714 | 65.4639719 |
| 2021/06/03 | SZ.002714 | 66.25 |
前方権利落ち調整データの計算方法：
牧原股份は 2021/06/03 に株式分割および現金配当（10株につき4株転換、14.61元配当）を実施しました。前方権利落ち調整の計算式に基づいて 2021/06/02 の終値を調整すると、前方調整済み価格（65.4639719）= 未調整価格（93.11）× 前方調整係数 A（0.71429）+ 前方調整係数 B（-1.04357）
# 複数回の後方権利落ち調整の例
前の例の続きとして、牧原股份の 2021/06/02 の後方権利落ち調整価格を計算します。
- 調整係数は以下の通り：
| 権利落ち日 | 銘柄コード | 内容 | 後方調整係数 A | 後方調整係数 B |
|---|---|---|---|---|
| 2014/07/04 | SZ.002714 | 10株につき2.34元配当（税込） | 1 | 0.234 |
| 2015-06-10 | SZ.002714 | 10株につき10株転換、0.61元配当（税込） | 2 | 0.061 |
| 2016-07-08 | SZ.002714 | 10株につき10株転換、3.53元配当（税込） | 2 | 0.353 |
| 2017-07-11 | SZ.002714 | 10株につき8株転換、6.9元配当（税込） | 1.8 | 0.69 |
| 2018-07-03 | SZ.002714 | 10株につき6.91元配当（税込） | 1 | 0.691 |
| 2019-07-04 | SZ.002714 | 10株につき0.5元配当（税込） | 1 | 0.05 |
| 2020-06-04 | SZ.002714 | 10株につき7株転換、5.5元配当（税込） | 1.7 | 0.55 |
- 未調整データは以下の通り：
| 日付 | 銘柄コード | 未調整終値 |
|---|---|---|
| 2021/06/02 | SZ.002714 | 93.11 |
- 後方権利落ち調整データは以下の通り：
| 日付 | 銘柄コード | 後方調整済み終値 |
|---|---|---|
| 2021/06/02 | SZ.002714 | 1152.7226 |
後方権利落ち調整データの計算方法：
牧原股份の 2021/06/02 の後方権利落ち調整価格を計算するには、2021/06/02 以前の権利落ちイベントを順に調整し、最終的な後方調整済み価格を算出します。具体的な計算は以下の通りです。