この記事を開いてくださったこと、心から感謝しています。Pine Scriptでストラテジーを書くとき、注文の数量を、宣言のデフォルトで決めるか、注文の命令のqtyで決めるか、迷った人も多いはずです。
結論から言うと、数量を1か所でまとめて管理したいならdefault_qty_type・default_qty_value、注文ごとに数量を変えたいならqty引数が向いています。両方を指定した場合は、qtyが優先されます。
この記事では、TradingView公式ドキュメントの説明をもとに、数量の決め方の違い・優先される順番・修正の手間・使い分けを整理し、自分に合う書き方まで踏み込んでまとめます。
注文の数量は、どうやって決められるのか?
まずは、Pine Scriptで注文の数量を決める、2つの方法を整理します。
strategy()の宣言で、デフォルトを決める
TradingView公式ドキュメントによると、strategy()の宣言に、default_qty_typeとdefault_qty_valueを入れると、注文の数量の初期値を決められます。
スクリプトを使う人は、設定の「Default order size」の欄で、変えることもできます。
- default_qty_typeとdefault_qty_valueで決める
- 設定画面からも変えられる
注文の命令に、qtyを指定する
公式ドキュメントでは、strategy.entryやstrategy.orderに、qtyを渡す方法も紹介されています。qtyがnaではない値のときは、デフォルトの種類と値は、その注文では使われません。注文ごとに、数量を変えられます。
デフォルトを使うには、qtyを外すかnaにする
公式ドキュメントによると、デフォルトの数量を使いたいときは、qty引数を外すか、qtyをnaにします。公式の例では、入力が0のときにnaを渡す書き方で、デフォルトを使う仕組みを作っています。
- qty引数を外すとデフォルトが使われる
- qtyをnaにしてもデフォルトが使われる
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
デフォルトでは、何を決められるのか?
ここでは、デフォルトの数量の、決め方を確認します。
金額で決める例と、資金の割合で決める例がある
公式ドキュメントの例には、default_qty_typeにstrategy.cash、default_qty_valueに5000を入れた書き方があります。
また、strategy.percent_of_equityに、default_qty_valueの2を入れた例もあり、利用できる資金の2%で入る例として説明されています。
- 金額で決める例がある
- 資金の割合で決める例がある
デフォルトが効くのは、qtyがないときだけ
公式ドキュメントでは、デフォルトの数量は、strategy.entryやstrategy.orderの呼び出しで、qtyがnaではない値でないときにだけ、使われると説明されています。qtyを渡すと、デフォルトは、その呼び出しでは無視されます。
主な違いを、表で比べる
公式ドキュメントの説明をもとに、2つの決め方の違いを表にまとめます。選ぶときの目安として使ってください。
| 項目 | デフォルトで決める | qtyで決める |
|---|---|---|
| 書く場所 | strategy()の宣言 | 注文の命令ごと |
| 変えるとき | 1か所を直す | 使った場所を直す |
| 設定画面からの変更 | 変えられる | コードで決まる |
| 優先順位 | qtyがないときだけ | 常にこちらが優先 |
※公式ドキュメントの説明をもとにした整理です。設定画面からの変更は、デフォルトの欄に関する説明にもとづきます。
修正の手間は、どれくらい違うのか?
仮の数字で、数量を変えるときに直す場所の数を比べます。
例の前提を、そろえる
ストラテジーに、注文を出す場所が、4か所あると仮定します。数量を変える場面が、3回あるとします。デフォルトで決める場合は、宣言の1か所、qtyで決める場合は、4か所すべてを直すと考えます。
- 注文を出す場所は4か所と仮定する
- 数量を変える場面は3回と仮定する
※筆者が設定した仮の数字にもとづく、計算例です。実際の修正箇所は、書き方で変わります。
デフォルトは3か所、qtyは12か所になる
デフォルトで決める場合は、1か所×3回で、3か所を直します。qtyで決める場合は、4か所×3回で、12か所です。差は9か所で、デフォルトは4分の1になります。
| 決め方 | 1回に直す場所(例) | 3回の合計(例) |
|---|---|---|
| デフォルト | 1か所 | 3か所 |
| qty | 4か所 | 12か所 |
※仮の数字にもとづく、筆者の計算例です。
直す場所が少ないほど、直し忘れは減りやすい
qtyを、あちこちに書くと、変えるときに、直し忘れが起きやすくなります。1か所に決めておけば、数量がそろっているかを、すぐに確かめられます。
- 直し忘れが起きにくい
- 数量がそろっているか確かめやすい
注文ごとに変えたいなら、qtyの強みが出る
一方で、買いと売りで数量を変えたい、条件によって数量を増やしたいといった場面では、qtyが向いています。公式の例でも、買いに4.0、売りに2.0と、個別の数量を渡す書き方が紹介されています。
資金の割合で決めると、どうなるのか?
公式ドキュメントの例にある、資金の2%を、仮の数字で計算してみます。
例の前提を、そろえる
利用できる資金が、100万円で、strategy.percent_of_equityに2を入れた場合を、考えます。2%で入るという説明を、単純に計算した、投入額の目安です。
- 利用できる資金は100万円と仮定する
- 割合は2%と仮定する
※筆者が設定した仮の数字にもとづく、計算例です。数量を計算する式は、確認したページには書かれていません。
100万円の2%は、2万円になる
100万円×2%で、2万円です。この金額ぶんで、入るという考え方です。実際の数量が、どう計算されるかは、確認した公式ドキュメントのページに、記載がありませんでした。
| 項目 | 金額(例) |
|---|---|
| 利用できる資金 | 1,000,000円 |
| 割合 | 2% |
| 投入額の目安 | 20,000円 |
※仮の数字にもとづく、筆者の計算例です。
資金が変わったときの動きは、確かめる
資金が増えたり減ったりしたとき、数量がどう変わるかは、確認したページには、書かれていませんでした。バックテストの取引一覧で、実際の数量を確かめてから、判断しましょう。
- 資金の増減の影響はページにない
- 取引一覧で数量を確かめる
ほかの設定との関係は、どうなっているのか?
数量と関係する、ほかの設定にも触れておきます。
pyramidingは、エントリーの回数を決める
公式ドキュメントによると、pyramidingは、strategy.entryで、同じ方向に何回入れるかを決める設定です。公式の例には、2や100を入れた書き方があります。strategy.orderには、この設定は影響しません。
- エントリーの回数の上限を決める
- strategy.orderには影響しない
entryとorderの違いも、合わせて考える
数量を決める2つの方法は、strategy.entryとstrategy.orderの、どちらにも使えます。2つの命令の違いは、strategy.entryとstrategy.orderを比べた記事で整理しています。
手数料の設定も、結果に響く
公式ドキュメントによると、手数料を指定しないと、約定した注文に、手数料はかかりません。例では、1%の手数料を入れた書き方もあります。決済の命令との関係は、strategy.closeとstrategy.close_allを比べた記事で触れています。
- 指定しないと手数料はかからない
- 入れると結果が変わる
実際に、どう使い分ければいいのか?
ここでは、場面ごとに、どちらを選ぶとよいかの目安を整理します。
数量を決まった値で使うなら、デフォルト
どの注文も、同じ数量や、同じ割合で入りたいときは、デフォルトにまとめるのが向いています。設定画面からも変えられるため、あとから試しやすい点も利点です。

