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"
}
'

{
  "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"
  }
}

{
  "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"
  }
}

{
  "success": false,
  "message": "success",
  "code": 0,
  "data": null
}

{
  "success": false,
  "message": "invalid api signature",
  "code": "unauthorized",
  "data": null
}

{
  "success": false,
  "message": "success",
  "code": 0,
  "data": null
}

{
  "success": false,
  "message": "success",
  "code": 0,
  "data": null
}

withdrawals

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

wallets

{wallet_id}

request-withdrawal

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"
}
'

{
  "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"
  }
}

{
  "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"
  }
}

{
  "success": false,
  "message": "success",
  "code": 0,
  "data": null
}

{
  "success": false,
  "message": "invalid api signature",
  "code": "unauthorized",
  "data": null
}

{
  "success": false,
  "message": "success",
  "code": 0,
  "data": null
}

{
  "success": false,
  "message": "success",
  "code": 0,
  "data": null
}

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

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

Existing idempotent withdrawal or signing response.

Option 1
Option 2

success

boolean

required

message

string

required

Example:

"success"

code

required

Example:

0

data

object

required

Show child attributes

Wallet API

Endpoints

Request a withdrawal

Authorizations

Headers

Path Parameters

Body

Response