Alpaca で株・暗号資産の自動売買を動かした後、OANDA で FX に対応したときに想定外のハマりどころが連発しました。FX 特有の罠を5つ紹介します。
罠1：JPY建て口座の残高を USD に換算しないとポジションサイズがおかしくなる
OANDA 口座が JPY 建ての場合、/accounts/{id}/summary が返す balance や NAV は日本円です。そのまま USD 計算のサイジング式に入れると、為替レートが1ドル＝150円の場合に 150倍の発注量 になります。
// account-tools.ts
const summary = await oanda.getAccountSummary();
let navUsd = summary.nav;
// JPY 建て口座の場合は USD に換算してからサイザーに渡す
if (summary.currency === "JPY") {
const tick = await oanda.getLatestPrice("USD_JPY");
if (tick && tick.price > 0) {
navUsd = summary.nav / tick.price; // 例: 1,500,000 / 150 = 10,000 USD
}
}
さらに JPY 建てペア（USD_JPY, GBP_JPY）は SL の「1 pip 価値」が USD 換算で異なります。厳密には1 unit あたりの pip 価値は 1 pip / entry_rate USD になります。そのため JPY ペアのサイジングは保守的（小さめ）になります。
罠2：USD_base ペアの SL 距離は外貨建てになる
USD_JPY や USD_CAD のように USD が base（左）の場合、|entry - SL| の単位が quote 通貨（JPY/CAD） になります。
// position-sizer.ts
const quoteConv = isUsdBase ? entry : 1;
// USD_JPY: entry ≈ 150, SL距離 0.5円 → USD換算 = 0.5 / 150 = 0.00333 USD/unit
const riskPerUnitUSD = riskPerShare / quoteConv;
quantity = Math.floor(riskTarget / riskPerUnitUSD);
EUR_USD のような quote-USD ペアならこの換算は不要（quoteConv = 1）ですが、USD_JPY 系は必ず換算が必要です。これを忘れると発注量が正しくなりません。
罠3：OANDA の SL/TP はネイティブ管理で、ソフトウェア監視が不要な代わりに決済検知が難しい
Alpaca の暗号資産では SL/TP をソフトウェアで監視してクローズします。OANDA は stopLossOnFill / takeProfitOnFill を注文時に渡せばブローカー側でネイティブ管理してくれます。
// OANDA の注文（SL/TP はネイティブ）
{
"order": {
"type": "MARKET",
"instrument": "GBP_USD",
"units": "10000",
"stopLossOnFill": { "price": "1.2450" },
"takeProfitOnFill": { "price": "1.2650" }
}
}
ただし問題があります。ブローカーが bar close 前のティックで SL/TP を執行した場合、バーが閉じたときには価格が SL/TP を越えていないように見える ことがあります。
SL = 1.2450
15:00 バーの動き: 1.2460 → 1.2449（SL ヒット）→ 1.2455（バー終値）
→ バー終値 1.2455 > SL 1.2450 → ソフトウェア判定: まだオープン！
→ でも実際はブローカー側でクローズ済み
解決策：OANDA の closed trades API で同期する
// hermes.ts
private async syncOandaFxOutcomes(): Promise<void> {
const pendingFx = this.memory.getPendingTrades()
.filter(e => e.type === "real" && e.symbol.includes("_"));
for (const entry of pendingFx) {
// OANDA の決済済みトレードと照合
const closed = await oanda.getClosedTrades(entry.symbol, entry.timestamp);
if (closed.length) {
const outcome = closed[0].realizedPL >= 0 ? "WIN" : "LOSS";
this.memory.updateOutcome(entry.id, outcome, pnlPct);
}
}
}
毎サイクルの冒頭で OANDA の closed trades API を叩いて、メモリ側の記録を同期します。
罠4：OANDA の REST API ページネーション
/trades エンドポイントで from + to + count を同時に指定すると API がエラーを返します。
// ❌ これはエラーになる
const params = { from: startTime, to: endTime, count: 50 };
// ✅ from + count のみ（to を除く）
const params = { from: startTime, count: 50 };
OANDA の API ドキュメントには書いてありますが見落としやすいです。from+to+count の組み合わせは拒否されます。
罠5：GBP ペアのレバレッジ上限が他ペアと異なる
OANDA のペーパー口座では GBP_USD / GBP_JPY は最大レバレッジが 20x に制限されていますが、EUR_USD は 25x、USD_JPY は 30x など異なります。
一律で最大レバレッジを設定すると GBP ペアで上限を超えた発注をしてしまいます。
// ペア別レバレッジキャップを strategy-params.json で管理
{
"GBP_USD": {
"leverageCap": 20
},
"EUR_USD": {
"leverageCap": 25
}
}
// position-sizer.ts
const effectiveLeverage = leverageOverride ?? this.maxLeverage;
const maxByLeverage = Math.floor(equity * effectiveLeverage / notionalPerUnit);
quantity = Math.min(quantity, maxByLeverage);
FX と株・暗号資産の主な違いまとめ
| 項目 | 株（Alpaca） | 暗号資産（Alpaca） | FX（OANDA） |
|---|---|---|---|
| SL/TP 管理 | ブローカー（bracket） | ソフトウェア | ブローカー（ネイティブ） |
| 決済検知 | bracket が自動クローズ | SL/TP チェックして close_position | closed trades API で同期 |
| 発注単位 | 株数（整数） | 小数可（0.0001 まで） | units（1,000〜100,000） |
| 口座通貨換算 | 不要（USD 建て） | 不要 | JPY 建て口座は要換算 |
| セッション | 平日 9:30-16:00 ET | 24/7 | 平日 24h（月〜金 UTC） |
FX は「執行はブローカーに任せられる」という利点がある一方、口座通貨・leverage・pip 換算など FX 固有の複雑さがあります。特に JPY 建て口座 × JPY ペアの組み合わせは最も注意が必要でした。