---
title: "Get trader collateral history"
method: GET
path: "/v1/traders/{trader_pubkey}/collateral-history"
tags: ["Trader"]
---

# Get trader collateral history

`GET /v1/traders/{trader_pubkey}/collateral-history`

Handles `GET /v1/traders/{trader_pubkey}/collateral-history` via `get.v1.traders.by_trader_pubkey.collateral_history`.

## Path parameters

- `trader_pubkey` string, required

## Query parameters

- `limit` integer, required
- `nextCursor` string
- `prevCursor` string
- `cursor` string

## Response `200`

- CollateralHistoryResponse — Response for collateral event history queries
  - `data` CollateralEvent[], required — The data payload (array of items)
    - `amount` integer, required — Amount deposited or withdrawn (in quote lots, 6 decimals)
    - `collateralAfter` integer, required — Collateral balance after this event (in quote lots, 6 decimals)
    - `eventIndex` integer, required — Event index for ordering within the slot
    - `eventType` string, required — Event type: 'deposit' or 'withdrawal'
    - `slot` integer, required — Solana slot when the event occurred
    - `slotIndex` integer, required — Index within the slot
    - `timestamp` string, date-time, required — Formatted datetime string (ISO 8601).
    - `traderPdaIndex` integer, required — Trader PDA index (usually 0)
    - `traderSubaccountIndex` integer, required — Trader subaccount index
  - `hasMore` boolean, required — Whether there are more results in the requested direction
  - `nextCursor` string, nullable — Cursor for fetching older results
  - `prevCursor` string, nullable — Cursor for fetching newer results

---

[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)