Create an FX quote

Changed on

Quote the USD debit for an exact foreign-currency amount. Pass the same amount and returned quote id when creating the international wire. USD international wires do not use FX quotes.

post/v2/transfers/international-wire/fx-quotes

Request

  • Base URL
    https://api.slash.com
  • URL
    https://api.slash.com/v2/transfers/international-wire/fx-quotes
  • Auth
    API key in header X-API-Key

Headers

X-Idempotency-Keystring required

Unique caller-generated key for one create request. Once an authenticated, schema-valid request reaches the operation, the key is permanently consumed for that operation and legal entity whether the operation succeeds or fails. Reusing it in that scope returns 409 and never replays a response, unlike API v1, which replays the original response for a matching key.

Request body

fromAccountstring required

Source virtual-account id with the subaccount_ prefix.

Example request

{
  "amount": {
    "amount": 10000,
    "currency": "GBP"
  }
}

Response

The created FX quote.

idstring required

FX quote id with the fx_rate_quote_ prefix.

status'pending' | 'available' | 'expired' | 'used' | 'canceled' required
exchangeRatestring required

Foreign currency units received per USD, including the FX fee.

createdAtstring date-time required
expiresAtstring date-time required

Exact expiration time. Quotes are typically valid for about 15 minutes; clients must treat this timestamp as authoritative.

updatedAtstring date-time required

Example response

{
  "amount": {
    "amount": 10000,
    "currency": "GBP"
  },
  "estimatedDebit": {
    "amount": 1250
  }
}

Changes