Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

PigCanFly1001/unitytool-agent-radar

Finance

Self-hosted dashboard tracking BSC wallets holding Binance Agent IDs, with trade logs, alerts and token audits.

104
36
JavaScript
NOASSERTION
2 days old

What it does

Agent Radar is a self-hosted web dashboard for watching AI-agent wallets on BNB Smart Chain. It indexes every wallet that holds a Binance Agent ID — the .ai identity NFT — and records what those wallets buy, sell, mint and claim. The main view ranks projects by the number of distinct agent wallets active in a chosen time window and streams activity in real time.

Per-project pages combine market data, launch progress, an agent trade log, activity rhythm by action type, the most active wallets and alert history. Token audits summarise team holdings, team sells, liquidity ownership, contract privileges, token-holding contracts, sell simulation and third-party security data into High/Medium/Low risk; any BSC token can be audited on demand. Wallet pages provide profit and activity leaderboards plus per-wallet P&L. Projects, wallets and audits each get a shareable link that renders a preview card when posted to Discord, Telegram or X, and Agent ID holders resolve to their .ai names.

It fits people who want to observe on-chain agent behaviour and token risk on BSC and are willing to run their own node-backed service.

Quick start

Requires Node.js 22.5 or newer; the project has zero npm dependencies and uses built-in SQLite.

cp config.example.json config.json   # edit RPCs if you like
node server/index.js                 # → http://127.0.0.1:8096

Alternatively deploy with Docker from the same directory:

cp config.example.json config.json
docker compose up -d --build

Open the printed address, pick a time window on the live board, and you should see ranked projects and the activity feed. Health checks are served at GET /healthz. For public HTTPS access, put Caddy or Nginx in front of port 8096, disable proxy buffering for Server-Sent Events, and set TRUST_PROXY=1 so rate limits apply per real client IP.

Configuration lives in config.json or environment variables: listen address (PORT/HOST), SQLite path (DB_PATH), BSC RPC endpoints (BLOCK_RPCS/LOGS_RPCS), the optional archive RPC (HOLDER_RPCS), GMGN_API_KEY for icons and socials, branding fields, PUBLIC_URL for preview cards, and rate/SSE limits. Preview card images need a TrueType font via OG_FONT/OG_FONT_BOLD; the Docker image ships none.

Constraints

  • Without a HOLDER_RPCS archive endpoint (with your own key), only recent history is replayed, so holder lists and .ai name resolution stay partial.
  • SSE connections need proxy buffering disabled, and behind a proxy the client IP must be forwarded with TRUST_PROXY=1.
  • Licensing is source-available, not open source: the UnityTool Non-Commercial Source License 1.0 permits personal, non-commercial running, study and modification, but forbids commercial use and AI/ML training without written permission. Branding in the top bar must stay visible.
  • The project presents itself as an information tool, not financial advice.

HotRepo's take

The repository appeared on the HotRepo new-project list on 2026-11-05 with 104 stars and 36 forks, gaining 2 stars in a one-hour window from 14:45 to 15:45 UTC. The fork-to-star ratio is high for that short observation, which is notable for a self-hosted dashboard under a restrictive non-commercial license; with only one recorded window there is no basis for calling it a trend. The technical claim worth weighing is the holder-completeness trade-off: the default setup runs without an archive RPC but only replays recent history, so anyone expecting full wallet coverage should budget for an archive endpoint key.

Project source and documentation

Written by AI from the project's README, updated . The project's own docs are the source of truth.