Transfers

Get withdrawal requests

Retrieves the withdrawal request history for the authenticated user. Results are paginated and can be filtered by status, asset, and time range.

GET
/transfers/withdrawal-requests

Authorization

ApiKeyAuth ApiSignatureAuth ApiTimestampAuth
x-api-key<token>

API key for authentication

In: header

x-api-signature<token>

HMAC-SHA256 signature: base64(HMAC(timestamp + method + path + body, secret))

In: header

x-api-timestamp<token>

Unix timestamp in seconds

In: header

Query Parameters

st?string

Filter by status. If not specified, returns all statuses.

  • WITHDRAWAL_REQUEST_STATUS_PENDING_APPROVAL: Submitted, awaiting approval (auto-approve job or admin RPC).
  • WITHDRAWAL_REQUEST_STATUS_REJECTED: Terminal: rejected before chain submission. Balance restored in perp state.
Default"WITHDRAWAL_REQUEST_STATUS_UNSPECIFIED"
Value in"WITHDRAWAL_REQUEST_STATUS_UNSPECIFIED" | "WITHDRAWAL_REQUEST_STATUS_PENDING" | "WITHDRAWAL_REQUEST_STATUS_SUCCESS" | "WITHDRAWAL_REQUEST_STATUS_FAIL" | "WITHDRAWAL_REQUEST_STATUS_PENDING_APPROVAL" | "WITHDRAWAL_REQUEST_STATUS_REJECTED"
asset?string

Filter by asset symbol (e.g., "USDC", "ETH").

crt_start_ts?string

Filter requests from this Unix timestamp (inclusive).

Formatuint64
crt_end_ts?string

Filter requests up to this Unix timestamp (inclusive).

Formatuint64
pg?string

Page number for pagination (1-indexed).

Formatint64
lmt?string

Number of items per page.

Formatint64

Response Body

application/json