Merge branch 'main' into feat/OP-5033-real-time-trades

# Conflicts:
#	package-lock.json
#	package.json

package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@electra.finance/sdk",
-  "version": "0.2.4-rc6",
+  "version": "0.2.5",
   "description": "Electra finance SDK",
   "main": "./lib/index.cjs",
   "module": "./lib/index.js",

src/services/PriceFeed/index.ts

@@ -1,6 +1,6 @@
 import { fetchWithValidation } from 'simple-typed-fetch';
 import type { BasicAuthCredentials } from '../../types.js';
-import { allTickersSchema, candlesSchema } from './schemas/';
+import { allTickersSchema, candlesSchema, leaderboardSchema, statisticsOverviewSchema, topPairsSchema, winnersSchema } from './schemas/';
 import { PriceFeedWS } from './ws/index.js';
 
 class PriceFeed {
@@ -24,6 +24,10 @@ class PriceFeed {
 
     this.getCandles = this.getCandles.bind(this);
     this.getAllTickers = this.getAllTickers.bind(this);
+    this.getLeaderboard = this.getLeaderboard.bind(this);
+    this.getStatisticsOverview = this.getStatisticsOverview.bind(this);
+    this.getTopPairs = this.getTopPairs.bind(this);
+    this.getWinners = this.getWinners.bind(this);
   }
 
   get basicAuthHeaders() {
@@ -64,6 +68,38 @@ class PriceFeed {
     );
   }
 
+  getLeaderboard = () => {
+    return fetchWithValidation(
+      `${this.statisticsUrl}/futures/addresses`,
+      leaderboardSchema,
+      { headers: this.basicAuthHeaders }
+    );
+  }
+
+  getStatisticsOverview = () => {
+    return fetchWithValidation(
+      `${this.statisticsUrl}/overview?exchange=ALL`,
+      statisticsOverviewSchema,
+      { headers: this.basicAuthHeaders }
+    );
+  }
+
+  getTopPairs = () => {
+    return fetchWithValidation(
+      `${this.statisticsUrl}/top-pairs?exchange=ALL`,
+      topPairsSchema,
+      { headers: this.basicAuthHeaders }
+    );
+  }
+
+  getWinners = () => {
+    return fetchWithValidation(
+      `${this.statisticsUrl}/futures/winners`,
+      winnersSchema,
+      { headers: this.basicAuthHeaders }
+    );
+  }
+
   get wsUrl() {
     const url = new URL(this.apiUrl);
     const wsProtocol = url.protocol === 'https:' ? 'wss' : 'ws';

src/services/PriceFeed/schemas/index.ts

@@ -1,2 +1,6 @@
 export { default as candlesSchema } from './candlesSchema.js';
 export { allTickersSchema } from './allTickersSchema.js';
+export { leaderboardSchema } from './leaderboardSchema.js'
+export { statisticsOverviewSchema } from './statisticsOverviewSchema.js'
+export { topPairsSchema } from './topPairsSchema.js';
+export { winnersSchema } from './winnersSchema.js'

src/services/PriceFeed/schemas/leaderboardSchema.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+
+export const leaderboardSchema = z
+  .object({
+    address: z.string(),
+    totalVolume: z.number(),
+    todayVolume: z.number(),
+    totalPnl: z.number(),
+    todayPnl: z.number(),
+    totalRoi: z.number(),
+    todayRoi: z.number(),
+  })
+  .array();

src/services/PriceFeed/schemas/statisticsOverviewSchema.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+
+export const statisticsOverviewSchema = z
+  .object({
+    time: z.number(),
+    statisticsOverview: z.object({
+      volume24h: z.number(),
+      volume7d: z.number(),
+      volumeAllTime: z.number()
+    })
+  });

src/services/PriceFeed/schemas/topPairsSchema.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+
+export const topPairsSchema = z.object({
+  time: z.number(),
+  topPairs: z.array(
+    z.object({
+      assetPair: z.string(),
+      statisticsOverview: z.object({
+        volume24h: z.number(),
+        volume7d: z.number()
+      })
+    })
+  )
+});

src/services/PriceFeed/schemas/winnersSchema.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+
+export const winnersSchema = z.object({
+  bestTrade: z.object({
+    address: z.string(),
+    instrument: z.string(),
+    leverage: z.number(),
+    pnl: z.number(),
+    side: z.string()
+  }),
+  worstTrade: z.object({
+    address: z.string(),
+    instrument: z.string(),
+    leverage: z.number(),
+    pnl: z.number(),
+    side: z.string()
+  }),
+  bestPnl: z.object({ address: z.string(), pnl: z.number() }),
+  worstPnl: z.object({ address: z.string(), pnl: z.number() })
+});