Skip to content
RUBI

Trades

Closed and open positions. This is the feed behind the activity analysis: bursts, one sided flow, holding time and the cross checks against what the trader says.

Paths are relative to your base URL
Rubi joins the base URL saved under Integrations with the path on this page. Save https://risk.example-firm.com/rubi/v1 with no trailing slash. GET /traders is then requested as https://risk.example-firm.com/rubi/v1/traders.

Shared rules for authentication, pagination, errors and the live check are on the Own tech overview.

GET/trades

Returns { data, next_cursor }

Every call, including GET /health, sends Authorization: Bearer <api key> and Accept: application/json. The key is the secret you paste in the dashboard. Rubi never sends a body: every endpoint is GET.

QueryRequiredRules
updated_sincesent by RubiInclusive lower bound on updated_at. Rubi sets this to 90 days before each selected-trader retrieval. Apply it together with account_id. Bounded connection diagnostics may omit updated_since.
cursornoOpaque cursor from the previous page.
limitno1 to 500. Rubi sends 200 when retrieving the selected trader.
account_idyesRequired exact account filter. Return only this account's trades on every page; never ignore this filter.
FieldTypeDescription
idstringRequired. Unique per account: ticket or position id. Stable across open and close. Numbers are accepted.
account_idstringRequired. Must match an account id from GET /accounts.
symbolstringRequired. Broker symbol, for example EURUSD or XAUUSD.
sidebuy | sellRequired. buy or sell. Rubi also accepts long and short, and 0 or 1, but send buy or sell.
open_timetimestampRequired. When the position opened.
updated_attimestampRequired. Update this when the position opens, changes or closes so it falls within the correct retrieval window.
volumenumber | nullLots. lots is accepted as an alias. This is not contract units.
close_timetimestamp | nullNull while the position is open. A null close_time marks the trade as open.
open_pricenumber | nullEntry price.
close_pricenumber | nullNull while open. Set both close_time and close_price together when the position closes.
stop_loss, take_profitnumber | nullPrices. Null when the order has none.
commission, swapnumber | nullIn account currency. Commission is typically negative.
profitnumber | nullNet result in account currency, after commission and swap when you have them.
200 response
{
  "data": [
    {
      "id": "pos_5512009",
      "account_id": "acc_99812",
      "symbol": "EURUSD",
      "side": "buy",
      "volume": 1.5,
      "open_time": "2026-09-22T13:01:07Z",
      "close_time": "2026-09-22T13:42:55Z",
      "open_price": 1.10412,
      "close_price": 1.10501,
      "stop_loss": 1.1021,
      "take_profit": null,
      "commission": -10.5,
      "swap": 0,
      "profit": 123.0,
      "updated_at": "2026-09-22T13:42:56Z"
    }
  ],
  "next_cursor": "c_20260922_5512009"
}
open position
{
  "id": "pos_5512010",
  "account_id": "acc_99812",
  "symbol": "GBPUSD",
  "side": "sell",
  "volume": 0.4,
  "open_time": "2026-09-23T08:11:02Z",
  "close_time": null,
  "open_price": 1.2711,
  "close_price": null,
  "stop_loss": 1.274,
  "take_profit": null,
  "commission": 0,
  "swap": 0,
  "profit": -18.2,
  "updated_at": "2026-09-23T08:11:02Z"
}

Retrieval window and updates#

Keep at least 90 days of closed trades addressable through updated_since. Records older than the requested update window are rejected. When a position is modified or closed, bump updated_at so the next selected-trader retrieval returns it again. Rubi upserts by account and trade ID, so the closed version replaces the open one.

Do not drop open trades
Leave close_time and close_price null until the position closes. Filtering the list down to closed trades only hides live exposure from the report.

Each scoped retrieval requires id, account_id, symbol, side, open_time and updated_at on every record. An empty data array is valid when you have no trades yet.