# Transaction History

> Query paginated deposit and withdrawal history for your Alpha Ladder account, with time-range filtering and per-record status details.

Retrieve a paginated list of deposit or withdrawal records for a Alpha Ladder account. Both tools return records newest-first and support optional time-range filtering.

## The flow

### Deposit history

<Steps>

<Step>

**Query deposit records** — call `get_deposit_list` (pageNum, pageSize, payeeAccountType, startTime?, endTime?) to retrieve deposit records.

- `payeeAccountType: 1` = fiat deposits.
- `startTime` / `endTime` are optional; format: `"YYYY-MM-DD HH:mm:ss"` (e.g. `"2026-04-01 00:00:00"`).
- Records are returned newest first.

</Step>

</Steps>

### Withdrawal history

<Steps>

<Step>

**Query withdrawal records** — call `get_withdrawal_list` (pageNum, pageSize, payeeAccountType, startTime?, endTime?) to retrieve withdrawal records.

- `payeeAccountType: 1` = fiat withdrawals.
- Same time-range format applies.

</Step>

</Steps>

### "Did my deposit arrive?" pattern

Use `pageNum: 1` and a small `pageSize` (e.g. `5`) to show the user the most recent entries. For deposits, check `status` / `statusDesc` on the matching `paymentCode`.

## Ask in chat

> "Did my USD deposit arrive? Show me the last 5 deposits."

The agent will call `get_deposit_list` with `pageNum: 1`, `pageSize: 5`, `payeeAccountType: 1` and display the most recent fiat deposit records with their status.

## What you get back

Both tools return a paginated response:

| Field | Description |
|---|---|
| `total` | Total number of matching records |
| `pages` | Total pages |
| `pageNum` | Current page |
| `pageSize` | Records per page |
| `list[]` | Array of deposit / withdrawal records |

Each record includes `paymentCode`, `status`, `statusDesc` (may be `null` — display the raw `status` with a note when null), `currency`, `totalAmount`, `receiveAmount`, and `chargeAmount`.

<Callout type="info">**Minor units:** `totalAmount`, `receiveAmount`, and `chargeAmount` are integers in minor units (e.g. cents for USD). Divide by `10^decimals` before displaying. See [Minor units](/developers/financial-services/concepts#minor-units).</Callout>

For the full field reference and status conventions, see [Response Reference](/developers/financial-services/responses).