Refund deposit

Request a refund for a cryptocurrency deposit sent to your WhiteBIT account via the V4 API.

POST /api/v4/main-account/refund-deposit

Refund a deposit

cURL

curl --request POST \
  --url https://whitebit.com/api/v4/main-account/refund-deposit \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --data '
{
  "transaction_id": "54bffeb7-7a8f-43f8-bcd8-f14ec10fee85",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'

200

{
  "id": "54bffeb7-7a8f-43f8-bcd8-f14ec10fee85"
}

Authorizations

X-TXC-APIKEY · string · header · required

API key authentication using signed requests

Body

application/json

transaction_id · string<uuid> · required

Transaction UUID of the deposit. Obtain from the deposit.canceled webhook (uniqueId field) or from the deposit/withdraw history in the WhiteBIT interface.

Example:

"54bffeb7-7a8f-43f8-bcd8-f14ec10fee85"

address · string · required

Destination wallet address for the refund. The address must support the same network and asset as the original deposit. Cannot be a WhiteBIT address. Does not have to match the original deposit address.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

request · string · required

Base64-encoded request body. See the authentication guide for signature generation details.

Example:

"{{request}}"

nonce · string · required

A unique identifier for the request. Use a monotonically increasing value such as a Unix timestamp in milliseconds.

Example:

"{{nonce}}"

Response

200

application/json

System accepts refund request

id · string<uuid> · required

Transaction ID of the deposit (echoed from request)