Skip to main content
POST
Create a Trade
Initiate a new trade.
You need to have an valid trade_id from a firm quote response to create a trade.

Authorizations

x-api-key
string
header
required

An API Key.

Headers

Authorization
string
required

The access token

X-Contact-ID
string

The ID of the contact

Query Parameters

quote_id
string
required

The identifier of the quote

client_id
string
required

The ID of the client

Body

application/json

Request Payload

reason
enum<string>
required

Reason for trade. The 'not_related_to_goods_or_services' reason is only for spot type.

Available options:
payment_for_goods,
payment_for_services,
repatriation_of_goods,
repatriation_of_services,
intercompany_funding_operational_purposes,
salary_payroll,
tax_related,
direct_investment,
property_purchase_sale,
payment_living_costs,
repayment_of_loan,
balance_hedging,
repatriation_from_investment,
other_not_related_to_goods_or_services,
charitable_aid,
capital_investment,
property_purchase,
mortage_repayment,
property_rental_or_maintenance,
travel_costs,
living_costs,
portfolio_netting,
not_related_to_goods_or_services,
other
reference
string

Reference for the trade.

trade_type
string

Currently ignored (DEPRECATED)

external_reference_id
string

API external reference id

Response

Trade created

bank_account
object
required

An existing bank account

maturity_date
string<date>
required

Limit date and time (UTC) in which funds must be received by Ebury

trade_id
string
required

Trade identifier

initial_margin_amount
number<double>

Only for forwards. Trade's deposit amount.

initial_margin_due_date
string<date>

Only for forwards. Date on or before which deposit must be received by Ebury. Date and time are in UTC.

external_reference_id
string

The client's external reference ID provided during trade creation