Overview

This API provides categorized audience and holders 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.

Parameter	Type	Description
address	string	Blockchain address of ERC-20 token or smart contract.

---

Category Definitions

On-Chain Entities: Individual Users

1

Trading Bot

Automated scripts executing repetitive trades or interactions (e.g., arbitrage, liquidations).

2

DeFi Maxi

Persistent DeFi participants (human or bot) with diverse cross-protocol engagement.

3

Crypto Native

Experienced, diverse users with manual on-chain activity.

4

Retail

Standard users exploring DeFi without automation or specialization.

5

Degen

Risk-tolerant users engaging with new tokens, mints, or speculative protocols.

6

Linked Wallet

Users creating wallets for airdrops or campaign-specific farming.

7

Bounded Wallet

Single-contract-focused wallets (sybils, insiders, custodians, or deposit addresses).

---

On-Chain Entities: Organizations

1

Apps

Smart contracts or multisigs of CEXs, dApps, custodians, etc.

2

Tokens

ERC-20, LP, or NFT contracts emitting transfer events.

---

Summarized Categories Definitions

High-level segmentation combining individual and organizational classes into three macro-categories.

Category	Description
Enterprise	Includes dApps and token contracts directly interacting with the target contract. Represents protocol-level or organizational entities.
Speculative	Includes Trading Bot, DeFi Maxi, 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.