TickerAll API Docs

Connect a broker account. We authenticate and warm a live connection, then hand back an accountId — the handle for THIS broker connection. One API key can hold several broker accounts, so the id lives in this response (and in GET /v1/accounts), NOT in the key. Use it in every later /v1/accounts/:id call. Your password is held in memory only while the connection is live, never saved to disk.

{
  "accountId": "acc_8Kd3...",
  "isDemo": true,
  "status": "connected",
  "expiresAt": "2026-05-22T18:42:10.000Z"
}

• ▸On the Free tier, only demo broker accounts are accepted — a real-money login is rejected with FREE_TIER_LIVE_REJECTED.
• ▸The connection stays warm for a while (see expiresAt). If it cools, calls return BROKER_ACCOUNT_NOT_HOT — just POST /v1/sessions again to reconnect.

Disconnect a broker account and release its connection. Returns no body.

(empty body)

List every broker account attached to your API key, with connection state.

[
  {
    "id": "acc_8Kd3...",
    "broker": "mt5",
    "server": "Exness-MT5Trial7",
    "accountNumber": "****5678",
    "isDemo": true,
    "status": "CONNECTED",
    "hot": true,
    "lastHotAt": "2026-05-22T18:30:01.000Z",
    "createdAt": "2026-05-20T09:11:55.000Z"
  }
]

• ▸accountNumber is masked to the last 4 digits. hot=false means the connection cooled — POST /v1/sessions to re-warm it.

Live account info — balance, equity, margin, leverage — plus the current open positions.

{
  "id": "acc_8Kd3...",
  "broker": "mt5",
  "server": "Exness-MT5Trial7",
  "accountNumber": "****5678",
  "isDemo": true,
  "status": "online",
  "account": {
    "name": "Demo Account 12345678",
    "accountType": "demo",
    "leverage": 500,
    "balance": 9871.42,
    "currency": "USD",
    "equity": 9863.10,
    "margin": 142.50,
    "freeMargin": 9720.60,
    "marginLevel": 6921.5
  },
  "positions": [
    {
      "ticket": 4072808150,
      "symbol": "BTCUSDm",
      "side": "BUY",
      "volume": 0.10,
      "entryPrice": 77512.73,
      "stopLoss": 71000,
      "takeProfit": 84000,
      "currentPrice": 77640.10,
      "profit": 12.74,
      "swap": 0,
      "commission": 0,
      "comment": "my-strategy",
      "magic": 0,
      "openTime": "2026-05-22T17:55:03.000Z"
    }
  ]
}

• ▸If the connection has cooled, you get status:"offline" with a hint instead of live data — POST /v1/sessions to reconnect.
• ▸Money fields (equity, margin, freeMargin, marginLevel) may be null on an MT4 account that has not yet pushed a balance frame — null is honest "not available yet", never a misleading 0.

Remove a broker account from your roster. We disconnect its live connection and drop it from your account list and from billing — this does NOT touch the broker account itself or any open positions. Reversible: reconnect the same login with POST /v1/sessions to re-add it.

{
  "id": "acc_8Kd3...",
  "status": "DISCONNECTED",
  "removed": true,
  "billableCount": 0
}

• ▸Idempotent — removing an already-removed account returns the same 200 shape.
• ▸If the account had always-hot enabled, that per-connection charge stops immediately; billableCount is your remaining always-hot connection count.

Switch which terminal type the account presents AS ("MOBILE" or "WEB"). Your open positions, pending orders and balance live on the broker account, not the connection, so they are preserved across the switch.

{
  "id": "acc_8Kd3...",
  "terminalType": "MOBILE",
  "status": "noop"
}

• ▸status is "noop" when the account is already on the requested transport.
• ▸Switching runs only when the account is idle (no in-flight trade — otherwise 409).
• ▸Both terminal types expose the full surface (account, quotes, positions, history).
• ▸The switch is zero-gap — the new transport is warmed before the old session is dropped — so open positions, orders and balance carry over untouched.

List tradeable symbols on the account, in the broker’s native names (pass-through, no normalization). symbols is the full catalog; watched is the subset that is actively streaming live ticks right now.

{
  "symbols": ["BTCUSDm", "ETHUSDm", "EURUSDm", "XAUUSDm", "USOILm", "..."],
  "watched": ["BTCUSDm", "ETHUSDm", "EURUSDm"]
}

• ▸Use a name from symbols when placing orders; subscribe to a name to start it ticking on the WebSocket.

Fetch historical OHLC bars from your connected broker, for any symbol the broker streams on this account. Returns the most-recent N hours of bars at the requested timeframe. Coarser timeframes (H4, D1, W1, MN1) reach much further back — daily bars typically cover years of history.

{
  "symbol": "BTCUSDm",
  "hours": 17520,
  "timeframe": "D1",
  "candles": [
    { "timestamp": 1747699200, "open": 104200.10, "high": 107840.55, "low": 103520.00, "close": 106910.73, "bid": 106910.73 },
    { "timestamp": 1747785600, "open": 106910.73, "high": 108100.00, "low": 105480.20, "close": 107512.40, "bid": 107512.40 }
  ]
}

