One Trading API
REST APIWebSocket API
REST APIWebSocket API
  1. Trading
  • Introduction
  • Authenticate
  • Subscribe
  • Ping / Pong
  • Trading
    • Introduction
    • Dead Man Switch (Auto Cancellation)
    • Create Order
    • Cancel All Orders
    • Cancel Order by Client ID
    • Cancel Order by Order ID
    • Margin Update
    • Settlement
    • Funding Payment
    • Order Booked
    • Order Rejected
    • Order Closed
    • Trade Executed
    • Order Fully Filled
    • Balance Adjustment
  • Orderbook
    • Introduction
    • Orderbook Snapshot
    • Orderbook Update
  • Price Ticks
    • Introduction
    • Price Tick
  • Book Ticker
    • Introduction
    • Book Tick
  1. Trading

Trade Executed

Spot#

{
  "channel_name": "TRADING",
  "type": "FILL", // DEPRECATED
  "event": "ORDER",
  "status": "FILL",
  "instrument_code": "BTC_EUR",
  "client_id": "a4698628-0443-4efd-b14f-2f929a907b66",
  "order_id": "31257543-181a-453b-0bab-c05dfa49631c",
  "time": 1743120925007395300,
  "side": "BUY",
  "order_book_sequence": 70467113399,
  "remaining": "0",
  "amount": "0.00248",
  "trade_id": "37b1c52b-4490-55b0-88ca-1d37f9515d90",
  "matched_as": "TAKER",
  "matched_amount": "0.00248",
  "matched_price_avg": "80620.06",
  "cum_quote_amount": "199.9377488",
  "fee": "0.00000496",
  "fee_currency": "BTC",
  "bals": [
    {
      "c": "BTC",
      "a": "10.00611402"
    },
    {
      "c": "EUR",
      "a": "1088100.76854612"
    }
  ],
  "lckd_bals": [
    {
      "c": "BTC",
      "a": "0"
    },
    {
      "c": "EUR",
      "a": "0"
    }
  ]
}
SpotTradeExecuted
channel_name
enum<string> 
required
The name of the WebSocket channel, always TRADING.
Allowed value:
TRADING
type
enum<string> 
deprecated
This field is deprecated and will be removed soon, please use the event and status fields.
Allowed value:
FILL
event
enum<string> 
required
Allowed value:
ORDER
status
enum<string> 
required
The order status.
Allowed values:
OPENFILLFILLED_FULLYCANCELLEDMOVEDINSUFFICIENT_FUNDSINSUFFICIENT_LIQUIDITYSELF_TRADEMOVE_SELF_TRADEMATCHING_POST_ONLY_RESULTS_IN_MATCHMATCHING_MOVE_FAILED_PRICE_OVER_RISK_LIMITRISK_MARGIN_TRADING_DISABLEDRISK_INVALID_RESERVE_BID_PRICERISK_FAILED_OVER_MAX_POSITION
instrument_code
string 
required
The instrument code of the market.
client_id
string <uuid>
required
The client provided, or system generated client id.
order_id
string <uuid>
required
The system generated order id.
time
number 
required
Nanosecond timestamp the order was accepted into the order book
side
string 
required
BUY or SELL
order_book_sequence
integer 
required
The order book sequence number.
amount
string 
required
The amount for the order.
trade_id
string <uuid>
required
The system generated trade id.
matched_as
enum<string> 
required
MAKER or TAKER
Allowed values:
MAKERTAKER
matched_amount
string 
required
How much of the order was matched with this trade.
matched_price_avg
string 
required
The average price at which the order was filled.
cum_quote_amount
string 
required
The cumulative quote currency amount for the filled portion of the order.
remaining
string 
required
The amount remaining for this order.
fee
string 
required
The amount taken as fee for this trade
fee_currency
string 
required
The currency in which the fee was charged. BUY orders will be charged fees in the base currency, SELL orders will be charged the fee in the quote currency.
tif
enum<string> 
required
Time in force.
Allowed values:
GTCFOKIOCPOST_ONLY
bals
array[object (TradingBalance) {2}] 
required
Available balances for the currencies concerned with this market.
c
string 
required
Currency code of the balance
a
string 
required
Amount of the balance
lckd_bals
array[object (TradingBalance) {2}] 
required
Locked balances for the currencies concerned with this market.
c
string 
required
Currency code of the balance
a
string 
required
Amount of the balance

