perp-cli 0.7.1 → 0.7.2

package/dist/exchanges/aster.js

@@ -23,6 +23,17 @@ export class AsterAdapter {
     get isReadOnly() {
         return !this._apiKey || !this._apiSecret;
     }
+    /** CLI symbol → Aster API symbol (ETH → ETHUSDT) */
+    _toApi(symbol) {
+        const s = symbol.toUpperCase().replace(/-PERP$/, "");
+        if (s.endsWith("USDT") || s.endsWith("BUSD"))
+            return s;
+        return `${s}USDT`;
+    }
+    /** Aster API symbol → CLI symbol (ETHUSDT → ETH) */
+    _fromApi(symbol) {
+        return symbol.replace(/USDT$/, "").replace(/BUSD$/, "");
+    }
     async init() {
         // Verify connectivity by fetching server time
         await this._publicGet("/fapi/v1/time");
@@ -70,7 +81,7 @@ export class AsterAdapter {
             // Extract max leverage from leverage brackets if available
             const maxLev = Number(s.maxLeverage ?? 50);
             return {
-                symbol: sym,
+                symbol: this._fromApi(sym),
                 markPrice: String(premium?.markPrice ?? ticker?.lastPrice ?? "0"),
                 indexPrice: String(premium?.indexPrice ?? "0"),
                 fundingRate: String(premium?.lastFundingRate ?? "0"),
@@ -81,7 +92,7 @@ export class AsterAdapter {
         });
     }
     async getOrderbook(symbol) {
-        const res = await this._publicGet("/fapi/v1/depth", { symbol: symbol.toUpperCase(), limit: "50" });
+        const res = await this._publicGet("/fapi/v1/depth", { symbol: this._toApi(symbol), limit: "50" });
         return {
             bids: res?.bids ?? [],
             asks: res?.asks ?? [],
@@ -89,12 +100,12 @@ export class AsterAdapter {
     }
     async getRecentTrades(symbol, limit = 20) {
         const trades = await this._publicGet("/fapi/v1/trades", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             limit: String(limit),
         });
         return (trades ?? []).map((t) => ({
             time: Number(t.time ?? 0),
-            symbol: symbol.toUpperCase(),
+            symbol: this._fromApi(String(t.symbol ?? symbol)),
             side: t.isBuyerMaker ? "sell" : "buy",
             price: String(t.price ?? "0"),
             size: String(t.qty ?? "0"),
@@ -103,7 +114,7 @@ export class AsterAdapter {
     }
     async getFundingHistory(symbol, limit = 10) {
         const data = await this._publicGet("/fapi/v1/fundingRate", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             limit: String(limit),
         });
         return (data ?? []).map((d) => ({
@@ -114,7 +125,7 @@ export class AsterAdapter {
     }
     async getKlines(symbol, interval, startTime, endTime) {
         const data = await this._publicGet("/fapi/v1/klines", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             interval,
             startTime: String(startTime),
             endTime: String(endTime),
@@ -151,7 +162,7 @@ export class AsterAdapter {
             .map((p) => {
             const amt = Number(p.positionAmt ?? 0);
             return {
-                symbol: String(p.symbol ?? ""),
+                symbol: this._fromApi(String(p.symbol ?? "")),
                 side: amt > 0 ? "long" : "short",
                 size: String(Math.abs(amt)),
                 entryPrice: String(p.entryPrice ?? "0"),
@@ -166,7 +177,7 @@ export class AsterAdapter {
         const orders = await this._signedGet("/fapi/v1/openOrders");
         return (orders ?? []).map((o) => ({
             orderId: String(o.orderId ?? ""),
-            symbol: String(o.symbol ?? ""),
+            symbol: this._fromApi(String(o.symbol ?? "")),
             side: String(o.side).toLowerCase(),
             price: String(o.price ?? "0"),
             size: String(o.origQty ?? "0"),
@@ -178,15 +189,15 @@ export class AsterAdapter {
     async getOrderHistory(limit = 30) {
         // allOrders requires symbol — get from positions or recent trades
         const positions = await this.getPositions();
-        const symbols = new Set(positions.map(p => p.symbol));
-        if (symbols.size === 0) {
+        const apiSymbols = new Set(positions.map(p => this._toApi(p.symbol)));
+        if (apiSymbols.size === 0) {
             // Fallback: query the most common perp symbols when no open positions exist
             for (const s of ["BTCUSDT", "ETHUSDT", "SOLUSDT", "BNBUSDT", "XRPUSDT"]) {
-                symbols.add(s);
+                apiSymbols.add(s);
             }
         }
         const allOrders = [];
-        for (const sym of symbols) {
+        for (const sym of apiSymbols) {
             try {
                 const orders = await this._signedGet("/fapi/v1/allOrders", {
                     symbol: sym,
@@ -195,7 +206,7 @@ export class AsterAdapter {
                 for (const o of orders ?? []) {
                     allOrders.push({
                         orderId: String(o.orderId ?? ""),
-                        symbol: String(o.symbol ?? ""),
+                        symbol: this._fromApi(String(o.symbol ?? "")),
                         side: String(o.side).toLowerCase(),
                         price: String(o.price ?? "0"),
                         size: String(o.origQty ?? "0"),
@@ -211,11 +222,11 @@ export class AsterAdapter {
     }
     async getTradeHistory(limit = 30) {
         const positions = await this.getPositions();
-        const symbols = new Set(positions.map(p => p.symbol));
-        if (symbols.size === 0)
-            symbols.add("BTCUSDT");
+        const apiSymbols = new Set(positions.map(p => this._toApi(p.symbol)));
+        if (apiSymbols.size === 0)
+            apiSymbols.add("BTCUSDT");
         const allTrades = [];
-        for (const sym of symbols) {
+        for (const sym of apiSymbols) {
             try {
                 const trades = await this._signedGet("/fapi/v1/userTrades", {
                     symbol: sym,
@@ -224,7 +235,7 @@ export class AsterAdapter {
                 for (const t of trades ?? []) {
                     allTrades.push({
                         time: Number(t.time ?? 0),
-                        symbol: String(t.symbol ?? ""),
+                        symbol: this._fromApi(String(t.symbol ?? "")),
                         side: t.buyer ? "buy" : "sell",
                         price: String(t.price ?? "0"),
                         size: String(t.qty ?? "0"),
@@ -243,14 +254,14 @@ export class AsterAdapter {
         });
         return (data ?? []).map((f) => ({
             time: Number(f.time ?? 0),
-            symbol: String(f.symbol ?? ""),
+            symbol: this._fromApi(String(f.symbol ?? "")),
             payment: String(f.income ?? "0"),
         }));
     }
     // ── Trading ──
     async marketOrder(symbol, side, size) {
         return this._signedPost("/fapi/v1/order", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             side: side.toUpperCase(),
             type: "MARKET",
             quantity: size,
@@ -258,7 +269,7 @@ export class AsterAdapter {
     }
     async limitOrder(symbol, side, price, size, opts) {
         const params = {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             side: side.toUpperCase(),
             type: "LIMIT",
             price,
@@ -279,7 +290,7 @@ export class AsterAdapter {
     }
     async cancelOrder(symbol, orderId) {
         return this._signedDelete("/fapi/v1/order", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             orderId,
         });
     }
@@ -287,14 +298,14 @@ export class AsterAdapter {
         if (!symbol) {
             // Cancel all for all symbols with open orders
             const orders = await this.getOpenOrders();
-            const symbols = new Set(orders.map(o => o.symbol));
+            const apiSymbols = new Set(orders.map(o => this._toApi(o.symbol)));
             const results = [];
-            for (const sym of symbols) {
+            for (const sym of apiSymbols) {
                 results.push(await this._signedDelete("/fapi/v1/allOpenOrders", { symbol: sym }));
             }
             return results;
         }
-        return this._signedDelete("/fapi/v1/allOpenOrders", { symbol: symbol.toUpperCase() });
+        return this._signedDelete("/fapi/v1/allOpenOrders", { symbol: this._toApi(symbol) });
     }
     // ── Risk ──
     async setLeverage(symbol, leverage, marginMode) {
@@ -302,7 +313,7 @@ export class AsterAdapter {
         if (marginMode) {
             try {
                 await this._signedPost("/fapi/v1/marginType", {
-                    symbol: symbol.toUpperCase(),
+                    symbol: this._toApi(symbol),
                     marginType: marginMode === "cross" ? "CROSSED" : "ISOLATED",
                 });
             }
@@ -311,13 +322,13 @@ export class AsterAdapter {
             }
         }
         return this._signedPost("/fapi/v1/leverage", {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             leverage: String(leverage),
         });
     }
     async stopOrder(symbol, side, size, triggerPrice, opts) {
         const params = {
-            symbol: symbol.toUpperCase(),
+            symbol: this._toApi(symbol),
             side: side.toUpperCase(),
             quantity: size,
             stopPrice: triggerPrice,

package/dist/exchanges/edgex.d.ts

@@ -0,0 +1,62 @@
+/**
+ * edgeX DEX adapter — StarkEx-based perpetual futures exchange.
+ * Base: https://pro.edgex.exchange
+ */
+import type { ExchangeAdapter, ExchangeMarketInfo, ExchangePosition, ExchangeOrder, ExchangeBalance, ExchangeTrade, ExchangeFundingPayment, ExchangeKline } from "./interface.js";
+export declare class EdgeXAdapter implements ExchangeAdapter {
+    readonly name = "edgex";
+    readonly chain = "starkex";
+    readonly aliases: readonly ["ex"];
+    private _accountId;
+    private _starkPrivateKey;
+    private _baseUrl;
+    private _contracts;
+    private _contractById;
+    private _marketsCache;
+    private static CACHE_TTL;
+    constructor(accountId?: string, starkPrivateKey?: string);
+    get isReadOnly(): boolean;
+    /** CLI symbol -> API symbol: ETH -> ETHUSD */
+    private _toApi;
+    /** API symbol -> CLI symbol: ETHUSD -> ETH, DOGE2USD -> DOGE2 */
+    private _fromApi;
+    private _getContract;
+    init(): Promise<void>;
+    getMarkets(): Promise<ExchangeMarketInfo[]>;
+    getOrderbook(symbol: string): Promise<{
+        bids: [string, string][];
+        asks: [string, string][];
+    }>;
+    getRecentTrades(symbol: string, limit?: number): Promise<ExchangeTrade[]>;
+    getFundingHistory(symbol: string, _limit?: number): Promise<{
+        time: number;
+        rate: string;
+        price: string | null;
+    }[]>;
+    getKlines(symbol: string, _interval: string, _startTime: number, _endTime: number): Promise<ExchangeKline[]>;
+    getBalance(): Promise<ExchangeBalance>;
+    getPositions(): Promise<ExchangePosition[]>;
+    getOpenOrders(): Promise<ExchangeOrder[]>;
+    getOrderHistory(_limit?: number): Promise<ExchangeOrder[]>;
+    getTradeHistory(_limit?: number): Promise<ExchangeTrade[]>;
+    getFundingPayments(_limit?: number): Promise<ExchangeFundingPayment[]>;
+    marketOrder(symbol: string, side: "buy" | "sell", size: string): Promise<unknown>;
+    limitOrder(symbol: string, side: "buy" | "sell", price: string, size: string, opts?: {
+        reduceOnly?: boolean;
+        tif?: string;
+    }): Promise<unknown>;
+    editOrder(symbol: string, orderId: string, price: string, size: string): Promise<unknown>;
+    cancelOrder(_symbol: string, orderId: string): Promise<unknown>;
+    cancelAllOrders(symbol?: string): Promise<unknown>;
+    setLeverage(symbol: string, leverage: number, _marginMode?: "cross" | "isolated"): Promise<unknown>;
+    stopOrder(symbol: string, side: "buy" | "sell", size: string, triggerPrice: string, opts?: {
+        limitPrice?: string;
+        reduceOnly?: boolean;
+    }): Promise<unknown>;
+    withdraw(_amount: string, _destination: string): Promise<unknown>;
+    private _computeL2OrderFields;
+    private _signRequest;
+    private _publicGet;
+    private _authGet;
+    private _authPost;
+}