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

​
Authenticate

Use authentication flow described in the Connect page.

​
Subscribe

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

​
Events

Messages arrive with op: "event", topic: "fill", and data is an array of FillResponse. Example: 
{
	"op": "event",
	"topic": "fill",
	"data": [
		{
			"sid": "0xfill1",
			"side": "buy",
			"size": 500,
			"price": 100250,
			"maker_fee": 4,
			"taker_fee": 10,
			"taker_order_sid": "0xordT",
			"taker_addr": "0xuserT...",
			"maker_order_sid": "0xordM",
			"maker_addr": "0xuserM...",
			"market_addr": "0x88a70ff...",
			"seq": 789,
			"maker_leverage": 3,
			"taker_leverage": 5,
			"maker_is_cross": true,
			"taker_is_cross": false,
			"timestamp": 1681234567,
			"timestamp_ms": 1681234567000
		}
	]
}
Field notes:
  • Fees are split: maker_fee and taker_fee.
  • timestamp (seconds) is deprecated; prefer timestamp_ms.

​
Fields

FieldTypeNotes
sidstringFill identifier
sidestringbuy or sell (taker perspective)
sizeintegerBase units (scaled)
priceintegerExecution price (scaled)
maker_feeintegerMaker fee (quote units scaled)
taker_feeintegerTaker fee (quote units scaled)
taker_order_sidstringTaker order id
taker_addrstringTaker user address
maker_order_sidstringMaker order id
maker_addrstringMaker user address
market_addrstringMarket address
seqintegerSequence of execution batch
maker_leverageintegerMaker leverage at fill
taker_leverageintegerTaker leverage at fill
maker_is_crossbooleanMaker margin mode
taker_is_crossbooleanTaker margin mode
timestampintegerDeprecated seconds timestamp
timestamp_msintegerMilliseconds timestamp (preferred)
See schema details in AsyncAPI: FillResponse.