Noviqa SDK

Appearance

trader.deals ​

1 method on trader.deals. Each returns the answer's data and throws NoviqaError on a failed answer.

list ​

GET/trader/v1/deals

Deal history

The account's deals (fills and money operations), newest first, by deal time. from (inclusive) and to (exclusive) are RFC3339 times; either may be left out; to must not be before from. page is 1-based (default 1), limit defaults to 100 and is capped at 1000. Only the signed-in account is ever read: the login comes from the session, never from the request.

Parameters
X-HST-Accountstring · header
Intended signed-in login captured by the browser tab before dispatch and retained across retries. A mismatch returns auth.account_changed (409) before mutation or refresh rotation. This never selects or authorizes an account; omission preserves existing API client compatibility.
fromstring · query
tostring · query
pageinteger · query
limitinteger · query
Returns
Promise<Deal[]>
The answer's data.
Errors
400invalid_input: invalid input
401auth.session_expired: session expired, sign in again
403auth.invalid_terminal: this terminal cannot be used here
403auth.otp_enrol_required: your group requires one-time codes: set them up to continue
403auth.password_change_required: you must change your password first
409auth.account_changed: the signed-in account changed; sign in again before continuing
500internal: something went wrong
ts
import { trader } from "@/lib/noviqa"

const data = await trader.deals.list({
  from: "2026-09-25T10:15:00Z",
  to: "2026-09-25T10:15:00Z",
  page: 1
})
bash
curl -X GET "$NOVIQA_API_URL/trader/v1/deals?from=2026-09-25T10%3A15%3A00Z&to=2026-09-25T10%3A15%3A00Z&page=1" \
  -H "Authorization: Bearer $NOVIQA_TOKEN"
json
{
  "success": true,
  "code": "ok",
  "message": "done",
  "data": [
    {
      "action": "buy",
      "calc_type": "forex",
      "comment": "Deposit via bank",
      "commission": "1.08452",
      "contract_size": "1.08452",
      "dealer": 1,
      "digits": 5,
      "entry": "in",
      "external_id": "string",
      "fee": "1.08452",
      "gateway_id": 1,
      "id": 1
    }
  ],
  "request_id": "5b7f2c1e"
}
ts
trader.deals.list(query?: { from?, to?, page?, limit? }, options?: RequestOptions): Promise<models.Deal[]>