cURL
Account
Pending Withdrawals
GET
cURL
Overview
Get all pending withdrawals for a user, including their status and claimable amounts.To avoid ambiguity, we denote the smallest possible multiple of USDC (0.000001 USDC) as one
uusdc,
which stands for µUSDC (micro-USDC), and denote the smallest possible multiple of a contract (0.01 contract)
as one ccontract (centicontract).User-facing USDC balances are specified as fixed-point strings (e.g. "1.2625" for USDC). Contract quantities
in the API and SDK are specified as integer ccontracts strings (e.g. "1050" for 10.50 contracts at precision 2).Path Parameters
string
required
User’s Ethereum wallet address.
Response
array
List of withdrawal records.
string
Total amount in
pending status in µUSDC (integer string).string
Total amount in
fill-locked status in µUSDC (integer string).string
Total amount in
unclaimed status in µUSDC (integer string).string
Total amount available to claim right now in µUSDC (integer string). Use this value to determine if the user can call
/get-withdraw-authorization.Withdrawal Statuses
Example Request
Example Response
Usage
Check this endpoint to:- Monitor withdrawal progress: See when scheduled withdrawals become claimable
- Determine claimable amount: Use
totalAvailableUnclaimedto know how much can be claimed - Track partial claims: View
claimedAmountUusdcandremainingUusdcfor partial claim tracking
totalAvailableUnclaimed !== "0", the user can call /get-withdraw-authorization to get a claim signature.