Create Withdrawal Transaction
To create a withdrawal transaction, send POST digital/v1/transaction-requests
request with the following body parameters:
{
"assetPoolId": "2be1cc9c-a5af-47e2-9dba-b7b82317e600",
"asset": "ETH",
"network": "ETHEREUM",
"reference": "myUniqueRef333",
"destinations": [
{
"address": "0x84A4a239805d06c685219801B82BEA7c76702214",
"amount": "0.001",
"asset": "ETH"
}
]
}
The details to be sent in this request are as follows:
Field | Required | Description |
---|---|---|
assetPoolId | ✔️ | Unique identifier of the Asset Pool |
asset | ✔️ | Type of cryptocurrency asset |
network | ✔️ | Blockchain network where the asset is hosted |
reference | ✔️ | Unique reference for the transaction |
destinations | ✔️ | Array containing the destination details for the withdrawal |
destinations.address | ✔️ | Crypto address where the funds will be sent |
destinations.amount | ✔️ | Amount of cryptocurrency to be sent to the address |
destinations.asset | ✔️ | Type of cryptocurrency asset to be sent to the address, matching the address type |
Upon successfully submitting the transaction request, you receive the following details:
{
"requestId": "018fef0a-ab15-7afb-966b-7d20c89b5504",
"asset": "ETH",
"assetPoolId": "2be1cc9c-a5af-47e2-9dba-b7b82317e600",
"network": "ETHEREUM",
"reference": "myUniqueRef333",
"status": "CREATED",
"sources": [],
"destinations": [
{
"address": "0x84A4a239805d06c685219801B82BEA7c76702214",
"amount": "0.001"
}
],
"type": "WITHDRAWAL",
"createdAt": "2024-06-06T19:33:24.885Z"
}
Field | Description |
---|---|
requestId | Unique identifier of the request |
asset | Type of cryptocurrency asset |
assetPoolId | Unique identifier of the Asset Pool |
network | Blockchain network where the asset is hosted |
reference | Unique reference for the transaction |
status | Current status of the transaction |
sources | Array with the source details for the withdrawal |
destinations | Array with the destination details for the withdrawal |
destinations.address | Crypto address where the funds will be sent |
destinations.amount | Amount of cryptocurrency to be sent to the address |
type | Type of transaction |
createdAt | Timestamp when the transaction was created in ISO 8601 format |
The withdrawal is now actioned and moves throughout the flow described previously. You can use the requestId
along with the Get transaction request endpoint to poll the withdrawal at any point.
Updated 25 days ago
What’s Next
At this point, the Layer1 platform sends out webhooks related to the withdrawal, which will be covered in the next section.