Welcome to LENS

LENS is a Chrome extension that injects on-chain intelligence directly into Twitter/X profiles. See wallet data, dev activity, and community tags without leaving the page.

i LENS currently supports Base chain only. Multi-chain support is on the roadmap.

What is LENS?

When you open any Twitter/X profile, LENS automatically scans the bio for wallet addresses, contract addresses, and GitHub links then pulls real on-chain data and displays it directly under the profile.

No tab switching. No copy-pasting addresses into block explorers. Everything you need to evaluate a wallet or dev is shown instantly.

Core Features

Dev Claim Fee

Track every time a dev claims fees from their contract. Know if funds went to an exchange.

BASE CHAIN

Deploy Count

See how many contracts this address has deployed. Serial deployers get flagged automatically.

ON-CHAIN

Smart Wallet Buys

Every token a wallet has bought. Copy trade KOLs directly from their profile.

COPY TRADE

CA History

Every CA ever posted in their bio including deleted ones with peak mcap.

BIO INTEL

Next Installation →

Installation

Install LENS in under 30 seconds from the Chrome Web Store. No account required, no wallet connection needed.

Chrome Web Store (Recommended)

1

Open Chrome Web Store

Visit the LENS page on Chrome Web Store. Search for "LENS on-chain" or use the direct link from the homepage.

2

Click "Add to Chrome"

Click the blue "Add to Chrome" button. A permissions dialog will appear LENS only requests access to x.com.

3

Confirm permissions

LENS requires access to x.com only. No other sites are accessed. Click "Add extension" to confirm.

4

Open any Twitter/X profile

Navigate to any profile on Twitter/X. LENS will automatically activate and display the intel panel under their profile info.

Manual Install (Developer Mode)

! Manual installation is for developers only. Use the Chrome Web Store for the most secure experience.

        # Clone the repository
        git clone https://github.com/lens-extension/lens

        # Install dependencies
        cd lens && npm install

        # Build the extension
        npm run build
        BASH
      

Then open chrome://extensions, enable Developer Mode, click "Load unpacked" and select the /dist folder.

Permissions Explained

Permission	Why it is needed
`x.com`	Read profile bios to detect wallet addresses and CAs
`storage`	Cache community tags locally for faster load

+ LENS never reads your DMs, posts, or any private data. It only reads public profile information.

Previous ← Introduction Next Dev Claim Fee →

Quick Start

Get LENS running and understand the UI in under 2 minutes.

Reading the Panel

Once installed, open any Twitter/X profile. Under the profile bio, LENS injects a dark panel with several sections:

┌─ LENS ─────────────────── SCAN COMPLETE ─┐
│ Labels: [KOL] [Dev] [Scammer · 47 flags] │
│ Wallets: Linked 3 | Mentioned 8          │
│ History: CA 12 | Bio 29 | Profile 4      │
├──────────────────────────────────────────┤
│ Dev Claim Fee 7x · $28,400 · To CEX │
│ Contracts 23x on Base · Serial Dev │
│ CA History 12 tokens · 9 deleted │
│ GitHub 47 repos · active 2d ago │
│ Username 4 changes │
├──────────────────────────────────────────┤
│ 903 Smart Followers expand │
└──────────────────────────────────────────┘
        UI LAYOUT
      

Understanding Labels

Label	Meaning	Source
`KOL`	Key Opinion Leader high follower count with on-chain activity	Automated
`Dev`	Has deployed contracts on Base	On-chain
`Whale`	Wallet net worth over $100K	On-chain
`Scammer`	Flagged by community members	Community
`DNF`	Do Not Follow manually tagged	Community

Previous ← Installation Next Dev Claim Fee →

Dev Claim Fee

Track every time a developer claims fees from their token contract on Base chain. One of the most powerful sell signals in crypto.

! Dev claim fee tracking is available for Base chain only in v1.0.0.

How it works

Most ERC-20 tokens on Base include a fee mechanism. When trades happen, a small percentage goes to the developer's contract. The dev can then call a claimFees() or similar function to withdraw accumulated fees to their wallet.

LENS monitors all such transactions on Base. When a wallet in someone's bio has claimed fees, LENS displays the full history inline.

