Using NOUNY

Overview

Everything runs from one wallet. NOUNY never takes custody: live funds sit in smart contracts owned by your wallet, and only your wallet can withdraw them.

Getting started

1. Connect your wallet

Click Connect wallet and choose your wallet (MetaMask, OKX Wallet, Rabby, Coinbase Wallet or any browser wallet). You sign a message to prove you own the address. It is not a transaction: it costs nothing and moves no funds. You stay signed in for 7 days on that browser.

2. Build a paper agent

1. Open Agent Studio.
2. Give it a name (3–32 letters or numbers) and pick a strategy.
3. Mode: Paper. Market: crypto (BTC, ETH, SOL, XRP, DOGE, LINK, AVAX, NEAR, SUI, ZEC), perpetuals, or stocks (AAPL, NVDA, TSLA, MSFT, AMZN, GOOGL, META, SPY, QQQ, COIN).
4. Click Backtest & launch.

NOUNY backtests the strategy on the last 720 hourly candles (30 days for crypto; for stocks, US market hours only, roughly 5 months) and compares it with simply holding. The agent then decides once an hour — buy, sell or hold — and writes the reason in its Decision log. Every agent appears on the public leaderboard. You can run up to 5 agents.

Strategies

All strategies are long-only: the agent either holds the asset or holds cash (USDG in live mode). Position size is the share of cash used per buy (10–100%).

Live trading & your vault

What you need

• A little ETH on Robinhood Chain for gas — 0.0005 ETH is plenty. ETH on Ethereum, Base or other chains does not count; bridge some to Robinhood Chain first.
• USDG on Robinhood Chain, the dollar agents trade with. Start with $10–$50.

The app adds and switches the network in your wallet when you sign your first vault transaction.

Create and fund the vault

1. In Agent Studio, the Live trading vault card is at the top. Set a daily trading limit (the most the agent may swap in 24 hours) and a max slippage (the worst price accepted versus the Chainlink oracle, 0.1–5%; 1% is a good default, 2% for stocks in 0.3% pools).
2. Click Create vault and confirm in your wallet.
3. Deposit USDG. This is a plain token transfer to your vault.

Run a live agent

1. In New agent, set Mode to Live.
2. Pick ETH / USDG, BTC / USDG or a stock / USDG market and click Backtest & launch.

On a buy the agent swaps part of your USDG into the asset through Uniswap; on a sell it swaps back. Each trade in the decision log links to its transaction. One live agent per vault; the vault needs at least $5 and agent access switched on. If a trade is larger than what is left of your daily limit, the agent trades the part that fits and continues next hour.

Withdraw, pause or stop

Even if the NOUNY website were offline, you could withdraw by calling withdraw(token, amount, yourAddress) on your vault from the explorer (Write contract).

Stock tokens

Live agents can trade 10 Robinhood Stock Tokens on Robinhood Chain: AAPL, NVDA, TSLA, MSFT, AMZN, GOOGL, META, SPY, QQQ and COIN, each against USDG through a Uniswap V3 pool.

• Prices come from Chainlink feeds that follow US equities 24/5 and already include the corporate-action multiplier (splits and dividends).
• Stocks trade Monday–Friday. The feeds pause on weekends, so the vault refuses stock swaps until they update. Your agent simply holds.
• Stock tokens are issued by Robinhood and may not be available in every country. Check that you are allowed to hold them where you live.

Payroll

1. In the Payroll section, click Create payroll vault (one per wallet).
2. Deposit USDG.
3. Add recipient: wallet address, amount, schedule (weekly, every 2 weeks, or monthly = every 30 days) and the first payment date (empty = now).

The NOUNY bot checks every hour and pays each salary when it is due. The card shows the balance, the monthly cost and the runway. If the balance is too low, the payment is skipped and paid as soon as you top up. You can also click Pay due now.

Only you can add or remove recipients and withdraw. The bot, or anyone else, can only trigger a payment that is due, to the address and amount you set, once per period.

Hooked pools

NOUNY runs a Uniswap v4 pool for WETH / USDG on Robinhood Chain with the NOUNY hook:

• Dynamic fee between 0.05% and 1%: on the first swap of each block the hook measures how far the price moved and keeps a running average. Calm market, low fee; volatile market, higher fee. Nobody sets it by hand.
• One swap per block per wallet, to limit sandwich attacks and MEV.
• Payroll share: the pool owner can route a share of the swap fee (up to half) to a payroll address. The LP fee is lowered by the same share, so swappers pay the same total.

