Guides

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

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.

Withdrawal history

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.

"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:

FieldDescription
totalTotal number of matching records
pagesTotal pages
pageNumCurrent page
pageSizeRecords 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.

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.

For the full field reference and status conventions, see Response Reference.

Was this page helpful?
© 2026 Alpha Ladder