Skip to content

trader.journal ​

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

list ​

GET/trader/v1/journal

Own journal

The account's sign-in and trade lines (the journal the terminal shows), newest first. Page backwards with before: pass the smallest id of the previous page. limit defaults to 100; a value above 500 (or 0) falls back to 100. Staff-only details (who acted, source service) are left out; params let the terminal word each line in the trader's language. 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.
beforeinteger · query
limitinteger · query
Returns
Promise<Entry[]>
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.journal.list({
  limit: 1
})
bash
curl -X GET "$NOVIQA_API_URL/trader/v1/journal?limit=1" \
  -H "Authorization: Bearer $NOVIQA_TOKEN"
json
{
  "success": true,
  "code": "ok",
  "message": "done",
  "data": [
    {
      "action": "string",
      "actor_ip": "string",
      "actor_login": 1,
      "at": "2026-09-25T10:15:00Z",
      "category": "auth",
      "channel": "string",
      "correlation_id": "string",
      "detail_ref": {
        "at": "2026-09-25T10:15:00Z",
        "line_id": "3f2a9c1e-8b7d-4e6f-a5c4-1b2d3e4f5a6b"
      },
      "details": null,
      "id": 1,
      "level": "debug",
      "line_id": "3f2a9c1e-8b7d-4e6f-a5c4-1b2d3e4f5a6b"
    }
  ],
  "request_id": "5b7f2c1e"
}
ts
trader.journal.list(query?: { before?, limit? }, options?: RequestOptions): Promise<journal.Entry[]>