Tickerbot API — The stock market in SQL

POST/v2/strategies/{name}/positions/{id}/close

Force-close a position at a caller-supplied price. The endpoint marks the position closed (or scales it down via `size_pct`), updates `shares_remaining` and `realized_pnl_dollars`, and sets `exit_reason: 'manual'` when the position is fully closed. PnL math: `(price - entry_price) * shares_to_close * direction` where `direction` is +1 for long, -1 for short. `price` is supplied by the caller because the v1 runner does not yet have a live-quote integration; the caller is expected to pass the current market price (or a fill price from an external broker).

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.

Body parameters

namestringrequired

Strategy slug.

idstringrequired

Position UUID — see the list-positions endpoint.

Status codes

200

{ as_of, ok: true, closed_shares, remaining_shares, realized_pnl_dollars, fully_closed }.

400

bad_request — invalid name, id, price, or size_pct.

404

not_found — no open position with that id on this strategy.

curl -X POST https://api.tickerbot.io/v2/strategies/{name}/positions/{id}/close \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "size_pct": 100
  }'

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",
  "ok": true,
  "closed_shares": 6.705,
  "remaining_shares": 6.705,
  "realized_pnl_dollars": 38.16,
  "fully_closed": false
}