# Execute trade

Executes a currency exchange trade using a valid quote ID. Must be called within 3 seconds of quote generation.
    
Use this endpoint to:
- Execute currency exchanges
- Lock in quoted rates
- Convert between currencies
- Initiate settlement process

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

## Path parameters:

  - `orgId` (string, required)

## Request fields (application/json):

  - `quoteId` (string, required)
    Example: "d8bc9618-2830-1822-9ae2-414aaf2b2de3"

## Response 200 fields (application/json):

  - `balances` (object)
    Updated user balances after the trade, keyed by currency symbol
    Example: {"USD":5000,"USDC":100}

  - `trade` (object)

  - `trade.id` (string)
    Unique identifier of the executed trade
    Example: "24753ee0-c3e9-4268-a48f-0cef3559f17f"

  - `trade.buy` (string)
    Currency symbol that user is buying
    Example: "USDC"

  - `trade.sell` (string)
    Currency symbol that user is selling
    Example: "USD"

  - `trade.referencedUnit` (string)
    Currency symbol used to specify the original trade input amount
    Example: "USD"

  - `trade.referenceAmount` (number)
    The amount the trade was based on, in the referenced currency
    Example: 123

  - `trade.amount` (number)
    The final amount transacted after fees or rounding
    Example: 122

  - `trade.status` (string)
    Status of the trade execution
    Example: "EXECUTED"

  - `trade.transactedAt` (string)
    UTC Timestamp when the trade was executed
    Example: "2025-01-21T17:37:33.074Z"

  - `trade.quoteId` (string)
    Unique identifier of the quote associated with this trade
    Example: "75324ee0-a48f-c3e9-4268-0cef3559f17f"

  - `userCreditLimit` (number)
    Total credit limit available to the user
    Example: 10000000

  - `userCreditUsed` (number)
    Amount of credit used by the user after this trade
    Example: 8844000.51844473

## 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 (application/json):

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

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