- 全部の注文で数量をそろえられる
- 設定画面から試せる
注文ごとに変えるなら、qty
買いと売りで数量を変えたいときや、条件によって数量を調整したいときは、qtyを使います。数量の計算を、コードの中で、自由に書けます。


- 注文ごとに数量を変えられる
- 条件で調整できる
併用して、基本はデフォルトにする方法もある
基本の数量はデフォルトに任せて、特別な場面だけ、qtyで上書きするという分け方もあります。qtyをnaにすれば、デフォルトに戻せるため、切り替えも簡単です。
- 基本はデフォルトに任せる
- 特別な場面だけqtyで上書きする
運用で気をつけたいことは、何か?
数量を決めるときに、共通して意識したい点をまとめます。
どちらで決めているかを、はっきりさせる
qtyを渡している注文では、デフォルトが無視されます。設定画面で数量を変えても、結果が変わらないときは、qtyが、渡されていないかを確かめましょう。
- qtyがあるとデフォルトは無視される
- 変えても結果が動かないときはqtyを疑う
取引一覧で、実際の数量を確かめる
書いたストラテジーは、バックテストの取引一覧で、実際の数量を確かめましょう。思っていた数量と違うときは、決め方や、設定の組み合わせを見直します。チャートツールと合わせて口座も比べたい人は、
FX口座・ツールの比較一覧もあわせて確認してみてください。



- 取引一覧で数量を見る
- 想定と違えば設定を見直す
小さなストラテジーで、両方を試す
最初は、単純なサインで買う小さなストラテジーを作って、デフォルトと、qtyの両方で、数量を決めて見比べてみましょう。優先される順番が、体で分かります。



- デフォルトとqtyの両方で試す
- 優先される順番を確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
strategy.fixedは、どういう意味なのか?
確認した公式ドキュメントの節には、strategy.fixedの説明は、ありませんでした。数量の種類として、どんな選択肢があるかは、関数の説明や、宣言の引数の説明で、確かめましょう。
資金の割合は、毎回計算し直されるのか?
確認した公式ドキュメントの節には、資金の割合で決めたときの、数量の計算の式や、計算し直す頻度の説明は、ありませんでした。取引一覧で、数量の変化を確かめながら、判断しましょう。
- この節に計算の式の説明はない
- 取引一覧で数量の変化を確かめる
まとめ:「Pine Scriptの注文数量、デフォルト指定とqty引数、1か所でまとめて管理できる手軽さと注文ごとに決められる自由度どっちを選ぶ?」
数量をまとめて管理したいならデフォルト、注文ごとに変えたいならqtyが向いています。qtyが優先される点を押さえて、使い分けましょう。
数量の決め方が分かると、ストラテジーを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










