@alpha-arcade/sdk 0.2.6 → 0.2.8

package/dist/index.d.cts

@@ -46,6 +46,13 @@ type Market = {
     featured?: boolean;
     options?: MarketOption[];
     feeBase?: number;
+    /** Liquidty Rewards Info */
+    totalRewards?: number;
+    rewardsPaidOut?: number;
+    rewardsSpreadDistance?: number;
+    rewardsMinContracts?: number;
+    lastRewardAmount?: number;
+    lastRewardTs?: number;
     /** Data source: 'onchain' or 'api' */
     source?: 'onchain' | 'api';
     [key: string]: unknown;
@@ -452,6 +459,13 @@ declare class AlphaClient {
      * @returns Array of open orders
      */
     getOpenOrders(marketAppId: number, walletAddress?: string): Promise<OpenOrder[]>;
+    /**
+     * Gets all open orders for a wallet across every live market using the Alpha REST API.
+     *
+     * @param walletAddress - The wallet address
+     * @returns Array of open orders for the wallet
+     */
+    getWalletOrdersFromApi(walletAddress: string): Promise<OpenOrder[]>;
     /**
      * Fetches all live, tradeable markets.
      *
@@ -496,6 +510,12 @@ declare class AlphaClient {
      * @returns Array of live markets from the API
      */
     getLiveMarketsFromApi(): Promise<Market[]>;
+    /**
+     * Fetches the reward markets from the Alpha REST API (requires API key).
+     *
+     * @returns Array of reward markets
+     */
+    getRewardMarkets(): Promise<Market[]>;
     /**
      * Fetches a single market by ID from the Alpha REST API (requires API key).
      *
@@ -505,8 +525,6 @@ declare class AlphaClient {
     getMarketFromApi(marketId: string): Promise<Market | null>;
 }
 
-/** The default Alpha Arcade mainnet market creator address */
-declare const DEFAULT_MARKET_CREATOR_ADDRESS = "5P5Y6HTWUNG2E3VXBQDZN3ENZD3JPAIR5PKT3LOYJAPAUKOLFD6KANYTRY";
 /**
  * Fetches all live, tradeable markets directly from the Algorand blockchain.
  *
@@ -548,6 +566,9 @@ declare const getLiveMarketsFromApi: (config: AlphaClientConfig) => Promise<Mark
  */
 declare const getMarketFromApi: (config: AlphaClientConfig, marketId: string) => Promise<Market | null>;
 
+declare const DEFAULT_API_BASE_URL = "https://platform.alphaarcade.com/api";
+declare const DEFAULT_MARKET_CREATOR_ADDRESS = "5P5Y6HTWUNG2E3VXBQDZN3ENZD3JPAIR5PKT3LOYJAPAUKOLFD6KANYTRY";
+
 /**
  * Calculates the required fee amount in microunits.
  *
@@ -626,4 +647,4 @@ declare const getEscrowGlobalState: (indexerClient: algosdk.Indexer, escrowAppId
  */
 declare const checkAssetOptIn: (algodClient: algosdk.Algodv2, address: string, assetId: number) => Promise<boolean>;
 
-export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_MARKET_CREATOR_ADDRESS, type EscrowGlobalState, type Market, type MarketGlobalState, type MarketOption, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookEntry, type OrderbookSide, type Position, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletPosition, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };
+export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, type EscrowGlobalState, type Market, type MarketGlobalState, type MarketOption, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookEntry, type OrderbookSide, type Position, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletPosition, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };

package/dist/index.d.ts

