pons-copy-trading-bot README

The project's README from github.com/0xhamssog/pons-copy-trading-bot. As one markdown file: README.md.

pons.family copy trader (Robinhood Chain)

Python bot that watches leader wallets on Robinhood Chain (chain id 4663) and copies their pons.family fills.

It is not Robinhood brokerage Social copy-trading and not an official Pons or Robinhood product. Every live fill spends ETH from your wallet. Tokens can go to zero.

What it copies

Venue How a leader fill is seen How the bot copies
Pons V1 Uniswap V3 Swap on the launch pool SwapRouter02.exactInputSingle (WETH pairs)
Pons V2 Bonding-curve CurveBuy / CurveSell curve.buy / curve.sell

Graduated V2 Uniswap v4 routing is not enabled. Non-WETH quote assets (USDG, tokenized stocks) are skipped.

Quick start

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
copy .env.example .env
python -m bot.smoke
python -m bot

Dashboard: http://127.0.0.1:8787

DRY_RUN=true (default) paper-trades only. Leave PRIVATE_KEY empty for watch-only mode.

Live fills require a paid RPC. The public endpoint is rate-limited and will be rejected when DRY_RUN=false.

Paste an Alchemy key (Robinhood's recommended provider) or any HTTPS RPC:

ALCHEMY_API_KEY=your_alchemy_key
DRY_RUN=false
PRIVATE_KEY=0x...

That expands to:

QuickNode / Chainstack / dRPC work the same way via PAID_RPC_URL and WS_URL. Public RPC stays as a read failover only. Broadcasts never go through the public node.

Create an Alchemy app: dashboard.alchemy.com → Robinhood Chain mainnet (4663).

Follow a wallet

Add leaders in the dashboard, or seed .env:

TARGET_WALLETS=0xLeaderOne...,0xLeaderTwo...

The watcher polls new blocks, keeps transactions from those addresses, and decodes Pons V1/V2 events from the receipt.

Risk controls

State lives in data/store.json (shared schema with the TypeScript bot if you still run that).

Commands

Command Purpose
python -m bot watcher + dashboard
python -m bot.smoke RPC + PONS token sanity check
python -m bot.replay decode a recent PONS pool swap
pytest sizing / risk / event decode tests

Optional React UI (same API): npm install then npm run dev:web while the Python bot is on port 8787.

Contracts (Robinhood Chain)

RPC: paid provider for live trading (Alchemy / QuickNode / Chainstack / dRPC); public https://rpc.mainnet.chain.robinhood.com is fallback for reads only. Explorer: robinhoodchain.blockscout.com

This is software for your own wallet. It is not financial advice.

pons-copy-trading-bot (0xhamssog/pons-copy-trading-bot)

crypto-trading
Searching Database…

160 ·GitHub
Pons-copy-trading-bot
What is this?It is a Python bot that watches leader wallets on Robinhood Chain (chain id 4663) and automatically copies their pons.family token fills into your own wallet.
Is this a CLI script or does it have a UI?It's a Python CLI daemon that also serves a built-in dashboard on port 8787, plus an optional separate React web UI that talks to the same API.
How do I get it running?Run `python -m bot` to start the watcher and dashboard. It defaults to DRYRUN=true so it paper-trades until you explicitly go live.
What do I need before trading live?You need a paid RPC endpoint (Alchemy, QuickNode, Chainstack or dRPC) and your wallet's private key — the public RPC is rate-limited and gets rejected once DRYRUN is turned off.
Are there trades it can't copy?It skips graduated V2 tokens that have moved to Uniswap v4 routing and skips any non-WETH quote assets like USDG or tokenized stocks.
What risk controls can I configure?You can set percent-of-leader or fixed ETH buy sizes, per-trade and daily ETH caps, minimum leader size and pool depth, a launch-protection skip window, cooldowns, a token blacklist, mirror-or-flatten behavior on sells, and slippage tolerance.
How does the bot detect a leader's trade?It polls new blocks, filters transactions from the leader addresses you add, and decodes Pons V1 Uniswap V3 swap events or V2 CurveBuy/CurveSell events from the transaction receipt.
Is this an official Pons or Robinhood product?No, the README explicitly says it is not Robinhood brokerage and not an official Pons or Robinhood product — it's independent social copy-trading software for your own wallet.
What's the difference between Pons V1 and V2 tokens?V1 tokens trade on a Uniswap V3 launch pool via SwapRouter02.exactInputSingle, while V2 tokens use a bonding curve with dedicated curve.buy/curve.sell functions until they graduate.
What are similar projects?pons-sniper-bot, robinhood-trading-tools, rh-swap, robinhood-lp-bot, robinhood-meme-token-stock-launchpad, Trpjan-solana-trading-toolkit, nuvex-services, stellar-trade
Which topics is it in?robinhood-chain, evm, crypto-trading, dapp, defi, wallet, trading-bot, algorithmic-trading, crypto, smart-contracts, bot, cryptocurrency
Creator
0xhamssog
Size
0.1 MB
Stars
160
Updated
CommitSep 09
Age
13y
Commits · 90 Days