# 権限と制限
# ログインについて
# 口座開設
moomoo APIを利用するには、まずmoomooアプリで取引口座を開設する必要があります。
# 初回ログイン時の確認事項
初回ログイン後、moomoo APIを継続して利用するには、アンケートへの回答および規約への同意が必要です。 moomooユーザーの方は、こちらから確認してください。
# 相場情報
相場データの利用は、以下の制限やルールが適用されます。
- 相場データの利用権限:相場データを取得するために必要な権限
- APIレート制限:APIの呼び出し頻度制限
- 登録枠:同時登録・受信可能なリアルタイム相場データの数
- 過去のローソク足データの取得枠:30日間で取得可能な銘柄数の上限
# 相場情報の利用権限
moomoo APIを通じて相場データを取得するには、対応する利用権限が必要です。 moomoo APIの相場情報利用権限は、moomooアプリの相場情報利用権限と完全には同一ではありません。 権限レベルに応じて、データの遅延時間、板情報の表示本数および利用可能なAPI機能が異なります。
一部商品の相場情報は、有料情報の購入後にご利用いただけます。 取得方法については、下表をご参照ください。
| 市場 | 商品 | 取得方法 |
|---|---|---|
| 香港 | 有価証券(株式、ETF、ワラント、CBBC、インラインワラント等) | * LV1:無料で取得できます。 * LV2:必要な場合は、 香港株のLV2 相場情報 をご購入ください。SF権限:現在対応していません。 |
| 指数 | ||
| セクター | ||
| オプション | * LV1:無料で取得できます。 * LV2:必要な場合は、 香港株のLV2 相場情報 をご購入ください。 | |
| 先物 | ||
| 米国 | 有価証券(NYSE、AMEX、NASDAQ上場の株式・ETF等) | * moomooアプリの相場情報利用権限とは共有されません。LV1の利用権限(基本の株価情報。夜間セッションを含む)が必要な場合は、 Nasdaq Basic をご購入ください。 * moomooアプリの相場情報利用権限とは共有されません。LV2の利用権限(基本の株価情報および板情報。夜間セッションの板情報を含む)が必要な場合は、 Nasdaq Basic+TotalView をご購入ください。 |
| セクター | ||
| OTC銘柄 | 現在ご利用いただけません。 | |
| オプション(株オプション・指数オプション等) | * 要件 * 要件 | |
| 先物 | moomoo証券では現在ご利用いただけません。 | |
| 指数 | 現在ご利用いただけません。 | |
| 中国A株 | 有価証券(株式、ETF等) | 現在ご利用いただけません。 |
| 指数 | ||
| セクター | ||
| シンガポール | 先物 | 現在ご利用いただけません。 |
| 日本 | 先物 | 現在ご利用いただけません。 |
ご注意
上記の表における中国本土と香港・マカオ・台湾・海外の区分は、OpenDログイン時のIPアドレスに基づいて判定されます。
# APIレート制限
サーバーを保護し、悪意のある攻撃を防ぐため、 moomooサーバーへのリクエストを送信するすべてのAPIにレート制限が設けられています。
制限ルールはAPIごとに異なります。 詳細は各APIページのAPIレート制限をご参照ください。
例:
スナップショット APIのレート制限は、 30秒間に最大60回までリクエスト可能です。0.5秒ごとに1回ずつリクエストすることも、60回連続でリクエストした後30秒待機してから次をリクエストすることも可能です。レート制限を超えた場合、APIはエラーを返します。
# リアルタイムデータ登録枠・過去ローソク足データ枠
登録枠および過去ローソク足データ枠の算出基準と制限は以下のとおりです。
| ユーザー種別 | 登録枠 | 過去ローソク足データ枠 |
|---|---|---|
| 口座開設済みユーザー | 100 | 100 |
| 総資産が1万香港ドル以上 | 300 | 300 |
| 以下のいずれかの条件を満たすこと: 1. 1. 総資産50万香港ドル以上 2. 月間取引件数>200 3. 月間売買代金>200万香港ドル | 1000 | 1000 |
| 以下のいずれかの条件を満たすこと: 1. 総資産500万香港ドル以上 2. 月間取引件数>2000件 3. 月間売買代金>2000万香港ドル | 2000 | 2000 |
1、総資産
moomoo証券でお預かりしている全資産(株式・オプション・投資信託・債券など)を、リアルタイム為替レートで香港ドルに換算した合計額です。
2、月間取引件数
moomoo証券における当月と前月の約定件数を比較し、多い方の値を適用します。
計算式:max(前月の約定件数、当月の約定件数)
3、月間売買代金
moomoo証券における当月と前月の売買代金を比較し、金額の大きい方を適用します。
計算式:max(前月の売買代金、当月の売買代金)
リアルタイム為替レートで香港ドルに換算します。なお、先物取引の売買代金計算には、調整係数(デフォルト値:0.1)を適用します。
計算式: 先物取引の売買代金 = ∑(各約定の数量 × 約定価格 × 契約乗数 × 為替レート × 調整係数)
4、登録枠
登録枠は、データ配信登録 APIに適用されます。1銘柄につき1種類のデータを登録するごとに1枠を消費します。登録を解除すると、使用済みの枠は解放されます。
例:
登録枠の上限が100だとします。「HK.00700の板情報」、「US.AAPLのティック」、「SH.600519のリアルタイム株価」の配信を同時に登録した場合、枠が3つ消費され、残りは97です。その後、「HK.00700の板情報」の登録を解除すると、消費枠は2つに戻り、残りの登録枠は98になります。
5、過去ローソク足データ枠
過去ローソク足データ枠は、過去ローソク足取得 APIに適用されます。直近30日以内に、1銘柄の過去ローソク足データをリクエストするごとに、枠を1つ消費します。直近30日以内に同一銘柄のデータを何度リクエストしても、枠は重複して消費されません。また、同一銘柄で異なる足種のローソク足をリクエストした場合も、消費されるのは1枠のみで、重複消費は発生しません。
例:
過去ローソク足データ枠が100で、本日が2020年7月5日だとします。2020年6月5日〜2020年7月5日の間に、合計60銘柄の過去ローソク足データをリクエストした場合、残りの枠は40となります。
ご注意
- 登録枠および過去ローソク足データ枠は、システムにより自動的に割り当てられるため、手動での申請は不要です。
- 新規に入金された口座では、枠のレベルは2時間以内に自動的に適用されます。
- 未着金の資産は枠の計算には含まれません。
# 取引機能
- 取引を行う際は、その市場に対応した取引口座が開設済みであることを事前にご確認ください。
例:米国株の取引は米国株の取引口座でのみ可能で、香港株の口座で行うことはできません。