FAQs

What's required to get started?

Wallet Intelligence is free to get started! All you need is to create a Thirdwave account and then you can request an API key. All keys come with up to 10K API requests per month. Note that a credit card is requested during account creation but will not be charged - it is purely for security purposes.

The 10K API response limit is not enough for me, how can I request more?

Contact our team to discuss partnership options and higher response limits.

What the different ways I can leverage Wallet Intelligence

There are many different applications for wallet-aware projects to gain value from Wallet Intelligence from analyzing wallet audience segments to understand user quality to real-time integrations to customize the user experience based on onchain value & behaviors. Check out the full set of use cases and step by step instructions here to get started.

I have a feature request - where can I submit it?

You can submit a feature request via the feedback form in the lower right of your API Settings page, and it will be reviewed by our product & engineering team promptly. Alternatively, you can also post feedback in our Telegram channel: @ThirdwaveDevelopers. Submissions via either channel will be reviewed by the product team for prioritization

I've encountered a bug or data issue - where can I submit it?

If you encounter any issues with the data, please submit a bug report via the bug form in the lower right of your API Settings page. Alternatively, you can also seek support in our Telegram channel: @ThirdwaveDevelopers. Submissions via either channel will be sent for review by our engineering team.

Glossary

General terms

Blockchain: A decentralized and distributed ledger technology that securely records transactions and data across a network of computers. In the context of blockchain gaming, it forms the foundation for transparent, secure, and immutable data storage. Blockchains ensure the integrity of in-game assets, player interactions, and economies while enabling trustless environments.

Smart Contract: A self-executing agreement written in code, residing on a blockchain, that automates and enforces predefined conditions. In blockchain gaming, smart contracts power in-game functionalities, manage ownership of digital assets (such as items or characters), execute game rules, and enable decentralized governance within gaming ecosystems.

Dapp (Decentralized Application): A decentralized application that operates without a central authority, utilizing blockchain technology or peer-to-peer networks. In blockchain gaming, dapps offer transparent and secure gaming experiences. They leverage smart contracts to automate game logic, manage in-game economies, and ensure fairness among players.

Wallet: A digital tool for managing public and private keys that enable users to interact with blockchain networks, including accessing, storing, and transferring cryptocurrencies, tokens, and in-game assets. In blockchain gaming, wallets facilitate ownership and seamless transactions of in-game items, currencies, or NFTs across different games or platforms.

Account: A blockchain-specific wallet that’s uniquely represented by an address. The address is a randomly generated string and usually, addresses from different blockchains are in different formats.

ERC-20 Token: A standardized fungible token on the Ethereum blockchain. In blockchain gaming, ERC-20 tokens are utilized for in-game currencies, rewards, or tradable assets. They ensure interoperability, enabling players to use tokens across various games and platforms within the Ethereum ecosystem.

ERC-721 Token (Non-Fungible Token - NFT): A unique and non-interchangeable token standard on the Ethereum blockchain. In blockchain gaming, ERC-721 tokens (NFTs) represent ownership of distinct in-game assets such as collectibles, characters, or rare items. NFTs provide proof of ownership, enabling players to trade or showcase their unique digital possessions.

Value Transfer: Transferring in-game currencies, tokens, or assets between wallets or addresses. Smart Contract Execution: Triggering smart contracts to perform automated actions or enforce predefined rules within the game. Data Modification: Updating in-game records, changing states, or appending information on the blockchain, influencing game progression or item ownership.

Gas (Ethereum): A fee paid for executing operations or smart contracts on the Ethereum blockchain. In blockchain gaming, gas fees ensure the processing and validation of in-game transactions or smart contract executions. They measure the computational effort required and act as a unit for transaction costs on the network.

HODLer: A "hodler" refers to an investor or participant who holds onto their cryptocurrency assets for an extended period, regardless of market fluctuations or short-term price movements. Hodlers typically have a long-term investment strategy and believe in the potential long-term value appreciation of their digital assets, often resisting the temptation to sell during periods of volatility. Hodlers are distinguished by their commitment to accumulating and retaining cryptocurrencies rather than actively trading them.

Thirdwave Field Categories

The Wallet Intelligence API offers four categories of information about wallets:

• Attributes are static characteristics of a wallet that don't change over time. For example, the createdAt attribute is a timestamp when the wallet first transacted on chain.

