Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
withdrawal

Prepare or complete a client-executed crypto withdrawal

Two-phase crypto withdrawal flow:

Phase 1 — Prepare (omit tx_hash):

  • Creates a pending withdrawal event
  • Returns withdrawal_id

Phase 2 — Complete (include tx_hash + withdrawal_id):

  • Updates the pending withdrawal with the on-chain tx hash
  • Marks the withdrawal as submitted

Both phases require JWT authentication.

post/v1/withdrawal/crypto

Headers

authorizationstring nullable

Bearer JWT issued by Grove.

Bearer JWT issued by Grove.

Request body

tx_hashstring nullable

Transaction hash (omit for prepare phase, required for complete phase)

withdrawal_idstring nullable

Withdrawal event ID from prepare phase (required for complete phase)

destination_addressstring required

Destination wallet address the funds were sent to

amountstring required

Amount withdrawn in token units (e.g., '5.00' for 5 USDC)

tokenstring

Token symbol (default: USDC)

networkstring

Network the withdrawal was executed on

Response

Successful Response

OR