What LENS shows

Field	Description
Total Claims	How many times fees have been claimed across all contracts
Total Amount	USD value of all fees claimed
Last Claim	When the most recent claim occurred
Destination	Where claimed funds were sent wallet or CEX
CEX Flag	Red flag if funds went directly to a centralized exchange

Red flags to watch for

! If claimed funds go directly to a known CEX address, this is a strong sell signal. The dev is likely converting fees to fiat.

Previous ← Quick Start Next Deploy Count →

Deploy Count

See how many smart contracts a wallet address has deployed on Base chain and get automatic risk flags for serial deployers.

Serial Deployer Detection

LENS automatically labels wallets that have deployed more than 5 contracts as Serial Dev. This does not mean they are malicious but it is a signal worth investigating.

Deploy Count	Label	Risk Level
1 - 2	New Dev	Low
3 - 5	Active Dev	Moderate
6 - 15	Serial Dev	Watch
15+	High Volume Dev	High

Previous ← Dev Claim Fee Next Smart Wallet Buys →

Smart Wallet Buys

See every token a wallet has purchased, sorted by profit. Copy trade KOLs and smart money directly from their X profile.

What counts as a buy

LENS tracks all ERC-20 swap transactions on Base where the wallet received tokens. Each token shows:

Field	Description
Token Name	Symbol and contract address
P&L	Estimated profit or loss in USD
Buy Date	First purchase timestamp
Top 10	Badge if wallet was in top 10 early buyers

Previous ← Deploy Count Next CA History →

CA History

Track every contract address ever posted in a Twitter/X bio including ones that have been deleted.

How bio tracking works

LENS indexes Twitter/X bios daily. Every time a CA appears in a bio, it is logged with a timestamp. When the CA disappears from the bio, it is marked as "Deleted" but never removed from LENS records.

i Bio snapshots are taken every 24 hours. There may be up to a 24-hour delay before a new CA appears in LENS history.

Previous ← Smart Wallet Buys Next GitHub Intel →

GitHub Intel

If a Twitter/X profile links to a GitHub account, LENS automatically fetches and displays repository intelligence.

What is fetched

Field	Source
Repository count	GitHub public API
Primary languages	GitHub public API
Last commit date	GitHub public API
Total stars	GitHub public API
Contract cross-reference	LENS on-chain matching

+ GitHub Intel uses the free public API. No authentication is required and no rate limits apply for basic profile data.

Previous ← CA History Next Community Tags →

Username History

See every username a Twitter/X account has ever used. Scammers frequently change handles to escape their reputation.

How username tracking works

LENS maintains a historical index of Twitter/X usernames mapped to account IDs. When a username changes, the old username is preserved in LENS records permanently.

This means even if someone changes their handle, anyone viewing their profile through LENS will see their full name history.

Previous ← GitHub Intel Next Community Tags →

Community Tags

A crowdsourced reputation system. Any LENS user can tag any Twitter/X account and every other LENS user sees the warning instantly.

Available Tags

Tag	Category	Description
`Scammer`	Red	Known scammer verified by multiple users
`Rugpull`	Red	Has rugged a token previously
`Serial Rugger`	Red	Multiple confirmed rugpulls
`Honeypot Dev`	Orange	Deployed honeypot contracts
`Fee Drainer`	Orange	Excessively claims fees
`Suspicious`	Yellow	Unverified suspicious behavior
`Legit Dev`	Green	Verified legitimate developer
`Based Dev`	Green	Community-trusted developer
`KOL`	Blue	Key Opinion Leader
`Whale`	Blue	High net worth wallet
`Builder`	Blue	Active builder in the ecosystem

Tag voting

Tags require a minimum of 3 user confirmations before being displayed publicly. This prevents spam tagging. Tags with more votes are shown more prominently.

! False or malicious tagging will result in your LENS account being banned from the community tagging system.

API Overview

The LENS API provides programmatic access to wallet intelligence, contract data, and community tags.

i The LENS API is currently in beta. Endpoints may change. All requests require an API key.

Base URL

https://api.lens.so/v1
        BASE URL
      

Authentication

All API requests require an Authorization header with your API key:

