/api/v1/forward/trades/{id}Change the risk levels or annotations on one of your forward trades. Only stopLoss, takeProfit, takeProfitLadder, breakEvenTrigger, notes and confluences are writable; size, entry, exit, P&L and status are decided server-side and are never editable, here or anywhere else. Send null to clear a level. Returns the updated trade.
| Name | In | Type | Req. | Description |
|---|---|---|---|---|
| id | path | string | yes | The forward trade id. |
| stopLoss | body | number | null | no | New stop-loss price, or null to clear it. |
| takeProfit | body | number | null | no | New take-profit price, or null to clear it. |
| takeProfitLadder | body | array | no | Replacement scale-out ladder: [{ price, pct }]. |
| breakEvenTrigger | body | number | null | no | New break-even trigger price, or null to clear it. |
| notes | body | string | null | no | Free-text note (max 2000 characters). |
| confluences | body | string | null | no | Free-text confluences (max 2000 characters). |
curl -X PATCH -H "Authorization: Bearer afx_live_xxx" \
-H "Content-Type: application/json" \
-d '{}' \
"https://www.analytics-fx.com/api/v1/forward/trades/value"{
"apiVersion": "v1",
"data": {
"id": "9b8a...", "accountId": "7c1d...", "symbol": "EURUSD", "side": "long",
"orderType": "market", "status": "open", "size": 0.5,
"entryPrice": 1.0821, "exitPrice": null, "stopLoss": 1.0835, "takeProfit": 1.09,
"pnl": null, "floatingPnl": 62.5, "currentPrice": 1.08335,
"pricedAt": "2026-08-27T14:01:00.000Z", "usedMargin": 540.6,
"takeProfitLadder": [], "breakEvenTrigger": null,
"openedAt": "2026-08-27T09:41:00.000Z", "closedAt": null,
"notes": "moved to break-even", "confluences": null
},
"meta": { "requestId": "req_fw05", "credits": { "cost": 1, "remaining": 973 } }
}PATCH /api/v1/forward/trades/Create a key at /dashboard/api. The key stays in your browser.