Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ekiden.fi/llms.txt

Use this file to discover all available pages before exploring further.

Subscribe to insurance pool snapshots for a symbol.
  • Topic: insurance_pool.<symbol> (e.g., insurance_pool.BTC-USDC)
  • Stream: Public (wss://api.ekiden.fi/ws/public)

​
Subscribe

{ "op": "subscribe", "args": ["insurance_pool.BTC-USDC"], "req_id": "106001" }
Ack: 
{ "op": "subscribed", "args": ["insurance_pool.BTC-USDC"], "req_id": "106001" }

​
Events

Messages arrive with op: "event", topic: "insurance_pool.<symbol>", and data containing an InsurancePoolSnapshot. Example: 
{
	"op": "event",
	"topic": "insurance_pool.BTC-USDC",
	"server_ts_ms": 1731541800000,
	"data": {
		"pool_id": "BTC-USDC",
		"pool_group_id": "perps",
		"cash_balance": "1000000",
		"realized_pnl_cum": "12500",
		"unrealized_pnl": "-250",
		"base_equity": "1000000",
		"equity": "999750",
		"group_redistribution_in": "0",
		"group_redistribution_out": "0",
		"group_adl_obligation": "0",
		"adl_mode": "Normal",
		"adl_trigger_reason": null,
		"latest_pnl_ratio": "0.0012",
		"updated_time": 1731541800000,
		"inventory": [
			{
				"symbol": "BTC-USDC",
				"side": "Buy",
				"size": "0.5",
				"avg_entry_price": "100000",
				"unrealized_pnl": "-250"
			}
		]
	}
}
Field notes:
  • Numeric balances, prices, sizes, and PnL values are strings to preserve precision.
  • updated_time and server_ts_ms are Unix milliseconds.
  • inventory is the pool’s current inventory exposure.
See schema details in AsyncAPI: InsurancePoolSnapshot.