Skip to main content

🧰 SDK

Welcome to the Thirdwave JavaScript SDK! This guide will help you integrate Wallet Intelligence into your JavaScript applications seamlessly. The SDK provides easy access to comprehensive blockchain wallet analytics, enabling you to build more insightful and engaging user experiences.

Quick Start​

To dive right in, install the SDK

πŸ‘‰πŸ» Install Javascript SDK: https://www.npmjs.com/package/@thirdwavelabs/core

The README provides detailed instructions on installation, initialization, usage examples, and API references.

Introduction​

The Thirdwave JavaScript SDK simplifies access to in-depth wallet analytics from Wallet Intelligence within your JavaScript projects. Whether you're building a web application, backend service, or Node.js application, the SDK provides an easy way to interact with the Wallet Intelligence API offered by Thirdwave.

Before you start using the SDK, it's important to understand some core concepts.

Wallet Intelligence​

Wallet Intelligence is a suite of tools and data that provides deep insights into blockchain wallets. It helps you analyze wallet behaviors, transaction patterns, and risk profiles.

  • Understand User Behavior: Analyze how wallets interact with different blockchain networks.
  • Risk Assessment: Identify potentially fraudulent or high-risk wallets.
  • Personalization: Tailor your application's experience based on wallet activity.

Learn more here.

Field Definitions​

The SDK provides access to various metrics that describe wallet activities. Here are some key metrics:

  • Engagement Score: An integer value from 0 to 100 that quantifies a wallet's onchain activity. Higher scores indicate active and consistent participation in transactions, helping you identify engaged users.

  • HODLer Score: A score ranging from 0 to 100 that evaluates a wallet's tendency to hold onto NFTs. A high score means the wallet typically retains its NFTs, indicating loyalty and long-term engagement.

  • Bot Warning: A binary indicator (true or false) that classifies whether a wallet is potentially a bot. This helps in enhancing security by identifying and mitigating automated or fraudulent activities.

  • Balance: Reflects the current USD value of all tokens owned by a wallet, calculated using the latest token-to-USD conversion rates. This metric allows you to segment users based on their wallet value.

  • Outbound Transaction Value: The amount of currency or tokens expended from the wallet or account over its lifetime. It sheds light on the account's consumption patterns, providing insights into expenditure behaviors or transactional habits.

For a full list of fields, refer to Wallet Intelligence Data. For in-depth definitions and more information on methodology, visit our Data Glossary.

How the SDK Enhances Your Application​

  • Enhance Security with Bot Shield: Detect and prevent bot activities by analyzing wallet behavior patterns with features like Bot Shield. Safeguard your application from automated attacks and maintain a secure environment for genuine users. Learn More: Bot Shield Guide

  • Boost User Engagement with Dynamic Incentives: Personalize rewards and offers based on individual wallet histories, increasing user retention and driving higher conversion rates. Learn More: Dynamic Incentives Guide

  • Customize User Experiences with Wallet-Based Personalization: Leverage insights from blockchain interactions to deliver a unique experience for each user. Enhance satisfaction with relevant content and improve onboarding by adapting to individual needs. Learn More: Wallet-Based Personalization Guide

SDK Resources​

Other Resources​

Check out these other pages to learn more about how to get the most out of Wallet Intelligence:

  • Tools Overview - Choose the best access method.
  • Use Cases - Step-by-step Wallet Intelligence use cases.
  • FAQs - Review commonly asked questions.
  • Glossary - Get detailed definitions & methodologies for Wallet Intelligence fields as well as general terminology.
  • Contact Us - See all the different ways to contact our team for support.