この記事を開いてくださったこと、心から感謝しています。Pine Scriptのストラテジーで、取引の情報を取り出したいとき、strategy.opentradesとstrategy.closedtradesのどちらを使えばよいのか、迷った人も多いはずです。
結論から言うと、まだ決済していない取引の情報を見たいならstrategy.opentrades、決済済みの取引を集計したいならstrategy.closedtradesが向いています。どちらも、取引の番号を渡して、1件ずつ情報を取り出します。
この記事では、TradingView公式ドキュメントの説明をもとに、対象の違い・番号の数え方・取り出せる情報・使い分けを整理し、自分に合う書き方まで踏み込んでまとめます。
opentradesとclosedtradesは、そもそも何なのか?
まずは、2つの組み込みの変数と関数が、何を指すのかを整理します。
opentradesは、まだ決済していない取引を扱う
TradingView公式ドキュメントによると、strategy.opentrades.で始まる関数は、まだ完了していない、つまり開いている取引の情報を返します。strategy.opentrades自体は、開いている取引の数としても使われます。
- まだ決済していない取引を扱う
- 取引の数としても使われる
closedtradesは、決済済みの取引を扱う
公式ドキュメントでは、strategy.closedtrades.で始まる関数は、完了した、つまり決済済みの取引の情報を返すと説明されています。strategy.closedtradesは、決済済みの取引の数として使えます。
どちらも、取引の番号で1件ずつ取り出す
公式ドキュメントによると、どちらの関数も、trade_numという整数の引数を受け取ります。番号を渡して、1件ずつ、取引の情報を取り出す形です。ストラテジー全体の値とは、使い方が異なります。
- trade_numに番号を渡す
- 1件ずつ情報を取り出す
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
番号の数え方には、どんなルールがあるのか?
ここでは、取引の番号の数え方と、注意点を確認します。
最初の取引は0番で、最後は数より1つ小さい
公式ドキュメントによると、最初の取引の番号は0です。最後の番号は、opentradesならstrategy.opentradesより1つ小さく、closedtradesならstrategy.closedtradesより1つ小さい値になります。
- 最初の取引は0番
- 最後は数より1つ小さい
取引の並び順は、ページに書かれていない
確認したページには、取引がどの順番で並ぶのか、たとえば古い順なのかは、書かれていませんでした。番号の範囲外を渡したときに、何が返るのかも、記載がありません。番号は、範囲に気をつけて使いましょう。
古い取引は、トリミングされる場合がある
公式ドキュメントでは、保持する決済済みの取引が9,000件を超えると、古い取引が、トリミングされると説明されています。トリミングされた取引は、closedtradesの関数で、naが返ります。ディープバックテストでは、この扱いではありません。
- 9,000件を超えるとトリミングされる
- トリミングされた取引はnaになる
主な違いを、表で比べる
公式ドキュメントの説明をもとに、2つの違いを表にまとめます。選ぶときの目安として使ってください。
| 項目 | opentrades | closedtrades |
|---|---|---|
| 対象 | 開いている取引 | 決済済みの取引 |
| 番号の範囲 | 0から数−1まで | 0から数−1まで |
| 決済の情報 | なし | exit_priceなどがある |
※公式ドキュメントの説明をもとにした整理です。
どんな情報を、取り出せるのか?
ここでは、取引ごとに取り出せる情報の種類を整理します。
共通で、取り出せる情報
公式ドキュメントによると、両方に共通して、エントリーのIDや価格、足の番号、時刻、コメントを取り出せます。数量を返すsize、損益を返すprofit、手数料を返すcommissionも、両方にあります。
- エントリーのIDや価格を取り出せる
- 数量や損益、手数料も取り出せる
最大の含み益と含み損も、取り出せる
公式ドキュメントでは、取引の最大の含み益を表すmax_runupと、最大の含み損を表すmax_drawdownも、両方にあると説明されています。割合で返すバージョンも、用意されています。
決済済みだけにある情報
公式ドキュメントによると、決済のID、価格、足の番号、時刻、コメントは、closedtradesにだけあります。決済していない取引には、決済の情報が、まだないためです。
- exit_idやexit_priceはclosedtradesだけ
- 決済の時刻やコメントもclosedtradesだけ
集計するとき、番号はどう回すのか?
仮の数字で、番号の範囲と、勝率の計算を整理します。
例の前提を、そろえる
決済済みの取引が100件、そのうち、profitが0より大きい取引が40件あったと仮定します。公式の例にならって、番号を0から回して、勝ちの件数を数えると考えます。
- 決済済みの取引は100件と仮定する
- profitが0より大きい取引は40件と仮定する
※筆者が設定した仮の数字にもとづく、計算例です。実際の取引の数や勝ちの割合は、ストラテジーで変わります。
番号は0から99まで、勝率は40%になる
100件なら、番号は0から99までです。最後の番号は、100−1で99になります。勝ちが40件なら、勝率は、40÷100で、40%です。
| 項目 | 値(例) |
|---|---|
| 決済済みの取引の数 | 100件 |
| 番号の範囲 | 0から99まで |
| 勝ちの件数 | 40件 |
| 勝率 | 40% |
※仮の数字にもとづく、筆者の計算例です。
数と番号の、1つのずれに注意する
取引の数は100でも、番号は99までしかありません。繰り返しの終わりを、数と同じにすると、1つ多く回ってしまいます。終わりは、数から1を引いた値にしましょう。
- 終わりは数から1を引く
- 数と同じにすると1つ多く回る
トリミングされる場合の、番号の見方
決済済みの取引が1万2,200件あったと仮定します。9,000件を超えた分が、古いほうからトリミングされるなら、3,200件がトリミングされる計算です。公式ドキュメントのfirst_indexが、残っている一番古い取引の番号を返します。
※仮の数字にもとづく、筆者の計算例です。トリミングの正確な動きは、公式ドキュメントでご確認ください。
ストラテジー全体の値とは、何が違うのか?
取引ごとの情報と、ストラテジー全体の値の違いも、整理しておきます。
全体の値は、1つの数字で返る
公式ドキュメントによると、strategy.position_size、strategy.equity、strategy.netprofit、strategy.openprofitなどは、ストラテジー全体の情報を保存する変数です。取引の番号は、必要ありません。
- ストラテジー全体の情報を保存する
- 取引の番号は必要ない
平均価格は、ポジションがあるときだけ値が入る
公式ドキュメントでは、strategy.position_avg_priceは、ストラテジーにポジションがあるときだけ、naではない値になると説明されています。ポジションがなければ、naです。
決済の命令との関係も、合わせて考える
取引のIDと決済の関係は、strategy.closeとstrategy.close_allを比べた記事で整理しています。注文の数量の決め方は、Pine Scriptの注文数量を比べた記事で触れています。
- エントリーのIDで取引を見分ける
- 数量の決め方とも関係する
実際に、どう使い分ければいいのか?
ここでは、場面ごとに、どちらを選ぶとよいかの目安を整理します。
今の持ち高を調べるなら、opentrades
いま開いている取引の、エントリー価格や数量を調べたいときは、opentradesが向いています。たとえば、最後に入った取引の価格を、次の注文の条件に使う場面です。

