Skip to main content
POST
/
corporate
/
operation
Create a new foreign exchange operation
curl --request POST \
  --url https://fxaas-dev.acorianacorretora.com.br/corporate/operation \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency_amount": 11.32,
  "operation_purpose": "EFX",
  "currency_pair": "USDBRL",
  "counterparty_id": "5be479ff-03b9-4b14-8cb4-3bf0e5c3ae28"
}
'
{
  "operation_id": "aac055ac-8b88-46a8-a878-43cae6cd4bfe",
  "operation_purpose": "EFX",
  "foreign_currency_amount": 11.32,
  "currency_pair": "USDBRL",
  "status": "pending_quote",
  "customer_id": "e73eee2f-9643-4fe5-b4c1-4d98cb324bf6",
  "counterparty_id": "5be479ff-03b9-4b14-8cb4-3bf0e5c3ae28",
  "bank_account": {
    "bank_name": "First National Bank",
    "swift_code": "FNBAUS33XXX",
    "bank_country": "United States of America",
    "account_number": "1234567890",
    "iban": "US45999999999999",
    "aba_routing_number": "121000248"
  },
  "intermediary_bank": {
    "bank_name": "International Transfer Bank",
    "swift_code": "INTLUS44XXX",
    "bank_country": "United States of America"
  },
  "batch_id": null,
  "created_at": "2025-03-25T14:27:20.095886Z"
}

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
​
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