Futures#

{
  "channel_name": "TRADING",
  "type": "FILL", // DEPRECATED
  "event": "ORDER",
  "status": "FILL",
  "instrument_code": "BTC_EUR_P",
  "client_id": "01f133fe-86d9-418f-8b52-86c71f1035d5",
  "order_id": "4539821b-df35-4d6a-21ed-ad1d6efc41fe",
  "time": 1743121323027671300,
  "side": "SELL",
  "order_book_sequence": 70467142629,
  "remaining": "0",
  "amount": "0.00185",
  "trade_id": "739f37ad-7c79-5bba-bc1f-f89c4cc90308",
  "matched_as": "TAKER",
  "matched_amount": "0.00185",
  "matched_price_avg": "80667.3",
  "cum_quote_amount": "149.234505",
  "open_volume": "-0.00247",
  "open_position": "199.273248",
  "fee": "0.29846901",
  "fee_currency": "EUR",
  "margin_used": "38.2479412",
  "liquidation": true, // This is optional, and only present if the order is part of a liquidation event
  "bals": [
    {
      "c": "EUR",
      "a": "962.73779864"
    }
  ]
}
FuturesTradeExecuted
channel_name
enum<string> 
required
The name of the WebSocket channel, always TRADING.
Allowed value:
TRADING
type
enum<string> 
deprecated
This field is deprecated and will be removed soon, please use the event and status fields.
Allowed value:
FILL
event
enum<string> 
required
Allowed value:
ORDER
status
enum<string> 
required
The order status.
Allowed values:
OPENFILLFILLED_FULLYCANCELLEDMOVEDINSUFFICIENT_FUNDSINSUFFICIENT_LIQUIDITYSELF_TRADEMOVE_SELF_TRADEMATCHING_POST_ONLY_RESULTS_IN_MATCHMATCHING_MOVE_FAILED_PRICE_OVER_RISK_LIMITRISK_MARGIN_TRADING_DISABLEDRISK_INVALID_RESERVE_BID_PRICERISK_FAILED_OVER_MAX_POSITION
instrument_code
string 
required
The instrument code of the market.
client_id
string <uuid>
required
The client provided, or system generated client id.
order_id
string <uuid>
required
The system generated order id.
time
number 
required
Nanosecond timestamp the order was accepted into the order book
side
string 
required
BUY or SELL
order_book_sequence
integer 
required
The order book sequence number.
remaining
string 
required
The amount remaining for this order.
amount
string 
required
The amount for the order.
trade_id
string <uuid>
required
The system generated trade id.
matched_as
enum<string> 
required
MAKER or TAKER
Allowed values:
MAKERTAKER
matched_amount
string 
required
How much of the order was matched with this trade.
matched_price_avg
string 
required
The average price at which the order was filled.
cum_quote_amount
string 
required
The cumulative quote currency amount for the filled portion of the order.
fee
string 
required
The amount taken as fee for this trade
fee_currency
string 
required
The currency in which the fee was charged. BUY orders will be charged fees in the base currency, SELL orders will be charged the fee in the quote currency.
tif
enum<string> 
required
Time in force.
Allowed values:
GTCFOKIOCPOST_ONLY
open_volume
string 
required
The total volume of contracts currently open for this specific market. If this value is positive, your overall position is LONG, if negative, your overall positions is SHORT
open_position
string 
required
The total amount (or notional value in EUR) of this markets contracts you have long/short across all trades.
margin_used
string 
required
The total margin used in your futures account, expressed in quote currency.
liquidation
boolean 
optional
Present and true if the trade was part of a liquidation event.
bals
array[object (TradingBalance) {2}] 
required
An array containing your account balance (equity) after the order has been booked. In this cash-settled futures account, the array will typically contain a single entry representing your balance in the settlement currency (EUR).
c
string 
required
Currency code of the balance
a
string 
required
Amount of the balance
Previous
Order Closed
Next
Order Fully Filled
Built with