• ▸Authed — needs your API key (same as the rest of the customer API). Works for any symbol your broker exposes on the connected account.
• ▸Each candle is { timestamp, open, high, low, close, bid }. timestamp is the bar OPEN time in Unix seconds (UTC); bid mirrors close.
• ▸Timeframes: M1, M5, M15, M30, H1, H4, D1, W1, MN1. Daily and coarser reach back years; intraday (M1–H4) covers recent months. One request returns as much history as fits in a few seconds — pass a large hours and take what comes back.
• ▸Deep look-backs are isolated onto a dedicated history connection — a big walk never disturbs your live tick stream.
• ▸If the broker returns no decodable bars for the symbol/range (e.g. an illiquid pair), the response is a 200 with an empty candles array — never a 500.

Unauthenticated read of the always-on demo feed — powers the sparklines and chart on tickerall.com. Limited to TickerAll’s demo symbol list and only callable from tickerall.com (origin-gated). For arbitrary broker symbols from your own code, use GET /v1/accounts/:id/candles above.

{
  "symbol": "BTCUSDm",
  "hours": 17520,
  "timeframe": "D1",
  "candles": [
    { "timestamp": 1747699200, "open": 104200.10, "high": 107840.55, "low": 103520.00, "close": 106910.73, "bid": 106910.73 },
    { "timestamp": 1747785600, "open": 106910.73, "high": 108100.00, "low": 105480.20, "close": 107512.40, "bid": 107512.40 }
  ]
}

• ▸No API key needed, but origin-gated: this endpoint accepts requests from tickerall.com only and exists to drive the public demo widgets. For programmatic access from your own code use GET /v1/accounts/:id/candles instead — it works on any symbol your broker exposes.
• ▸Each candle is { timestamp, open, high, low, close, bid }. timestamp is the bar OPEN time in Unix seconds (UTC); bid mirrors close.
• ▸Only the demo feed’s symbol list is available here. For any other symbol, connect a broker account and call GET /v1/accounts/:id/candles instead.

Place a market order (fills immediately) or a pending limit/stop order (rests until price is hit).

{
  "ticket": 4072808150,
  "symbol": "BTCUSDm",
  "side": "BUY",
  "type": "market",
  "volume": 0.10,
  "price": null,
  "stopLoss": 71000,
  "takeProfit": 84000,
  "comment": "my-strategy",
  "status": "open",
  "timestamp": "2026-05-22T17:55:03.000Z"
}

• ▸Requires an Idempotency-Key header (see Conventions). Re-sending the same key returns the original response without placing a second order.
• ▸status is "open" for market orders and "pending" for limit/stop orders.
• ▸A broker rejection (bad volume, market closed, stop-level too tight, insufficient margin) comes back as 422 BROKER_REJECTED with the broker’s reason in message.

Close an open position. Omit volume for a full close, or pass a smaller volume for a partial close.

{
  "ticket": 4072808150,
  "symbol": "BTCUSDm",
  "side": "BUY",
  "volume": 0.10,
  "closed": true,
  "timestamp": "2026-05-22T18:10:44.000Z"
}

• ▸Requires an Idempotency-Key header.
• ▸If the ticket is not an open position on this account you get 404 TICKET_NOT_FOUND.

Modify the stop-loss and/or take-profit of an open position. Provide at least one of stopLoss / takeProfit.

{
  "ticket": 4072808150,
  "symbol": "BTCUSDm",
  "side": "BUY",
  "volume": 0.10,
  "stopLoss": 72000,
  "takeProfit": 85000,
  "timestamp": "2026-05-22T18:12:09.000Z"
}

• ▸Requires an Idempotency-Key header.
• ▸You must supply at least one of stopLoss or takeProfit; sending neither is a VALIDATION_ERROR.
• ▸Some brokers enforce a minimum stop distance (stop level). Too-tight values come back as 422 BROKER_REJECTED.

Closed-trade history for the account — executed trades paired into round-trips (entry + exit), the equivalent of MT5’s history_deals_get. Returns the recent window your broker provides on connect plus any trades closed live during the session. Filter by symbol and close-time range.

{
  "trades": [
    {
      "ticket": "4072808150",
      "symbol": "ETHUSDm",
      "side": "BUY",
      "volume": 0.10,
      "openPrice": 2500.50,
      "closePrice": 2510.25,
      "openTime": "2026-05-20T10:00:00.000Z",
      "closeTime": "2026-05-20T12:30:00.000Z",
      "profit": 0.98,
      "swap": 0,
      "commission": 0,
      "stopLoss": 0,
      "takeProfit": 0,
      "closeTicket": "4072808151",
      "complete": true
    }
  ],
  "count": 1,
  "limit": 500
}

• ▸Returns the recent window your broker pushes on connect (typically the last few weeks) plus trades closed live during the current session. from/to filter those rows — they do not fetch further back than the broker’s window.
• ▸Each row is a round-trip: ticket is the open/position ticket; closeTicket is the closing deal (may be null for a trade closed live this session). profit is realised P/L in the account currency.
• ▸complete=true is a confirmed round-trip with trustworthy P/L. complete=false marks an incomplete/unmatched row, where profit is reported as null rather than a misleading 0.
• ▸swap and commission are reported as 0 (not carried in this data set).
• ▸A cheap read that never disturbs your live tick stream. On a connection that has cooled you get 409 BROKER_ACCOUNT_NOT_HOT — POST /v1/sessions to reconnect.