Sign in

v1

latestOpenAPI 3.0.02026-08-0641318.9 KB
Fund

Withdraw organization funds

Creates a withdrawal. Requires fund.withdraw permission.

request_id is optional. When supplied, it must be a UUID and acts as the idempotency key. When the same merchant retries with the same request_id, the API returns the previously created withdrawal information with is_duplicate=true.

post/withdraw

Headers

Datestring

GMT server time, e.g. Tue, 21 Jan 2025 12:00:00 GMT. Required on the wire; the Try it signer injects it automatically.

Authorizationstring

HMAC-SHA256 Signature header. Required on the wire; the Try it signer injects it automatically. See the Authentication guide.

Digeststring

SHA-256 digest required on the wire when a body is present; the Try it signer injects it automatically.

Request body

request_idstring uuid

Optional idempotency key. Must be a UUID when supplied.

chainstring required

Public chain name. Use a currently enabled pair returned by the withdrawal fees endpoint.

token_typestring required

Token type. Use a currently enabled pair returned by the withdrawal fees endpoint.

amountstring required

Positive withdrawal amount. Digits after the sixth decimal place are truncated without rounding; the resulting amount must be at least 1 and greater than the withdrawal fee.

wallet_addressstring required

Destination wallet address valid for the selected chain.

notestring

Optional withdrawal note.

Example request

{
  "request_id": "e94b4e88-36c2-4550-907e-839742cf5fae",
  "chain": "ETHEREUM",
  "token_type": "USDT",
  "amount": "10.00",
  "wallet_address": "0x5f716e5775b18409917e2a2f0762d29d6c385cb0",
  "note": "Treasury withdrawal"
}

Response

Standard response envelope

OR

Example response

{
  "data": {
    "request_id": "e94b4e88-36c2-4550-907e-839742cf5fae",
    "status": "pending"
  }
}