apenft-js-tron 2.0.6 → 2.0.8-beta.0

package/README.md

@@ -1,6 +1,7 @@
 # APENFT SDK
 
 ## What is apenft-js-tron?
+
 "apenft-js-tron" is a SDK for APENFT marketplace base on TRON blockchain and TronLink wallet.
 
 ## Table of Contents
@@ -19,6 +20,9 @@
       - [Query Assets Under an Account](#query-assets-under-an-account)
       - [Query Collections Under an Account](#query-collections-under-an-account)
       - [Query NFT details](#query-nft-details)
+      - [Query Currencies](#query-currencies)
+      - [Query All Assets](#query-all-assets)
+      - [Query Ranking NFTs](#query-ranking-nfts)
   - [Order](#order)
     - [Create an Order](#create-an-order)
       - [Fixed Price](#fixed-price)
@@ -42,7 +46,12 @@
   - [Collection](#collection)
     - [Query Collections](#query-collections)
       - [Query the NFT List Under a Collection](#query-the-nft-list-under-a-collection)
-      - [Query a Single Collection](#query-a-single-collection)
+      - [Query Single Collection Info](#query-single-collection-info)
+      - [Query Single Collection Attributes](#query-single-collection-attributes)
+      - [Query All Collections](#query-all-collections)
+      - [Query Hot Collections](#query-hot-collections)
+      - [Query Collection Trade Trend](#query-collection-trade-trend)
+      - [Query Collection Trading History](#query-collection-trading-history)
   - [License](#license)
 
 ## Installation
@@ -78,8 +87,8 @@ const { tronWeb } = window;
 
 /* For node */
 const tronWeb = new TronWeb({
-  fullHost: "https://api.shasta.trongrid.io",
-  privateKey: "xxxxx-xxxx-xxxxx-xxxxx-xxxxx",
+    fullHost: "https://api.shasta.trongrid.io",
+    privateKey: "xxxxx-xxxx-xxxxx-xxxxx-xxxxx",
 });
 
 /* Initialize SDK */
@@ -180,11 +189,11 @@ async APENFTQuery.getAssetsList(account,pagination);
 Example:
 ```js
 const assetsList = await sdk_query.getAssetsList(
-  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 console.log("assetsList", assetsList);
 ```
@@ -207,11 +216,11 @@ async APENFTQuery.getCollections(account,pagination);
 Example:
 ```js
 const collectionsList = await sdk_query.getCollections(
-  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 console.log("collectionsList", collectionsList);
 ```
@@ -225,7 +234,7 @@ Instructions:
 ```js
 /**
  *
-* @param {string} collection 
+ * @param {string} collection 
  * @param {string} id 
  * @returns Promise
  */
@@ -235,12 +244,174 @@ async APENFTQuery.getAssetDetail(collection,id);
 Example:
 ```js
 const assetDetail = await sdk_query.getAssetDetail(
-  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
-  "1327"
+    "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+    "1327"
 );
 console.log("assetDetail", assetDetail);
 ```
 
+#### Query Currencies
+
+```js
+APENFTQuery.getCurrencies()
+```
+
+Instructions:
+
+```js
+async APENFTQuery.getCurrencies();
+```
+
+Example:
+
+```js
+const currencies = await sdk_query.getCurrencies();
+console.log("currencies", currencies);
+```
+
+#### Query All Assets
+
+```js
+APENFTQuery.queryAllAssets({sort, pagination, filters});
+```
+
+Instructions:
+
+```ts
+async getAllAssets(params: {sort: AssetSortBy, pagination?: Pagination, filters?: AssetQueryFilters}): Promise<any>;
+
+enum AssetSortBy {
+    HighestLastSale = 'HighestLastSale',
+    RecentlyListed = 'RecentlyListed',
+    PriceLowToHigh = 'PriceLowToHigh',
+    PriceHighToLow = 'PriceHighToLow',
+    RecentlyTransfer = 'RecentlyTransfer',
+    RecentlyCreated = 'RecentlyCreated',
+    RecentlySold = 'RecentlySold',
+    EndingSoon = 'EndingSoon',
+}
+
+interface Pagination {
+    first: number
+    cursor?: string
+}
+
+interface AssetQueryFilters {
+    search?: string
+    price?: PriceRangeFilter
+    statuses?: AssetStatus[]
+    collections?: string[]
+    user_account?: string
+    owners?: string[]
+    creators?: string[]
+    categories?: string[]
+    currencies?: string[]
+    is_recommend?: boolean
+    collection_types?: AssetListCollectionTypes[]
+}
+
+interface PriceRangeFilter {
+    min?: number | string
+    max?: number | string
+    currency: 'TRX' | 'USD'
+}
+
+enum AssetListCollectionTypes {
+    NORMAL = 'NORMAL',
+    MYSTERY_BOX = 'MYSTERY_BOX',
+}
+
+enum AssetStatus {
+    BUY_NOW = 'BUY_NOW',
+    ON_AUCTION = 'ON_AUCTION',
+    VERIFIED = 'VERIFIED',
+    HAS_OFFERS = 'HAS_OFFERS',
+}
+
+```
+
+Example:
+```js
+const currencies = await sdk_query.getCurrencies();
+const trxAndUsdtAddresses = currencies
+    .filter((currency) => currency.symbol === "TRX" || currency.symbol === "USDT")
+    .map((currency) => currency.address);
+
+const assets = await sdk_query.getAllAssets({
+    sort: AssetSortBy.PriceLowToHigh,
+    pagination: { first: 30 },
+    filters: {
+        statuses: [AssetStatus.BUY_NOW],
+        price: { min: 1, max: 100000, currency: "TRX" },
+        collections: ["TXb5avabU6Z2Dhhp4wV2WbX3JCX844PDAB"],
+        categories: [Category.ART, Category.COLLECTIBLES],
+        currencies: trxAndUsdtAddresses,
+        collection_types: [AssetListCollectionTypes.NORMAL],
+    },
+});
+console.log("assets", assets);
+```
+
+#### Query Ranking NFTs
+
+```js
+APENFTQuery.getRankingNFTs({sort, sort_asc, categories, is_rank_disabled, has_listing_asset, pagination});
+```
+
+Instructions:
+
+```js
+async APENFTQuery.getRankingNFTs(params: RankingDetailParams): Promise;
+
+interface RankingDetailParams extends Partial<RankingDetailFilters> {
+    sort: CollectionSortBy
+    sort_asc: boolean
+    pagination: Pagination
+}
+
+interface RankingDetailFilters {
+    categories: Category[]
+    is_rank_disabled: boolean
+    has_listing_asset: boolean
+}
+
+enum CollectionSortBy {
+    Volume7d = "Volume7d",
+    Volume24h = "Volume24h",
+    Volume30d = "Volume30d",
+    VolumeTotal = "VolumeTotal",
+}
+
+enum Category {
+    ART = "art",
+    COLLECTIBLES = "collectibles",
+    VIRTUAL_WORLD = "virtual-world",
+    MUSIC = "music",
+    UTILITY = "utility",
+    SPORTS = "sports",
+    TRADING_CARDS = "trading-cards",
+    DOMAIN_NAMES = "domain-names",
+}
+
+interface Pagination {
+    first: number
+    cursor?: string
+}
+```
+
+Example:
+
+```js
+const rankingNFTs = await sdk_query.getRankingNFTs({
+    sort: CollectionSortBy.Volume7d,
+    sort_asc: false,
+    pagination: { first: 20 },
+    categories: [],
+    is_rank_disabled: false,
+    has_listing_asset: true,
+});
+console.log("rankingNFTs", rankingNFTs);
+```
 
 ## Order
 ### Create an Order
@@ -268,36 +439,36 @@ async initApprove({ APENFTOrders, orderType, orderParams})
 
 Example:
 ```js
-  let orderType = "FixPriceOrder";
-  const params = {
-      collection: "TNy9UXCHeAa2jrRiG6CjUppiwKJ9vodfS9",
-      id: "67",
-      price: 20,
-      currency: "TRX",
-      expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
-      buyerAddress: "",
-  }
-
-  let orderParams = await sdk_query.getFixPriceOrderParams(params);
-
-  try {
-      await initApprove({
-          APENFTOrders: sdk_orders,
-          orderType: orderType,
-          orderParams: orderParams,
-      });
-
-      let result = await sdk_orders.createSellOrder(orderParams);
-      console.log(result);
-
-      if (result && result.orderHash) {
-          console.log("FixPriceOrder Listing Successful!");
-      } else {
-          console.log("Failed");
-      }
-  } catch (e) {
-      console.log(e);
-  }
+let orderType = "FixPriceOrder";
+const params = {
+    collection: "TNy9UXCHeAa2jrRiG6CjUppiwKJ9vodfS9",
+    id: "67",
+    price: 20,
+    currency: "TRX",
+    expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+    buyerAddress: "",
+}
+
+let orderParams = await sdk_query.getFixPriceOrderParams(params);
+
+try {
+    await initApprove({
+        APENFTOrders: sdk_orders,
+        orderType: orderType,
+        orderParams: orderParams,
+    });
+
+    let result = await sdk_orders.createSellOrder(orderParams);
+    console.log(result);
+
+    if (result && result.orderHash) {
+        console.log("FixPriceOrder Listing Successful!");
+    } else {
+        console.log("Failed");
+    }
+} catch (e) {
+    console.log(e);
+}
 ```
 
 #### Fixed Price
@@ -326,12 +497,12 @@ async APENFTQuery.getFixPriceOrderParams(params);
 Example:
 ```js
 const params = {
-  collection: "TNy9UXCHeAa2jrRiG6CjUppiwKJ9vodfS9",
-  id: "67",
-  price: 20,
-  currency: "TRX",
-  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
-  buyerAddress: "",
+    collection: "TNy9UXCHeAa2jrRiG6CjUppiwKJ9vodfS9",
+    id: "67",
+    price: 20,
+    currency: "TRX",
+    expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+    buyerAddress: "",
 };
 let orderParams = await sdk_query.getFixPriceOrderParams(params);
 ```
@@ -354,19 +525,19 @@ Example:
 ```js
 const orderType = "FixPriceOrder";
 const params = {
-  collection: "TNy9UXCHeAa2jrRiG6CjUppiwKJ9vodfS9",
-  id: "67",
-  price: 20,
-  currency: "TRX",
-  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
-  buyerAddress: "",
+    collection: "TNy9UXCHeAa2jrRiG6CjUppiwKJ9vodfS9",
+    id: "67",
+    price: 20,
+    currency: "TRX",
+    expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+    buyerAddress: "",
 };
 let orderParams = await sdk_query.getFixPriceOrderParams(params);
 await initApprove({
-          APENFTOrders: sdk_orders,
-          orderType: orderType,
-          orderParams: orderParams,
-      });
+    APENFTOrders: sdk_orders,
+    orderType: orderType,
+    orderParams: orderParams,
+});
 await sdk_orders.createSellOrder(orderParams);
 ```
 
@@ -398,12 +569,12 @@ async APENFTQuery.getEnglishAuctionOrderParams(params);
 Example:
 ```js
 const params = {
-  collection: "TQXKjXfTiy9j2qfRXNroZdrrAawu65b72Z",
-  id: "5",
-  bidPrice: 20,
-  reservePrice: 100,
-  currency: "USDT",
-  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+    collection: "TQXKjXfTiy9j2qfRXNroZdrrAawu65b72Z",
+    id: "5",
+    bidPrice: 20,
+    reservePrice: 100,
+    currency: "USDT",
+    expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
 };
 let orderParams = await sdk_query.getEnglishAuctionOrderParams(params);
 ```
@@ -424,12 +595,12 @@ async APENFTOrders.createAuctionOrder(orderParams);
 Example:
 ```js
 const params = {
-  collection: "TQXKjXfTiy9j2qfRXNroZdrrAawu65b72Z",
-  id: "5",
-  bidPrice: 20,
-  reservePrice: 100,
-  currency: "USDT",
-  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+    collection: "TQXKjXfTiy9j2qfRXNroZdrrAawu65b72Z",
+    id: "5",
+    bidPrice: 20,
+    reservePrice: 100,
+    currency: "USDT",
+    expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
 };
 let orderParams = await sdk_query.getEnglishAuctionOrderParams(params);
 
@@ -461,11 +632,11 @@ async APENFTQuery.getMakeOfferOrderOrderParams(params);
 Example:
 ```js
 const params = {
-  collection: "TQFhpAACCPomuW4daSiGTh4SMCvUKtZyNs",
-  id: "105",
-  price: 110,
-  currency: "WTRX",
-  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+    collection: "TQFhpAACCPomuW4daSiGTh4SMCvUKtZyNs",
+    id: "105",
+    price: 110,
+    currency: "WTRX",
+    expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
 };
 let orderParams = await sdk_query.getMakeOfferOrderOrderParams(params);
 ```
@@ -486,11 +657,11 @@ async APENFTOrders.createBuyOrder(orderParams);
 Example:
 ```js
 const params = {
-  collection: "TQFhpAACCPomuW4daSiGTh4SMCvUKtZyNs",
-  id: "105",
-  price: 110,
-  currency: "WTRX",
-  expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
+    collection: "TQFhpAACCPomuW4daSiGTh4SMCvUKtZyNs",
+    id: "105",
+    price: 110,
+    currency: "WTRX",
+    expirationTime: new Date().getTime() + 7 * 24 * 60 * 60 * 1000,
 };
 let orderParams = await sdk_query.getMakeOfferOrderOrderParams(params);
 
@@ -523,10 +694,10 @@ async APENFTQuery.getEnglishAuctionBiddingOrderParams(params);
 Example:
 ```js
 const params = {
-  collection: "TGvAiyw7uT27xVpqHaQ1NM6ZDquEEHQgso",
-  id: "9927",
-  price: 125,
-  currency: "WTRX",
+    collection: "TGvAiyw7uT27xVpqHaQ1NM6ZDquEEHQgso",
+    id: "9927",
+    price: 125,
+    currency: "WTRX",
 };
 let orderParams = await sdk_query.getEnglishAuctionBiddingOrderParams(params);
 ```
@@ -546,10 +717,10 @@ async APENFTOrders.createBiddingOrder(orderParams);
 Example:
 ```js
 const params = {
-  collection: "TGvAiyw7uT27xVpqHaQ1NM6ZDquEEHQgso",
-  id: "9927",
-  price: 125,
-  currency: "WTRX",
+    collection: "TGvAiyw7uT27xVpqHaQ1NM6ZDquEEHQgso",
+    id: "9927",
+    price: 125,
+    currency: "WTRX",
 };
 let orderParams = await sdk_query.getEnglishAuctionBiddingOrderParams(params);
 
@@ -579,9 +750,9 @@ async APENFTQuery.getLowerPriceOrderParams(params);
 Example:
 ```js
 const params = {
-  collection: "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
-  id: "2",
-  price: 80,
+    collection: "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
+    id: "2",
+    price: 80,
 };
 let orderParams = await sdk_query.getLowerPriceOrderParams(params);
 ```
@@ -602,9 +773,9 @@ async APENFTOrders.createLowerPriceOrder(orderParams);
 Example:
 ```js
 const params = {
-  collection: "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
-  id: "2",
-  price: 80,
+    collection: "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
+    id: "2",
+    price: 80,
 };
 let orderParams = await sdk_query.getLowerPriceOrderParams(params);
 
@@ -633,8 +804,8 @@ async APENFTQuery.getAssetBestAskOrderInfo(collection,id);
 Example:
 ```js
 let bestAskOrder = await sdk_query.getAssetBestAskOrderInfo(
-  "TDczyk1W3jNf62cfeZ5d7CasiVXfwy4xiY",
-  "252"
+    "TDczyk1W3jNf62cfeZ5d7CasiVXfwy4xiY",
+    "252"
 );
 ```
 
@@ -655,14 +826,14 @@ async APENFTOrders.account.orderMatch({ buyOrder, sellOrder });
 Example:
 ```js
 let OrderSide = {
-  0: "Buy",
-  1: "Sell",
-  Buy: 0,
-  Sell: 1,
+    0: "Buy",
+    1: "Sell",
+    Buy: 0,
+    Sell: 1,
 };
 let bestAskOrder = await sdk_query.getAssetBestAskOrderInfo(
-  "TDczyk1W3jNf62cfeZ5d7CasiVXfwy4xiY",
-  "252"
+    "TDczyk1W3jNf62cfeZ5d7CasiVXfwy4xiY",
+    "252"
 );
 
 const accountAddress = "XXXXXX";
@@ -670,16 +841,16 @@ const signedOrder = sdk_orders.orders.orderFromJSON(bestAskOrder);
 
 let recipientAddress = "";
 if (bestAskOrder.side === OrderSide.Sell) {
-  recipientAddress = accountAddress;
+    recipientAddress = accountAddress; 
 }
 if (bestAskOrder.side === OrderSide.Buy) {
-  recipientAddress = bestAskOrder.maker;
+    recipientAddress = bestAskOrder.maker;
 }
 
 const { buy, sell } = sdk_orders.orders.makeMatchingOrder({
-  signedOrder,
-  accountAddress: accountAddress,
-  recipientAddress,
+    signedOrder,
+    accountAddress: accountAddress,
+    recipientAddress,
 });
 
 await sdk_orders.account.orderMatch({ buy, sell });
@@ -707,11 +878,11 @@ async APENFTQuery.getReceivedOffers(account,pagination);
 Example:
 ```js
 let receivedOffers = await sdk_query.getReceivedOffers(
-  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 console.log("receivedOffers", receivedOffers);
 ```
@@ -734,18 +905,18 @@ async APENFTOrders.account.orderMatch({ buyOrder, sellOrder });
 Example:
 ```js
 let OrderSide = {
-  0: "Buy",
-  1: "Sell",
-  Buy: 0,
-  Sell: 1,
+    0: "Buy",
+    1: "Sell",
+    Buy: 0,
+    Sell: 1,
 };
 // Gets a list of bids received
 const receivedOffers = await sdk_query.getReceivedOffers(
-  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 // Choose to accept the NTH bid (a price for an NFT)
 // You can filter an NFT yourself based on the returned data
@@ -757,16 +928,16 @@ const signedOrder = sdk_orders.orders.orderFromJSON(bestBidOrder);
 
 let recipientAddress = "";
 if (bestBidOrder.side === OrderSide.Sell) {
-  recipientAddress = accountAddress;
+    recipientAddress = accountAddress;
 }
 if (bestBidOrder.side === OrderSide.Buy) {
-  recipientAddress = bestBidOrder.maker;
+    recipientAddress = bestBidOrder.maker;
 }
 
 const { buy, sell } = sdk_orders.orders.makeMatchingOrder({
-  signedOrder,
-  accountAddress: accountAddress,
-  recipientAddress,
+    signedOrder,
+    accountAddress: accountAddress,
+    recipientAddress,
 });
 
 await sdk_orders.account.orderMatch({ buy, sell });
@@ -794,8 +965,8 @@ async APENFTQuery.getAssetBestAskOrderInfo(collection,id);
 Example:
 ```js
 const order = await sdk_query.getAssetBestAskOrderInfo(
-  "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
-  "2"
+    "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
+    "2"
 );
 ```
 
@@ -815,8 +986,8 @@ async APENFTOrders.account.orderCancel(order);
 Example:
 ```js
 const order = await sdk_query.getAssetListingInfo(
-  "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
-  "2"
+    "TL39x7unoU1ivqxac43umyUaFoGzEE2Ens",
+    "2"
 );
 const _order = sdk_orders.orders.orderFromJSON(order);
 await sdk_orders.account.orderCancel(_order);
@@ -843,11 +1014,11 @@ async APENFTQuery.getSentOffers(account,pagination);
 Example:
 ```js
 const sentOffers = await sdk_query.getSentOffers(
-  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 console.log("sentOffers", sentOffers);
 ```
@@ -869,11 +1040,11 @@ Example:
 ```js
 // Get sent offers
 const sentOffers = await sdk_query.getSentOffers(
-  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 console.log("sentOffers", sentOffers);
 
@@ -905,8 +1076,8 @@ async APENFTQuery.getTransferParams(collection,id);
 Example:
 ```js
 const { metadata, assetData } = await sdk_query.getTransferParams(
-  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
-  "1327"
+    "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+    "1327"
 );
 ```
 
@@ -928,12 +1099,12 @@ async APENFTOrders.account.assetTransfer(metadata, to)
 Example:
 ```js
 const { metadata, assetData } = await sdk_query.getTransferParams(
-  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
-  "1327"
+    "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+    "1327"
 );
 const { newAsset } = await sdk_orders.getAssetOrderVersion(assetData);
 if (metadata?.asset) {
-  metadata.asset.data = newAsset || "";
+    metadata.asset.data = newAsset || "";
 }
 
 let to = "TQzRKbEgp7iSj9fpXX5ghdBHHoh3tEtgwU";
@@ -964,12 +1135,12 @@ async APENFTQuery.getAssetListingOrders(collection,id,pagination);
 Example:
 ```js
 const listingData = await sdk_query.getAssetListingOrders(
-  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
-  "1327",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+    "1327",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 console.log("listingData", listingData);
 ```
@@ -994,12 +1165,12 @@ async APENFTQuery.getAssetOffers(collection,id,pagination);
 Example:
 ```js
 const offersData = await sdk_query.getAssetOffers(
-  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
-  "1327",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+    "1327",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 console.log("offersData", offerData);
 ```
@@ -1025,12 +1196,12 @@ async APENFTQuery.getAssetTradingHistory(collection,id,pagination);
 Example:
 ```js
 const assetTradingHistory = await sdk_query.getAssetTradingHistory(
-  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
-  "1327",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+    "1327",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 console.log("assetTradingHistory", assetTradingHistory);
 ```
@@ -1053,11 +1224,11 @@ async APENFTQuery.getReceivedOffers(account,pagination);
 Example:
 ```js
 const receivedOffers = await sdk_query.getReceivedOffers(
-  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 console.log("receivedOffers", receivedOffers);
 ```
@@ -1080,11 +1251,11 @@ async APENFTQuery.getSentOffers(account,pagination);
 Example:
 ```js
 const sentOffers = await sdk_query.getSentOffers(
-  "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 console.log("sentOffers", sentOffers);
 ```
@@ -1111,20 +1282,23 @@ async APENFTQuery.getCollectionAssetsList(collection,pagination);
 Example:
 ```js
 const collectionAssetsList = await sdk_query.getCollectionAssetsList(
-  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
-  {
-    first: 100, // min:1 max:100
-    cursor: "",
-  }
+    "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ",
+    {
+      first: 100, // min:1 max:100
+      cursor: "",
+    }
 );
 console.log("collectionAssetsList", collectionAssetsList);
 ```
 
-####  Query a Single Collection
-```
+#### Query Single Collection Info
+
+```js
 APENFTQuery.getSingleCollectionInfo(collection)
 ```
+
 Instructions:
+
 ```js
 /**
  *
@@ -1133,17 +1307,187 @@ Instructions:
  */
 async APENFTQuery.getSingleCollectionInfo(collection);
 ```
+
 Example:
+
 ```js
 const singleCollectionInfo = await sdk_query.getSingleCollectionInfo(
-  "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ"
+    "TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ"
 );
 console.log("singleCollectionInfo", singleCollectionInfo);
 ```
 
+#### Query Single Collection Attributes
 
+```js
+APENFTQuery.getSingleCollectionAttributes(collection)
+```
+
+Instructions:
+
+```ts
+/**
+ * @param {string} collection 
+ * @returns Promise
+ */
+async APENFTQuery.getSingleCollectionAttributes(collection: string): Promise;
+```
+
+Example:
+
+```js
+const singleCollectionAttributes = await sdk_query.getSingleCollectionAttributes("TQfujfp9LNU4yRYcAiXcLRmjDuVKQ8U3AJ");
+console.log("singleCollectionAttributes", singleCollectionAttributes);
+```
+
+#### Query All Collections
+
+```js
+APENFTQuery.getAllCollections({sort, pagination, filters});
+```
+
+Instructions:
 
+```ts
+async APENFTQuery.getAllCollections(params: {sort?: CollectionSortBy, pagination?: Pagination, filters?: CollectionListFilterObj}): Promise;
 
+enum CollectionSortBy {
+    Volume7d = "Volume7d",
+    Volume24h = "Volume24h",
+    Volume30d = "Volume30d",
+    VolumeTotal = "VolumeTotal",
+}
+interface Pagination {
+    first: number
+    cursor?: string
+}
+interface CollectionListFilterObj {
+    search?: string
+    owners?: string[]
+}
+```
+
+Example:
+
+```js
+const collections = await sdk_query.getAllCollections({
+    sort: CollectionSortBy.Volume7d,
+    pagination: { first: 20 },
+    filters: {
+        search: "test",
+        owners: ["TFrBnJPgZEfXtvauVG9XVLaDEDDo5jtMWV"],
+    },
+});
+console.log("collections", collections);
+```
+
+#### Query Hot Collections
+
+```js
+APENFTQuery.getHotCollections({chain, is_recommend})
+```
+
+Instructions:
+
+```ts
+async APENFTQuery.getHotCollections(params: {chain: string, is_recommend: boolean}): Promise;
+```
+
+Example:
+
+```js
+const hotCollections = await sdk_query.getHotCollections({chain: "tron", is_recommend: true});
+console.log("hotCollections", hotCollections);
+```
+
+#### Query Collection Trade Trend
+
+```js
+APENFTQuery.getCollectionTradeTrend({ days, collection })
+```
+
+Instructions:
+
+```ts
+async APENFTQuery.getCollectionTradeTrend(params: {days?: CollectionTradeTrendFilterDays, collection: string}): Promise;
+
+enum CollectionTradeTrendFilterDays {
+    Days_7 = 'Days_7',
+    Days_14 = 'Days_14',
+    Days_30 = 'Days_30',
+    Days_60 = 'Days_60',
+    Days_90 = 'Days_90',
+    Days_365 = 'Days_365',
+    Days_All = 'Days_All',
+}
+
+interface CollectionTradeTrendParams {
+    days?: CollectionTradeTrendFilterDays
+    collection: string
+}
+```
+
+Example:
+
+```js
+const collectionTradeTrend = await sdk_query.getCollectionTradeTrend({
+    days: CollectionTradeTrendFilterDays.Days_7,
+    collection: "TLLyoedhRyoJdxYYPvHKr3pMgiBQxayn5c",
+});
+console.log("collectionTradeTrend", collectionTradeTrend);
+```
+
+#### Query Collection Trading History
+
+```js
+APENFTQuery.getCollectionTradingHistory({ pagination, event_types, currencies, collections, user })
+```
+
+Instructions:
+
+```ts
+async APENFTQuery.getCollectionTradingHistory(params: CollectionTradingHistoryParams): Promise<any>;
+
+enum EventType {
+    Transfer = 'Transfer',
+    Offer = 'Offer',
+    Listing = 'Listing',
+    CancelOffer = 'CancelOffer',
+    CancelListing = 'CancelListing',
+    Mint = 'Mint',
+    Burn = 'Burn',
+    Sale = 'Sale',
+}
+
+interface Pagination {
+    first: number
+    cursor?: string
+}
+
+interface CollectionTradingHistoryParams {
+    pagination?: Pagination
+    event_types: EventType[]
+    currencies: string[]
+    collections: string[]
+    user: string
+}
+```
+
+Example:
+
+```js
+const currencies = await sdk_query.getCurrencies();
+const trxAndUsdtAddresses = currencies
+    .filter((currency) => currency.symbol === "TRX" || currency.symbol === "USDT")
+    .map((currency) => currency.address);
+const collectionTradingHistory = await sdk_query.getCollectionTradingHistory({
+    collections: ["TLLyoedhRyoJdxYYPvHKr3pMgiBQxayn5c"],
+    pagination: { first: 20 },
+    event_types: [EventType.Sale, EventType.Transfer],
+    currencies: trxAndUsdtAddresses,
+});
+console.log("collectionTradingHistory", collectionTradingHistory);
+```
 
 ## License
 [MIT]()