# Trade

The Trade APIs facilitate programmatic currency exchange through a quote-then-trade workflow, ensuring price transparency and guaranteed execution at quoted rates.

## Generate quote

 - [POST /v1/brokerage/{orgId}/generate_quote](https://docs.sandbox.openfx.com/api/trade/generatequote.md): 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

## List trades

 - [GET /v1/brokerage/{orgId}/trades](https://docs.sandbox.openfx.com/api/trade/listtrades.md): Returns a comprehensive list of all orders, including both completed and pending transactions.
    
Use this endpoint to:
- Track trading activity
- Monitor order statuses
- Generate trading reports
- Reconcile transactions

## Get trade by ID

 - [GET /v1/brokerage/{orgId}/trade/{id}](https://docs.sandbox.openfx.com/api/trade/gettradebyid.md): Provides detailed information on a specific trade using its unique identifier.
    
Use this endpoint to:
- Verify order execution details
- View settlement status
- Access transaction timestamps
- Review trade parameters

## Execute trade

 - [POST /v1/brokerage/{orgId}/trade](https://docs.sandbox.openfx.com/api/trade/executetrade.md): 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