@eluvio/elv-client-js 3.2.11 → 3.2.12

package/dist/src/walletClient/ClientMethods.js

@@ -295,7 +295,7 @@ exports.UserItemInfo = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regenerator
  * @param {string=} contractAddress - Filter results by the address of the NFT contract
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  *
  * @returns {Promise<Object>} - Results of the query and pagination info
  */
@@ -1072,7 +1072,7 @@ exports.Listing = /*#__PURE__*/function () {
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the item name.
  * You can retrieve all available item names from the <a href="#.ListingNames">ListingNames method</a>.
- *  @param {string=} editionFilter - Filter results by item edition.
+ *  @param {Array<string>=} editionFilters - Filter results by item edition.
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the edition name.
  * You can retrieve all available item edition names from the <a href="#.ListingEditionNames">ListingEditionNames method</a>.
@@ -1080,12 +1080,13 @@ exports.Listing = /*#__PURE__*/function () {
  *  <br /><br />
  *  NOTE: These filters must be an <b>exact match</b> on the attribute name and value.
  * You can retrieve all available item attributes from the <a href="#.ListingAttributes">ListingAttributes method</a>.
+ * @param {Object=} priceRange - Filter min and/or max price (e.g. `{min: 1}` `{max: 2}` `{min: 1.50, max: 10.50})
  * @param {string=} sellerAddress - Filter by a specific seller
  * @param {string=} contractAddress - Filter results by the address of the NFT contract
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {string=} currency - Filter results by purchase currency. Available options: `usdc`
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  * @param {integer=} lastNDays - Filter by results listed in the past N days
  *
  * @returns {Promise<Object>} - Results of the query and pagination info
@@ -1122,7 +1123,7 @@ exports.Listings = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRunt
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the item name.
  * You can retrieve all available item names from the <a href="#.ListingNames">ListingNames method</a>.
- *  @param {string=} editionFilter - Filter results by item edition.
+ *  @param {Array<string>} editionFilters - Filter results by item edition.
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the edition name.
  * You can retrieve all available item edition names from the <a href="#.ListingEditionNames">ListingEditionNames method</a>.
@@ -1130,12 +1131,13 @@ exports.Listings = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRunt
  *  <br /><br />
  *  NOTE: These filters must be an <b>exact match</b> on the attribute name and value.
  * You can retrieve all available item attributes from the <a href="#.ListingAttributes">ListingAttributes method</a>.
+ * @param {Object=} priceRange - Filter min and/or max price (e.g. `{min: 1}` `{max: 2}` `{min: 1.50, max: 10.50})
  * @param {string=} sellerAddress - Filter by a specific seller
  * @param {string=} contractAddress - Filter results by the address of the NFT contract
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {string=} currency - Filter results by purchase currency. Available options: `usdc`
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  * @param {integer=} lastNDays - Filter by results listed in the past N days
  *
  * @returns {Promise<Object>} - Statistics about listings. All prices in USD.
@@ -1171,7 +1173,7 @@ exports.ListingStats = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regenerator
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the item name.
  * You can retrieve all available item names from the <a href="#.ListingNames">ListingNames method</a>.
- *  @param {string=} editionFilter - Filter results by item edition.
+ *  @param {Array<string>} editionFilters - Filter results by item edition.
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the edition name.
  * You can retrieve all available item edition names from the <a href="#.ListingEditionNames">ListingEditionNames method</a>.
@@ -1184,7 +1186,7 @@ exports.ListingStats = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regenerator
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {string=} currency - Filter results by purchase currency. Available options: `usdc`
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  * @param {integer=} lastNDays - Filter by results listed in the past N days
  *
  * @returns {Promise<Object>} - Results of the query and pagination info
@@ -1220,7 +1222,7 @@ exports.Sales = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the item name.
  * You can retrieve all available item names from the <a href="#.ListingNames">ListingNames method</a>.
- *  @param {string=} editionFilter - Filter results by item edition.
+ *  @param {Array<string>} editionFilters - Filter results by item edition.
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the edition name.
  * You can retrieve all available item edition names from the <a href="#.ListingEditionNames">ListingEditionNames method</a>.
@@ -1233,7 +1235,7 @@ exports.Sales = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {string=} currency - Filter results by purchase currency. Available options: `usdc`
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  * @param {integer=} lastNDays - Filter by results listed in the past N days
  *
  * @returns {Promise<Object>} - Results of the query and pagination info
@@ -1269,7 +1271,7 @@ exports.Transfers = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRun
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the item name.
  * You can retrieve all available item names from the <a href="#.ListingNames">ListingNames method</a>.
- *  @param {string=} editionFilter - Filter results by item edition.
+ *  @param {Array<string>} editionFilters - Filter results by item edition.
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the edition name.
  * You can retrieve all available item edition names from the <a href="#.ListingEditionNames">ListingEditionNames method</a>.
@@ -1282,7 +1284,7 @@ exports.Transfers = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRun
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {string=} currency - Filter results by purchase currency. Available options: `usdc`
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  * @param {integer=} lastNDays - Filter by results listed in the past N days
  *
  * @returns {Promise<Object>} - Statistics about sales. All prices in USD.

package/dist/src/walletClient/index.js

@@ -1241,15 +1241,17 @@ var ElvWalletClient = /*#__PURE__*/function () {
             _ref14$sortDesc,
             sortDesc,
             filter,
-            editionFilter,
+            editionFilters,
             attributeFilters,
             contractAddress,
             tokenId,
             currency,
             marketplaceParams,
             tenantId,
-            _ref14$collectionInde,
-            collectionIndex,
+            collectionIndexes,
+            priceRange,
+            tokenIdRange,
+            capLimit,
             sellerAddress,
             _ref14$lastNDays,
             lastNDays,
@@ -1261,7 +1263,6 @@ var ElvWalletClient = /*#__PURE__*/function () {
             marketplaceInfo,
             marketplace,
             filters,
-            collection,
             path,
             _ref16,
             contents,
@@ -1272,8 +1273,10 @@ var ElvWalletClient = /*#__PURE__*/function () {
           while (1) {
             switch (_context16.prev = _context16.next) {
               case 0:
-                _ref14 = _args16.length > 0 && _args16[0] !== undefined ? _args16[0] : {}, _ref14$mode = _ref14.mode, mode = _ref14$mode === void 0 ? "listings" : _ref14$mode, _ref14$sortBy = _ref14.sortBy, sortBy = _ref14$sortBy === void 0 ? "created" : _ref14$sortBy, _ref14$sortDesc = _ref14.sortDesc, sortDesc = _ref14$sortDesc === void 0 ? false : _ref14$sortDesc, filter = _ref14.filter, editionFilter = _ref14.editionFilter, attributeFilters = _ref14.attributeFilters, contractAddress = _ref14.contractAddress, tokenId = _ref14.tokenId, currency = _ref14.currency, marketplaceParams = _ref14.marketplaceParams, tenantId = _ref14.tenantId, _ref14$collectionInde = _ref14.collectionIndex, collectionIndex = _ref14$collectionInde === void 0 ? -1 : _ref14$collectionInde, sellerAddress = _ref14.sellerAddress, _ref14$lastNDays = _ref14.lastNDays, lastNDays = _ref14$lastNDays === void 0 ? -1 : _ref14$lastNDays, _ref14$start = _ref14.start, start = _ref14$start === void 0 ? 0 : _ref14$start, _ref14$limit = _ref14.limit, limit = _ref14$limit === void 0 ? 50 : _ref14$limit;
-                collectionIndex = parseInt(collectionIndex);
+                _ref14 = _args16.length > 0 && _args16[0] !== undefined ? _args16[0] : {}, _ref14$mode = _ref14.mode, mode = _ref14$mode === void 0 ? "listings" : _ref14$mode, _ref14$sortBy = _ref14.sortBy, sortBy = _ref14$sortBy === void 0 ? "created" : _ref14$sortBy, _ref14$sortDesc = _ref14.sortDesc, sortDesc = _ref14$sortDesc === void 0 ? false : _ref14$sortDesc, filter = _ref14.filter, editionFilters = _ref14.editionFilters, attributeFilters = _ref14.attributeFilters, contractAddress = _ref14.contractAddress, tokenId = _ref14.tokenId, currency = _ref14.currency, marketplaceParams = _ref14.marketplaceParams, tenantId = _ref14.tenantId, collectionIndexes = _ref14.collectionIndexes, priceRange = _ref14.priceRange, tokenIdRange = _ref14.tokenIdRange, capLimit = _ref14.capLimit, sellerAddress = _ref14.sellerAddress, _ref14$lastNDays = _ref14.lastNDays, lastNDays = _ref14$lastNDays === void 0 ? -1 : _ref14$lastNDays, _ref14$start = _ref14.start, start = _ref14$start === void 0 ? 0 : _ref14$start, _ref14$limit = _ref14.limit, limit = _ref14$limit === void 0 ? 50 : _ref14$limit;
+                collectionIndexes = (collectionIndexes || []).map(function (i) {
+                  return parseInt(i);
+                });
                 params = {
                   sort_by: sortBy,
                   sort_descending: sortDesc,
@@ -1294,7 +1297,7 @@ var ElvWalletClient = /*#__PURE__*/function () {
               case 6:
                 marketplaceInfo = _context16.sent;
 
-                if (!(collectionIndex >= 0)) {
+                if (!(collectionIndexes.length > 0)) {
                   _context16.next = 11;
                   break;
                 }
@@ -1315,65 +1318,33 @@ var ElvWalletClient = /*#__PURE__*/function () {
                   filters.push("seller:eq:".concat(this.client.utils.FormatAddress(sellerAddress)));
                 }
 
-                if (!(marketplace && collectionIndex >= 0)) {
-                  _context16.next = 25;
-                  break;
-                }
-
-                collection = marketplace.collections[collectionIndex];
-                collection.items.forEach(function (sku) {
-                  if (!sku) {
-                    return;
-                  }
-
-                  var item = marketplace.items.find(function (item) {
-                    return item.sku === sku;
-                  });
-
-                  if (!item) {
-                    return;
-                  }
-
-                  var address = Utils.SafeTraverse(item, "nft_template", "nft", "address");
-
-                  if (address) {
-                    filters.push("".concat(mode === "owned" ? "contract_addr" : "contract", ":eq:").concat(Utils.FormatAddress(address)));
-                  }
-                }); // No valid items, so there must not be anything relevant in the collection
-
-                if (!(filters.length === 0)) {
-                  _context16.next = 23;
-                  break;
-                }
-
-                if (!mode.includes("stats")) {
-                  _context16.next = 22;
-                  break;
-                }
+                if (marketplace && collectionIndexes.length >= 0) {
+                  collectionIndexes.forEach(function (collectionIndex) {
+                    var collection = marketplace.collections[collectionIndex];
+                    collection.items.forEach(function (sku) {
+                      if (!sku) {
+                        return;
+                      }
 
-                return _context16.abrupt("return", {});
+                      var item = marketplace.items.find(function (item) {
+                        return item.sku === sku;
+                      });
 
-              case 22:
-                return _context16.abrupt("return", {
-                  paging: {
-                    start: params.start,
-                    limit: params.limit,
-                    total: 0,
-                    more: false
-                  },
-                  results: []
-                });
+                      if (!item) {
+                        return;
+                      }
 
-              case 23:
-                _context16.next = 26;
-                break;
+                      var address = Utils.SafeTraverse(item, "nft_template", "nft", "address");
 
-              case 25:
-                if (mode !== "owned" && marketplaceInfo || tenantId) {
+                      if (address) {
+                        filters.push("".concat(mode === "owned" ? "contract_addr" : "contract", ":eq:").concat(Utils.FormatAddress(address)));
+                      }
+                    });
+                  });
+                } else if (mode !== "owned" && marketplaceInfo || tenantId) {
                   filters.push("tenant:eq:".concat(marketplaceInfo ? marketplaceInfo.tenantId : tenantId));
                 }
 
-              case 26:
                 if (contractAddress) {
                   if (mode === "owned") {
                     filters.push("contract_addr:eq:".concat(Utils.FormatAddress(contractAddress)));
@@ -1395,15 +1366,17 @@ var ElvWalletClient = /*#__PURE__*/function () {
                   }
                 }
 
-                if (editionFilter) {
-                  if (mode.includes("listing")) {
-                    filters.push("nft/edition_name:eq:".concat(editionFilter));
-                  } else if (mode === "owned") {
-                    filters.push("meta:@>:{\"edition_name\":\"".concat(editionFilter, "\"}"));
-                    params.exact = false;
-                  } else {
-                    filters.push("edition:eq:".concat(editionFilter));
-                  }
+                if (editionFilters) {
+                  editionFilters.forEach(function (editionFilter) {
+                    if (mode.includes("listing")) {
+                      filters.push("nft/edition_name:eq:".concat(editionFilter));
+                    } else if (mode === "owned") {
+                      filters.push("meta:@>:{\"edition_name\":\"".concat(editionFilter, "\"}"));
+                      params.exact = false;
+                    } else {
+                      filters.push("edition:eq:".concat(editionFilter));
+                    }
+                  });
                 }
 
                 if (attributeFilters) {
@@ -1427,65 +1400,89 @@ var ElvWalletClient = /*#__PURE__*/function () {
                   filters.push("created:gt:".concat((Date.now() / 1000 - lastNDays * 24 * 60 * 60).toFixed(0)));
                 }
 
+                if (priceRange) {
+                  if (priceRange.min) {
+                    filters.push("price:gt:".concat(parseFloat(priceRange.min) - 0.01));
+                  }
+
+                  if (priceRange.max) {
+                    filters.push("price:lt:".concat(parseFloat(priceRange.max) + 0.01));
+                  }
+                }
+
+                if (tokenIdRange) {
+                  if (tokenIdRange.min) {
+                    filters.push("info/ordinal:gt:".concat(parseInt(tokenIdRange.min) - 1));
+                  }
+
+                  if (tokenIdRange.max) {
+                    filters.push("info/ordinal:lt:".concat(parseInt(tokenIdRange.max) + 1));
+                  }
+                }
+
+                if (capLimit) {
+                  filters.push("info/cap:lt:".concat(parseInt(capLimit) + 1));
+                }
+
                 _context16.t0 = mode;
-                _context16.next = _context16.t0 === "owned" ? 34 : _context16.t0 === "listings" ? 37 : _context16.t0 === "transfers" ? 39 : _context16.t0 === "sales" ? 43 : _context16.t0 === "listing-stats" ? 46 : _context16.t0 === "sales-stats" ? 48 : 50;
+                _context16.next = _context16.t0 === "owned" ? 26 : _context16.t0 === "listings" ? 29 : _context16.t0 === "transfers" ? 31 : _context16.t0 === "sales" ? 35 : _context16.t0 === "listing-stats" ? 38 : _context16.t0 === "sales-stats" ? 40 : 42;
                 break;
 
-              case 34:
+              case 26:
                 path = UrlJoin("as", "wlt", "nfts");
 
                 if (marketplaceInfo) {
                   path = UrlJoin("as", "wlt", "nfts", marketplaceInfo.tenantId);
                 }
 
-                return _context16.abrupt("break", 50);
+                return _context16.abrupt("break", 42);
 
-              case 37:
+              case 29:
                 path = UrlJoin("as", "mkt", "f");
-                return _context16.abrupt("break", 50);
+                return _context16.abrupt("break", 42);
 
-              case 39:
+              case 31:
                 path = UrlJoin("as", "mkt", "hst", "f");
                 filters.push("action:eq:TRANSFERRED");
                 filters.push("action:eq:SOLD");
-                return _context16.abrupt("break", 50);
+                return _context16.abrupt("break", 42);
 
-              case 43:
+              case 35:
                 path = UrlJoin("as", "mkt", "hst", "f");
                 filters.push("action:eq:SOLD");
-                return _context16.abrupt("break", 50);
+                return _context16.abrupt("break", 42);
 
-              case 46:
+              case 38:
                 path = UrlJoin("as", "mkt", "stats", "listed");
-                return _context16.abrupt("break", 50);
+                return _context16.abrupt("break", 42);
 
-              case 48:
+              case 40:
                 path = UrlJoin("as", "mkt", "stats", "sold");
-                return _context16.abrupt("break", 50);
+                return _context16.abrupt("break", 42);
 
-              case 50:
+              case 42:
                 if (filters.length > 0) {
                   params.filter = filters;
                 }
 
                 if (!mode.includes("stats")) {
-                  _context16.next = 55;
+                  _context16.next = 47;
                   break;
                 }
 
-                _context16.next = 54;
+                _context16.next = 46;
                 return Utils.ResponseToJson(this.client.authClient.MakeAuthServiceRequest({
                   path: path,
                   method: "GET",
                   queryParams: params
                 }));
 
-              case 54:
+              case 46:
                 return _context16.abrupt("return", _context16.sent);
 
-              case 55:
+              case 47:
                 _context16.t2 = Utils;
-                _context16.next = 58;
+                _context16.next = 50;
                 return this.client.authClient.MakeAuthServiceRequest({
                   path: path,
                   method: "GET",
@@ -1495,22 +1492,22 @@ var ElvWalletClient = /*#__PURE__*/function () {
                   } : {}
                 });
 
-              case 58:
+              case 50:
                 _context16.t3 = _context16.sent;
-                _context16.next = 61;
+                _context16.next = 53;
                 return _context16.t2.ResponseToJson.call(_context16.t2, _context16.t3);
 
-              case 61:
+              case 53:
                 _context16.t1 = _context16.sent;
 
                 if (_context16.t1) {
-                  _context16.next = 64;
+                  _context16.next = 56;
                   break;
                 }
 
                 _context16.t1 = [];
 
-              case 64:
+              case 56:
                 _ref16 = _context16.t1;
                 contents = _ref16.contents;
                 paging = _ref16.paging;
@@ -1526,12 +1523,12 @@ var ElvWalletClient = /*#__PURE__*/function () {
                   })
                 });
 
-              case 70:
-                _context16.prev = 70;
+              case 62:
+                _context16.prev = 62;
                 _context16.t4 = _context16["catch"](11);
 
                 if (!(_context16.t4.status && _context16.t4.status.toString() === "404")) {
-                  _context16.next = 74;
+                  _context16.next = 66;
                   break;
                 }
 
@@ -1545,15 +1542,15 @@ var ElvWalletClient = /*#__PURE__*/function () {
                   results: []
                 });
 
-              case 74:
+              case 66:
                 throw _context16.t4;
 
-              case 75:
+              case 67:
               case "end":
                 return _context16.stop();
             }
           }
-        }, _callee16, this, [[11, 70]]);
+        }, _callee16, this, [[11, 62]]);
       }));
 
       function FilteredQuery() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eluvio/elv-client-js",
-  "version": "3.2.11",
+  "version": "3.2.12",
   "description": "Javascript client for the Eluvio Content Fabric",
   "main": "src/index.js",
   "author": "Kevin Talmadge",

package/src/walletClient/ClientMethods.js

@@ -195,7 +195,7 @@ exports.UserItemInfo = async function ({userAddress}={}) {
  * @param {string=} contractAddress - Filter results by the address of the NFT contract
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  *
  * @returns {Promise<Object>} - Results of the query and pagination info
  */
@@ -604,7 +604,7 @@ exports.Listing = async function({listingId}) {
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the item name.
  * You can retrieve all available item names from the <a href="#.ListingNames">ListingNames method</a>.
- *  @param {string=} editionFilter - Filter results by item edition.
+ *  @param {Array<string>=} editionFilters - Filter results by item edition.
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the edition name.
  * You can retrieve all available item edition names from the <a href="#.ListingEditionNames">ListingEditionNames method</a>.
@@ -612,12 +612,13 @@ exports.Listing = async function({listingId}) {
  *  <br /><br />
  *  NOTE: These filters must be an <b>exact match</b> on the attribute name and value.
  * You can retrieve all available item attributes from the <a href="#.ListingAttributes">ListingAttributes method</a>.
+ * @param {Object=} priceRange - Filter min and/or max price (e.g. `{min: 1}` `{max: 2}` `{min: 1.50, max: 10.50})
  * @param {string=} sellerAddress - Filter by a specific seller
  * @param {string=} contractAddress - Filter results by the address of the NFT contract
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {string=} currency - Filter results by purchase currency. Available options: `usdc`
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  * @param {integer=} lastNDays - Filter by results listed in the past N days
  *
  * @returns {Promise<Object>} - Results of the query and pagination info
@@ -639,7 +640,7 @@ exports.Listings = async function() {
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the item name.
  * You can retrieve all available item names from the <a href="#.ListingNames">ListingNames method</a>.
- *  @param {string=} editionFilter - Filter results by item edition.
+ *  @param {Array<string>} editionFilters - Filter results by item edition.
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the edition name.
  * You can retrieve all available item edition names from the <a href="#.ListingEditionNames">ListingEditionNames method</a>.
@@ -647,12 +648,13 @@ exports.Listings = async function() {
  *  <br /><br />
  *  NOTE: These filters must be an <b>exact match</b> on the attribute name and value.
  * You can retrieve all available item attributes from the <a href="#.ListingAttributes">ListingAttributes method</a>.
+ * @param {Object=} priceRange - Filter min and/or max price (e.g. `{min: 1}` `{max: 2}` `{min: 1.50, max: 10.50})
  * @param {string=} sellerAddress - Filter by a specific seller
  * @param {string=} contractAddress - Filter results by the address of the NFT contract
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {string=} currency - Filter results by purchase currency. Available options: `usdc`
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  * @param {integer=} lastNDays - Filter by results listed in the past N days
  *
  * @returns {Promise<Object>} - Statistics about listings. All prices in USD.
@@ -674,7 +676,7 @@ exports.ListingStats = async function() {
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the item name.
  * You can retrieve all available item names from the <a href="#.ListingNames">ListingNames method</a>.
- *  @param {string=} editionFilter - Filter results by item edition.
+ *  @param {Array<string>} editionFilters - Filter results by item edition.
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the edition name.
  * You can retrieve all available item edition names from the <a href="#.ListingEditionNames">ListingEditionNames method</a>.
@@ -687,7 +689,7 @@ exports.ListingStats = async function() {
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {string=} currency - Filter results by purchase currency. Available options: `usdc`
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  * @param {integer=} lastNDays - Filter by results listed in the past N days
  *
  * @returns {Promise<Object>} - Results of the query and pagination info
@@ -709,7 +711,7 @@ exports.Sales = async function() {
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the item name.
  * You can retrieve all available item names from the <a href="#.ListingNames">ListingNames method</a>.
- *  @param {string=} editionFilter - Filter results by item edition.
+ *  @param {Array<string>} editionFilters - Filter results by item edition.
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the edition name.
  * You can retrieve all available item edition names from the <a href="#.ListingEditionNames">ListingEditionNames method</a>.
@@ -722,7 +724,7 @@ exports.Sales = async function() {
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {string=} currency - Filter results by purchase currency. Available options: `usdc`
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  * @param {integer=} lastNDays - Filter by results listed in the past N days
  *
  * @returns {Promise<Object>} - Results of the query and pagination info
@@ -744,7 +746,7 @@ exports.Transfers = async function() {
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the item name.
  * You can retrieve all available item names from the <a href="#.ListingNames">ListingNames method</a>.
- *  @param {string=} editionFilter - Filter results by item edition.
+ *  @param {Array<string>} editionFilters - Filter results by item edition.
  *  <br /><br />
  *  NOTE: This string must be an <b>exact match</b> on the edition name.
  * You can retrieve all available item edition names from the <a href="#.ListingEditionNames">ListingEditionNames method</a>.
@@ -757,7 +759,7 @@ exports.Transfers = async function() {
  * @param {string=} tokenId - Filter by token ID (if filtering by contract address)
  * @param {string=} currency - Filter results by purchase currency. Available options: `usdc`
  * @param {Object=} marketplaceParams - Filter results by marketplace
- * @param {integer=} collectionIndex - If filtering by marketplace, filter by collection. The index refers to the index in the array `marketplace.collections`
+ * @param {Array<integer>=} collectionIndexes - If filtering by marketplace, filter by collection(s). The index refers to the index in the array `marketplace.collections`
  * @param {integer=} lastNDays - Filter by results listed in the past N days
  *
  * @returns {Promise<Object>} - Statistics about sales. All prices in USD.