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…

160 ·GitHub
Pons-copy-trading-bot
Что это?Это Python-бот, который следит за кошельками лидеров в Robinhood Chain (chain id 4663) и автоматически копирует их сделки с токенами pons.family в ваш собственный кошелёк.
Это CLI-скрипт или у него есть UI?Это CLI-демон на Python, который также раздаёт встроенную панель на порту 8787, плюс опциональный отдельный веб-UI на React, работающий с тем же API.
Как его запустить?Выполните `python -m bot`, чтобы запустить наблюдатель и панель. По умолчанию задан DRYRUN=true, так что бот ведёт бумажную торговлю, пока вы явно не перейдёте на реальную.
Что нужно перед реальной торговлей?Нужен платный RPC-эндпоинт (Alchemy, QuickNode, Chainstack или dRPC) и приватный ключ вашего кошелька — публичный RPC ограничен по частоте запросов и отклоняется, как только DRYRUN выключен.
Есть ли сделки, которые он не может скопировать?Он пропускает «выпускные» V2-токены, перешедшие на маршрутизацию Uniswap v4, и любые котируемые активы, кроме WETH, например USDG или токенизированные акции.
Какие ограничения по риску можно настроить?Можно задать размер покупки в процентах от лидера или фиксированный в ETH, лимиты ETH на сделку и в день, минимальный размер сделки лидера и глубину пула, окно пропуска защиты запуска, кулдауны, чёрный список токенов, поведение при продажах — зеркалить или закрывать позицию, и допустимое проскальзывание.
Как бот распознаёт сделку лидера?Он опрашивает новые блоки, фильтрует транзакции по добавленным вами адресам лидеров и декодирует из чека транзакции события обмена Uniswap V3 для Pons V1 или события V2 CurveBuy/CurveSell.
Это официальный продукт Pons или Robinhood?Нет, в README прямо сказано, что это не брокер Robinhood и не официальный продукт Pons или Robinhood — это независимое ПО социального копитрейдинга для вашего собственного кошелька.
В чём разница между токенами Pons V1 и V2?Токены V1 торгуются в стартовом пуле Uniswap V3 через SwapRouter02.exactInputSingle, а токены V2 используют кривую связывания с отдельными функциями curve.buy/curve.sell, пока не завершат выпуск.
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