First Leeward

Crypto Withdrawals

Submit withdrawal signature

POSThttps://api.firstleeward.com/v0/crypto-withdrawals/:id/sign

Submits the wallet owner signature over the current signing payload. The withdrawal then proceeds to broadcast.

Authorizations

Authorizationstring · headerrequired

API key as Bearer token, e.g. Bearer YOUR_API_KEY

Headers

Leeward-Versionenum<string>required

API version (YYYY-MM-DD). Available option: 2026-09-18

Idempotency-Keystringrequired

Unique key for safely retrying this request. Up to 255 characters; we recommend a UUIDv4. The first request executes and its response is cached; subsequent requests with the same key replay the cached response (24h retention).

Path Parameters

idstring<uuid>required

Crypto withdrawal ID

Body

application/json

executionIdstring<uuid>required

The executionId returned with the payload that was signed

signaturestringrequired

Owner signature over payloadToSign

Response

200Crypto withdrawal resource
idstring<uuid>required

Unique withdrawal identifier

accountIdstring<uuid>required

Account the funds are withdrawn from

chainIdstringrequired

Blockchain network the transfer happens on

Available options:ETHEREUM_MAINNETETHEREUM_SEPOLIABASE_MAINNETBASE_SEPOLIAARBITRUM_ONE_MAINNETARBITRUM_ONE_SEPOLIAPOLYGON_MAINNETPOLYGON_AMOYSOLANA_MAINNETSOLANA_DEVNET
assetobjectrequired

Asset metadata

Show child attributes
symbolstringrequired

Asset symbol

namestring | nullrequired

Full asset name

decimalsintegerrequired

Number of decimal places

logoUristring | nullrequired

URI to asset logo image

amountstringrequired

Gross amount requested, with decimals applied. The fee is taken out of this rather than charged on top.

netAmountstringrequired

Amount the destination receives: the gross less the fee

feeobjectrequired

Fee charged for the withdrawal, fixed at the time it was requested

Show child attributes
amountstringrequired

Fee retained, with decimals applied

assetobjectrequired

Asset metadata

Show child attributes
symbolstringrequired

Asset symbol

namestring | nullrequired

Full asset name

decimalsintegerrequired

Number of decimal places

logoUristring | nullrequired

URI to asset logo image

destinationAddressstringrequired

Address the funds are sent to

statusstringrequired

Current withdrawal status

Available options:PENDING_SIGNATUREPROCESSINGCOMPLETEDEXPIREDCANCELLEDFAILED
failureReasonstring | nullrequired

What went wrong. Set only when the status is FAILED.

Available options:REJECTED_BY_COMPLIANCEACCOUNT_RESTRICTEDTRANSACTION_FAILED
transactionIdstring | nullrequired

On-chain transaction identifier. Present once the transfer has been submitted to the network, which happens while the status is still PROCESSING.

expiresAtstringrequired

When the signature window closes. Past this point the withdrawal is closed and the funds become spendable again.

completedAtstring | nullrequired

When the transfer was observed to be irreversible on-chain, which is when the status became COMPLETED. Null until then.

createdAtstringrequired

ISO 8601 creation timestamp

updatedAtstringrequired

ISO 8601 last update timestamp

400The signature does not verify against the registered signer
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
404Crypto withdrawal not found
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
409Response for status 409
Option 1 · CryptoWithdrawalNotSignableError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
Option 2 · CryptoWithdrawalPayloadStaleError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired