Request a withdrawal

Provider automation path for withdrawals. With signing disabled this creates an idempotent dry-run operation. With signing enabled it plans a native EVM transaction from trusted wallet metadata and persists a signing request. Signing, signing result persistence, EVM broadcast, and receipt reconciliation are opt-in operational paths. Stale signing requests can be failed by operator-configured timeout without allowing late success results to overwrite that terminal state. Receipt reconciliation can wait for an operator-configured minimum confirmation depth before finalizing submitted withdrawals, and can optionally rebroadcast stored signed transactions or fail old submitted transactions whose receipts never appear. Gas-bumped replacement transaction handling is the next implementation milestone.

POST /api/v1/wallets/{wallet_id}/request-withdrawal

cURL

snakeCase

curl --request POST \ --url https://wallet-sandbox.blockops.network/api/v1/wallets/{wallet_id}/request-withdrawal \ --header 'ACCESS-API-KEY: <api-key>' \ --header 'ACCESS-SIGN: <api-key>' \ --header 'ACCESS-TIMESTAMP: <api-key>' \ --header 'Content-Type: application/json' \ --data ' { "asset_id": "00000000-0000-4000-8000-000000000002", "amount": "0.01", "recipient_address": "0x1111111111111111111111111111111111111111" } '

200

{
  "success": true,
  "message": "success",
  "code": 0,
  "data": {
    "id": "<string>",
    "withdrawal_id": "<string>",
    "wallet_id": "<string>",
    "asset_id": "<string>",
    "amount": "<string>",
    "recipient_address": "<string>",
    "status": "dry_run",
    "network_id": "<string>",
    "amount_base_units": "<string>",
    "from_address": "<string>",
    "status_reason": "<string>",
    "tx_id": "<string>",
    "tx_hash": "<string>",
    "chain_id": 123,
    "block_number": 123,
    "block_hash": "<string>",
    "gas_used": "<string>",
    "effective_gas_price_wei": "<string>",
    "confirmed_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

ACCESS-API-KEY · string · header · required

HMAC API-key identifier.

ACCESS-TIMESTAMP · string · header · required

Unix timestamp in seconds.

ACCESS-SIGN · string · header · required

Base64-encoded hex HMAC signature.

Headers

X-Idempotency-Key · string

Idempotency key for write operations.

Maximum string length: 128

Path Parameters

wallet_id · string · required

Body

application/json

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Accepts snake_case fields and camelCase aliases.

asset_id · string · required

amount · string · required

recipient_address · string · required

assetId · string

recipientAddress · string

to_address · string

toAddress · string

address · string

Response

200

application/json

Existing idempotent withdrawal or signing response.

Option 1

Option 2

success · boolean · required

message · string · required

Example:

"success"

code · integer string · required

Example:

0

data · object · required

Show child attributes