Overview
This API provides a personalization toolkit with categorized audience and holder insights for any smart contract or ERC-20 token address across indexed EVM chains (Ethereum, BNB, Arbitrum, Optimism, Base, Polygon, opBNB). It uses indexed on-chain activity and returns segmented audience metrics based on behavioral and relational patterns.
Applications
On-chain risk assessment
Portfolio signals
Trading insights
Yield insights
Incentives management
Input Parameters
Users send the blockchain address (target) of any smart contract or ERC-20 token.
The API returns categorized audience data, showing what type of on-chain entities interact with the contract and how intensively.
address
string
Blockchain address of ERC-20 token or smart contract.
Category Definitions
Trading Bot
Automated trading wallets.
DeFi Bot
DeFi bot or advanced users showing persistent multi-contract activity.
Linked Bot
Automated behavior and significant bond with the target contract.
Crypto Native
Experienced, diverse human users (non-automated).
Retail
Common users, low diversity and without automation.
Degen
Risk-tolerant, highly active users.
Linked Wallet
Wallets that have strong connection with the target address but have other interests as well.
Isolated Wallet
Wallets that have significant but isolated activity within the target contract.
Bounded Wallet
Wallets that are extremely tied to the target contract.
App
On-chain infrastructure applications, like DEX routers or bridges, without strong target contract relation.
CEX/Deposit
CEX, deposits or payment providers.
Custodian
Wallets/Contracts with purpose of holding/managing target contract tokens.
DeFi Protocol
DeFi applications like Vaults and DEX pools, related to the target contract.
Token
ERC-20, NFT, and vault contracts without strong target contract relation.
Summarized Categories Definitions
High-level segmentation combining individual and organizational classes into three macro-categories.
Enterprise
Includes dApps and token contracts directly interacting with the target contract. Represents protocol-level or organizational entities.
Speculative
Includes Trading Bot, DeFi Bot, Linked Bot, Isolated and Bounded Wallet. Represents automated or reward-driven behaviors (arbitrage, sybils, insiders). For stablecoins/top alts, may represent custodial/payment addresses.
Organic
Includes Crypto Native, Degen, Retail, and Isolated Wallet. Represents real human user activity of varying sophistication and risk tolerance.
Last updated