Skip to main content
Receive real-time updates on your executions (fills).
  • Topic: execution
  • Stream: Private (wss://api.ekiden.fi/ws/private)

​
Authenticate

Use authentication flow described in the Connect page.

​
Subscribe

{ "op": "subscribe", "args": ["execution"], "req_id": "203001" }
Ack: 
{ "op": "subscribed", "args": ["execution"], "req_id": "203001" }

​
Events

Messages arrive with op: "event", topic: "execution", and data is an array of Execution. Example: 
{
	"op": "event",
	"topic": "execution",
	"server_ts_ms": 1731541800000,
	"data": [
		{
			"exec_id": "550e8400-e29b-41d4-a716-446655440111",
			"symbol": "BTC-USDC",
			"order_id": "550e8400-e29b-41d4-a716-446655440000",
			"order_link_id": null,
			"side": "Buy",
			"sub_account_address": "0xsubacct...",
			"order_price": "100200",
			"order_qty": "1000",
			"leaves_qty": "500",
			"order_type": "Limit",
			"exec_price": "100250",
			"exec_qty": "500",
			"exec_value": "50125000",
			"exec_type": "Trade",
			"exec_time": "1731541800000",
			"is_maker": false,
			"fee_rate": "0.0002",
			"mark_price": "100260",
			"index_price": "100240",
			"seq": 789
		}
	]
}
Field notes:
  • Numeric values are encoded as strings to preserve precision.
  • exec_time is Unix milliseconds (encoded as a string).

​
Fields

FieldTypeNotes
exec_idstringExecution ID (UUID)
symbolstringSymbol name
order_idstringOrder ID (UUID)
order_link_idstring or nullClient-provided link id, if set
sidestringBuy or Sell
sub_account_addressstringSub-account address
order_pricestringOriginal order price
order_qtystringOriginal order quantity
leaves_qtystringRemaining quantity after this fill
create_typestring or nullCreate source/type
order_typestringLimit or Market
stop_order_typestring or nullStop order type, if applicable
exec_pricestringExecution price
exec_qtystringExecution quantity
exec_valuestringExecuted value (price * qty)
exec_typestringExecution type (e.g. Trade, Adl, …)
exec_timestringExecuted timestamp (ms)
is_makerbooleantrue maker, false taker
fee_ratestringTrading fee rate
mark_pricestringMark price at execution
index_pricestringIndex price at execution
closed_sizestring or nullClosed position size
seqintegerCross sequence
See schema details in AsyncAPI: Execution.