- 開いている取引の情報を調べられる
- 次の注文の条件に使える
成績を集計するなら、closedtrades
勝率や平均の保有期間、合計の損益を集計したいときは、closedtradesが向いています。公式の例でも、番号を0から回して、表に集計結果を出しています。


- 勝率や合計の損益を集計できる
- 表に出して確かめられる
全体の値で足りるなら、全体の変数を使う
取引ごとの情報が必要なく、いまの持ち高の大きさだけを知りたいなら、strategy.position_sizeで足ります。必要な情報の粒度に合わせて、選びましょう。
- 持ち高の大きさだけなら全体の変数
- 粒度に合わせて選ぶ
運用で気をつけたいことは、何か?
取引の情報を扱うときに、共通して意識したい点をまとめます。
取引の数が0のときの扱いを、決めておく
取引が1件もないときは、番号を渡しても、取り出す対象がありません。繰り返しを始める前に、取引の数が0より大きいかを、確かめておくと安心です。
- 取引の数が0のときを先に確かめる
- 取り出す対象がない場合に備える
naが返る場合に備える
トリミングされた取引では、naが返ります。公式の例のように、値がnaかどうかを確かめてから、計算に使うと、思わぬ結果を防げます。
チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。



- naかどうかを確かめてから使う
- 集計が崩れるのを防ぐ
小さなストラテジーで、試してみる
最初は、数件だけ取引する小さなストラテジーを作って、番号を0から回し、エントリー価格を表に出してみましょう。番号の数え方が、体で分かります。



- 数件の取引で番号の動きを見る
- 表に出して確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
番号の若いほうが、古い取引なのか?
確認した公式ドキュメントの節には、取引の並び順の説明が、ありませんでした。最初が0番という説明だけです。順番に依存する処理を書くときは、実際に表に出して、確かめましょう。
範囲外の番号を渡すと、どうなるのか?
確認した公式ドキュメントの節には、範囲外の番号を渡したときの、返り値の説明が、ありませんでした。トリミングされた取引でnaが返るという説明は、別のケースです。範囲の中で使う書き方が、安全です。
- この節に範囲外の説明はない
- 範囲の中で使う
まとめ:「Pine Scriptのstrategy.opentradesとstrategy.closedtrades、いま開いている取引を調べる即時性と決済済みの成績を集計できる網羅性どっちを選ぶ?」
いま開いている取引を調べるならopentrades、決済済みの成績を集計するならclosedtradesが向いています。番号は0から数−1までという点を、押さえて使いましょう。
取引の情報を取り出せると、ストラテジーを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