@@ -46,6 +46,13 @@ type Market = {
     featured?: boolean;
     options?: MarketOption[];
     feeBase?: number;
+    /** Liquidty Rewards Info */
+    totalRewards?: number;
+    rewardsPaidOut?: number;
+    rewardsSpreadDistance?: number;
+    rewardsMinContracts?: number;
+    lastRewardAmount?: number;
+    lastRewardTs?: number;
     /** Data source: 'onchain' or 'api' */
     source?: 'onchain' | 'api';
     [key: string]: unknown;
@@ -452,6 +459,13 @@ declare class AlphaClient {
      * @returns Array of open orders
      */
     getOpenOrders(marketAppId: number, walletAddress?: string): Promise<OpenOrder[]>;
+    /**
+     * Gets all open orders for a wallet across every live market using the Alpha REST API.
+     *
+     * @param walletAddress - The wallet address
+     * @returns Array of open orders for the wallet
+     */
+    getWalletOrdersFromApi(walletAddress: string): Promise<OpenOrder[]>;
     /**
      * Fetches all live, tradeable markets.
      *
@@ -496,6 +510,12 @@ declare class AlphaClient {
      * @returns Array of live markets from the API
      */
     getLiveMarketsFromApi(): Promise<Market[]>;
+    /**
+     * Fetches the reward markets from the Alpha REST API (requires API key).
+     *
+     * @returns Array of reward markets
+     */
+    getRewardMarkets(): Promise<Market[]>;
     /**
      * Fetches a single market by ID from the Alpha REST API (requires API key).
      *
@@ -505,8 +525,6 @@ declare class AlphaClient {
     getMarketFromApi(marketId: string): Promise<Market | null>;
 }
 
-/** The default Alpha Arcade mainnet market creator address */
-declare const DEFAULT_MARKET_CREATOR_ADDRESS = "5P5Y6HTWUNG2E3VXBQDZN3ENZD3JPAIR5PKT3LOYJAPAUKOLFD6KANYTRY";
 /**
  * Fetches all live, tradeable markets directly from the Algorand blockchain.
  *
@@ -548,6 +566,9 @@ declare const getLiveMarketsFromApi: (config: AlphaClientConfig) => Promise<Mark
  */
 declare const getMarketFromApi: (config: AlphaClientConfig, marketId: string) => Promise<Market | null>;
 
+declare const DEFAULT_API_BASE_URL = "https://platform.alphaarcade.com/api";
+declare const DEFAULT_MARKET_CREATOR_ADDRESS = "5P5Y6HTWUNG2E3VXBQDZN3ENZD3JPAIR5PKT3LOYJAPAUKOLFD6KANYTRY";
+
 /**
  * Calculates the required fee amount in microunits.
  *
@@ -626,4 +647,4 @@ declare const getEscrowGlobalState: (indexerClient: algosdk.Indexer, escrowAppId
  */
 declare const checkAssetOptIn: (algodClient: algosdk.Algodv2, address: string, assetId: number) => Promise<boolean>;
 
-export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_MARKET_CREATOR_ADDRESS, type EscrowGlobalState, type Market, type MarketGlobalState, type MarketOption, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookEntry, type OrderbookSide, type Position, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletPosition, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };
+export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, type EscrowGlobalState, type Market, type MarketGlobalState, type MarketOption, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookEntry, type OrderbookSide, type Position, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletPosition, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };

package/dist/index.js

@@ -1402,6 +1402,12 @@ var calculateMatchingOrders = (orderbook, isBuying, isYes, quantity, price, slip
   }
   return matches;
 };
+
+// src/constants.ts
+var DEFAULT_API_BASE_URL = "https://platform.alphaarcade.com/api";
+var DEFAULT_MARKET_CREATOR_ADDRESS = "5P5Y6HTWUNG2E3VXBQDZN3ENZD3JPAIR5PKT3LOYJAPAUKOLFD6KANYTRY";
+
+// src/modules/orderbook.ts
 var getAllCreatedApplications = async (indexerClient, address, limit = 100) => {
   let applications = [];
   let nextToken;
@@ -1495,6 +1501,49 @@ var getOpenOrders = async (config, marketAppId, walletAddress) => {
     owner: o.globalState.owner ?? ""
   }));
 };
