Sign upDocumentationSupportCommunity on Discord

Financial Stats

Suggest Edits

This guide will walk you through the fundamentals of an NFT Wallet Financial Stats APIs. These set of capabilities enhance previously discussed Financial profiles by offering wallets statistics and various additional ways of filtering the data.

By analyzing these metrics, businesses and platforms can identify opportunities for growth, create tailored marketing campaigns, and enhance user experiences within the community.

Financial stats can be obtained at an individual wallet level or at a collection level for all collection owners.

Note: Unlike Financial profiles, these APIs provide aggregated data for all wallets that match a given criteria.

Stats by wallets

To obtain data on a wallet level simply provide a wallet(s) address or ENS name(s). You can provide up to 500 addresses at a time in a single API call.

curl -i -X POST \
  https://ethereum-rest.api.mnemonichq.com/audiences/v1beta1/financial_stats/by_wallets \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: <YOUR API KEY>' \
  -d '{
    "walletAddresses": [
      "0x3eb4b12127EdC81A4d2fD49658db07005bcAd065",
      "cowherd.eth"
    ]
  }'

Below is an aggregated data for given wallets.

{
    "walletsCount": "2",
    "collectionsOwnedCountAvg": 28.5,
    "nftsPurchasesCountAvg": 87,
    "nftsPurchasesVolumeAvg": 18.09219937223114,
    "nftsPurchasesPriceAvg": 0.24613774282228315,
    "walletAgeMin": "571",
    "walletAgeMax": "685",
    "nftsFifoHoldingSpanAvg": 102.69736992530135
}

You can use additional parameters to filter wallets that match certain criteria. Parameters are evaluated as a logical AND.

Available filters:

  • nftsPurchasesVolumeGte – minimum NFTs purchases volume, given in the native blockchain token.
  • nftsPurchasesPriceAvgGte – minimum average price paid for NFT purchase, given in the native blockchain token.
  • collectionsOwnedCountGte – minimum count of unique collections currently owned by the wallet.
  • daysSinceLastPurchaseLte – maximum days since last NFT was purchased.

Stats by collection

To obtain financial stats of the owners of a particular collection, simply provide a collection address.

Below are the stats of the owners of the Mutant Ape Yacht Club collection.

curl -i -X GET \
  https://ethereum-rest.api.mnemonichq.com/audiences/v1beta1/financial_stats/by_collection/0x60e4d786628fea6478f785a6d7e704777c86a7c6 \
  -H 'X-API-Key: <YOUR API KEY>'

The response structure is very similar to the above, and represents all owners of the given collection.

{
    "walletsCount": "11125",
    "collectionsOwnedCountAvg": 41.14216209801827,
    "nftsPurchasesCountAvg": 143.84419128990154,
    "nftsPurchasesVolumeAvg": 432.78377263534077,
    "nftsPurchasesPriceAvg": 4.156019073250368,
    "walletAgeMin": "0",
    "walletAgeMax": "2116",
    "nftsFifoHoldingSpanAvg": 53.07633582685353
}

As seen in the result above, there are a total of 11,125 wallets in the collection, with an average ownership of 41.142 collections per wallet. On average, each wallet has made 143.844 NFT purchases with a cumulative volume of 432.784 ETH. The average purchase price for an NFT is 4.156 ETH. Wallet ages within the collection range from 0 to 2,116 days. The average holding span, based on the First-In-First-Out (FIFO) method, for NFTs across these wallets is 53.076 days.

Summary

In summary, wallet financial statistics provide valuable insights into the overall financial activity, preferences, and trends of the collection's participants.

Furthermore, understanding the average wallet age and holding span can help platforms to develop loyalty programs and promotional strategies that encourage user engagement and foster long-term relationships with collectors in the NFT ecosystem.

Updated 11 months ago