List Withdrawal Transactions
Returns withdrawal transactions for the authenticated merchant account. Supports pagination and filtering by state, chains, date range, and withdrawal config. Requires WITHDRAWS_READ.
api.hel.io/v1 and generate API keys there. For the development environment, use api.dev.hel.io/v1 and generate API keys from moonpay.dev.hel.io.Authorizations
Authentication using JWT token
Query Parameters
Your API key, which can be generated from the Helio Dashboard settings page.
Page number (1-based).
Page size. Defaults to 20, maximum 100.
x <= 100Cursor for pagination. Returns items with _id less than this value.
Search by withdrawal detail ID, destination wallet (prefix), source token, or destination token.
Sort field. Defaults to createdAt.
Sort order. Defaults to desc.
asc, desc ISO 8601 start of createdAt range (inclusive).
ISO 8601 end of createdAt range (inclusive).
Filter by one or more withdrawal states.
QUOTED, SUBMITTING, SUBMITTED, BRIDGING, COMPLETED, FAILED, FAILED_EXPIRED, EXPIRED, REFUNDED_BY_PROVIDER Filter by source chain symbol (e.g. SOL, ETH).
Filter by destination chain symbol.
Filter by withdrawal config ID.
Response
Withdrawal transactions retrieved successfully.
Withdrawal detail ID.
QUOTED, SUBMITTING, SUBMITTED, BRIDGING, COMPLETED, FAILED, FAILED_EXPIRED, EXPIRED, REFUNDED_BY_PROVIDER Source chain symbol.
Source token symbol.
Source amount in atomic units.
Destination chain symbol.
Destination token symbol.
Destination amount in atomic units.
Destination wallet address.
Most recent transaction hash associated with the withdrawal.
acknowledged = confirmed; unacknowledged = sent, keep polling; rejected = terminal failure.
acknowledged, unacknowledged, rejected Human-readable error when the withdrawal failed.
Merchant-defined customer identifier set at prepare time, or null when omitted.
