Predictive Behaviors

This guide will walk you through the fundamentals of using wallet predictive behaviors APIs. Make sure to get familiar with the core concepts of our wallet behaviors solution.

Behavioral summary by a wallet(s)

You can obtain a behavior profile for an individual wallet or a group of wallets. You can use up to 500 wallets at a time per one API call.

Note: You can also use ENS names instead of addresses or mix both formats. Each ENS name will be resolved to an address automatically according to the current ENS mapping.

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

The returned objects contains a list of provided wallets with an attributed behavior per each wallet and a percentage of wallets in the behavioral group vs all wallets in the collection.

{
    "aggregatedBehaviors": [
        {
            "behavior": "BEHAVIOR_COLLECTOR",
            "walletsCount": "1",
            "walletsPercentage": 50
        },
        {
            "behavior": "BEHAVIOR_EXPLORER",
            "walletsCount": "1",
            "walletsPercentage": 50
        }
    ]
}

Behavioral summary by collection

The behavioral summary by collection provides a breakdown of all the wallets into behavioral categories and enables you to identify collections that rank the highest when it comes to attracting the experienced influential owners, or bringing in the newbies.

Below, is an example of such a summary obtained for the ALTS by adidas collection.

curl --request GET \
     --url https://ethereum-rest.api.mnemonichq.com/audiences/v1beta1/behaviors/by_collection/0x749f5ddf5ab4c1f26f74560a78300563c34b417d \
     --header 'X-API-Key: <YOUR API KEY>' \
     --header 'accept: application/json'

{
  "aggregatedBehaviors": [
    {
      "behavior": "BEHAVIOR_NEWBIE",
      "walletsCount": "19",
      "walletsPercentage": 0.1316883836983643,
      "walletsCountChange30d": "0"
    },
    {
      "behavior": "BEHAVIOR_WHALE",
      "walletsCount": "1",
      "walletsPercentage": 0.006930967563071805,
      "walletsCountChange30d": "1"
    },
    {
      "behavior": "BEHAVIOR_PATRON",
      "walletsCount": "43",
      "walletsPercentage": 0.2980316052120876,
      "walletsCountChange30d": "15"
    },
    {
      "behavior": "BEHAVIOR_CREATOR",
      "walletsCount": "208",
      "walletsPercentage": 1.4416412531189353,
      "walletsCountChange30d": "44"
    },
    {
      "behavior": "BEHAVIOR_FLIPPER",
      "walletsCount": "273",
      "walletsPercentage": 1.8921541447186028,
      "walletsCountChange30d": "52"
    },
    {
      "behavior": "BEHAVIOR_ADVANCED",
      "walletsCount": "374",
      "walletsPercentage": 2.592181868588855,
      "walletsCountChange30d": "86"
    },
    {
      "behavior": "BEHAVIOR_EXPLORER",
      "walletsCount": "6792",
      "walletsPercentage": 47.0751316883837,
      "walletsCountChange30d": "1823"
    },
    {
      "behavior": "BEHAVIOR_COLLECTOR",
      "walletsCount": "2712",
      "walletsPercentage": 18.796784031050734,
      "walletsCountChange30d": "896"
    },
    {
      "behavior": "BEHAVIOR_INFLUENCER",
      "walletsCount": "10",
      "walletsPercentage": 0.06930967563071805,
      "walletsCountChange30d": "2"
    },
    {
      "behavior": "BEHAVIOR_TASTEMAKER",
      "walletsCount": "91",
      "walletsPercentage": 0.6307180482395343,
      "walletsCountChange30d": "5"
    }
  ]
}

Further, we can obtain behavior details for the same collection:

curl --request GET \
     --url https://ethereum-rest.api.mnemonichq.com/audiences/v1beta1/behaviors/by_collection/0x749f5ddf5ab4c1f26f74560a78300563c34b417d/details \
     --header 'X-API-Key: <YOUR API KEY>' \
     --header 'accept: application/json'

