Get withdrawal status

Look up the state of a withdrawal by its event ID.

GET /api/v4/dexbuilder/withdraw/status

Get withdrawal status

cURL

curl --request GET \
  --url https://api.dexbuilder.com/api/v4/dexbuilder/withdraw/status \
  --header 'KEY: <api-key>' \
  --header 'SIGN: <api-key>' \
  --header 'Timestamp: <api-key>' \
  --header 'X-User-Wallet-Address: <x-user-wallet-address>'

200

Example

{
  "code": 0,
  "message": "success",
  "reason": "<string>",
  "trace_id": "<string>",
  "data": {
    "event_id": "<string>",
    "tx_hash": "<string>",
    "status": 123
  }
}

Look up the state of a withdrawal by its event ID.

Use a Broker API Key and pass the target user’s wallet in X-User-Wallet-Address. The gateway checks that the wallet belongs to your Broker. See Broker API Key and signing.

​

Usage notes

• Status values: 0 not found, 10 pending withdrawal, 11 confirming, 20 successful, 30 failed. Values 20 and 30 are terminal states.
• tx_hash is empty before the transaction is submitted onchain. While processing, you may poll every 3 to 10 seconds.

Authorizations

KEY · string · header · required

Broker API Key

Timestamp · string · header · required

Unix timestamp in seconds

SIGN · string · header · required

Hexadecimal HMAC-SHA512 signature generated with the Broker Secret Key

Headers

X-User-Wallet-Address · string · required

Target user's wallet address. The gateway verifies that the user belongs to the current Broker.

Query Parameters

event_id · string<uuid> · required

UUID returned by the withdrawal submit endpoint

Response

200

application/json

Query successful

code · integer

Business code; 0 indicates success

Example:

0

message · string

Human-readable message; success responses use success

Example:

"success"

reason · string

Error reason identifier; usually empty on success

trace_id · string

Trace ID to provide when requesting support

data · object

Show child attributes