POST
/
embedded-wallets
/
hyperliquid
/
withdraw
curl --request POST \
  --url https://api.copin.io/embedded-wallets/hyperliquid/withdraw \
  --header 'Content-Type: application/json' \
  --data '{
  "sourceAddress": "<string>",
  "destinationAddress": "<string>",
  "amount": 123
}'
{
  "userId": "<string>",
  "embeddedWallet": "<string>",
  "data": {},
  "data.destinationAddress": "<string>",
  "data.chargeFeeTime": "<string>",
  "data.chargeFeeTxHash": "<string>",
  "data.withdrawTime": "<string>",
  "data.txHash": "<string>",
  "data.amount": 123,
  "data.feeAmount": 123,
  "data.hyperliquidWithdrawFeeAmount": 123,
  "data.hyperliquidTransferFeeAmount": 123,
  "data.withdrawAmount": 123,
  "data.receiveAmount": 123,
  "type": "<string>",
  "status": "<string>",
  "createdAt": "<string>"
}

​
Request Body

​
sourceAddress
string
required

Address of the source wallet (embedded wallet)

​
destinationAddress
string
required

Address of the destination wallet to withdraw funds to

​
amount
number
required

Amount to withdraw

​
Request Example

curl --request POST \
--url "https://api.copin.io/embedded-wallets/hyperliquid/withdraw" \
--header 'Content-Type: application/json' \
--data '{
  "sourceAddress":"0x06791c29FaEDb81A87A2Ef85ce2A986fE6dDF96e",
  "destinationAddress": "0x1535484c1Eec1D203fE1A53EA11a621a884AE067",
  "amount": 10
}'

​
Response

The API returns withdrawal transaction details and status information.

​
userId
string

Identifier of the user who initiated the withdrawal

​
embeddedWallet
string

Address of the embedded wallet

​
data
object

Withdrawal transaction details

​
data.destinationAddress
string

Address where funds are being sent

​
data.chargeFeeTime
string

Timestamp when fees were charged

​
data.chargeFeeTxHash
string

Transaction hash for the fee charge

​
data.withdrawTime
string

Timestamp when the withdrawal was initiated

​
data.txHash
string

Transaction hash for the withdrawal

​
data.amount
number

Total amount requested for withdrawal

​
data.feeAmount
number

Total fee amount

​
data.hyperliquidWithdrawFeeAmount
number

Withdrawal fee charged by HyperLiquid

​
data.hyperliquidTransferFeeAmount
number

Transfer fee charged by HyperLiquid

​
data.withdrawAmount
number

Amount being withdrawn

​
data.receiveAmount
number

Amount that will be received after fees

​
type
string

Type of transaction (e.g., “WITHDRAW”)

​
status
string

Current status of the withdrawal (e.g., “SUCCESSFUL”)

​
createdAt
string

Timestamp when the withdrawal request was created

​
Response Example

{
  "userId": "654849d04857e1f744646cdd",
  "embeddedWallet": "0x06791c29FaEDb81A87A2Ef85ce2A986fE6dDF96e",
  "data": {
    "destinationAddress": "0x1535484c1Eec1D203fE1A53EA11a621a884AE067",
    "chargeFeeTime": "2025-04-15T08:06:57.341Z",
    "chargeFeeTxHash": "0x378fac4292a2145778ef0419d8fec0019100d73af2bf21ecacb4bc260b5b28c8",
    "withdrawTime": "2025-04-15T08:06:57.341Z",
    "txHash": "0x1988529b8b136229881b543373725e22b154b09471cf8c23b76d8f1b134bcf22",
    "amount": 10,
    "feeAmount": 1.1,
    "hyperliquidWithdrawFeeAmount": 1,
    "hyperliquidTransferFeeAmount": 1,
    "withdrawAmount": 7.9,
    "receiveAmount": 6.9
  },
  "type": "WITHDRAW",
  "status": "SUCCESSFUL",
  "createdAt": "2025-04-15T08:06:57.341Z"
}