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

# Get trader collateral history

`GET /v1/trader/{authority}/collateral-history`

## Request

- Base URL: `https://perp-api.phoenix.trade`
- URL: `https://perp-api.phoenix.trade/v1/trader/{authority}/collateral-history`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/phoenix/apis/phoenix-eternal-api/docs/v1/trader/:authority/collateral-history/get.ts> (a function with typed inputs; its response is checked against the schema)

Handles `GET /v1/trader/{authority}/collateral-history` via `get.v1.trader.by_authority.collateral_history`.

## Path parameters

- `authority` string, required

## Query parameters

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

## Response `200`

Collateral history

- 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.dev/phoenix/apis/phoenix-eternal-api.md) - [All operations](https://skmtc.dev/phoenix/apis/phoenix-eternal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phoenix/apis/phoenix-eternal-api/revisions/542796fe0648?raw)