AnalyticsFX. Trading Analytics and Journal Platform

POST/api/v1/forward/accounts/{id}/trades

2 creditsOwner-scoped

Open forward trade

Place an order on one of your active forward-testing accounts. A market order fills at the last completed 1-minute close, the same series the server settles against, so no price is accepted for one; a limit order rests at your price until the server fills it. From there the one-minute sweep owns the outcome: fills, stops, targets, break-even and stop-outs are decided server-side and no P&L figure is ever accepted from a caller. 404 if the account does not exist or is not yours; 400 if it is archived or the 1-minute series has no recent bar (a closed market, for instance).

Parameters

Name	In	Type	Req.	Description
id	path	string	yes	The forward account id.
symbol	body	string	yes	Instrument symbol, e.g. EURUSD.
side	body	"long" \| "short"	yes	Direction of the position.
size	body	number	yes	Position size in lots.
orderType	body	"market" \| "limit"	no	Defaults to market.
price	body	number	no	Resting price. Required for a limit order, ignored for a market order.
stopLoss	body	number	no	Stop-loss price.
takeProfit	body	number	no	Take-profit price.
takeProfitLadder	body	array	no	Scale-out ladder: [{ price, pct }]. The rungs may not add up to more than 100%.
breakEvenTrigger	body	number	no	Reaching this price moves the stop to entry, once.

Example request

curl -X POST -H "Authorization: Bearer afx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"eurusd","side":"long","size":0.5}' \
  "https://www.analytics-fx.com/api/v1/forward/accounts/value/trades"

Example response

{
  "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.08, "takeProfit": 1.09,
    "pnl": null, "floatingPnl": 0, "currentPrice": 1.0821,
    "pricedAt": "2026-08-27T09:41:00.000Z", "usedMargin": 540.6,
    "takeProfitLadder": [], "breakEvenTrigger": null,
    "openedAt": "2026-08-27T09:41:00.000Z", "closedAt": null,
    "notes": null, "confluences": null
  },
  "meta": { "requestId": "req_fw04", "credits": { "cost": 2, "remaining": 974 } }
}

Try this endpoint

API key

id *symbol *side *size *orderTypepricestopLosstakeProfittakeProfitLadderbreakEvenTrigger

POST /api/v1/forward/accounts//trades

Create a key at /dashboard/api. The key stays in your browser.

Name

Type

Req.

Description

path

string

yes

The forward account id.

symbol

body

string

yes

Instrument symbol, e.g. EURUSD.

side

body

"long" | "short"

yes

Direction of the position.

size

body

number

yes

Position size in lots.

orderType

body

"market" | "limit"

Defaults to market.

price

body

number

Resting price. Required for a limit order, ignored for a market order.

stopLoss

body

number

Stop-loss price.

takeProfit

body

number

Take-profit price.

takeProfitLadder

body

array

Scale-out ladder: [{ price, pct }]. The rungs may not add up to more than 100%.

breakEvenTrigger

body

number

Reaching this price moves the stop to entry, once.

curl -X POST -H "Authorization: Bearer afx_live_xxx" \ -H "Content-Type: application/json" \ -d '{"symbol":"eurusd","side":"long","size":0.5}' \ "https://www.analytics-fx.com/api/v1/forward/accounts/value/trades"

{ "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.08, "takeProfit": 1.09, "pnl": null, "floatingPnl": 0, "currentPrice": 1.0821, "pricedAt": "2026-08-27T09:41:00.000Z", "usedMargin": 540.6, "takeProfitLadder": [], "breakEvenTrigger": null, "openedAt": "2026-08-27T09:41:00.000Z", "closedAt": null, "notes": null, "confluences": null }, "meta": { "requestId": "req_fw04", "credits": { "cost": 2, "remaining": 974 } } }