本記事は連載 「非エンジニアでもわかる!AIと作るFX自動売買入門」 の1本です。
第6回では、AIが作ったコードを動かす前に行う「3つの安全チェック」を紹介しました。
本記事から、いよいよ自動売買botの部品づくりに入ります。第5回で紹介した4つのステップのうち、最初の「データを取る」を実際に作っていきます。
OANDA APIから過去の為替データを取得し、CSVファイルに保存して、Excelで中身を確認するところまで進めます。
ここで取得したデータは、第9回のバックテスト(過去のデータで売買ルールを試すこと)でも使います。
この記事のゴール
本記事を読み終えた時点で、以下ができる状態を目指します。
- OANDA APIで取得できる過去データの種類がわかる
- 通貨ペア・足の種類・範囲を、AIに正しく伝えられる
- 過去データをCSVファイルに保存し、Excelで中身を確認できる
- 通貨ペアや足の種類を変えて、同じコードを使い回せる
- 取得時によくあるエラーに対処できる
事前準備
以下が完了していることを前提に進めます。
- 第2〜6回でClaude Code Desktopの操作に一通り慣れている
- 第3回で
~/oanda_credentials/.envにデモ口座のAPIトークンとアカウントIDを保存している - CSVファイルを開くためのExcelがパソコンに入っている(ない場合はMacのNumbersやGoogleのSpreadsheetを使ってください)
まだお済みでない方は、先に第2〜6回をご覧ください。
なお、第5回ではデータを rates.csv に保存する例を紹介しました。
第5回の実験ですでに rates.csv ができている方もいるため、本記事では oanda_bot フォルダの中に data フォルダを作り、USD_JPY_D.csv のように「通貨ペア_足の種類」という名前で保存していきます。
OANDA APIで取得できる過去データの種類
まずは、どのようなデータが取れるのかを押さえておきましょう。
ローソク足データとは
OANDA APIで取得できる過去データは、チャートでおなじみのローソク足の形をしています。1本のローソク足は、次の5つの値でできています。
| 列名 | 意味 |
|---|---|
| Open | 始値(その足が始まったときの価格) |
| High | 高値(その足の期間で一番高かった価格) |
| Low | 安値(その足の期間で一番安かった価格) |
| Close | 終値(その足が終わったときの価格) |
| Volume | 出来高(その足の期間で価格が更新された回数) |
FXの場合、Volumeは実際に取引された金額ではなく、価格が何回更新されたかを表しています。相場が活発だったかどうかの目安として使う値だと考えてください。
足の種類
ローソク足1本が表す期間のことを「足の種類」と呼びます。OANDA APIでは5秒足から月足まで選べます。よく使うものを表にまとめました。
| 足の種類 | APIでの書き方 |
|---|---|
| 1分足 | M1 |
| 5分足 | M5 |
| 15分足 | M15 |
| 1時間足 | H1 |
| 4時間足 | H4 |
| 日足 | D |
| 週足 | W |
| 月足 | M |
1分足が「M1」、月足が「M」と、どちらにもMが使われている点にご注意ください。AIには「1時間足」「日足」と日本語で伝えれば、正しい書き方に直してくれます。
価格の種類(Bid・Ask・Mid)
為替の価格には、次の3種類があります。
- Bid:売るときの価格
- Ask:買うときの価格
- Mid:BidとAskのちょうど中間の価格
BidとAskの差がスプレッド(取引のたびにかかる実質的なコスト)です。
チャートの確認やバックテストでは、まずMid(中値)を使うのが一般的です。本記事でもMidを使って取得していきます。
一度に取れるのは5,000本まで
OANDA APIでは、1回のリクエスト(APIへのお願い)で取得できるローソク足は最大5,000本です。日足なら約20年分、1時間足なら約10か月分にあたります。
本記事の範囲であれば、5,000本で十分に足ります。それより多く取りたい場合の頼み方は、「うまくいかないときは」で紹介します。
取りたいデータをAIに伝えるコツ
次に、AIへの伝え方を整理しておきます。
伝えるのは「通貨ペア・足の種類・範囲・保存形式」の4つ
過去データを頼むときは、次の4つを必ず伝えます。
- 通貨ペア:ドル円、ユーロ円など
- 足の種類:日足、1時間足など
- 範囲:何本分、またはいつからいつまで
- 保存形式:保存先のファイル名、列の並び
第5回で紹介した「入力・処理・出力」に当てはめると、1〜3が処理、4が出力にあたります。
どれか1つでも抜けていると、AIが勝手に決めてしまい、想定と違うデータが保存される原因になります。
範囲の指定は「本数」と「期間」の2通り
取得する範囲は、次の2通りの方法で指定できます。
| 指定方法 | 伝え方の例 | 向いている場面 |
|---|---|---|
| 本数で指定 | 「直近100本」 | 最新のデータを手早く取りたいとき |
| 期間で指定 | 「2026年1月1日から3月31日まで」 | 特定の期間を調べたいとき |
期間で指定するときは、「日本時間で」と添えておくと、日付の区切りがずれずに済みます。
通貨ペアの書き方
OANDA APIでは、通貨ペアを USD_JPY のように、2つの通貨をアンダーバー(_)でつないで書きます。「USDJPY」や「USD/JPY」と書くとエラーになります。
AIには「ドル円」と伝えれば正しく書いてくれますが、エラーが出たときに確認するポイントとして覚えておいてください。
時刻は日本時間に直してもらう
OANDA APIから返ってくる時刻は、**世界標準時(UTC)**という、日本時間より9時間遅れた時刻です。そのままCSVに保存すると、Excelで開いたときに日付や時刻がずれて見えてしまいます。
AIに頼むときは、「時刻は日本時間に変換してください」と一言添えておきましょう。
やってみよう:過去データを取得してCSVに保存する
ここからは、実際にClaude Codeに頼んで過去データを取得していきます。
ステップ1:ドル円の日足を直近100本取得する
まずは、第5回で紹介した「ステップ1:データを取る」の骨格をもとに、次のプロンプトを送ってください。
🧑 OANDA APIを使って、ドル円の日足を直近100本取得し、oanda_botフォルダ内の data フォルダに USD_JPY_D.csv として保存するPythonコードを、get_candles.py という名前で作ってください。
APIトークンは ~/oanda_credentials/.env に保存済みです(中身を確認する必要はありません)。
python-dotenv を使って、実行時に環境変数 OANDA_ACCESS_TOKEN とOANDA_ACCOUNT_IDとして読み込み、デモ環境(practice)を使ってください。
価格は中値(Mid)を使い、CSVの列は time, Open, High, Low, Close, Volume の順にしてください。
time は日本時間に変換してください。
まだ確定していない最新の足は除いてください。
書き終わったら実行して、保存した行数と最新の5行を教えてください。
先ほどの4つ(通貨ペア・足の種類・範囲・保存形式)が、すべて入っていることを確認してください。
列名を英語にしているのは、第9回のバックテストでそのまま使える形にしておくためです。
※環境によって回答の内容が異なることが考えられます。
実行の許可を求められたら、内容を確認して「一度だけ許可」を選びます。保存した行数として100行、最新の5行として日付と価格が表示されれば成功です。
oanda_bot フォルダの中に data フォルダができ、その中に USD_JPY_D.csv が保存されていることも確認しておきましょう。
ステップ2:保存されたCSVをExcelで開いて確認する
次に、保存されたCSVをExcelで開いてみます。USD_JPY_D.csv をダブルクリックすると、Excelで開くことができます。
1行目が列名、2行目以降が1日ごとのローソク足のデータです。開いたら、次の4点を確認してください。
- データが100行ある(1行目の列名を含めて101行)
- 一番下の行が最新の日付になっている
- 土日の日付が入っていない(為替市場は土日が休みのため)
- Closeの値が、チャートで見た最近の終値とおおむね一致している
4つ目は、OANDAの取引ツールなどのチャートを横に並べて、直近の数日分を見比べるだけで構いません。細かい値まで一致しなくても、数銭程度の差であれば問題ありません。
なお、Excelで開いたまま保存すると、日付の表示形式などが変わってしまうことがあります。このCSVはbotやバックテストで使うデータなので、Excelでは見るだけにして、保存せずに閉じるようにしてください。
ステップ3:1時間足を期間を指定して取得する
次に、範囲を「期間」で指定して、1時間足を取得してみます。次のプロンプトを送ってください。
🧑 get_candles.py を参考に、ドル円の1時間足を、日本時間の2026年1月1日から2026年3月31日までの期間で取得し、data フォルダに USD_JPY_H1.csv として保存してください。
CSVの列や時刻の扱いは USD_JPY_D.csv と同じにしてください。
USD_JPY_D.csv は上書きしないでください。
書き終わったら実行して、保存した行数と、最初と最後の行を教えてください。
※環境によって回答の内容が異なることが考えられます。
最初の行が1月初旬、最後の行が3月31日になっていれば成功です。
年末年始や土日は市場が休みのため、1月1日ちょうどから始まらないことがあります(画像の例では1月1日ちょうどから取得)。行数は、およそ1,500行前後になります。
ステップ4:通貨ペアや足の種類を変えて使い回す
ここまでで、日足と1時間足のデータが取れました。
ただ、通貨ペアや足の種類を変えるたびに新しいコードを作ってもらうのは手間です。そこで、get_candles.py を使い回せる形に直してもらいます。
🧑 get_candles.py を修正して、ファイルの先頭で「通貨ペア」「足の種類」「本数」を設定できるようにしてください。
保存するファイル名は「通貨ペア_足の種類.csv」の形で自動的に決まるようにしてください(例:USD_JPY_D.csv、GBP_JPY_H4.csv)。
それ以外の処理は変えないでください。
※環境によって回答の内容が異なることが考えられます。
修正が終わると、ファイルの先頭に設定をまとめた部分ができます。コードの中では、たとえば次のような形になります。
INSTRUMENT = "USD_JPY" # 通貨ペア
GRANULARITY = "D" # 足の種類
COUNT = 100 # 本数
設定部分が先頭にまとまっていれば、この3行を変えるだけで別のデータを取得できます。
自分で書き換える必要はありません。次のように頼めば、Claudeが設定を変えて実行してくれます。
🧑 get_candles.py の設定を、ポンド円の4時間足、300本に変えて実行してください。
※環境によって回答の内容が異なることが考えられます。
data フォルダに GBP_JPY_H4.csv が保存されていれば成功です。
このように一度使い回せる形にしておくと、第9回以降でいろいろなデータを試すときにも便利です。
取得したコードを安全チェックで確認する
最後に、第6回で紹介した安全チェックを行っておきましょう。
get_candles.py はデータを取得するだけのコードなので、チェック②(取引の金額)とチェック③(デモか本番か)の影響は大きくありません。
ただし、APIトークンを使うコードであることに変わりはないため、チェック①(秘密情報)だけは確認しておきます。
🧑 get_candles.py について質問です。コードは修正しないで、答えだけ教えてください。
1.APIトークンは、どこから読み込んでいますか?コード内への直接の記述や、画面・ファイルへの出力はありますか?
2.このコードには、注文を出す処理が含まれていますか?
※環境によって回答の内容が異なることが考えられます。
トークンが .env から読み込まれていて、注文を出す処理が含まれていなければ問題ありません。
2つ目の質問は、データを取得するだけのはずのコードに、AIが気を利かせて余計な処理を入れていないかを確かめるためのものです。
うまくいかないときは
過去データの取得でつまずきやすい場面と、その対処をまとめます。
400番台のエラーが出る
実行したときに「Invalid value specified for 'instrument'」のような、400番台のエラーが出ることがあります。これは、APIに渡した値の書き方が間違っているときに出るエラーです。
主な原因は次の2つです。
- 通貨ペアの書き方が違う(USD_JPY ではなく USDJPY や USD/JPY になっている)
- 足の種類の書き方が違う(1時間足が H1 ではなく 1H や 60 になっている)
エラーメッセージをそのまま貼り付けて、Claudeに直してもらいましょう。
実行したら次のエラーが出ました。原因と修正案を教えてください。
---
[エラーメッセージをそのまま貼り付け]
---
直せそうであれば修正まで進めてください。
第5回のテンプレ3(エラー相談)と同じ形です。
5,000本を超えるデータを取りたい
1回で取得できるのは5,000本までのため、それを超える本数や期間を指定するとエラーになります。たとえば、1時間足を数年分取得したい場合は、次のように頼んでみてください。
🧑 ドル円の1時間足を、日本時間の2023年1月1日から2025年12月31日までの期間で取得したいです。
1回のリクエストで取得できるのは5,000本までなので、期間を分けて取得し、1つのCSVにつなげて data フォルダに保存してください。
つなぎ目でデータが重複したり抜けたりしないようにしてください。
長い期間のデータは、第9回のバックテストで改めて扱います。
Excelで開くと文字化けする
列名を日本語にしている場合、Excelで開くと列名が文字化けすることがあります。本記事のように列名を英語にしておけば、基本的に文字化けは起きません。
日本語の列名を使いたい場合は、Claudeに次のように頼んでください。
🧑 CSVをExcelで開くと文字化けします。Excelで文字化けしない形式で保存するように修正してください。
日足の時刻が朝6時や7時になっている
日本時間に変換した日足のCSVを見ると、時刻が「6:00」や「7:00」になっていることがあります。これは間違いではありません。
OANDAの日足は、ニューヨーク時間の夕方5時で1日を区切っています。これを日本時間に直すと、夏は朝6時、冬は朝7時になります。
「その日の朝6時(または7時)から翌朝までの1日分」のデータだと考えてください。
最新の足だけ値がおかしい
最新の足だけ、高値と安値の幅が小さかったり、他と比べて値がおかしく見えたりすることがあります。これは、まだ確定していない足が含まれている可能性があります。
たとえば日足であれば、今日の足は日本時間の朝6時(または7時)になるまで値が動き続けます。
本記事のステップ1のプロンプトでは「まだ確定していない最新の足は除いてください」と伝えているため、通常は含まれません。もし含まれていた場合は、次のように頼んでください。
🧑 取得したデータのうち、まだ確定していない最新の足は除いて保存するように修正してください。それ以外の処理は変えないでください。
まとめ
本記事では、OANDA APIで過去データを取得し、CSVに保存してExcelで確認するところまで進めました。ポイントを振り返ります。
- OANDA APIの過去データはローソク足の形で、Open・High・Low・Close・Volumeの5つの値でできている
- AIには「通貨ペア・足の種類・範囲・保存形式」の4つを伝える
- 範囲は「本数」と「期間」の2通りで指定でき、期間は日本時間で伝える
- 時刻は日本時間に変換し、まだ確定していない足は除いて保存する
- 保存したCSVはExcelで見るだけにして、保存せずに閉じる
-
get_candles.pyを使い回せる形にしておくと、通貨ペアや足の種類を一言で切り替えられる
次回(第8回)は、自分のトレードルールを「言葉」で書き出して、AIに渡すコツを扱います。本記事で取得したデータに対して、どのような売買ルールを当てはめるかを考えていきます。
免責事項
OANDA証券株式会社
第一種金融商品取引業 関東財務局長(金商)第2137号/商品先物取引業者
加入協会:一般社団法人 金融先物取引業協会/日本証券業協会/日本商品先物取引協会
- 店頭外国為替証拠金取引(FX)、株価指数CFD取引及び商品CFD取引は、元本及び利益が保証されている金融商品ではありません。預託した証拠金の額に比べ大きい金額の取引ができるため、外国為替、株式、株価指数、商品、金利市場等の市場変動により、その損失額が預託された証拠金額を上回る可能性があります。
- 各取引に必要な証拠金は次の通りです。店頭外国為替証拠金取引に関しては、個人口座は取引金額の4%以上、法人口座は、金融先物取引業協会が算出した通貨ペアごとの為替リスク想定比率を取引の額に乗じて得た額と、当社が算出したリスク想定比率を用いた額のどちらか高い額以上(為替リスク想定比率とは、金融商品取引業等に関する内閣府令第117条第27項第1号に規定される定量的計算モデルを用い算出します)、株価指数CFD取引に関しては、個人口座・法人口座いずれも取引金額の10%以上、商品CFD取引に関しては、個人口座・法人口座いずれも取引金額の5%以上の証拠金が必要です。
- 口座管理費及び取引手数料は原則無料です。但し一部取引コースに関しては、取引にあたり手数料が発生することがあります。手数料の詳細については、該当するコースの取引説明書をご覧ください。
- 売付価格と買付価格には差(スプレッド)があり、相場急変動等によりスプレッド幅が拡大し、意図したお取引ができない可能性があります。
- お取引を始めるにあたっては取引説明書及び取引約款を熟読し、取引内容や仕組み、リスク等を十分にご理解いただいた上で、ご自身の判断にてお取引くださるようお願い致します。
- 弊社企業情報は、弊社ホームページに開示しています。
- お客様相談窓口:0120-923-213/日本商品先物取引協会相談センター:03-3664-6243