• Metrics are quantifiable measures that provide insights into a wallet's activity or performance. Standard wallet metrics include spend totalBalance and transactions

• Labels are identifiers that categorize wallets based on their attributes, behaviors, or engagement patterns. Similar to tags, a wallet can have many labels like isBot or playsGames to help developers identify wallets that meet specific criteria.

• Scores are calculated ratings based on custom combinations of attributes, metrics, and labels to help developers make informed decisions based on the wallet's onchain characteristics and actions.

Thirdwave Field Definitions

Created At: A timestamp indicating when the wallet first appeared on any EVM-compliant chain convered by Thirdwave. This value is the earliest value of the transaction timestamps in either firstExpenseTransaction and firstFundingTransaction. It serves as an indicator of the account's maturity and longevity in the ecosystem, often influencing trustworthiness or credibility assessments.

First Expense Transaction: The inaugural transaction executed by a wallet or account. It signifies the initiation point of activity within the account or wallet, often serving as a fundamental marker for analysis, especially in understanding the account's or wallet's historical engagement.

First Funding Transaction: The inaugural transaction received by a wallet or account. It signifies the initiation point of being able to execute transactions by the account or wallet.

Transaction Count: The total number of transactions executed by a wallet or account throughout its lifetime. It's worth noting that this metric only takes into account executed transactions, and excludes received transactions or deposits. This is an important distinction because other tools like Etherscan may include all transactions going in and out of the account while Wallet Intelligence's transaction count is specific to transactions executed by the wallet. This metric can be helpful in understanding a wallet's outgoing transaction history.

Total Balance: The USD value of all native and ERC20 tokens at the time of the wallet’s most recent activity. NOTE: Total Balance will be replaced by Current Balance in an upcoming Q2'24 release which will be communicated through our developer channels. Current Balance reflects the current USD value of all native and ERC20 tokens currently owned by a wallet. This means that it uses the current USD conversion rate for those holdings instead of the USD conversion rate at the time of the wallet's most recent activity with that token. The benefit of this is that you can accurately and fairly compare balances across wallets, as they are all based on the current USD conversion value.

Spend: Quantifies the amount of currency or tokens expended from the wallet or account over a specific period. It sheds light on the account's consumption patterns, providing insights into expenditure behaviors or transactional habits.

Spend Games: The amount of currency or tokens expended from the wallet or account over a specific period on gaming category dapps. This metric provides valuable insights into the individual's spending habits and consumption patterns within the gaming category. For web3 game developers this metric can be particularly valable for identifying gaming whales vs general blockchain whales.

IsBot: This binary indicator serves to classify whether an account or user is deemed a bot or automated entity within the system. It's a critical metric in distinguishing between genuine human-operated accounts and automated or scripted accounts.

Bot Behaviors: Bot behaviors refer to specific actions or patterns typically exhibited by automated or scripted accounts (bots). These actions might include repetitive or scripted transactions, consistent patterns, or behaviors that align with programmed instructions rather than natural human interaction.

• Transaction Velocity: Analyzes transaction rates to detect automated actions beyond human capacity.
• Temporal Activity: Profiles consistent timed activity, identifying automated behavior to safeguard against bot-driven activities.
• Continuous Engagement: Classifies uninterrupted and perpetual engagement, distinguishing genuine user interactions from automated engagements, bolstering platform security against disruptive bot activities.
• Funding Network: Flags wallets that have been initially funded by sources associated with multiple, high-confidence bot wallets. Bot wallets require funding to cover gas fees for transaction execution. Typically, bot operators exclusively use specific wallets and contracts to finance their operations. The functionality aims to precisely identify and exclude funding originating from centralized exchanges. An advantage of this bot behavior is that it can detect wallets that are bots with very few or even no transactions.

HODLer Score: a powerful tool that helps you evaluate a wallet's tendency to hold or sell NFTs, providing valuable insights into its trading behavior. The score ranges from 0 to 100, with 0 indicating that the wallet owner typically sells all NFTs immediately, while a score of 100 denotes that the wallet typically is still holding all its NFTs. This score is essential for assessing long-term engagement in NFT projects, as it helps you identify and reward loyal project holders. A high hodlerScore indicates sustained participation, which can aid in decision-making regarding rewards and additional features within NFT ecosystems. With daily updates, hodlerScore provides real-time data that can inform your strategic decisions and keep you ahead of the game.