Skip to main content
POST
Create a new foreign exchange operation

Headers

Authorization
string
required

Authorization header

Example:

"Bearer Token"

Body

application/json
currency_amount
number<double>
required

Amount of currency to exchange

operation_purpose
string
required

Purpose of the operation (e.g., "EFX")

currency_pair
string
required

Currency pair for the exchange (e.g., "USDBRL")

counterparty_id
string
required

ID of the counterparty for this operation

Response

Operation created successfully

operation_id
string

Unique identifier of the operation

operation_purpose
string

Purpose of the operation

foreign_currency_amount
number<double>

Amount of foreign currency to exchange

currency_pair
string

Currency pair for the exchange

status
string

Current status of the operation

customer_id
string

ID of the customer for this operation

counterparty_id
string

ID of the counterparty for this operation

bank_account
object
intermediary_bank
object | null
batch_id
string | null

ID of the batch if the operation is part of a batch

created_at
string<date-time>

Timestamp when the operation was created