Skip to main content

🎁 Airdrop Optimization

AirDrop Optimization leverages Wallet Intelligence to enhance the precision and effectiveness of airdrop campaigns by providing detailed insights into wallet addresses and their associated metrics. By analyzing wallet value, transaction history, spending behavior, and engagement levels, developers can identify potential bots, assess value distribution, and measure participant engagement. This comprehensive analysis allows developers to refine and optimize their airdrop strategies to target genuine, high-value users. Using Wallet Intelligence fields, developers can tailor their airdrop criteria to focus on participants most likely to contribute positively to the community, such as those with high hodler scores, frequent transaction activity, or significant past interactions with similar dapps.

AirDrop Optimization ensures that airdrop campaigns reach the right audience, maximizing impact and fostering a more engaged and loyal user base. This data-driven approach leads to more efficient resource allocation, improved outcomes, and sustained growth for every airdrop campaign.

Instructions​

Step 0: Upload Airdrop Wallet Batch

  • Prepare a list of blockchain wallet addresses in an array format. This batch should consist of wallets that have signed up for the airdrop.
  • This batch can contain up to 10,000 addresses.
  • If the list is over 10K wallets, then you will need to submit multiple requests. Example -->
[
"0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"0x988527874C7E3f02115F89A6a97135c70B6a47Fc",
...,
"0x5f3fd252caa351a69f5c98b78fd0db71adfe5bea"
]

Step 1: Obtain API Key

Step 2: Construct the API Request

  • Use the multi-wallet endpoint URL https://api.thirdwavelabs.com/evm/wallets/batch.
  • Set the request method to POST.

Step 3: Set Headers

  • Include the X-Api-Key header in your request with your API key as the value.
  • Set the Content-Type header to application/json.

Step 4: Send the Request

  • Execute the request, submitting the array of wallet addresses in the request body.
curl
--request POST 'https://api.thirdwavelabs.com/evm/wallets/batch' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '["0xd8da6bf26964af9d7eed9e03e53415d37aa96045","0x988527874C7E3f02115F89A6a97135c70B6a47Fc",...,"0x5f3fd252caa351a69f5c98b78fd0db71adfe5bea"]'

Step 5: Receive and Interpret the Response

  • Upon receiving the response from the API, parse the data into a CSV file or spreadsheet format to analyze the wallet audience in aggregate.
  • Review the attributes of each wallet object, including botWarning, outboundTransactionValue, balance, outboundTransactionCount, hodlerScore, and other characteristics.
  • Identify and remove potential bot wallets by checking the botWarning field.
  • Analyze the distribution of wallet values and engagement metrics to identify high-value participants.
[
    {
        "data": {
        "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "firstSeenAt": "2015-09-28T08:24:43.000Z",
        "balance": 3206079.16,
        "hodlerScore": 55,
        "engagementScore": 84,
        "botWarning": false,
        "outboundTransactionValue": 64270664.33,
        "outboundTransactionCount": "1244",
        "transactionPatterns": [
         { "key": "CONTINUOUS", "value": false },
         { "key": "HIGH_VELOCITY", "value": false },
         { "key": "SUSPICIOUS_WALLET_NETWORK", "value": false },
         { "key": "TIMED", "value": false }
         ]
    }
    },
    {
        "data": {
        "address": "0x988527874C7E3f02115F89A6a97135c70B6a47Fc",
        "firstSeenAt": "2021-09-14T12:15:40.000Z",
        "balance": 1476.61,
        "hodlerScore": 98,
        "engagementScore": 99,
        "botWarning": true,
        "outboundTransactionValue": 64270664.33,
        "outboundTransactionCount": "1244",
        "transactionPatterns": [
         { "key": "CONTINUOUS", "value": true },
         { "key": "HIGH_VELOCITY", "value": false },
         { "key": "SUSPICIOUS_WALLET_NETWORK", "value": true },
         { "key": "TIMED", "value": false }
         ]
    }
    },
    {
        ...
    },
    {
        "data": {
        "address": "0x5f3fd252caa351a69f5c98b78fd0db71adfe5bea",
        "firstSeenAt": "2024-04-11T07:18:39.000Z",
        "balance": 1.95,
        "hodlerScore": 63,
        "engagementScore": 22,
        "botWarning": false,
        "outboundTransactionValue": 1.56,
        "outboundTransactionCount": "5",
        "transactionPatterns": [
         { "key": "CONTINUOUS", "value": false },
         { "key": "HIGH_VELOCITY", "value": false },
         { "key": "SUSPICIOUS_WALLET_NETWORK", "value": false },
         { "key": "TIMED", "value": false }
         ]
    }
    }
]
info

If the wallet address provided doesn't exist, wasn't in the correct format, or is not on a supported chain, the response for that entry will be null.

Step 6: Generate Insights

  • Utilize the extracted data to generate insights and optimize the airdrop campaign.
  • Segment participants based on wallet characteristics to tailor rewards or incentives.
  • Adjust campaign strategies based on the quality & value of wallets to maximize engagement and ROI.

Suggested analysis to run:

Validity

  • % Bot Warnings
  • % Transaction Pattern flags (i.e. % flagged for suspicious wallet network)

Value

  • Total, median, average balance
  • Top 10 wallets by balance
  • Total, median, average outboundTransactionValue
  • Top 10 Wallets wallets by outboundTransactionValue

Behavior

  • Median, average, hodlerScore
  • Top 10 wallets by hodlerScore
  • Median, average, engagementScore
  • Top 10 wallets by engagementScore

Experience

  • Total, median, average outboundTransactionCount
  • Top 10 wallets by outboundTransactionCount
  • Segment by wallet age based on firstSeenAt timestamp

Outcome​

By leveraging Thirdwave's Wallet Intelligence API for AirDrop Optimization, developers can gain valuable insights into the characteristics of participants, identify potential bots, and optimize their airdrop campaigns to achieve better outcomes.