+var normalizeApiOrder = (raw) => ({
+  escrowAppId: Number(raw.escrowAppId ?? raw.orderId),
+  marketAppId: Number(raw.marketAppId),
+  position: raw.orderPosition ?? 0,
+  side: raw.orderSide === "BUY" ? 1 : 0,
+  price: raw.orderPrice ?? 0,
+  quantity: raw.orderQuantity ?? 0,
+  quantityFilled: raw.orderQuantityFilled ?? 0,
+  slippage: raw.slippage ?? 0,
+  owner: raw.senderWallet ?? ""
+});
+var getWalletOrdersFromApi = async (config, walletAddress) => {
+  if (!config.apiKey) {
+    throw new Error("apiKey is required for API-based market fetching. Retrieve an API key from the Alpha Arcade platform via the Account page and pass it to the client.");
+  }
+  const baseUrl = config.apiBaseUrl ?? DEFAULT_API_BASE_URL;
+  const allOrders = [];
+  let cursor;
+  let hasMore = true;
+  while (hasMore) {
+    const params = new URLSearchParams({ wallet: walletAddress, limit: "300" });
+    if (cursor) {
+      params.set("cursor", cursor);
+    }
+    const url = `${baseUrl}/get-wallet-orders?${params.toString()}`;
+    const response = await fetch(url, { headers: { "x-api-key": config.apiKey } });
+    if (!response.ok) {
+      throw new Error(`Alpha API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (Array.isArray(data)) {
+      allOrders.push(...data.map(normalizeApiOrder));
+      hasMore = false;
+    } else if (data.orders) {
+      allOrders.push(...data.orders.map(normalizeApiOrder));
+      cursor = data.nextCursor ?? void 0;
+      hasMore = data.hasMore === true && !!cursor;
+    } else {
+      hasMore = false;
+    }
+  }
+  return allOrders;
+};
 
 // src/modules/trading.ts
 var extractEscrowAppId = async (algodClient, indexerClient, targetTxId) => {
@@ -1956,8 +2005,6 @@ var getPositions = async (config, walletAddress) => {
 };
 
 // src/modules/markets.ts
-var DEFAULT_API_BASE_URL = "https://partners.alphaarcade.com/api";
-var DEFAULT_MARKET_CREATOR_ADDRESS = "5P5Y6HTWUNG2E3VXBQDZN3ENZD3JPAIR5PKT3LOYJAPAUKOLFD6KANYTRY";
 var toSeconds = (ts) => ts > 1e10 ? Math.floor(ts / 1e3) : ts;
 var groupMultiChoiceMarkets = (flatMarkets) => {
   const parentMap = /* @__PURE__ */ new Map();
@@ -2071,7 +2118,7 @@ var getMarketOnChain = async (config, marketAppId) => {
 };
 var getLiveMarketsFromApi = async (config) => {
   if (!config.apiKey) {
-    throw new Error("apiKey is required for API-based market fetching. Use getMarketsOnChain() instead, or pass an apiKey.");
+    throw new Error("apiKey is required for API-based market fetching. Use getMarketsOnChain() instead, or retrieve an API key from the Alpha Arcade platform via the Account page and pass it to the client.");
   }
   const baseUrl = config.apiBaseUrl ?? DEFAULT_API_BASE_URL;
   const allMarkets = [];
@@ -2108,7 +2155,7 @@ var getLiveMarketsFromApi = async (config) => {
 };
 var getMarketFromApi = async (config, marketId) => {
   if (!config.apiKey) {
-    throw new Error("apiKey is required for API-based market fetching. Use getMarketOnChain() instead, or pass an apiKey.");
+    throw new Error("apiKey is required for API-based market fetching. Use getMarketOnChain() instead, or retrieve an API key from the Alpha Arcade platform via the Account page and pass it to the client.");
   }
   const baseUrl = config.apiBaseUrl ?? DEFAULT_API_BASE_URL;
   const url = `${baseUrl}/get-market?marketId=${encodeURIComponent(marketId)}`;
@@ -2125,6 +2172,13 @@ var getMarketFromApi = async (config, marketId) => {
   }
   return market;
 };
+var getRewardMarkets = async (config) => {
+  if (!config.apiKey) {
+    throw new Error("apiKey is required for API-based market fetching. Retrieve an API key from the Alpha Arcade platform via the Account page and pass it to the client.");
+  }
+  const markets = await getLiveMarketsFromApi(config);
+  return markets.filter((m) => m.totalRewards && m.totalRewards > 0);
+};
 var getLiveMarkets = async (config) => {
   if (config.apiKey) {
     return getLiveMarketsFromApi(config);
@@ -2150,7 +2204,7 @@ var AlphaClient = class {
     if (!config.usdcAssetId) throw new Error("usdcAssetId is required");
     this.config = {
       ...config,
-      apiBaseUrl: config.apiBaseUrl ?? "https://partners.alphaarcade.com/api"
+      apiBaseUrl: config.apiBaseUrl ?? DEFAULT_API_BASE_URL
     };
   }
   // ============================================
@@ -2282,6 +2336,15 @@ var AlphaClient = class {
   async getOpenOrders(marketAppId, walletAddress) {
     return getOpenOrders(this.config, marketAppId, walletAddress);
   }
+  /**
+   * Gets all open orders for a wallet across every live market using the Alpha REST API.
+   *
+   * @param walletAddress - The wallet address
+   * @returns Array of open orders for the wallet
+   */
+  async getWalletOrdersFromApi(walletAddress) {
+    return getWalletOrdersFromApi(this.config, walletAddress);
+  }
   // ============================================
   // Markets
   // ============================================
@@ -2339,6 +2402,14 @@ var AlphaClient = class {
   async getLiveMarketsFromApi() {
     return getLiveMarketsFromApi(this.config);
   }
+  /**
+   * Fetches the reward markets from the Alpha REST API (requires API key).
+   *
+   * @returns Array of reward markets
+   */
+  async getRewardMarkets() {
+    return getRewardMarkets(this.config);
+  }
   /**
    * Fetches a single market by ID from the Alpha REST API (requires API key).
    *
@@ -2350,6 +2421,6 @@ var AlphaClient = class {
   }
 };
 
-export { AlphaClient, DEFAULT_MARKET_CREATOR_ADDRESS, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };
+export { AlphaClient, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map