@imbingox/acex 0.3.0 → 0.4.0-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -7
- package/docs/api.md +66 -66
- package/package.json +1 -1
- package/src/adapters/binance/adapter.ts +131 -12
- package/src/adapters/binance/market-catalog.ts +10 -10
- package/src/adapters/binance/stream-protocol.ts +202 -0
- package/src/client/runtime.ts +1 -1
- package/src/internal/decimal.ts +19 -0
- package/src/internal/managed-websocket.ts +8 -0
- package/src/internal/subscription-multiplexer.ts +747 -0
- package/src/managers/account-manager.ts +40 -32
- package/src/managers/market-manager.ts +100 -51
- package/src/managers/order-manager.ts +7 -8
- package/src/types/account.ts +27 -28
- package/src/types/market.ts +12 -12
- package/src/types/order.ts +6 -7
- package/src/adapters/binance/book-ticker.ts +0 -123
- package/src/adapters/binance/mark-price.ts +0 -126
package/src/types/order.ts
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import type BigNumber from "bignumber.js";
|
|
2
1
|
import type { PositionSide } from "./account.ts";
|
|
3
2
|
import type {
|
|
4
3
|
PrivateRuntimeReason,
|
|
@@ -102,14 +101,14 @@ export interface OrderSnapshot {
|
|
|
102
101
|
side: OrderSide;
|
|
103
102
|
type: string;
|
|
104
103
|
status: OrderStatus;
|
|
105
|
-
price?:
|
|
106
|
-
triggerPrice?:
|
|
107
|
-
amount:
|
|
108
|
-
filled:
|
|
109
|
-
remaining?:
|
|
104
|
+
price?: string;
|
|
105
|
+
triggerPrice?: string;
|
|
106
|
+
amount: string;
|
|
107
|
+
filled: string;
|
|
108
|
+
remaining?: string;
|
|
110
109
|
reduceOnly?: boolean;
|
|
111
110
|
positionSide?: PositionSide;
|
|
112
|
-
avgFillPrice?:
|
|
111
|
+
avgFillPrice?: string;
|
|
113
112
|
exchangeTs?: number;
|
|
114
113
|
receivedAt: number;
|
|
115
114
|
updatedAt: number;
|
|
@@ -1,123 +0,0 @@
|
|
|
1
|
-
import { createManagedWebSocket } from "../../internal/managed-websocket.ts";
|
|
2
|
-
import type { BinanceMarketDefinition } from "./market-catalog.ts";
|
|
3
|
-
|
|
4
|
-
export interface BinanceL1BookUpdate {
|
|
5
|
-
bidPrice: string;
|
|
6
|
-
bidSize: string;
|
|
7
|
-
askPrice: string;
|
|
8
|
-
askSize: string;
|
|
9
|
-
exchangeTs?: number;
|
|
10
|
-
receivedAt: number;
|
|
11
|
-
}
|
|
12
|
-
|
|
13
|
-
export interface BinanceBookTickerSubscription {
|
|
14
|
-
readonly ready: Promise<void>;
|
|
15
|
-
close(): void;
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
export interface BinanceBookTickerCallbacks {
|
|
19
|
-
onBookTicker(update: BinanceL1BookUpdate): void;
|
|
20
|
-
onFreshnessChange(
|
|
21
|
-
freshness: "fresh" | "stale",
|
|
22
|
-
reason?: "heartbeat_timeout",
|
|
23
|
-
): void;
|
|
24
|
-
onDisconnected(): void;
|
|
25
|
-
onError?(error: Error): void;
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
export interface BinanceBookTickerOptions {
|
|
29
|
-
initialMessageTimeoutMs: number;
|
|
30
|
-
staleAfterMs: number;
|
|
31
|
-
reconnectDelayMs: number;
|
|
32
|
-
reconnectMaxDelayMs: number;
|
|
33
|
-
now?: () => number;
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
interface BinanceBookTickerMessage {
|
|
37
|
-
b?: string;
|
|
38
|
-
B?: string;
|
|
39
|
-
a?: string;
|
|
40
|
-
A?: string;
|
|
41
|
-
T?: number;
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
const BINANCE_SPOT_WS_BASE_URL = "wss://stream.binance.com:9443/ws";
|
|
45
|
-
const BINANCE_USDM_WS_BASE_URL = "wss://fstream.binance.com/ws";
|
|
46
|
-
const BINANCE_COINM_WS_BASE_URL = "wss://dstream.binance.com/ws";
|
|
47
|
-
|
|
48
|
-
function getWsBaseUrl(market: BinanceMarketDefinition): string {
|
|
49
|
-
switch (market.family) {
|
|
50
|
-
case "spot":
|
|
51
|
-
return BINANCE_SPOT_WS_BASE_URL;
|
|
52
|
-
case "usdm":
|
|
53
|
-
return BINANCE_USDM_WS_BASE_URL;
|
|
54
|
-
case "coinm":
|
|
55
|
-
return BINANCE_COINM_WS_BASE_URL;
|
|
56
|
-
}
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
function buildBookTickerUrl(market: BinanceMarketDefinition): string {
|
|
60
|
-
return `${getWsBaseUrl(market)}/${market.id.toLowerCase()}@bookTicker`;
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
function parseBookTickerMessage(
|
|
64
|
-
data: string,
|
|
65
|
-
): BinanceBookTickerMessage | undefined {
|
|
66
|
-
const parsed = JSON.parse(data) as BinanceBookTickerMessage;
|
|
67
|
-
if (!parsed.b || !parsed.B || !parsed.a || !parsed.A) {
|
|
68
|
-
return undefined;
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
return parsed;
|
|
72
|
-
}
|
|
73
|
-
|
|
74
|
-
export function subscribeBinanceBookTicker(
|
|
75
|
-
market: BinanceMarketDefinition,
|
|
76
|
-
callbacks: BinanceBookTickerCallbacks,
|
|
77
|
-
options: BinanceBookTickerOptions,
|
|
78
|
-
): BinanceBookTickerSubscription {
|
|
79
|
-
const session = createManagedWebSocket<BinanceBookTickerMessage>({
|
|
80
|
-
url: buildBookTickerUrl(market),
|
|
81
|
-
initialMessageTimeoutMs: options.initialMessageTimeoutMs,
|
|
82
|
-
now: options.now,
|
|
83
|
-
messageWatchdog: {
|
|
84
|
-
staleAfterMs: options.staleAfterMs,
|
|
85
|
-
onStale() {
|
|
86
|
-
callbacks.onFreshnessChange("stale", "heartbeat_timeout");
|
|
87
|
-
},
|
|
88
|
-
},
|
|
89
|
-
reconnect: {
|
|
90
|
-
initialDelayMs: options.reconnectDelayMs,
|
|
91
|
-
maxDelayMs: options.reconnectMaxDelayMs,
|
|
92
|
-
},
|
|
93
|
-
parseMessage: parseBookTickerMessage,
|
|
94
|
-
onMessage(message, receivedAt) {
|
|
95
|
-
if (!message.b || !message.B || !message.a || !message.A) {
|
|
96
|
-
return;
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
callbacks.onBookTicker({
|
|
100
|
-
bidPrice: message.b,
|
|
101
|
-
bidSize: message.B,
|
|
102
|
-
askPrice: message.a,
|
|
103
|
-
askSize: message.A,
|
|
104
|
-
exchangeTs: message.T,
|
|
105
|
-
receivedAt,
|
|
106
|
-
});
|
|
107
|
-
callbacks.onFreshnessChange("fresh");
|
|
108
|
-
},
|
|
109
|
-
onUnexpectedClose() {
|
|
110
|
-
callbacks.onDisconnected();
|
|
111
|
-
},
|
|
112
|
-
onError() {
|
|
113
|
-
callbacks.onError?.(new Error(`WebSocket error for ${market.symbol}`));
|
|
114
|
-
},
|
|
115
|
-
});
|
|
116
|
-
|
|
117
|
-
return {
|
|
118
|
-
ready: session.ready,
|
|
119
|
-
close() {
|
|
120
|
-
session.close();
|
|
121
|
-
},
|
|
122
|
-
};
|
|
123
|
-
}
|
|
@@ -1,126 +0,0 @@
|
|
|
1
|
-
import { createManagedWebSocket } from "../../internal/managed-websocket.ts";
|
|
2
|
-
import type { BinanceMarketDefinition } from "./market-catalog.ts";
|
|
3
|
-
|
|
4
|
-
export interface BinanceFundingRateUpdate {
|
|
5
|
-
fundingRate: string;
|
|
6
|
-
nextFundingTime?: number;
|
|
7
|
-
markPrice?: string;
|
|
8
|
-
indexPrice?: string;
|
|
9
|
-
exchangeTs?: number;
|
|
10
|
-
receivedAt: number;
|
|
11
|
-
}
|
|
12
|
-
|
|
13
|
-
export interface BinanceMarkPriceSubscription {
|
|
14
|
-
readonly ready: Promise<void>;
|
|
15
|
-
close(): void;
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
export interface BinanceMarkPriceCallbacks {
|
|
19
|
-
onFundingRate(update: BinanceFundingRateUpdate): void;
|
|
20
|
-
onFreshnessChange(
|
|
21
|
-
freshness: "fresh" | "stale",
|
|
22
|
-
reason?: "heartbeat_timeout",
|
|
23
|
-
): void;
|
|
24
|
-
onDisconnected(): void;
|
|
25
|
-
onError?(error: Error): void;
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
export interface BinanceMarkPriceOptions {
|
|
29
|
-
initialMessageTimeoutMs: number;
|
|
30
|
-
staleAfterMs: number;
|
|
31
|
-
reconnectDelayMs: number;
|
|
32
|
-
reconnectMaxDelayMs: number;
|
|
33
|
-
now?: () => number;
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
interface BinanceMarkPriceMessage {
|
|
37
|
-
e?: string;
|
|
38
|
-
E?: number;
|
|
39
|
-
s?: string;
|
|
40
|
-
p?: string;
|
|
41
|
-
i?: string;
|
|
42
|
-
r?: string;
|
|
43
|
-
T?: number;
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
const BINANCE_USDM_MARKET_WS_BASE_URL = "wss://fstream.binance.com/market/ws";
|
|
47
|
-
const BINANCE_COINM_WS_BASE_URL = "wss://dstream.binance.com/ws";
|
|
48
|
-
|
|
49
|
-
function getWsBaseUrl(market: BinanceMarketDefinition): string {
|
|
50
|
-
switch (market.family) {
|
|
51
|
-
case "usdm":
|
|
52
|
-
return BINANCE_USDM_MARKET_WS_BASE_URL;
|
|
53
|
-
case "coinm":
|
|
54
|
-
return BINANCE_COINM_WS_BASE_URL;
|
|
55
|
-
case "spot":
|
|
56
|
-
throw new Error(
|
|
57
|
-
`Funding rate is not supported for spot market: ${market.symbol}`,
|
|
58
|
-
);
|
|
59
|
-
}
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
function buildMarkPriceUrl(market: BinanceMarketDefinition): string {
|
|
63
|
-
return `${getWsBaseUrl(market)}/${market.id.toLowerCase()}@markPrice`;
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
function parseMarkPriceMessage(
|
|
67
|
-
data: string,
|
|
68
|
-
): BinanceMarkPriceMessage | undefined {
|
|
69
|
-
const parsed = JSON.parse(data) as BinanceMarkPriceMessage;
|
|
70
|
-
if (!parsed.r) {
|
|
71
|
-
return undefined;
|
|
72
|
-
}
|
|
73
|
-
|
|
74
|
-
return parsed;
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
export function subscribeBinanceMarkPrice(
|
|
78
|
-
market: BinanceMarketDefinition,
|
|
79
|
-
callbacks: BinanceMarkPriceCallbacks,
|
|
80
|
-
options: BinanceMarkPriceOptions,
|
|
81
|
-
): BinanceMarkPriceSubscription {
|
|
82
|
-
const session = createManagedWebSocket<BinanceMarkPriceMessage>({
|
|
83
|
-
url: buildMarkPriceUrl(market),
|
|
84
|
-
initialMessageTimeoutMs: options.initialMessageTimeoutMs,
|
|
85
|
-
now: options.now,
|
|
86
|
-
messageWatchdog: {
|
|
87
|
-
staleAfterMs: options.staleAfterMs,
|
|
88
|
-
onStale() {
|
|
89
|
-
callbacks.onFreshnessChange("stale", "heartbeat_timeout");
|
|
90
|
-
},
|
|
91
|
-
},
|
|
92
|
-
reconnect: {
|
|
93
|
-
initialDelayMs: options.reconnectDelayMs,
|
|
94
|
-
maxDelayMs: options.reconnectMaxDelayMs,
|
|
95
|
-
},
|
|
96
|
-
parseMessage: parseMarkPriceMessage,
|
|
97
|
-
onMessage(message, receivedAt) {
|
|
98
|
-
if (!message.r) {
|
|
99
|
-
return;
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
callbacks.onFundingRate({
|
|
103
|
-
fundingRate: message.r,
|
|
104
|
-
nextFundingTime: message.T,
|
|
105
|
-
markPrice: message.p,
|
|
106
|
-
indexPrice: message.i,
|
|
107
|
-
exchangeTs: message.E,
|
|
108
|
-
receivedAt,
|
|
109
|
-
});
|
|
110
|
-
callbacks.onFreshnessChange("fresh");
|
|
111
|
-
},
|
|
112
|
-
onUnexpectedClose() {
|
|
113
|
-
callbacks.onDisconnected();
|
|
114
|
-
},
|
|
115
|
-
onError() {
|
|
116
|
-
callbacks.onError?.(new Error(`WebSocket error for ${market.symbol}`));
|
|
117
|
-
},
|
|
118
|
-
});
|
|
119
|
-
|
|
120
|
-
return {
|
|
121
|
-
ready: session.ready,
|
|
122
|
-
close() {
|
|
123
|
-
session.close();
|
|
124
|
-
},
|
|
125
|
-
};
|
|
126
|
-
}
|