Skip to main content
POST
Quote withdrawals
Withdrawal quote and submit calls require an Ed25519 signature over the exact HTTP method, request path and query, timestamp, nonce, and raw body hash. Reuse the business idempotency key with a new timestamp, nonce, and signature when retrying an uncertain response.

Authorizations

X-Api-Key
string
header
default:sb_test_your_key
required

API credential. Withdrawal quote and submit operations additionally require the documented Ed25519 timestamp, nonce, and signature headers.

Headers

X-Stabyl-Timestamp
string
required

Current Unix time in milliseconds. The server accepts at most 30 seconds of clock skew.

X-Stabyl-Nonce
string<uuid>
required

A new UUIDv4 or UUIDv7 for this HTTP attempt. A verified nonce is single-use for five minutes.

X-Stabyl-Signature
string
required

Unpadded base64url Ed25519 signature of the version 1 canonical payload. The exact path includes the server prefix, for example /v1/partner/wallets/withdrawals.

Body

application/json

List-shaped withdrawal to quote: NGN bank items, or exactly one crypto item with currency NGN and settlement_rail CNGN, or currency USD and settlement_rail USDT/USDC. The signed HTTP request authenticates the caller; quoting does not reserve funds.

currency
string
required
Example:

"NGN"

items
object[]
required

Bank withdrawals accept 1 to 50 bank-account items. CNGN (NGN) and USDT/USDC (USD) withdrawals accept exactly one crypto-address item.

Required array length: 1 - 50 elements
settlement_rail
string | null
Example:

"USDC"

Response

Withdrawal quote

data
object
required
status
enum<string>
required
Available options:
success