Trade Models

These models are returned by the get all trades and get a trade endpoints.

BookedTrade

{
    "trade_id": "string",
    "trade_type": "string",
    "status": "string",
    "buy_currency": "string",
    "buy_amount": "number",
    "buy_balance_for_drawdown": "number",
    "sell_currency": "string",
    "sell_amount": "number",
    "sell_balance_for_drawdown": "number",
    "initial_margin": "number",
    "margin_call": "number",
    "rate": "number",
    "rate_symbol": "string",
    "order_date": "string",
    "maturity_date": "string",
    "fee_currency": "string",
    "fee_amount": "number",
    "synthetic": "boolean",
    "parent_trade_id": "string",
    "trade_receipt": "string",
    "reference": "string",
    "convert": "boolean",
    "external_reference_id": "string"
}

This model is a representation of a booked trade. Fields

string

Always. Trade identifier

string

Always. Trade type

string

Always. Status of the trade. See status.

string

Always. Buy currency code

number

Always. Buy amount

number

Always. Remaining buy amount in the Forward after deducting the drawdown amounts

string

Always. Sell currency code

number

Always. Sell amount

number

Always. Remaining sell amount in the Forward after deducting the drawdown amounts

number

Always. The remaining initial margin after deducting the amount used in the drawdowns.

number

Always. The summation of the remaining margin calls after deducting the amount used in the drawdowns.

number

Always. Booked rate

string

Always. The symbol of booked rate

string

Always. Order date

string

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

string

Always. Fee currency

number

Always. Fee amount

string

Always. Parent trade ID (not null for drawdown trades)

boolean

Always. Identifies as a synthetic future contracts

string

The URL to get the trade receipt

string

External Reference ID

string

Additional trade reference e.g., invoice number

boolean

Intention behind the trade (either to move funds internally between Ebury wallets or to link payments to trades)

TradeStatus

This is an enumeration of the status of a trade, and can be found in the BookedTrade model. Values

Value	Description
`Created`	Trade has been created
`Funds In Partially`	The trade has been partially funded
`Funds in Full`	The trade has been fully funded
`Funds Out Partially Allocated`	The proceeds of the trade have been only partially allocated to payments out
`Funds Out Full Allocated`	The proceeds of the trade have been fully allocated to payments out
`Closed`	The proceeds of the trade have been fully paid out and the trade is closed
`Cancelled`	The trade has been cancelled

ReasonForTradeValues

This is list of acceptable values for the reason field when creating a trade. Values

Value	Description	MiFID
`payment_for_goods`	Payment for identifiable goods	No
`payment_for_services`	Payment for identifiable services	No
`repatriation_of_goods`	Repatriation of sale of identifiable goods	No
`repatriation_of_services`	Repatriation of sale of identifiable services	No
`intercompany_funding_operational_purposes`	Intercompany funding for operational purposes	No
`salary_payroll`	Salary/Payroll	No
`tax_related`	Tax related	No
`direct_investment`	Direct investment	No
`property_purchase_sale`	Payments for property purchase or sale	No
`payment_living_costs`	Payment for living costs	No
`repayment_of_loan`	Repayment of a loan	Yes
`balance_hedging`	Balance sheet hedging	Yes
`repatriation_from_investment`	Repatriation of revenues from investments	Yes
`other_not_related_to_goods_or_services`	Other not related to goods or services	Yes

FX forwards with Ebury Partners Belgium NV can only be used for payments related for goods, services, or direct investments. We may ask for more information if needed. If you wish to use FX forwards for other purposes please contact your relationship manager.

​BookedTrade

​TradeStatus

​ReasonForTradeValues

BookedTrade

TradeStatus

ReasonForTradeValues