Drawdowns

Create a drawdown

Create a drawdown from an existing forward trade. You need to have a valid forward trade_id to create a drawdown.

post/drawdowns

Request

  • Base URL: https://api.ebury.io
  • URL: https://api.ebury.io/drawdowns
  • Auth: API key in header x-api-key

Query parameters

client_idstring required

The ID of the client

trade_idstring required

The ID of the forward trade to draw down from

Headers

Authorizationstring required

The access token

X-Contact-IDstring

The ID of the contact

Request body

amountnumber double required

The amount to draw down

operation'buy' | 'sell' required

The direction of the amount

value_datestring required

The T+2 value date for the drawdown in YYYY-MM-DD or YYYY/MM/DD format

reason_for_trade'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' required

Reason for trade

use_marginboolean required

Whether to use any available margin from the forward trade to fund the drawdown

convertboolean required

Intention behind the drawdown. When set to true, drawdown will be executed and funds will be transferred between two Ebury wallets. When false, drawdown will be executed only when it is linked to at least one payment

auto_confirm_value_dateboolean

When set to true, the next available value date will be used if the requested T+2 date is invalid. When false, the request will fail if the value date is not valid

external_reference_idstring

API external reference id for the drawdown. Maximum 128 characters. Alphanumeric, hyphens, and underscores only

Response

Drawdown created

trade_idstring required

Drawdown trade identifier

amount_to_transfernumber double

The amount to be transferred

buy_amountnumber double

The amount in the buy currency

sell_amountnumber double

The amount in the sell currency

ratestring

The exchange rate applied

reason_for_tradestring

The reason for trade specified in the request

external_reference_idstring

Your external reference ID if provided

convertboolean

Whether funds will be converted

value_datestring

The value date for the drawdown

deposit_not_usedstring

Amount of deposit not used from the forward trade

bank_accountobject

Bank account details for funding the drawdown

feeobject

Fee details for the drawdown, including payment and trade fees

fee_bank_accountobject

Bank account details for the fee payment

Changes

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