Skip to main content
POST
/
v2
/
wallets
/
{id}
/
withdraw
Initiate a withdrawal
curl --request POST \
  --url https://sandbox.groundtech.co/v2/wallets/{id}/withdraw \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "f4a5b6c7-0000-4000-8000-000000000001",
  "destinationChain": "arbitrum",
  "amountUsd": 50,
  "destinationAddress": "0xRecipient..."
}
'
{ "id": "w1a2b3c4-0000-4000-8000-000000000001", "amountUsd": "50.000000", "feeUsd": "0.000000", "destinationChain": "arbitrum", "destinationAddress": "0xRecipient...", "status": "pending", "txHash": null, "failureReason": null, "createdAt": "2025-09-05T10:00:00Z", "completedAt": null, "payouts": [] }

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Wallet ID

Body

application/json
​
requestId
string<uuid>
required

Client-generated idempotency key (UUID v4).

​
destinationChain
enum<string>
required

Destination chain for the withdrawal. Use ethereum_sepolia for sandbox testing.

Available options:
arbitrum,
base,
ethereum,
ethereum_sepolia,
polygon,
solana
​
amountUsd
number<double>
required

Amount to withdraw in USD terms.

​
destinationAddress
string
required

On-chain destination address. Use an EVM hex address for EVM chains or a base58 address for solana.

Response

Withdrawal initiated (or existing withdrawal returned for idempotent retry)

​
id
string<uuid>
​
amountUsd
string

Withdrawal amount in USD as a formatted string.

​
feeUsd
string | null

Fee charged for the withdrawal as a formatted string.

​
destinationChain
enum<string>

Destination chain for the withdrawal.

Available options:
arbitrum,
base,
ethereum,
ethereum_sepolia,
polygon,
solana
​
destinationAddress
string
​
status
enum<string>

Simplified withdrawal status.

Available options:
pending,
processing,
completed,
failed,
cancelled
​
txHash
string | null

On-chain transaction hash once the withdrawal is broadcast.

​
payouts
object[]

Individual payout legs of the withdrawal.

​
failureReason
string | null

Human-readable reason for failure (only present when status is failed).

​
createdAt
string<date-time>
​
completedAt
string<date-time> | null