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:

FieldRequiredDescription
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"
}
FieldDescription
requestIdUnique identifier of the request
assetType of cryptocurrency asset
assetPoolIdUnique identifier of the Asset Pool
networkBlockchain network where the asset is hosted
referenceUnique reference for the transaction
statusCurrent status of the transaction
sourcesArray with the source details for the withdrawal
destinationsArray with the destination details for the withdrawal
destinations.addressCrypto address where the funds will be sent
destinations.amountAmount of cryptocurrency to be sent to the address
typeType of transaction
createdAtTimestamp 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.


What’s Next

At this point, the Layer1 platform sends out webhooks related to the withdrawal, which will be covered in the next section.