---
title: "List trader notifications"
method: GET
path: "/v1/traders/{trader_pubkey}/notifications"
tags: ["Notifications"]
---

# List trader notifications

`GET /v1/traders/{trader_pubkey}/notifications`

Handles `GET /v1/traders/{trader_pubkey}/notifications` via `get.v1.traders.by_trader_pubkey.notifications`.

## Path parameters

- `trader_pubkey` string, required

## Query parameters

- `limit` integer, nullable
- `cursor` string, nullable
- `unackedOnly` boolean, nullable

## Response `200`

- GetNotificationsResponse
  - `items` NotificationItem[], required
    - union — Notification item: discriminated union by source (event vs admin vs general).
      - object
        - `acked` boolean, required
        - `createdAt` string, date-time, required
        - `data` unknown, required
        - `details` union — Structured details for each notification type. Serialized to JSON for the `details` DB column and API response field.
          - object
            - `base_lots_filled` integer, required
            - `price` number, double, required
            - `side` string, required
            - `symbol` string, required
            - `type` 'orderFilled', required
          - object
            - `base_lots_released` integer, required
            - `side` string, required
            - `symbol` string, required
            - `type` 'riskEngineCancelOrder', required
          - object
            - `base_amount` number, double, required
            - `quote_amount` number, double, required
            - `side` string, required
            - `symbol` string, required
            - `trigger_type` string, nullable
            - `type` 'stopLossExecuted', required
          - object
            - `base_amount` number, double, required
            - `quote_amount` number, double, required
            - `side` string, required
            - `symbol` string, required
            - `trigger_type` string, nullable
            - `type` 'conditionalOrderExecuted', required
          - object
            - `base_amount` number, double, required
            - `quote_amount` number, double, required
            - `side` string, required
            - `symbol` string, required
            - `type` 'liquidation', required
          - object
            - `asset_id` integer, required
            - `base_lots_closed` integer, required
            - `type` 'adl', required
          - object
            - `asset_id` integer, required
            - `base_lots_transferred` integer, required
            - `haircut_rate` integer, required
            - `type` 'backstopLiquidation', required
            - `virtual_quote_lots_transferred` integer, required
          - object — DB fallback for old rows. Never serialized to the API response.
            - `type` 'unknown', required
        - `eventIndex` integer, required
        - `id` integer, required
        - `instructionIndex` integer, required
        - `notificationType` string, required
        - `recipientIndex` integer, required
        - `slot` integer, required — Composite index for dedupe/ack; matches DB unique key and WS temporary id.
        - `slotIndex` integer, required
        - `source` 'event', required
      - object
        - `acked` boolean, required
        - `body` string, nullable
        - `createdAt` string, date-time, required
        - `data` unknown, required
        - `id` integer, required
        - `notificationType` string, required
        - `source` 'admin', required
        - `title` string, nullable
      - object — General notification: user-specific, real-time (e.g. from Redis), not from on-chain events nor global admin announcements.
        - `acked` boolean, required
        - `body` string, nullable
        - `createdAt` string, date-time, required
        - `data` unknown, required
        - `id` integer, required
        - `notificationType` string, required
        - `source` 'general', required
        - `title` string, nullable
  - `nextCursor` string, nullable

---

[API](https://skmtc.net/phoenix/apis/phoenix-eternal-api.md) · [All operations](https://skmtc.net/phoenix/apis/phoenix-eternal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phoenix/phoenix-eternal-api/versions/0f598402d680/schema)