{
  "walletBehaviors": [
    {
      "address": "0x002505eefcbd852a148f03ca3451811032a72f96",
      "behavior": "BEHAVIOR_EXPLORER",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_HIGH",
      "selling": "SCORE_MED",
      "taste": "SCORE_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x0042e7b8a10705b9180acda98426b2d03706f836",
      "behavior": "BEHAVIOR_COLLECTOR",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_VERY_HIGH",
      "selling": "SCORE_LOW",
      "taste": "SCORE_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x004cf65b315287fc064495da288459208ef575a9",
      "behavior": "BEHAVIOR_EXPLORER",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_VERY_HIGH",
      "selling": "SCORE_MED",
      "taste": "SCORE_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x0064f54f2084758afa4e013b606a9fdd718ec53c",
      "behavior": "BEHAVIOR_ADVANCED",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_HIGH",
      "selling": "SCORE_MED",
      "taste": "SCORE_VERY_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x0095ba16471786229ee0f4ed90672071c5daaa29",
      "behavior": "BEHAVIOR_ADVANCED",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_MED",
      "selling": "SCORE_MED",
      "taste": "SCORE_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x00c7b3b4dc1ba84cb924da9335cb9c173ee91dbb",
      "behavior": "BEHAVIOR_EXPLORER",
      "experience": "SCORE_HIGH",
      "holding": "SCORE_MED",
      "selling": "SCORE_MED",
      "taste": "SCORE_VERY_LOW",
      "automation": "SCORE_VERY_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x00fec515b02e30fc901b6edc6e21ba84f05c0445",
      "behavior": "BEHAVIOR_COLLECTOR",
      "experience": "SCORE_HIGH",
      "holding": "SCORE_HIGH",
      "selling": "SCORE_VERY_LOW",
      "taste": "SCORE_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x0100029670faae0fd631810c483b9cae68e9bb1a",
      "behavior": "BEHAVIOR_TASTEMAKER",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_VERY_HIGH",
      "selling": "SCORE_MED",
      "taste": "SCORE_HIGH",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x011093322a9cbdc707b371996f8b4100bfa8793c",
      "behavior": "BEHAVIOR_COLLECTOR",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_HIGH",
      "selling": "SCORE_MED",
      "taste": "SCORE_MED",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x012345e6fa44eed2df2443c739e65165861e0842",
      "behavior": "BEHAVIOR_FLIPPER",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_VERY_HIGH",
      "selling": "SCORE_HIGH",
      "taste": "SCORE_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x012ced81884de439b75d1b96302d25c7344c4919",
      "behavior": "BEHAVIOR_EXPLORER",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_HIGH",
      "selling": "SCORE_MED",
      "taste": "SCORE_VERY_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x01348f50406198ed37447a9cf2f0c28a6df6cce2",
      "behavior": "BEHAVIOR_EXPLORER",
      "experience": "SCORE_HIGH",
      "holding": "SCORE_HIGH",
      "selling": "SCORE_MED",
      "taste": "SCORE_VERY_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x017c4dc18a2d67e82a49c4359016e50fd8e63233",
      "behavior": "BEHAVIOR_TASTEMAKER",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_VERY_HIGH",
      "selling": "SCORE_MED",
      "taste": "SCORE_HIGH",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x0199e49aaa8226841bfdd9ddb0ba61ad0b251399",
      "behavior": "BEHAVIOR_FLIPPER",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_MED",
      "selling": "SCORE_HIGH",
      "taste": "SCORE_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x021e0ff91d2d7da0a77f34335b8fc963c72bb8de",
      "behavior": "BEHAVIOR_EXPLORER",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_HIGH",
      "selling": "SCORE_MED",
      "taste": "SCORE_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x021f64f531ea9985d14384c38f88b31f947bd102",
      "behavior": "BEHAVIOR_COLLECTOR",
      "experience": "SCORE_HIGH",
      "holding": "SCORE_HIGH",
      "selling": "SCORE_LOW",
      "taste": "SCORE_VERY_LOW",
      "automation": "SCORE_VERY_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x023192b16a986dc4e5cb76c1ec2f4d2de4d08462",
      "behavior": "BEHAVIOR_CREATOR",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_HIGH",
      "selling": "SCORE_HIGH",
      "taste": "SCORE_MED",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x0237e9ba5e24dc26ae0b226eab90708fd160a058",
      "behavior": "BEHAVIOR_EXPLORER",
      "experience": "SCORE_HIGH",
      "holding": "SCORE_MED",
      "selling": "SCORE_MED",
      "taste": "SCORE_VERY_LOW",
      "automation": "SCORE_VERY_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x024aef1375c1701693b2a0c8e8ad7badf0dce493",
      "behavior": "BEHAVIOR_EXPLORER",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_MED",
      "selling": "SCORE_MED",
      "taste": "SCORE_VERY_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    },
    {
      "address": "0x024f36b02608a5129c61f8df54dc7286f9113dee",
      "behavior": "BEHAVIOR_FLIPPER",
      "experience": "SCORE_VERY_HIGH",
      "holding": "SCORE_HIGH",
      "selling": "SCORE_HIGH",
      "taste": "SCORE_VERY_LOW",
      "automation": "SCORE_LOW",
      "spendIntent": "SCORE_VERY_HIGH",
      "influence": "SCORE_VERY_LOW"
    }
  ]
}

Nest steps

Predictive behaviors are a powerful tool which allows building more personalized experiences in wallets and marketplaces. Read our guide on how to use predictive wallet behaviors to build personalized recommendations.

Relevant APIs:

Our behavioral categories can be further combined with financial data that provides more information on the recency of engagement, wallet price sensitivity, lifetime spend amounts, net profits and current balance.

Continue exploring Audience Insights APIs with the following guides: