# Generate quote

Creates a new quote for a specific currency pair and amount, returning a quote ID and guaranteed rate valid for 3 seconds.
      
Use this endpoint to:
        - Get real-time exchange rates
        - Lock in rates for trading
        - Calculate exchange amounts
        - Review applicable fees and margins

Endpoint: POST /v1/brokerage/{orgId}/generate_quote
Version: v1.0.0
Security: bearerAuth

## Path parameters:

  - `orgId` (string, required)

## Request fields (application/json):

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

  - `buy` (string, required)
    Example: "USDC"

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

  - `referencedUnit` (string, required)
    Example: "USDC"

## Response 200 fields (application/json):

  - `status` (string)
    Enum: "success", "error"

  - `data` (object,null)

  - `data.quote` (object)

  - `data.quote.id` (string)
    Unique identifier for the quote
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `data.quote.userId` (string)
    Unique identifier of the user who generated the quote
    Example: "123e4567-e89b-12d3-a456-426614174001"

  - `data.quote.buy` (string)
    Currency the user wants to buy (quote's target currency)
    Example: "USD"

  - `data.quote.sell` (string)
    Currency the user wants to sell (quote's base currency)
    Example: "USDC"

  - `data.quote.referencedUnit` (string)
    Currency symbol used to reference the input amount
    Example: "USD"

  - `data.quote.referencedAmount` (number)
    Input amount in the referenced unit provided by the user
    Example: 1000

  - `data.quote.quoteAmount` (number)
    Calculated amount the user will receive or pay, based on the reference amount
    Example: 999.800000007998

  - `data.quote.createdAt` (string)
    UTC Timestamp when the quote was generated
    Example: "2024-11-25T15:05:34.945Z"

  - `data.quote.expiryTimeinSeconds` (number)
    Number of seconds until the quote expires
    Example: 15

  - `message` (string)
    Example: "Data fetched successfully"

## Response 400 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Data fetched successfully"

## Response 401 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Data fetched successfully"


## Response 500 fields