Skip to main content

🛍️ Dynamic Incentives

Dynamic Incentives empower Web3 developers to design personalized offers and incentives based on comprehensive wallet metrics such as wallet value, spending behavior, hodler score, and overall blockchain activity. By leveraging Wallet Intelligence, developers can tailor incentives relative to each user's value, ensuring that all users receive offers that are appropriately scaled to their engagement and worth. For example, developers can use spending behavior to offer exclusive discounts or rewards to frequent spenders, or use hodler scores to provide special benefits to long-term holders.

This approach helps prevent churn by addressing the specific needs and preferences of users across different value segments, fostering loyalty, and ensuring they remain engaged with the platform. Dynamic Incentives enable developers to deliver customized experiences that drive user satisfaction and ensure a competitive edge in the evolving Web3 ecosystem.

Instructions​

Step 0: User connects new wallet (example: 0x828d3Fff01cf78C96495aB1bD2C1e1b1b2384A9a) to your application.

Step 1: Obtain API Key

Step 2: Construct the API Request

  • Use the endpoint URL https://api.thirdwavelabs.com/evm/wallets/{account}, replacing {account} with the blockchain wallet address you want to check.
  • Set the request method to GET.

Step 3: Set Headers

  • Include the X-Api-Key header in your request with your API key as the value.

Step 4: Send the Request

  • Execute the request using your preferred method, such as curl or HTTP request library in your programming language of choice.
curl -s
--request GET 'https://api.thirdwavelabs.com/evm/wallets/0x828d3Fff01cf78C96495aB1bD2C1e1b1b2384A9a'
--header 'X-Api-Key: YOUR_API_KEY'

Step 5: Receive and Interpret the Response

  • Upon receiving the response from the API, parse the data to extract the relevant information.
  • Review the wallet's attributes such as balance, outboundTransactionValue, and hodlerScore to determine the user's value and engagement level.
  • Identify high-value users (whales) based on their high balance, significant spend, and high hodler score.

Example Response

{
  "data": {
    "address": "0x828d3fff01cf78c96495ab1bd2c1e1b1b2384a9a",
    "balance": 453.83,
    "botWarning": false,
    "engagementScore": 95,
    "firstSeenAt": "2021-02-11T19:51:10.000Z",
    "hodlerScore": 95,
    "outboundTransactionCount": "973",
    "outboundTransactionValue": 445014.864936489,
    "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: Customize Offers

  • Create customized offers and incentives tailored to the user's value and engagement level.
    • For high-value users (whales): Provide higher reward offers or exclusive incentives to encourage further engagement and spending.
    • For lower-value users: Offer scaled-down incentives to encourage them to increase their engagement and spending over time.

Outcome​

By tailoring offers and incentives based on the user's wallet attributes and blockchain activity, developers can optimize upselling strategies to maximize revenue and user engagement.