HAMILTON DOCS

01 · overviewAn agent that holds a wallet

Hamilton is a command-line agent you run on your own machine. It keeps an ETH wallet on Robinhood Chain, reads prices and pools on chain, searches the web for context, and proposes trades. Nothing is sent until you approve it in the terminal or in your Telegram bot.

Source

github.com/hamilton-agent/hamilton, Apache-2.0

Runs

npx github:hamilton-agent/hamilton, Node 20.19+

Model

Claude Opus 5 through your Anthropic API key

Chain

Robinhood Chain mainnet, chain id 4663

Servers holding funds

none

02 · keysA key that stays home

hamilton setup generates a new private key and writes it to ~/.hamilton/wallet.json with owner-only permissions. The agent can sign with it; it cannot print or export it. Fund the address with a little ETH on Robinhood Chain.

├── wallet      ~/.hamilton/wallet.json (0600)
├── settings    ~/.hamilton/settings.json
├── journal     ~/.hamilton/journal.jsonl
├── notes       ~/.hamilton/notes.md
├── sessions    ~/.hamilton/sessions/
├── move it     set HAMILTON_HOME

03 · uniswap v4Stocks against ETH

Tokenized stocks such as NVDA, SPY, TSLA and AAPL trade against native ETH in Uniswap v4 pools. Hamilton picks the deepest live pool, reads its price from StateView, quotes with the V4 Quoter and swaps through the Universal Router with a minimum output.

Pools

ETH paired with the stock, fee 1% or 0.30%, no hooks

Real fee

about 1.1% on the 1% pools: the protocol takes 0.1%

Selling

approve the token to Permit2, allow the router through Permit2, swap

Skipped

pools with no liquidity

04 · launchpadBonding curves

Pons is the Robinhood Chain launchpad. Hamilton lists recent launches with curve price, market cap, ETH on the curve and graduation progress, quotes buys by simulating them on chain, and trades on the curve directly.

Trades

buy and sell on the Pons V2 curve

Only

tokens that trade against ETH and have not graduated

Fees

1% Pons curve fee plus the creator tax the token set

05 · controlNothing moves without you

├── quote      every trade is quoted first, simulated on chain
├── limits     per-trade and per-day ETH limits are checked before you are asked
├── card       side, venue, token, size, expected fill, slippage and the reason
├── approve    y in the terminal or the Approve button in Telegram
├── journal    approved, declined and filled trades are all recorded

Change limits with hamilton limits --max-trade 0.05 --daily 0.25 --slippage 3.

06 · remoteYour own bot

Create a bot with @BotFather and run hamilton telegram with TELEGRAM_BOT_TOKEN and TELEGRAM_OWNER_ID set. The bot uses long polling from your machine, answers only the owner, keeps the session across restarts and sends trades with Approve and Decline buttons. Unanswered approvals expire after 10 minutes.

/balance

wallet address and ETH

/status

model, limits and session

/new

fresh session

07 · what it can callThe toolbox

wallet_status

address, balance, limits, today's spend

token_balance

any ERC-20 in the wallet

stock_prices

live stock-token prices and pool depth

pons_recent_launches

latest Pons launches

pons_token

one Pons token in detail

quote_trade

a quote, no gas

execute_trade

the only tool that moves money, gated by limits and your approval

trade_journal

past trades

remember

notes carried into future sessions

web_search

news and context

08 · tokenThe token

Hamilton is a token on Robinhood Chain, launched through Pons. There is one contract, it lives in config.js on GitHub, and the site reads it from there.

Chain

Robinhood Chain, EVM

Launchpad

Pons

Ticker

$HAMILTON

09 · questionsQuestions