Noviqa SDK

Appearance

trader.notifications ​

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

list ​

GET/trader/v1/notifications

Notifications

The newest notifications staff sent to the account, newest first. New ones also arrive on the live socket.

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.
limitinteger · query
How many, default 50 (0 or less = 50, above 200 = 200).
Returns
Promise<Notification[]>
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.notifications.list({
  limit: 1
})
bash
curl -X GET "$NOVIQA_API_URL/trader/v1/notifications?limit=1" \
  -H "Authorization: Bearer $NOVIQA_TOKEN"
json
{
  "success": true,
  "code": "ok",
  "message": "done",
  "data": [
    {
      "company": "HS Markets Ltd",
      "created_at": "2026-09-25T10:15:00Z",
      "id": 1,
      "login": 1001,
      "message": "string",
      "sender": 1
    }
  ],
  "request_id": "5b7f2c1e"
}
ts
trader.notifications.list(query?: { limit? }, options?: RequestOptions): Promise<account.Notification[]>