Withdraw
Withdraws ETH or a currency token from the specified node wallet to a target address. This call is asynchronous — the handler creates a WithdrawType (1) node transaction and returns HTTP 204 immediately. The funds settle only once the wallet pipeline confirms the on-chain transfer. Poll Get Node Transactions for the most-recent WithdrawType row until its status reaches Done (3) or Error (4).
Request
POST /v2/admin/nodes/{nodeID}/withdraw
Parameters
| Name | Type | In | Description |
|---|---|---|---|
nodeID | string | path | Required. The ID of the node to withdraw from |
Headers
| Name | Description |
|---|---|
Content-Type | application/json |
Authorization | Required. Bearer token for authentication |
Body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
currency_token_id | string or null | No | Currency Token ID to withdraw. Use null to withdraw native coin (e.g., ETH) |
address | string | Yes | Recipient wallet address |
amount | number | Yes | Amount to withdraw |
Example
curl --location 'http://localhost:3453/v2/admin/nodes/665ae536a6392b75cfd40352/withdraw' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
"currency_token_id": null,
"address": "0xa112983907944387B64ba512daF256B3f28f93f5",
"amount": 0.01
}'
Response
- Status:
204 No Content - Body: none
Status Codes
| Status Code | Description |
|---|---|
| 204 | No Content - Withdrawal accepted |
| 400 | Bad Request - Invalid input |
| 401 | Unauthorized - Invalid or missing authentication token |
| 404 | Not Found - Node does not exist |
| 500 | Internal Server Error |