@alpha-arcade/sdk 0.2.4 → 0.2.6

package/README.md

@@ -37,7 +37,7 @@ const client = new AlphaClient({
 });
 
 // 4. Fetch live markets (reads directly from chain)
-const markets = await client.getMarkets();
+const markets = await client.getLiveMarkets();
 console.log(`Found ${markets.length} live markets`);
 
 // 5. Place a limit buy order on the first market
@@ -71,7 +71,7 @@ new AlphaClient(config: AlphaClientConfig)
 | `activeAddress` | `string` | Yes | Your Algorand address |
 | `matcherAppId` | `number` | Yes | Matcher contract app ID (mainnet: `3078581851`) |
 | `usdcAssetId` | `number` | Yes | USDC ASA ID (mainnet: `31566704`) |
-| `apiKey` | `string` | No | Alpha partners API key. If provided, `getMarkets()` uses the API for richer data (images, categories, volume). If omitted, markets are discovered on-chain. |
+| `apiKey` | `string` | No | Alpha partners API key. If provided, `getLiveMarkets()` uses the API for richer data (images, categories, volume). If omitted, markets are discovered on-chain. |
 | `apiBaseUrl` | `string` | No | API base URL (default: `https://partners.alphaarcade.com/api`) |
 | `marketCreatorAddress` | `string` | No | Market creator address for on-chain discovery (defaults to Alpha Arcade mainnet) |
 
@@ -91,7 +91,7 @@ const result = await client.createLimitOrder({
   quantity: 2_000_000,  // 2 shares in microunits
   isBuying: true,
 });
-// result: { escrowAppId, txIds, confirmedRound }
+// result: { escrowAppId, txIds, confirmedRound, matchedQuantity?, matchedPrice? }
 ```
 
 #### `createMarketOrder(params)`
@@ -107,7 +107,7 @@ const result = await client.createMarketOrder({
   isBuying: true,
   slippage: 50_000,     // $0.05 slippage tolerance
 });
-// result: { escrowAppId, matchedQuantity, txIds, confirmedRound }
+// result: { escrowAppId, txIds, confirmedRound, matchedQuantity, matchedPrice }
 ```
 
 #### `cancelOrder(params)`
@@ -228,12 +228,12 @@ for (const order of orders) {
 
 Markets can be loaded **on-chain** (default, no API key) or via the **REST API** (richer data, requires API key).
 
-#### `getMarkets()` / `getMarket(marketId)`
+#### `getLiveMarkets()` / `getMarket(marketId)`
 
 Smart defaults — uses the API if `apiKey` is set, otherwise reads from chain.
 
 ```typescript
-const markets = await client.getMarkets();
+const markets = await client.getLiveMarkets();
 for (const m of markets) {
   console.log(`${m.title} — App ID: ${m.marketAppId}, source: ${m.source}`);
 }
@@ -250,12 +250,12 @@ const markets = await client.getMarketsOnChain();
 const market = await client.getMarketOnChain(3012345678);
 ```
 
-#### `getMarketsFromApi()` / `getMarketFromApi(marketId)`
+#### `getLiveMarketsFromApi()` / `getMarketFromApi(marketId)`
 
 Always uses the REST API. Requires `apiKey`. Returns richer data: images, categories, volume, probabilities.
 
 ```typescript
-const markets = await client.getMarketsFromApi();
+const markets = await client.getLiveMarketsFromApi();
 const market = await client.getMarketFromApi('uuid-here');
 ```
 
@@ -312,7 +312,7 @@ const setup = () => {
 
 const run = async () => {
   const client = setup();
-  const markets = await client.getMarkets(); // Loads from chain, no API key needed
+  const markets = await client.getLiveMarkets(); // Loads from chain, no API key needed
 
   for (const market of markets) {
     const book = await client.getOrderbook(market.marketAppId);

package/dist/index.cjs

@@ -1544,7 +1544,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;
@@ -2080,7 +2094,7 @@ var getMarketOnChain = async (config, marketAppId) => {
     return null;
   }
 };
-var getMarketsFromApi = async (config) => {
+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.");
   }
@@ -2093,7 +2107,7 @@ var getMarketsFromApi = async (config) => {
     if (lastEvaluatedKey) {
       params.set("lastEvaluatedKey", lastEvaluatedKey);
     }
-    const url = `${baseUrl}/get-live-markets?${params.toString()}`;
+    const url = `${baseUrl}/get-live-markets-cached?${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}`);
@@ -2136,9 +2150,9 @@ var getMarketFromApi = async (config, marketId) => {
   }
   return market;
 };
-var getMarkets = async (config) => {
+var getLiveMarkets = async (config) => {
   if (config.apiKey) {
-    return getMarketsFromApi(config);
+    return getLiveMarketsFromApi(config);
   }
   return getMarketsOnChain(config);
 };
@@ -2304,8 +2318,8 @@ var AlphaClient = class {
    *
    * @returns Array of live markets
    */
-  async getMarkets() {
-    return getMarkets(this.config);
+  async getLiveMarkets() {
+    return getLiveMarkets(this.config);
   }
   /**
    * Fetches a single market by its ID.
@@ -2347,8 +2361,8 @@ var AlphaClient = class {
    *
    * @returns Array of live markets from the API
    */
-  async getMarketsFromApi() {
-    return getMarketsFromApi(this.config);
+  async getLiveMarketsFromApi() {
+    return getLiveMarketsFromApi(this.config);
   }
   /**
    * Fetches a single market by ID from the Alpha REST API (requires API key).
@@ -2369,10 +2383,10 @@ exports.calculateMatchingOrders = calculateMatchingOrders;
 exports.checkAssetOptIn = checkAssetOptIn;
 exports.decodeGlobalState = decodeGlobalState;
 exports.getEscrowGlobalState = getEscrowGlobalState;
+exports.getLiveMarketsFromApi = getLiveMarketsFromApi;
 exports.getMarketFromApi = getMarketFromApi;
 exports.getMarketGlobalState = getMarketGlobalState;
 exports.getMarketOnChain = getMarketOnChain;
-exports.getMarketsFromApi = getMarketsFromApi;
 exports.getMarketsOnChain = getMarketsOnChain;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map