# The FX Quote object

## Attributes

- `id` (string)
  Unique identifier for the object.

- `object` (string)
  String representing the object’s type. Objects of the same type share the same value.

- `created` (timestamp)
  Time at which the quote was created, measured in seconds since the Unix epoch.

- `lock_duration` (enum)
  The duration the exchange rate quote remains valid from creation time. Allowed values are none, hour, and day. Note that for the test mode API available in alpha, you can request an extended quote, but it won’t be usable for any transactions.
Possible enum values:
  - `day`
    Requests a quote valid for one day

  - `five_minutes`
    Requests a quote valid for five minutes

  - `hour`
    Requests a quote valid for one hour

  - `none`
    Requests a quote valid without lock rate

- `lock_expires_at` (timestamp, nullable)
  Time at which the quote will expire, measured in seconds since the Unix epoch.

  If lock_duration is set to ‘none’ this field will be set to null.

- `lock_status` (enum)
  Lock status of the quote.  Transitions from active to expired once past the lock_expires_at timestamp.

  Can return value none, active, or expired.
Possible enum values:
  - `active`
    FX Quote lock is active

  - `expired`
    FX Quote lock has expired

  - `none`
    FX Quote does not have a lock status

- `rates` (object)
  Information about the rates.

  - `rates.<from_currency>.exchange_rate` (float)
    The rate that includes the FX fee rate.

  - `rates.<from_currency>.rate_details` (object)
    The breakdown of the rates.

    - `rates.<from_currency>.rate_details.base_rate` (float)
      The rate for the currency pair.

    - `rates.<from_currency>.rate_details.duration_premium` (float)
      The fee for locking the conversion rates.

    - `rates.<from_currency>.rate_details.fx_fee_rate` (float)
      The FX fee for the currency pair.

    - `rates.<from_currency>.rate_details.reference_rate` (float, nullable)
      A reference rate for the currency pair provided by the reference rate provider.

    - `rates.<from_currency>.rate_details.reference_rate_provider` (enum, nullable)
      The reference rate provider.
Possible enum values:
      - `ecb`
        The European Central Bank is reference rate provider.

        We provide the reference rate when both the `from_currency` and `to_currency` are in the following list:

        - eur
        - usd
        - jpy
        - bgn
        - czk
        - dkk
        - gbp
        - huf
        - pln
        - ron
        - sek
        - chf
        - isk
        - nok
        - try
        - aud
        - brl
        - cad
        - cny
        - hkd
        - idr
        - ils
        - inr
        - krw
        - mxn
        - myr
        - nzd
        - php
        - sgd
        - thb
        - zar

- `to_currency` (string)
  The currency to convert into, typically this is the currency that you want to settle to your Stripe balance. Three-letter ISO currency code, in lowercase. Must be a supported currency.

- `usage` (object)
  The usage specific information for the quote.

  - `usage.payment` (object, nullable)
    The details required to use an FX Quote for a payment

    - `usage.payment.destination` (string, nullable)
      The Stripe account ID that the funds will be transferred to.

      This field should match the account ID that would be used in the PaymentIntent’s transfer_data[destination] field.

    - `usage.payment.on_behalf_of` (string, nullable)
      The Stripe account ID that these funds are intended for.

      This field must match the account ID that would be used in the PaymentIntent’s on_behalf_of field.

  - `usage.transfer` (object, nullable)
    The details required to use an FX Quote for a transfer

    - `usage.transfer.destination` (string)
      The Stripe account ID that the funds will be transferred to.

      This field should match the account ID that would be used in the Transfer’s destination field.

  - `usage.type` (enum)
    The transaction type for which the FX Quote will be used.

    Can be ‘payment’ or ‘transfer’.
Possible enum values:
    - `payment`
      The usage of the FX Quote is for payments.

    - `transfer`
      The usage of the FX Quote is for transfers.

### The FX Quote object

```json
{
  "id": "fxq_1QKf8UET9NELqCotgW6CNTnm",
  "object": "fx_quote",
  "created": 1731498806.6424642,
  "lock_duration": "hour",
  "lock_expires_at": 1731502406.5579598,
  "lock_status": "active",
  "rates": {
    "gbp": {
      "exchange_rate": 1.10167,
      "rate_details": {
        "base_rate": 1.12415,
        "fx_fee_rate": 0.02,
        "reference_rate": 1.12437,
        "reference_rate_provider": "ecb"
      }
    },
    "krw": {
      "exchange_rate": 0.000617274,
      "rate_details": {
        "base_rate": 0.000629871,
        "fx_fee_rate": 0.02,
        "reference_rate": 0.000629997,
        "reference_rate_provider": "ecb"
      }
    }
  },
  "to_currency": "chf",
  "usage": {
    "payment": null,
    "transfer": null,
    "type": "payment"
  }
}
```