Validate Transfer
PostAuth requiredBeta
Checks a transfer against the transfer rules before you execute it, and returns the fee, the net amount leaving the source account, and the estimated amount the destination receives. Validation moves no money. An invalid transfer returns an error describing what failed, so is_valid is always true on success.
Endpoint
Post
/wallet/v1/transfers/validateBase URL: https://api.derivws.com
Status Codes
200OK - The transfer passes validation, with the fee and amount breakdown.
400Bad request - The transfer breaks a transfer rule, or the body failed validation.
401Unauthorized - Missing or invalid Bearer token.
403Forbidden - Valid token but insufficient scope (payment scope required).
429Too many requests - Rate limit exceeded.
500Internal server error - errors[0].code will be InternalServerError.
503Service unavailable - Request rejected by the gateway circuit breaker.
504Gateway timeout - The service did not respond in time.
Error Responses
400Validation error
{
"errors": [
{
"status": 400,
"code": "ValidationError",
"message": "rate is required for a cross-currency transfer",
"field": "rate"
}
]
}400Currency not allowed
{
"errors": [
{
"status": 400,
"code": "CurrencyNotAllowed",
"message": "The destination payment agent does not accept this currency"
}
]
}Authentication Required
This endpoint requires the
Deriv-App-ID header to identify your application. OAuth2 Scope: paymentAbout Validate Transfer
The POST /wallet/v1/transfers/validate endpoint: Checks a transfer against the transfer rules before you execute it, and returns the fee, the net amount leaving the source account, and the estimated amount the destination receives. Validation moves no money. An invalid transfer returns an error describing what failed, so is_valid is always true on success.
Any other questions? Get in touch