Authorization: Bearer lens_sk_xxxxxxxxxxxxxxxx
        HEADER
      

Rate Limits

Plan	Requests/min	Requests/day
Free	10	1,000
Pro	100	50,000
Enterprise	Custom	Unlimited

Previous ← Community Tags Next Wallet Endpoints →

Wallet Endpoints

Query wallet intelligence data including holdings, history, and on-chain activity.

GET /wallet/{address} Get full wallet profile

Returns complete wallet data including token holdings, net worth, chain activity, and labels.

GET /wallet/0x1a2b3c4d5e6f...

// Response
{
  "address": "0x1a2b3c4d...",
  "net_worth_usd": 284000,
  "labels": ["KOL", "Dev"],
  "chain_activity": ["base", "ethereum"],
  "wallet_age_days": 847
}
            JSON
          

GET /wallet/{address}/buys Get token purchase history

Returns all token purchases sorted by profit/loss.

// Query params
chain=base // Filter by chain
limit=50 // Max results (default 20)
sort=pnl_desc // Sort by P&L descending
            PARAMS
          

Previous ← API Overview Next Contract Endpoints →

Contract Endpoints

Query contract deployment history and fee claim activity on Base chain.

GET /contract/{address}/claims Get fee claim history

// Response
{
  "contract": "0xabc...",
  "total_claims": 7,
  "total_usd": 28400,
  "last_claim": "2026-06-10T08:22:00Z",
  "claims": [
    {
      "date": "2026-06-10",
      "amount_usd": 8200,
      "destination": "0x9f2a...CEX",
      "cex_flag": true
    }
  ]
}
            JSON
          

GET /deployer/{address} Get all contracts deployed by address

// Response
{
  "deployer": "0x1a2b...",
  "total_contracts": 23,
  "risk_label": "Serial Dev",
  "contracts": [...]
}
            JSON
          

Previous ← Wallet Endpoints Next Tags Endpoints →

Tags Endpoints

Read and write community tags programmatically.

GET /tags/{twitter_username} Get tags for a Twitter username

// Response
{
  "username": "cryptodevalex",
  "tags": [
    { "tag": "Scammer", "votes": 47, "category": "red" },
    { "tag": "Serial Rugger", "votes": 23, "category": "red" }
  ]
}
            JSON
          

POST /tags Submit a new tag

// Request body
{
  "twitter_username": "cryptodevalex",
  "tag": "Scammer",
  "evidence_url": "https://..."
}
            JSON
          

Previous ← Contract Endpoints Next FAQ →

FAQ

Frequently asked questions about LENS.

Is LENS free?v

Yes. The Chrome extension is completely free. An API tier will be available for developers who want programmatic access to LENS data.

Which chains does LENS support?v

LENS currently supports Base chain for all on-chain features (dev claim fee, deploy count). Ethereum, BSC, and Arbitrum are on the roadmap for future releases.

Does LENS access my wallet or private keys?v

No. LENS never asks for wallet access or private keys. It is a read-only tool that only reads public on-chain data and public Twitter/X profile information.

Can I tag someone incorrectly or as a joke?v

Tags require a minimum vote threshold before going public, and abusive tagging will result in your account being banned from the community tag system. All tags are moderated by the LENS team.

How often is data updated?v

On-chain data (claims, deploys) is updated in near real-time via blockchain indexing. Bio and CA history snapshots are taken every 24 hours. Community tags are updated instantly.

How do I report a false tag?v

Anyone can dispute a tag from the LENS extension UI. Click on the tag, select "Dispute", and submit evidence. Disputed tags are reviewed by the LENS moderation team within 48 hours.

Is LENS open source?v

Yes. The extension source code is fully open source on GitHub. You can verify exactly what data is read and how it is used.

Previous ← Tags Endpoints Next Changelog →

Changelog

Release history and updates for LENS.

v1.0.0 June 2026

+ Initial public release.

First public release of LENS Chrome Extension.

Dev Claim Fee tracking on Base chain
Contract deploy count with serial dev detection
Smart wallet buys and P&L display
CA History with deleted CA tracking
GitHub intel integration
Username history tracking
Community tags system with voting
Smart Followers count

Previous ← FAQ