Skip to main content
WEBHOOK

Body

application/json

One fill for the user.

type
string
required

Webhook event identifier.

Allowed value: "derivatives.trade_executed"
user_id
string
required

Globally unique public identifier for a user.

Required string length: 14 - 42
account_id
string
required

Globally unique public identifier for an account.

Required string length: 14 - 42
trade_id
string
required

Trade identifier used to reconcile fills and discard duplicates.

symbol
string
required

Derivatives instrument symbol.

side
enum<string>
required

Direction of an order or execution.

Available options:
buy,
sell
quantity
string
required

Contract quantity executed in this trade.

price
string
required

Execution price for this trade.

Required string length: 1 - 64
Pattern: ^[0-9]+(\.[0-9]+)?$
fee
string
required

Fee for this trade. A positive value is charged to the user and a negative value is a rebate credited to the user. Fees are in the contract's settlement currency, which is the quote currency for linear contracts and the base currency for inverse contracts. EEA perpetual fees exclude any liquidation fee.

executed_at
string<date-time>
required

Time the trade executed.

order_id
string

Order that produced this fill. Omitted for a fill without a matching order, such as a liquidation.

client_order_id
string

Partner-supplied order identifier, when one was provided.

Response

2XX

Delivery endpoint accepted the webhook.