Skip to main content
Withdrawals progress through a small set of states. After you initiate one, you poll either the wallet’s withdrawal list or the individual withdrawal by id until the process reaches a terminal state. Each withdrawal begins as “created”. As processing starts, status moves to “processing”. When all transfers are finalized, the status becomes “completed” and one or more transaction hashes may be present. If a problem prevents completion, the status becomes “failed” and a failure reason or error message may be included. List withdrawals for a yield wallet 
curl -X GET "$BASE_URL/yield-wallets/503ceb11-369a-4c5b-8bc9-7406cebec439/withdrawals?page=1&pageSize=20" \
  -H "Authorization: Bearer $TOKEN"
200 response 
{
  "withdrawals": [
    {
      "id": "af8fc553-a16c-4bff-a3e4-0091173f0eb6",
      "requestId": "47c0cd99-8e1e-4712-97a9-97304cb467ac",
      "status": "completed",
      "failureReason": null,
      "yieldWalletId": "503ceb11-369a-4c5b-8bc9-7406cebec439",
      "withdrawalAmount": 0.00063,
      "destinationToken": "usdt",
      "destinationChain": "bsc",
      "destinationAddress": "0x76F8fc6667E239f83a547d4e16225d6a34f6FA22",
      "txHashes": [
        "0xc1ab4fd839a5a7104710d52adf7b570282711e655b243dc74b8a31be9f7d90f4"
      ],
      "fromPrincipal": 0.00063,
      "fromYield": 0,
      "createdAt": "2025-09-11T04:47:46.786526+00:00"
    }
  ],
  "page": 1,
  "pageSize": 20,
  "total": 4
}
Fetch a single withdrawal by id 
curl -X GET "$BASE_URL/yield-wallets/withdrawals/c1a2b3c4-d5e6-7890-ab12-cd34ef56ab78" \
  -H "Authorization: Bearer $TOKEN"
200 response 
{
  "id": "c1a2b3c4-d5e6-7890-ab12-cd34ef56ab78",
  "requestId": "456e7890-f12c-34d5-b678-901234567890",
  "status": "completed",
  "failureReason": null,
  "yieldWalletId": "123e4567-e89b-12d3-a456-426614174000",
  "withdrawalAmount": 1000.5,
  "destinationToken": "usdc",
  "destinationChain": "ethereum",
  "destinationAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "txHashes": [
    "0xc1ab4fd839a5a7104710d52adf7b570282713e655b243dc74b8a31be9f7d90f4",
    "0x3f3eb97aad7733272eda7a514a2c45884fd84f9377bb91e11a87bd3ab0141a53"
  ],
  "fromPrincipal": 0,
  "fromYield": 0,
  "createdAt": "2025-01-15T14:30:45.123Z"
}
The statuses you will see are created, processing, completed, and failed. Use your original requestId to correlate application actions to the final on-chain results.