Trades

Get a trade

Get a trade with a specific trade_id

get/trades/{trade_id}

Request

  • Base URL: https://api.ebury.io
  • URL: https://api.ebury.io/trades/{trade_id}
  • Auth: API key in header x-api-key

Path parameters

trade_idstring required

Trade identifier

Query parameters

client_idstring required

The identifier of a client.

Headers

Authorizationstring required

The access token.

X-Contact-IDstring

The identifier of a contact.

Response

Returns a BookedTrade model

buy_amountnumber float required

Buy amount

buy_balance_for_drawdownnumber float required

Remaining buy-side balance available to draw down against this trade. Zero for trades that cannot be drawn down.

buy_currencystring required

Buy currency code

fee_amountnumber float required

Fee amount

fee_currencystring required

Fee currency

initial_marginnumber float

Only for forwards. Trade's deposit amount.

margin_callnumber float

Only for forwards. Margin call amount.

maturity_datestring date-time required

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

order_datestring date required

Order date

parent_trade_idstring nullable required

Parent trade ID (not null for drawdown deals)

ratenumber float required

Booked rate

rate_symbolstring required

The symbol of booked rate

referencestring

Additional trade reference. Example: Invoice number.

sell_amountnumber float required

Sell amount

sell_balance_for_drawdownnumber float required

Remaining sell-side balance available to draw down against this trade. Zero for trades that cannot be drawn down.

sell_currencystring required

Sell currency code

start_datestring date nullable required

Date the drawdown window opens. Only set for window forwards; null for every other trade type and for window forwards with no start date.

status'Created' | 'Funds In Partially' | 'Funds In Full' | 'Funds Out Partially Allocated' | 'Funds Out Full Allocated' | 'Closed' | 'Cancelled' required

Status of the trade

syntheticboolean required

Identifies as a synthetic future contracts

trade_idstring required

Trade identifier

trade_receiptstring uri-reference

The URL to get the trade receipt

trade_typestring required

Trade type

external_reference_idstring

The client's external reference ID if provided during trade creation

Changes

No recorded changes to this operation across all 1 revision of this API.