Tickerbot API — The stock market in SQL

GET/v2/strategies/{name}/positions

Lists positions belonging to a strategy. The position table is Tickerbot's own ledger — it records what the strategy did, not what's actually held at a brokerage. Position rows carry `entry_price` (shares-weighted across filled tranches), `entry_atr`, `peak_price`, share counts, `tranches_fired`, `realized_pnl_dollars`, and `exit_reason` (set when closed).

Plan access

Hobby and above.

Rate limit

Hobby 60/min · Pro 2,000/min · Scale 10,000/min.

Capacity

Counts against your saved-rule capacity until v1.5 introduces a separate cap.

Query parameters

namestringrequired

Strategy slug.

statusstringdefault open

Filter by open/closed.

limitintegerdefault 100

Page size. Max 500.

Status codes

200

{ as_of, count, positions: [...] }. Sorted by opened_at desc.

400

bad_request — invalid status filter or strategy name.

curl "https://api.tickerbot.io/v2/strategies/{name}/positions" \
  --get \
  --data-urlencode 'status=open' \
  --data-urlencode 'limit=100' \
  -H "Authorization: Bearer YOUR_KEY"

Try it

This endpoint requires an authenticated key. Sign in to run it from your dashboard, or get a free key. tickerbot.io/dashboard.

Sample response

{
  "as_of": "2026-05-30T18:55:00.000Z",
  "count": 1,
  "positions": [
    {
      "id": "0c1a2e6c-2c4b-4f9b-b7a1-3d0a2e1f1a44",
      "leg_name": "core",
      "ticker": "AAPL",
      "side": "long",
      "opened_at": 1779389800,
      "closed_at": null,
      "entry_price": 186.42,
      "entry_atr": 3.18,
      "peak_price": 191.05,
      "shares_filled": 13.41,
      "shares_remaining": 13.41,
      "tranches_fired": 1,
      "realized_pnl_dollars": 0,
      "exit_reason": null
    }
  ]
}