Skip to content

openpulsechain/public

Repository files navigation

OpenPulsechain

Open-source analytics platform for PulseChain.

Live: openpulsechain.com · Dune: Bridge Analytics

Not affiliated with PulseChain, PulseX, or any related entity. Data is for informational purposes only — not financial advice.


What's included

Module Description
Dashboard 16-page web app: Overview, DEX, Tokens, Bridge, Whales, Intelligence, Safety, Alerts, Smart Money, Leagues, Heart Law, Wallet Profiles, Token Safety, MCP/API, Privacy
Token Safety API FastAPI with 25 public endpoints: safety scores, scam radar, deployer reputation, smart money, wallet analysis, leagues, bridge stats, funding trees
REST API FastAPI with 12 endpoints: tokens, prices, history, pairs, market overview, safety proxies
MCP Server Model Context Protocol server with 20 tools for AI assistants
Chrome Extension Token safety scores, transaction guard, portfolio tracker, scam alerts
Indexers 23 Python cron jobs collecting on-chain data every 5-15 min
Dune 9 SQL queries + 20 visualizations for bridge analytics (Ethereum-side)

Features

Analytics Dashboard

  • Overview — PLS price, chain TVL, gas estimates, token prices table
  • DEX Analytics — PulseX daily volume, liquidity, top 30 trading pairs
  • Token Explorer — 2500+ browsable tokens with pagination, search, price history charts
  • Bridge Monitor — OmniBridge + Hyperlane: daily flows, cumulative net flow, whale alerts, TVL by token
  • Whale Tracker — Top holders, cross-token analysis, funding clusters, connection graph
  • Leagues — Holder tier rankings for PLS, PLSX, HEX, INC, updated every 6 hours
  • Heart Law — Educational AMM price simulator for PulseX pools

Security & Intelligence

  • Token Safety Scanner — Composite score (0-100, grade A-F) based on honeypot detection, contract analysis, LP health, holder concentration, token age
  • Scam Radar — Automated alerts for LP removals and whale dumps, scanning every 30 minutes
  • Deployer Reputation — Serial rugger detection: analyzes deployer's token history, dead token ratio
  • Smart Money Tracker — Large swaps on PulseX, top wallets by volume, auto-refresh every 60s
  • Wallet Profiler — Token holdings + swap activity for any address
  • Market Intelligence — AI-analyzed Twitter sentiment, risk conclusions, action detection

Chrome Extension

  • Transaction Guard — Intercepts swaps on PulseX, 9mm, Piteas and warns about risky tokens before signing
  • Safety Scanner — Browse all analyzed tokens with safety scores, grades, and sub-score details
  • Portfolio Tracker — Track wallet balances with sparkline charts
  • Scam Alerts — Real-time notifications for critical scam detections

Data

  • 2,500+ tokens discovered from PulseX Subgraph
  • 463K+ price records (daily, since May 2023)
  • 231K+ bridge transfers (OmniBridge + Hyperlane)
  • 100% sovereign token prices from PulseX derivedUSD — no CoinGecko dependency for PulseChain tokens

Architecture

PulseX Subgraph ──┐
DefiLlama API ────┤
PulseChain RPC ───┤──> Python Indexers ──> PostgreSQL (RLS)
Blockscout API ───┘                            │
                                     ┌─────────┼──────────┐
                                     │         │          │
                                React SPA  REST API   Safety API
                                     │                    │
                                Dashboard         safety.openpulsechain.com
                              16 pages + MCP      25 public endpoints
                                     │
                             Chrome Extension

Project Structure

/
  frontend/              # React dashboard (16 pages)
  api/                   # REST API FastAPI (tokens, prices, pairs)
  token_safety/          # Safety API FastAPI (scores, scam radar, deployer, smart money, leagues)
  indexers/              # 23 Python cron jobs (on-chain data collection)
  live_cache/            # Real-time token pool cache (DexScreener)
  mcp-server/            # MCP server for AI assistants (20 tools)
  extension/             # Chrome browser extension
  dune/                  # SQL queries for Dune Analytics
  docs/                  # Documentation

Getting started

git clone https://github.com/openpulsechain/openpulsechain.git
cd openpulsechain
Module Setup
frontend/ npm install && npm run dev
indexers/ pip install -r requirements.txt + .env config
api/ pip install -r requirements.txt && uvicorn main:app
token_safety/ pip install -r requirements.txt && uvicorn main:app
mcp-server/ npm install && npm run build
extension/ npm install && npm run build → load dist/ in Chrome

Data sources

Data Source Access
Token prices (PulseChain) PulseX Subgraph derivedUSD Public
TVL, DEX volume DefiLlama API Public
Gas price, blocks PulseChain RPC Public
Bridge events (ETH-side) Dune Analytics Public (2500 credits/mo)
Bridge events (PLS-side) PulseChain OmniBridge Subgraph Public
Hyperlane transfers Hyperlane Explorer API Public
Contract analysis PulseChain Scan API (Blockscout v2) Public
Honeypot detection FeeChecker contract (on-chain simulation) On-chain
Token logos PulseX CDN, Piteas GitHub, DexScreener Public

License

MIT

About

Open-source PulseChain analytics platform — token prices, safety scoring, smart money tracking, holder leagues, bridge stats. REST API + MCP server for AI agents.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors