BaseGemScanner

Early-stage Base token discovery engine.

BaseGemScanner continuously monitors newly deployed Base tokens, tracks wallet activity, applies liquidity and momentum filters, and generates an Early Alpha Feed.

---

Overview

The scanner is designed to identify promising newly launched Base tokens before they become widely visible.

Output from the scanner is exposed through an API and consumed by the Arc Nanopayments gateway.

Architecture:

New Token ↓ tokenTracker.js ↓ signalEngine.js ↓ tracked_tokens.json token_history.json ↓ alphaFeed.js ↓ alphaApi.js ↓ GET /api/alpha/early

---

Core Data Sources

tracked_tokens.json

Main token registry.

Contains:

• token name
• symbol
• contract address
• creator
• launch timestamp

Used as the source of truth for discovered tokens.

---

token_history.json

Stores historical snapshots for each token.

Contains:

• market cap
• liquidity
• volume
• conviction score
• momentum score
• rug risk score
• signal stage

This file powers Early Watch detection.

---

wallet_scans.json

Wallet monitoring results.

Contains:

• smart wallet activity
• wallet conviction
• wallet entries

Used to enrich token scoring.

---

Key Files

src/tokenTracker.js

Tracks newly launched Base tokens.

Responsibilities:

• discover tokens
• update tracked_tokens.json
• maintain token registry

---

src/signalEngine.js

Core scoring engine.

Calculates:

• conviction score
• momentum score
• rug risk
• signal stage

Produces:

• STAGE_1_EARLY_DETECT
• EARLY WATCH

---

src/alphaFeed.js

Generates the Early Alpha Feed.

Reads:

• tracked_tokens.json
• token_history.json

Filters:

• STAGE_1_EARLY_DETECT
• momentum threshold
• liquidity threshold

Returns:

• newest early opportunities
• ranked alpha candidates

---

src/alphaApi.js

Public API server.

Endpoint:

GET /api/alpha/early

Returns:

{
  "package": "Early Alpha Feed",
  "price": "0.002 USDC",
  "count": 9,
  "tokens": [...]
}

---

Example Feed

{
  "symbol": "VVVELLUM",
  "name": "Venice Vellum",
  "score": 80,
  "marketCap": 38844,
  "liquidity": 36040,
  "stage": "STAGE_1_EARLY_DETECT"
}

---

Integration

This feed is consumed by:

https://github.com/ekervo/arc-nanopayments

Users pay:

0.002 USDC

to unlock premium Early Alpha Feed access via Arc x402 payments.

---

Tech Stack

• Node.js
• Express
• Base
• JSON storage
• Arc x402 Integration