Skip to main content
POST
/
v2
/
wallets
/
{id}
/
deposits
/
simulate
Simulate a deposit (sandbox only)
curl --request POST \
  --url https://sandbox.groundtech.co/v2/wallets/{id}/deposits/simulate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amountUsd": 100
}
'
{
  "id": "e2f3a4b5-0000-4000-8000-000000000001",
  "transactionHash": null,
  "chain": "ethereum",
  "token": "usdc",
  "fromAddress": null,
  "toAddress": "0xDeposit...",
  "blockNumber": null,
  "amount": "100.00",
  "createdAt": "2025-09-02T12:00:00Z"
}

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
​
amountUsd
number<double>
required

Amount in USD to simulate depositing.

Response

Simulated deposit created

​
id
string<uuid>
​
transactionHash
string | null
​
chain
enum<string>

Chain where the deposit was detected.

Available options:
ethereum,
arbitrum,
base,
polygon,
optimism,
avalanche,
solana
​
token
enum<string>

Token that was deposited.

Available options:
usdc
​
fromAddress
string | null
​
toAddress
string | null
​
blockNumber
integer | null
​
amount
string | null

Deposit amount as a formatted string (e.g. "100.50").

​
createdAt
string<date-time>