Skip to main content
POST
/
v2
/
wallets
/
{id}
/
withdrawal-preview
Preview a withdrawal
curl --request POST \
  --url https://sandbox.groundtech.co/v2/wallets/{id}/withdrawal-preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destinationChain": "arbitrum",
  "amountUsd": 50
}
'
{
  "amountRequestedUsd": "50.000000",
  "feeUsd": "0.000000",
  "withdrawableUsd": "1000.000000",
  "totalUsdAfterWithdrawal": "950.000000",
  "estimatedCompletionTime": "PT2H"
}

Documentation Index

Fetch the complete documentation index at: https://docs.groundtech.co/llms.txt

Use this file to discover all available pages before exploring further.

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
​
destinationChain
enum<string>
required

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

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

If omitted, the preview returns the maximum withdrawable amount.

Response

Withdrawal preview

​
amountRequestedUsd
string

The withdrawal amount (requested amount, or the maximum available if omitted).

​
feeUsd
string

Fee charged for the withdrawal (currently always "0.000000").

​
withdrawableUsd
string

Conservative amount that can safely start a new withdrawal for this destination right now.

​
totalUsdAfterWithdrawal
string

Estimated wallet total after the previewed withdrawal amount is paid out.

​
estimatedCompletionTime
string

ISO-8601 duration estimate for withdrawal completion.