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)

Searching Database…

这是什么?它是一个 Python 机器人,监控 Robinhood Chain(chain id 4663)上的领单钱包,并自动把他们的 pons.family 代币成交复制到你自己的钱包。
这是个 CLI 脚本,还是有界面?它是一个 Python CLI 守护进程,同时在 8787 端口提供内置仪表盘,另有一个可选的独立 React 网页界面,与同一个 API 通信。
怎么让它跑起来?运行 `python -m bot` 启动监控器和仪表盘。它默认 DRYRUN=true,会一直模拟交易,直到你明确切换到实盘。
实盘交易前需要准备什么?你需要一个付费 RPC 端点(Alchemy、QuickNode、Chainstack 或 dRPC)和你钱包的私钥——公共 RPC 有限速,一旦关闭 DRYRUN 就会被拒绝。
有它无法复制的交易吗?它会跳过已迁移到 Uniswap v4 路由的毕业 V2 代币,也会跳过 USDG 或代币化股票等所有非 WETH 的报价资产。
我可以配置哪些风险控制?你可以设置按领单者比例或固定 ETH 的买入规模、每笔和每日 ETH 上限、最小领单规模和池子深度、新币保护跳过窗口、冷却时间、代币黑名单、卖出时跟随或清仓的行为,以及滑点容忍度。
机器人怎么检测领单者的交易?它轮询新区块,过滤出你添加的领单地址发出的交易,并从交易回执中解码 Pons V1 的 Uniswap V3 swap 事件或 V2 的 CurveBuy/CurveSell 事件。
这是 Pons 或 Robinhood 的官方产品吗?不是,README 明确说明它不是 Robinhood 券商服务,也不是 Pons 或 Robinhood 的官方产品——它是为你自己的钱包打造的独立社交跟单软件。
Pons V1 和 V2 代币有什么区别?V1 代币通过 SwapRouter02.exactInputSingle 在 Uniswap V3 启动池交易,而 V2 代币使用联合曲线,配有专用的 curve.buy/curve.sell 函数,直到毕业为止。
Creator
0xhamssog
Size
0.1 MB
Stars
160
Updated
CommitSep 09
Age
13y
Commits · 90 Days