@alpha-arcade/sdk 0.2.5 → 0.2.7

package/dist/index.d.cts

@@ -158,13 +158,10 @@ type CreateOrderResult = {
     txIds: string[];
     /** Confirmed round number */
     confirmedRound: number;
-};
-/** Result of creating a market order (includes match info) */
-type CreateMarketOrderResult = CreateOrderResult & {
     /** Total quantity that was matched */
-    matchedQuantity: number;
+    matchedQuantity?: number;
     /** Weighted average fill price in microunits (accounts for complementary matching) */
-    matchedPrice: number;
+    matchedPrice?: number;
 };
 /** Result of cancelling an order */
 type CancelOrderResult = {
@@ -375,7 +372,7 @@ declare class AlphaClient {
      * @param params - Order parameters (marketAppId, position, price, quantity, isBuying, slippage)
      * @returns The created escrow app ID, matched quantity, and transaction info
      */
-    createMarketOrder(params: CreateMarketOrderParams): Promise<CreateMarketOrderResult>;
+    createMarketOrder(params: CreateMarketOrderParams): Promise<CreateOrderResult>;
     /**
      * Cancels an open order by deleting its escrow app.
      *
@@ -455,6 +452,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.
      *
@@ -508,8 +512,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.
  *
@@ -551,6 +553,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://partners.alphaarcade.com/api";
+declare const DEFAULT_MARKET_CREATOR_ADDRESS = "5P5Y6HTWUNG2E3VXBQDZN3ENZD3JPAIR5PKT3LOYJAPAUKOLFD6KANYTRY";
+
 /**
  * Calculates the required fee amount in microunits.
  *
@@ -629,4 +634,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 CreateMarketOrderResult, 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

@@ -158,13 +158,10 @@ type CreateOrderResult = {
     txIds: string[];
     /** Confirmed round number */
     confirmedRound: number;
-};
-/** Result of creating a market order (includes match info) */
-type CreateMarketOrderResult = CreateOrderResult & {
     /** Total quantity that was matched */
-    matchedQuantity: number;
+    matchedQuantity?: number;
     /** Weighted average fill price in microunits (accounts for complementary matching) */
-    matchedPrice: number;
+    matchedPrice?: number;
 };
 /** Result of cancelling an order */
 type CancelOrderResult = {
@@ -375,7 +372,7 @@ declare class AlphaClient {
      * @param params - Order parameters (marketAppId, position, price, quantity, isBuying, slippage)
      * @returns The created escrow app ID, matched quantity, and transaction info
      */
-    createMarketOrder(params: CreateMarketOrderParams): Promise<CreateMarketOrderResult>;
+    createMarketOrder(params: CreateMarketOrderParams): Promise<CreateOrderResult>;
     /**
      * Cancels an open order by deleting its escrow app.
      *
@@ -455,6 +452,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.
      *
@@ -508,8 +512,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.
  *
@@ -551,6 +553,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://partners.alphaarcade.com/api";
+declare const DEFAULT_MARKET_CREATOR_ADDRESS = "5P5Y6HTWUNG2E3VXBQDZN3ENZD3JPAIR5PKT3LOYJAPAUKOLFD6KANYTRY";
+
 /**
  * Calculates the required fee amount in microunits.
  *
@@ -629,4 +634,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 CreateMarketOrderResult, 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://partners.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.");
+  }
+  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) => {
@@ -1519,7 +1568,21 @@ var extractEscrowAppId = async (algodClient, indexerClient, targetTxId) => {
   return 0;
 };
 var createLimitOrder = async (config, params) => {
-  return createOrder(config, { ...params, slippage: 0, matchingOrders: [] });
+  const orderbook = await getOrderbook(config, params.marketAppId);
+  const matchingOrders = calculateMatchingOrders(
+    orderbook,
+    params.isBuying,
+    params.position === 1,
+    params.quantity,
+    params.price,
+    0
+  );
+  const totalMatchedQuantity = matchingOrders.reduce((sum, o) => sum + o.quantity, 0);
+  const matchedPrice = totalMatchedQuantity > 0 ? Math.round(
+    matchingOrders.reduce((sum, o) => sum + (o.price ?? params.price) * o.quantity, 0) / totalMatchedQuantity
+  ) : params.price;
+  const result = await createOrder(config, { ...params, slippage: 0, matchingOrders });
+  return { ...result, matchedQuantity: totalMatchedQuantity, matchedPrice };
 };
 var createMarketOrder = async (config, params) => {
   let matchingOrders = params.matchingOrders;
@@ -1942,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();
@@ -2136,7 +2197,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
     };
   }
   // ============================================
@@ -2268,6 +2329,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
   // ============================================
@@ -2336,6 +2406,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