Swap

In the Provide liquidity section of the app, pick the direction, enter an amount and you see the quote (from Uniswap's v4 Quoter, including the hook fee). Approve the token once, then Swap. You receive at least the quoted amount minus 1%, or the swap is cancelled.

LP vault with agent rebalancing

1. Create an LP vault and set its limits: narrowest and widest range (%), minimum hours between moves, and the oracle band (how close the pool price must be to Chainlink).
2. Deposit WETH and USDG. Within the hour the agent opens a range around the price.
3. When the price leaves the range or gets near its edge, the agent moves the range — only inside your limits and only if the pool price is within your oracle band of Chainlink. Every decision is in the decision log.

The agent can only move the range; it never withdraws. You can exit (pull the liquidity back into the vault) and withdraw any time, even while paused, and revoke the agent. Trading fees earned by the position stay in your vault. When the agent moves the range it does not swap, so part of one token can stay idle in the vault.

Who can do what

These rules are enforced by the smart contracts. Nobody — including the NOUNY team — can override them.

Every swap is checked on-chain: the minimum output is computed from Chainlink (not by the bot), stale or invalid prices are rejected, the pool is pinned per token, total swap value is capped per 24 hours, and the vault checks its own balance before and after.

Fees & limits

• NOUNY fees: none. You pay network gas for your own transactions (fractions of a cent). The bot pays gas for agent trades and payroll runs.
• Uniswap pool fee on each live trade: 0.01% (ETH), 0.05% (BTC, AAPL, NVDA, GOOGL, SPY, QQQ, COIN) or 0.3% (TSLA, MSFT, AMZN, META), plus price impact.
• Pools on Robinhood Chain are still small, so keep trade sizes modest. Your max slippage protects you: a trade worse than that versus the oracle is refused.
• Paper agents simulate 0.1% cost per trade. Up to 5 agents per wallet, one live agent per vault, up to 100 payroll recipients.

Contracts

Robinhood Chain, chain ID 4663. Source code, tests and a script that checks the deployed bytecode against the source are on GitHub.

Your own vault and payroll addresses are shown in the app, and returned by vaultOf(wallet) / payrollOf(wallet) on the factories. The full token, oracle and pool list is in the repository README.

Security

• The bot key is treated as untrusted. If it were stolen, it could only trade a vault's tokens against each other through the pinned pools, within your slippage and daily limit — roughly daily limit × (slippage + pool fee + oracle lag) per day at worst — until you pause or revoke it. It can never withdraw.
• For payroll, the bot can only trigger payments you scheduled; it cannot redirect, increase or bring them forward.
• The contracts are covered by unit, fuzz and mainnet-fork tests. The security model, guarantees and known limitations are documented in SECURITY.md.
• Found a vulnerability? Report it privately via GitHub → Security → Report a vulnerability.

Troubleshooting

Terms

NOUNY is software that helps you run automated strategies and payments with smart contracts you own. By using it you agree that:

• Nothing on NOUNY is financial, investment, legal or tax advice. Backtests and past results do not predict future returns.
• Trading crypto and tokenized stocks is risky and you can lose money. Live agents trade real funds in your vault according to the strategy you choose.
• Smart contracts, oracles, bridges, wallets, Uniswap pools and blockchains can fail or behave unexpectedly. You use NOUNY at your own risk, and the software is provided "as is", without warranties.
• You are responsible for your wallet, your keys, the limits you set, and for complying with the laws that apply to you, including any restrictions on holding stock tokens in your country.
• We may change or discontinue the website and the bot at any time. Your vault and payroll contracts stay under your control, and you can always withdraw directly on-chain.

Privacy

• What we store: your wallet address (as your account), the agents you create with their settings, decisions and results, and — only if you join the waitlist — your email address.
• What we don't collect: names, private keys or seed phrases. We use no tracking or advertising cookies: one secure session cookie keeps you signed in, and your browser remembers which wallet you used.
• Public by nature: agent names, strategies and results appear on the public leaderboard with a shortened wallet address. Everything you do on-chain (vaults, deposits, trades, payroll) is public on Robinhood Chain.
• Third parties: market data comes from Binance, Hyperliquid, Finnhub and Yahoo Finance (server-side; your browser may contact Hyperliquid directly). Blockchain reads go through an RPC provider (dRPC).
• Deleting data: delete an agent in the Studio to remove it and its history. Waitlist removal and other requests: open an issue on GitHub.