Create Exchange Order

How to Request for Quote

Creating a quote is an optional step when creating an order. This step should be used when the user wants to lock the exchange rate for a specific period of time.

For example, if the user needs the rate to be guaranteed for 5 minutes, they must create a quote and set the expiration time in seconds using the expiresIn field (5 minutes equals 300 seconds).

For more details on how to create a quote, refer to the documentation according to the version your system is integrated with:

V1: https://docs.tracefinance.com/v1.0/reference/post_exchange-api-quotes

V2: https://docs.tracefinance.com/reference/post_exchange-api-quotes

How to Simulate an Exchange Order

Simulation is also an optional step and should be used when the user needs to preview the expected values of an operation.

In a simulation, the user must provide:

The operation type (buy or sell);

The foreign currency;

And the amount, which can be specified either in BRL or in the foreign currency.

Additionally, the user can provide a quote ID. If the quote ID is not provided, the system will use the reference rate available at the moment the simulation is requested.

Simulations are for reference purposes only and cannot be reprocessed or used to create orders.

For more details on how to perform a simulation, refer to the documentation corresponding to the version your system is integrated with:

V1: https://docs.tracefinance.com/v1.0/reference/post_exchange-api-orders-simulate

V2: https://docs.tracefinance.com/reference/post_exchange-api-orders-simulate

How to Create an Exchange Order

To create an order, the user must provide the amount, the operation type (buy or sell), and the foreign currency. If a quote has been created, the user can include its ID to use it as the reference rate. If no quote ID is provided, the current market rate at the time of creation will be used.

After the order is created, the Operations team will process it. If the order cannot be processed, it will be canceled (a webhook will be sent to notify the user). Otherwise, the order will be considered completed, and the settlement process will be initiated.

For more details on how to create an order, refer to the documentation corresponding to the version your system is integrated with:

V1: https://docs.tracefinance.com/v1.0/reference/post_exchange-api-orders

V2: https://docs.tracefinance.com/reference/post_exchange-api-orders