Initiate an on-chain withdrawal

post/venue-adapter-service/api/vas/v1/initiate-withdrawal

Initiates an on-chain withdrawal from a venue account, used by Link.

Request Body

externalId string required
Credential external ID for the account from which funds should be withdrawn
asset string required
BitGo asset identifier to withdraw
Min length: >= 1 characters
destinationAddress string required
On-chain destination address
Min length: >= 1 characters
memo string
Optional memo/tag for memo-based chains (e.g., XRP, EOS, ATOM)
Min length: >= 1 characters
linkTransferId string required
Transfer ID in Link, created in an initial state before calling VAS
Min length: >= 1 characters
amount string required
Amount to withdraw in full units
Min length: >= 1 characters
travelRuleData object
Optional travel rule data required for certain jurisdictions
beneficiaryAddress object
Beneficiary physical address
beneficiaryFinancialInstitution string
Name of the beneficiary financial institution
Min length: >= 1 characters
beneficiaryName object
Beneficiary legal name
beneficiaryWalletType string
Type of beneficiary wallet
Allowed values: WALLET_TYPE_SELF_HOSTED WALLET_TYPE_EXCHANGE
isSelf boolean
Whether the withdrawal is to the same entity

200 Response

transfer object required
credentialExternalId string required
Min length: >= 1 characters
transferId string required
Min length: >= 1 characters
type string required
Allowed values: INBOUND OUTBOUND INTERNAL_INBOUND INTERNAL_OUTBOUND
status string required
Allowed values: PENDING UNCONFIRMED CONFIRMED CANCELED FAILED
assetRaw string required
Min length: >= 1 characters
amount string required
Min length: >= 1 characters
createdAt string <date-time>required
detailsOne ofrequired
externalId string
Min length: >= 1 characters
transactionId string
Min length: >= 1 characters
network string
Min length: >= 1 characters
networkRaw string
Min length: >= 1 characters
confirmations number
asset string
Min length: >= 1 characters
feeAsset string
Min length: >= 1 characters
feeAssetRaw string
Min length: >= 1 characters
feeAmount string
Min length: >= 1 characters

400 Response

error string required
Min length: >= 1 characters
missingFields array[string]

404 Response

errorName string required
error string required

409 Response

errorName string required
error string required

422 Response

errorName string required
error string required

500 Response

errorName string required
error string required