> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ebury.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trade Models

These models are returned by the [get all trades](#get-all-trades) and [get a trade](#get-a-trade) endpoints.

## BookedTrade

```json theme={null}
{
    "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**

<ResponseField name="trade_id" type="string">
  Always. Trade identifier
</ResponseField>

<ResponseField name="trade_type" type="string">
  Always. Trade type
</ResponseField>

<ResponseField name="status" type="string">
  Always. Status of the trade. See [`status`](#tradestatus).
</ResponseField>

<ResponseField name="buy_currency" type="string">
  Always. Buy currency code
</ResponseField>

<ResponseField name="buy_amount" type="number">
  Always. Buy amount
</ResponseField>

<ResponseField name="buy_balance_for_drawdown" type="number">
  Always. Remaining buy amount in the Forward after deducting the drawdown amounts
</ResponseField>

<ResponseField name="sell_currency" type="string">
  Always. Sell currency code
</ResponseField>

<ResponseField name="sell_amount" type="number">
  Always. Sell amount
</ResponseField>

<ResponseField name="sell_balance_for_drawdown" type="number">
  Always. Remaining sell amount in the Forward after deducting the drawdown amounts
</ResponseField>

<ResponseField name="initial_margin" type="number">
  Always. The remaining initial margin after deducting the amount used in the drawdowns.
</ResponseField>

<ResponseField name="margin_call" type="number">
  Always. The summation of the remaining margin calls after deducting the amount used in the drawdowns.
</ResponseField>

<ResponseField name="rate" type="number">
  Always. Booked rate
</ResponseField>

<ResponseField name="rate_symbol" type="string">
  Always. The symbol of booked rate
</ResponseField>

<ResponseField name="order_date" type="string">
  Always. Order date
</ResponseField>

<ResponseField name="maturity_date" type="string">
  Always. Limit date and time (UTC) in which funds must be received by Ebury
</ResponseField>

<ResponseField name="fee_currency" type="string">
  Always. Fee currency
</ResponseField>

<ResponseField name="fee_amount" type="number">
  Always. Fee amount
</ResponseField>

<ResponseField name="parent_trade_id" type="string">
  Always. Parent trade ID (not `null` for drawdown trades)
</ResponseField>

<ResponseField name="synthetic" type="boolean">
  Always. Identifies as a synthetic future contracts
</ResponseField>

<ResponseField name="trade_receipt" type="string">
  The URL to get the trade receipt
</ResponseField>

<ResponseField name="external_reference_id" type="string">
  External Reference ID
</ResponseField>

<ResponseField name="reference" type="string">
  Additional trade reference e.g., invoice number
</ResponseField>

<ResponseField name="convert" type="boolean">
  Intention behind the trade (either to move funds internally between Ebury wallets or to link payments to trades)
</ResponseField>

## TradeStatus

This is an enumeration of the status of a trade, and can be found in the [BookedTrade](#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](#create-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 |

<Note>
  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.
</Note>