Autonomous B20 token
risk agent on Base

Headless JSON API. No UI. No paid providers. Score every B20 token against contract age, holder concentration, liquidity ratios, and known hook patterns.

autoshard — live contract scan
$ # initiate WETH scan on Base mainnet
$ curl -X POST http://127.0.0.1:8080/scan \
    -H 'Content-Type: application/json' \
    -d ‘{"address":"0x4200...0006","chain":"base"}'

// response
{
  "address":   "0x4200000000000000000000000000000000000006",
  "symbol":    "WETH",
  "risk_score": 92.0,
  "classification": "safe",
  "factors": {
    "contract_age": 2847193,
    "top_holder_pct": 12.4,
    "liquidity_locked": true
  },
  "reasons": ["mature contract", "distributed holders"]
}
autoshard — token contract
chain      base
    

What is AutoShard?

An autonomous risk analysis agent purpose-built for Base B20 tokens. It runs headless, returns JSON, and never asks for an API key.

Autonomous B20 token risk agent

Continuously scans and scores B20 tokens on Base mainnet without manual intervention.

🔷
Runs on Base mainnet

Native to Base. Uses standard JSON-RPC with chain-aware headers.

🔌
Headless JSON API

Four endpoints. Structured responses. Drop into any agent, CI pipeline, or bot.

🚫
No UI

No dashboard. No frontend. No dependencies beyond Python stdlib.

💰
No paid providers

Uses public Base RPC. No Alchemy, no Infura, no subscriptions.

🪣
SQLite-backed ledger

Persists every scan locally. Export, replay, or rebuild scores at any time.

Four steps from bytecode to risk score.

Everything runs locally. No cloud. No black box.

1

Fetch Contract

Pulls contract metadata and holder data via Base JSON-RPC.

2

Analyze Bytecode

Inspects opcodes and selectors for known risk patterns.

3

Detect Risk Patterns

Scores contract age, holder concentration, liquidity gaps, and hooks.

4

Return JSON Response

Outputs deterministic score with breakdown, classification, and reasons.

Built for agents. Designed for humans.

Everything you'd expect from production risk infrastructure, none of the bloat.

🤖

Autonomous analysis

Runs unattended. Schedule via cron or trigger on-chain events.

🔎

Bytecode inspection

Reads selectors, parses opcodes, flags suspicious patterns.

🪝

Hook detection

Identifies pause, mint, fee-setting hooks and other admin surfaces.

📊

Transparent risk scoring

Deterministic deltas. No ML. Scoring rules fully documented.

🔗

Headless JSON API

REST over HTTP. Language-agnostic. Works with curl, Python, TS, Rust.

🌐

Open source

MIT licensed. Inspect, fork, extend. Community-driven.

🔷

Base-native

Optimized for Base mainnet and Base Sepolia. Chain-aware.

📦

Lightweight infrastructure

Pure Python. Single file. stdlib only. ~200 lines.

🗄️

SQLite ledger

Local-first persistence. Export JSON. Query history at any time.

One API. Any client.

Integrates cleanly into any stack that can make an HTTP request.

Wallets
AI Agents
Trading Bots
Launchpads
AutoShard API
Base Mainnet RPC
Clients → AutoShard → Chain

Four endpoints. One philosophy.

Every response is JSON. Every field is documented. No auth required.

# scan a token $ curl -X POST http://127.0.0.1:8080/scan \ -H 'Content-Type: application/json' \ -d '{"address":"0x4200000000000000000000000000000000000006","chain":"base"}' // response { "address": "0x4200000000000000000000000000000000000006", "name": "Wrapped Ether", "symbol": "WETH", "risk_score": 92.0, "classification":"safe", "last_scanned": "2025-06-26T17:42:11Z", "factors": { "contract_age": 2847193, "top_holder_pct": 12.4, "has_liquidity": true, "hooks": [] }, "reasons": ["mature contract", "distributed holders"] } # other endpoints $ curl http://127.0.0.1:8080/health $ curl http://127.0.0.1:8080/ledger $ curl -X POST http://127.0.0.1:8080/refresh
GET
/health
Service status
POST
/scan { address, chain? }
Score a single token
GET
/ledger
Full token ledger with scores
POST
/refresh
Recompute scores without RPC

Transparent by design.

AutoShard is MIT licensed. The detection logic is public, documented, and community-driven.

MIT Licensed

Use it, fork it, ship it. No restrictions, no gating.

Transparent Detection Logic

Every deduction is hardcoded in SKILL.md. No hidden weights.

Community-Driven

Built on Base. Improved by the community. PRs welcome.

Ready to integrate?

AutoShard is the risk layer for Base B20. Four endpoints. Zero friction.