Cross-Currency Transfer

PostAuthentification requiseBêta

Moves funds between two wallets owned by the authenticated client that hold different currencies. Quote the rate first with the exchange-rate endpoint, then send the returned exchange_rate and rate_token to execute at that rate. Any applicable currency-exchange fee is deducted from the amount.

Point de terminaison

Post/wallet/v1/transfers/exchange

URL de base : https://api.derivws.com

Codes de statut

200OK - The transfer was executed, with the request_id echoed back.

400Bad request - The transfer breaks a transfer rule, the rate_token is stale, 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.

Réponses d'erreur

400Validation error

{
  "errors": [
    {
      "status": 400,
      "code": "ValidationError",
      "message": "rate_token is required",
      "field": "rate_token"
    }
  ]
}

400Transfer limit breached

{
  "errors": [
    {
      "status": 400,
      "code": "DailyLimitError",
      "message": "This transfer would exceed your daily transfer limit"
    }
  ]
}

Authentification requise

Ce point de terminaison nécessite l'en-tête Deriv-App-ID pour identifier votre application. Portée OAuth2 : payment

À propos de Cross-Currency Transfer

Le point de terminaison POST /wallet/v1/transfers/exchange : Moves funds between two wallets owned by the authenticated client that hold different currencies. Quote the rate first with the exchange-rate endpoint, then send the returned exchange_rate and rate_token to execute at that rate. Any applicable currency-exchange fee is deducted from the amount.

Transfer Between Wallets Platform Transfer

D'autres questions ? Nous contacter