feat: add endpoint getBlueChipStatistics, which returns blue chip statistics referring to [NFTScan Overview](https://www.nftscan.com/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d?module=Analytics)

Author: yohuohuohuo

src/api/evm/statistic/index.ts

@@ -6,6 +6,7 @@ import {
 } from '../../../types/evm/statistic/request-params';
 import {
   QueryAccountOverviewResponse,
+  QueryBlueChipStatisticsResponse,
   QueryCollectionRankingResponse,
   QueryCollectionStatisticsResponse,
   QueryCollectionTradeResponse,
@@ -144,7 +145,7 @@ export default class NftscanEvmStatistic extends BaseApi<NftscanConfig> {
    * *****
    * Obtain account overview statistics.
    * - This endpoint returns overview statistics for an account address referring to NFTScan Overview({@link https://www.nftscan.com/0xea7a0f1434084b2e99b42f045896e7326fed9dc1}).
-   * - details: {@link https://docs.nftscan.com/nftscan/trendingUsingGET}
+   * - details: {@link https://docs.nftscan.com/nftscan/accountOverviewUsingGET}
    * @param accountAddress The account address
    * @returns Promise<{@link QueryAccountOverviewResponse}>
    */
@@ -159,6 +160,27 @@ export default class NftscanEvmStatistic extends BaseApi<NftscanConfig> {
     );
   }
 
+  /**
+   * *****
+   * [PRO]
+   * *****
+   * Obtain blue chip statistics.
+   * - This endpoint returns blue chip statistics referring to({@link https://www.nftscan.com/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d?module=Analytics}).
+   * - details: {@link https://docs.nftscan.com/nftscan/blueChipUsingGET}
+   * @param contractAddress The NFT contract address
+   * @returns Promise<{@link QueryBlueChipStatisticsResponse}>
+   */
+  getBlueChipStatistics(contractAddress: string): Promise<QueryBlueChipStatisticsResponse> {
+    if (isEmpty(contractAddress)) {
+      return missingParamError('contractAddress');
+    }
+
+    return nftscanGet<NsObject, QueryBlueChipStatisticsResponse>(
+      this.config,
+      `${NftscanConst.API.evm.statistic.getBlueChipStatistics}${contractAddress}`,
+    );
+  }
+
   /**
    * Obtain marketplace ranking statistics.
    * - This endpoint returns NFT marketplace ranking statistics referring to NFTScan Marketplace({@link https://www.nftscan.com/marketplace}).

src/types/evm/statistic/response-data.ts

@@ -542,6 +542,26 @@ export interface QueryCollectionStatisticsResponse {
   volume_24h: number;
 }
 
+/**
+ * The response parameters of EVM API 'getBlueChipStatistics'
+ */
+export interface QueryBlueChipStatisticsResponse {
+  /**
+   * How many owners who have at least one Blue Chip NFT for the collection.
+   */
+  blue_chip_owner: number;
+
+  /**
+   * Percentage of owners of this collection who have at least one Blue Chip NFT
+   */
+  next_blue_chip_probability: string;
+
+  /**
+   * How many owners for the collection
+   */
+  owner: number;
+}
+
 /**
  * The response parameters of EVM API 'getMintRanking'
  */

src/util/nftscan.const.ts

@@ -45,6 +45,7 @@ export default class NftscanConst {
         getCollectionTrade: '/v2/statistics/collection/trade/',
         getCollectionTrending: '/v2/statistics/collection/trending/',
         getAccountOverview: '/v2/statistics/overview/',
+        getBlueChipStatistics: '/v2/statistics/blue/chip/',
         getMarketplaceRanking: '/v2/statistics/ranking/marketplace',
         getMarketCapRanking: '/v2/statistics/ranking/marketcap',
         getCollectionStatistics: '/v2/statistics/collection/',