DOCS

Account & Execution API

Query your account positions and place futures orders over a simple API on your own Rithmic broker account.

Overview

The Account & Execution API lets you query your account state and place and manage futures orders over a dead-simple HTTP API, routed to your own Rithmic broker account (prop firms and retail alike). You bring your Rithmic credentials; tickstream is the thin, fast account & execution layer on top.

• Query every position on your linked accounts — quantity, average open price, open/closed PnL, balances.
• Pull your trade history — every fill, as data, ready for your own analysis. Works for any linked account, independent of the algos.
• Open a long/short market position with N contracts.
• Bracket orders — a linked take-profit and stop-loss in one call.
• Move the TP/SL, flatten the position, or cancel — one call each.
• Futures only. Your orders, your account, your risk.

Pricing: $9.99/mo, a standalone add-on separate from the data tiers — also bundled in All-in-One.

Your positions

One call returns every Rithmic account linked to your API key, each with its latest position snapshot: net quantity per symbol, average open fill price, open and closed PnL, and account-level balances. A session is maintained automatically for every account you link — no algo activation required — and snapshots refresh about once a minute.

curl https://api.tick-stream.xyz/v1/exec/positions \
  -H "Authorization: Bearer sk_live_…"

{
  "accounts": [
    {
      "accountId": "acct_9f2c…",
      "updatedAt": 1751712000000,
      "account": {
        "name": "PAPER-12345",
        "metrics": { "accountBalance": 52140.50, "openPnl": 185.00, "closedPnl": -40.00 }
      },
      "positions": [
        {
          "symbol": "NQU6", "exchange": "CME",
          "qty": 2, "avgOpenPrice": 20010.25,
          "openPnl": 185.00, "closedPnl": -40.00
        }
      ]
    }
  ]
}

positions contains open positions (net quantity ≠ 0). updatedAt is the snapshot time in ms; if your session is disconnected the snapshot is the last known state.

Your trade history

Every fill on your linked accounts, as raw data — analyze your own trading however you like: win rates, per-symbol PnL, time-of-day breakdowns, slippage vs. our tick history. This works for any account you link in the dashboard, whether or not an algo trades it. History accumulates from the moment your account is linked (plus whatever your broker's order plant returns on connect) and survives restarts.

curl "https://api.tick-stream.xyz/v1/exec/fills?start=1751000000&symbol=NQU6" \
  -H "Authorization: Bearer sk_live_…"

Query: ?account=, ?symbol=, ?start=/?end= (epoch seconds), ?limit= (default 5000, most recent kept). Fills are returned oldest-first.

{
  "metrics": { "count": 142, "buyQty": 96, "sellQty": 96 },
  "fills": [
    {
      "accountId": "acct_9f2c…", "id": "20260705-1834",
      "ts": 1751713433, "tradeDate": "20260705",
      "symbol": "NQU6", "side": "buy",
      "qty": 2, "price": 20008.75,
      "orderNum": "233442211", "orderType": "MKT"
    }
  ]
}

Your orders

Every order you place through the Account & Execution API is tracked against the API key that placed it. List them — open, filled, cancelled or rejected — and watch them live in your dashboard.

curl https://api.tick-stream.xyz/v1/exec/orders \
  -H "Authorization: Bearer sk_live_…"

Query: ?status=open, ?status=filled or ?status=all (default).

{
  "metrics": { "open": 1, "filled": 3, "cancelled": 0, "rejected": 0 },
  "orders": [
    {
      "symbol": "NQU6", "side": "buy", "qty": 1,
      "orderType": "limit", "price": 20000, "status": "working",
      "filledQty": 0
    }
  ]
}

Placing orders

The order-placement surface. Order routing requires your connected Rithmic session and an open market:

Your Rithmic credentials are used only to route your own orders and are never shared. See the broader safety model in our rollout notes — demo-first, per-user isolation, kill-switch.