---
title: "Create a FX quote"
method: POST
path: "/fx/quotes"
---

# Create a FX quote

`POST /fx/quotes`

[Available in Production/Sandbox environment] Request a quote for an FX conversion.

## Headers

- `X-XFERS-APP-API-KEY` string, required
- `X-PUBLIC-KEY-ID` string
- `X-TIMESTAMP` string
- `X-NONCE` string
- `X-SIGNATURE` string

## Request body

- object
  - `data` object
    - `attributes` object
      - `from` object, required — Source currency and amount.
        - `currency` string, required — Source currency. One of: `XUSD`, `XSGD`, `USD`, `SGD`.
        - `amount` string — Amount in source currency. Decimal string.<br><br><strong>Note:</strong> Either `from.amount` or `to.amount` must be provided, but not both.
      - `to` object, required — Target currency and optional amount.
        - `currency` string, required — Target currency. Currently only `IDR`.
        - `amount` string — Amount in target currency. Decimal string.<br>If provided, the quote is computed in reverse (target → source).<br><br><strong>Note:</strong> Either `from.amount` or `to.amount` must be provided, but not both.
      - `tenor` string, required — Settlement speed. Currently only `instant` is supported.

## Response `201`

201 Created

- object
  - `data` object
    - `id` string — Quote ID, prefixed with `fx_quote_`.
    - `type` string — Resource type. Always `fxQuote`.
    - `attributes` object
      - `rate` number — FX rate applied (from → to).
      - `from` object — Source currency and amount.
        - `currency` string
        - `amount` string
      - `to` object — Target currency and computed amount.
        - `currency` string
        - `amount` string
      - `tenor` string — Settlement speed. Currently only `instant` is supported.
      - `createdAt` string — ISO 8601 timestamp of quote creation (Singapore timezone).
      - `expiresAt` string — ISO 8601 timestamp of quote expiry (Singapore timezone).

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/straitsx/apis/straitsx-sandbox-base-url.md) · [All operations](https://skmtc.net/straitsx/apis/straitsx-sandbox-base-url/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/straitsx/straitsx-sandbox-base-url/versions/9ceee2969aeb/schema)