# Create FX quote

Creates a firm FX quote locked for a short time window.

Endpoint: POST /v1/fx-quotes
Version: 2.0.0
Security: oAuth2

## Header parameters:

  - `Idempotency-Key` (string)
    A unique key to make POST requests idempotent.

## Request fields (application/json):

  - `baseCurrency` (string, required)
    Example: "USD"

  - `quoteCurrency` (string, required)
    Example: "GTQ"

  - `amount` (number, required)
    Example: 1000

  - `side` (string, required)
    Enum: "buy", "sell"

  - `lockDuration` (integer,null)
    Example: 60

## Response 201 fields (application/json):

  - `quoteId` (string, required)
    Example: "fxq_01JH..."

  - `baseCurrency` (string, required)

  - `quoteCurrency` (string, required)

  - `amount` (number, required)

  - `side` (string, required)
    Enum: "buy", "sell"

  - `rate` (string, required)
    Example: "7.7310"

  - `convertedAmount` (number, required)
    Example: 7731

  - `fees` (array)

  - `fees.type` (string)

  - `fees.currency` (string)

  - `expiresAt` (string, required)

  - `createdAt` (string, required)

## Response 400 fields (application/json):

  - `traceId` (string, required)
    Correlation id for troubleshooting
    Example: "trc_01JH8K5P3V9M2K5Q7W6J3Z1A9B"

  - `error` (object, required)

  - `error.code` (string)
    Example: "INVALID_REQUEST"

  - `error.message` (string)
    Example: "Missing required field"

  - `error.details` (object)