K3RN docs: how to use the agent, bot and wallet

K3RN is an AI trading terminal + agent for Robinhood Chain. This page covers everything from logging in to letting the agent trade 24/7.

What is K3RN

A trading terminal for Robinhood Chain (chain id 4663, gas paid in ETH) with an AI agent that watches every token on the chain and finds trades for you.

Terminal: live token lists, charts, security scans, buy / sell straight through Uniswap (v3 + v4).
Agent: scans the chain every minute, follows smart money, skips insider-heavy tokens, and sends you signals with take-profit / stop-loss alerts.
Telegram bot @grepfibot: the same signals and alerts in your Telegram.
24/7 auto (optional): the server trades the agent's signals from your own wallet, within daily limits you set.

REAL means real ETH from your wallet, real results. DEMO means paper trading with fake money on live prices, to see how the agent behaves. Demo results never count anywhere.

Getting started

Log in. Tap [ login ] top right. Email, Google or X creates a K3RN wallet for you (by Privy, no seed phrase to manage). You can also connect a browser wallet like Rabby or MetaMask.
Add ETH on Robinhood Chain. Open wallet → ↓ deposit and send ETH on Robinhood Chain to that address (bridge it first if your ETH is on another chain). Swaps cost around 0.00001 ETH in gas.
Trade or let the agent work. Tap any token for its chart and a buy / sell panel, or go to agent to set up the bot.

your key · K3RN never sees your private key. With an email / Google / X login you can export it any time from the wallet menu (Privy opens its own secure window).

The pages

page	what it shows
hot (trending)	hot Robinhood Chain pairs ranked by score: liquidity, volume, buy pressure, momentum.
new (new_pairs)	newest pools by age: minted (< 15 min), fresh (15–60 min), warming (1 h +), newest first, refreshed every 30 s, plus pons_curve: tokens launched on Pons that are still on their bonding curve, with a progress bar to graduation. minted shows only pools whose liquidity is burned or locked by default (toggle `all` to see everything). Pools under $100 of liquidity or already rugged are hidden.
stocks	official Robinhood stock tokens with live DEX prices, tradeable 24/7.
smart_money	wallets the agent follows (early buyers in 2+ tokens that already ran), their latest buys, and large WETH / USDG moves.
pools	top pools by volume with a fee-based APR estimate.
wallet	your balances and value, deposit / send, airdrop detection, hide tokens, export key.
agent	your bot: real log, signals, positions, 24/7 auto, forward test.
leaderboard	real round trips verified on-chain, plus contests. Paper trades never count.

Token panel

Tap any token (also positions on the agent page) to open its panel: chart / TradingView / DexScreener, market stats, and a security scan (owner, holders, honeypot test by simulating a sell, round-trip quote, liquidity lock). Then buy or sell; the route is picked automatically between Uniswap v3, Uniswap v4 and the Pons bonding curve.

Pons launches

Tokens launched on Pons can be bought and sold in K3RN while they're still on their bonding curve: the trade goes straight to the token's curve contract (curve fee 1% + the creator's tax; a snipe tax applies in the first seconds after launch and is shown in the quote). Once a token raises its ETH target it graduates to Uniswap v4 and K3RN routes there automatically.

How the agent trades

What it scans

Every minute: every token on Robinhood Chain it can find, merged from DexScreener (pairs, search, boosted, profiles) and GeckoTerminal (trending, most traded, top volume, newest pools, several pages each), on Uniswap v3 and v4.

When it buys

Breakouts: trend up on 1h and still rising on 5m, more buys than sells.
Pullback bounces: a token up 30%+ in 24h that dipped this hour and is bouncing.
Conviction score (0-100) on top of the score: buy pressure, turnover, a healthy trend, liquidity vs market cap. It skips one-candle pumps, 5m spikes over +25%, tokens up 300%+ in a day and pools younger than 15 minutes.
Smart money: tokens bought by smart wallets get a boost. Strategy smart buys when 2+ smart wallets buy the same token within an hour.
Smart-money micro caps: tokens under your minimum liquidity (down to $5K) are allowed only when 3+ smart wallets are buying a pool at least 1 hour old, with a tight -8% stop.
Pons curves: Pons launches 15–85% of the way to graduation that gained 4+ points in about 5 minutes, at least 2 minutes old, creator tax 3% or less and no snipe tax. Smart-money buys rank them higher. Stop loss -10%.
Market mood: no new buys when most of the chain is dumping.
Scam guard: before every signal and again right before an auto-buy, the agent reads the token contract on-chain and skips it if it is an upgradeable proxy, if a live owner can blacklist wallets, mint, change taxes or stop trading, if it has hidden balance-editing functions, or if its Uniswap v4 pool uses an unknown hook. Right before buying it also measures the real depth of the pool on-chain from two live quotes (feeds can be stale, and liquidity can be pulled between scan and buy): pools under $10K are skipped, and no setting can lower that floor. It also checks for an allowance backdoor: whether the deployer, the owner or anyone can move a holder's tokens with no approval (how GTAVI burned buyers' bags). For Pons tokens it skips any where the creator still holds more than 5% of supply or the creator tax is above 3%. Then it simulates a real buy and an immediate sell inside one read-only call (nothing is sent): if the sell reverts (honeypot) or gives back under 85% of the ETH (hidden tax), the token is skipped. Rejected tokens are banned for 7 days. DEX pools must be at least 3 hours old (unknown age = skipped); micro caps need 3+ smart wallets and a pool at least 6 hours old.

Safety checks before every signal

Round trip: it quotes buy then sell back. Under 90% back (thin pool, sell tax, honeypot hook) → skipped.
Insiders: wallets that bought in the launch block + the dev wallet. If they still hold 25%+ of supply → skipped.

When it sells

exit	rule
stop loss	down your `sl` % (default 10%, micro caps 8%). Positions the bot bought never ride past -12%, whatever the setting
breakeven stop	once up +10% (or a third of your take-profit), the stop moves to your entry
protect profit	up +15% or more and then giving back 60% of that run: sells what's left
trailing take profit	past your `tp`, it rides the move and sells when it gives back a third of the peak gain (at least 8 points)
rug exit	24/7 auto sells at once if a position can't be quoted anymore or its pool loses half its depth since the buy (liquidity being pulled)
time exit	flat (-5% to +5%) after 6 hours: frees the ETH

24/7 exits use wider slippage (5% take profit, 15% stop loss, 35% rug exit) so a falling token can't make the sell revert, and a failed sell is retried every minute until it's out.

It learns

Each closed 24/7 trade is filed under its setup (breakout, pullback, smart, sniper, micro). After 5+ trades a losing setup gets stricter (needs more conviction) and a winning one a bit looser. You get a Telegram message every time it adjusts. Tokens you lost on are blocked for 24h; 3 losing exits in 2 hours pause new buys.

Using the agent

Connect Telegram (recommended): agent → connect Telegram, sign the free message, open the link. Your wallet is now linked to @grepfibot.
Bot settings: agent → bot settings: strategy (momentum, sniper, smart, arb), size per trade, take profit, stop loss, min liquidity, min score, max positions, signals per hour.
Pick how trades happen:
- Manual: signals show on the agent page and in Telegram. Tap approve, sign in your wallet.
- auto-buy / auto-sell in this tab: signals run by themselves while the K3RN tab stays open and on screen.
- 24/7 auto: the server trades even when your phone and laptop are off. See below.

size per trade · keep it small next to your ETH balance. The agent always keeps a little ETH for gas and skips a buy when size + gas reserve is more than you have.

Reading the real log

The real log shows exactly what the agent is doing: MATCH = a token passed the filters, skip = why it didn't (with the reason), no match = a tally of why every scanned token was rejected, watch = your open positions vs their stop.

Agent access

Right now the agent is open to everyone. After the token launches, using the real agent (signals, auto-buy in the tab, 24/7 auto and Telegram signals) will require holding at least $25 worth of the token in your wallet, valued at its live sell price and checked every minute. Without it the agent pauses new buys and signals; stop loss / take profit on your open positions keep running. Demo (paper trading) stays open to everyone.

24/7 auto trading

The server buys the agent's signals and sells on take-profit / stop-loss from your own K3RN wallet, 24/7.

Log in with email / Google / X (browser wallets keep their own key and can't be used from a server).
agent → 24/7 auto → choose auto-buy and/or auto-sell, max buys per day and max ETH per day.
Tick "I understand", tap allow + turn on. Privy asks you once to allow K3RN's server, then you sign a free message.

Limits are enforced on the server: max buys / day, max ETH / day, gas reserve. Signals older than 5 minutes are skipped and nothing runs twice.
Auto-sell only touches tokens the bot bought or signalled, never your other bags.
Every trade is posted to Telegram with the tx link, written to the real log and added to your forward test.
Turn off: 24/7 auto → turn off + revoke. Server access is removed from your wallet right away.

stops are checked every minute · if a token crashes between two checks, it sells at the price at that moment, which can be below your stop.

Forward test & win rate

The agent's real track record, from your own trades only: win rate, net PnL after fees, average win / loss, profit factor, best / worst, max drawdown and every round trip with buy + sell tx links. copy summary and export csv let you share or check it. There are no backtested or made-up numbers anywhere in K3RN.

Telegram bot

Open @grepfibot and link from K3RN → agent → connect Telegram. Commands:

command	what it does
`/status`	what the bot is doing right now, settings, 24/7 auto, v4
`/positions`	open positions with PnL
`/trades`	last trades the server made for you, with tx links
`/auto`	24/7 auto: on / off, limits, today's buys and ETH
`/smart`	smart wallets it follows + their latest buys
`/learn`	per-setup results and what the bot tightened or loosened
`/info`	how the bot picks, checks and exits trades
`/strategy`	`momentum` · `sniper` · `smart` · `arb`
`/set`	`/set size 0.002`, also `tp`, `sl`, `minscore`, `minliq`, `maxpos`, `perhour`
`/pause` · `/resume`	stop / start new buys (tp / sl keeps running)
`/track 0x…` · `/untrack`	watch a token you bought yourself
`/wallet` · `/unlink`	your linked wallet

Wallet & airdrops

Deposit / send: wallet → ↓ deposit (address + QR) or ↑ send for ETH or any token, with the network fee shown before you confirm.
Airdrops: tokens someone sent you that you never bought are tagged airdrop · not bought, grouped separately and not counted in your total.
Hide: tap hide on any token to move it to the hidden list (unhide any time). It only changes what you see; the token stays in your wallet.

Safety

airdropped tokens · a random token with a big "value" in your wallet is usually bait. Never approve it, never sell it on sites in its name, never connect your wallet to links it points to. Left alone, it can't hurt you.

official links only · the token contract address is posted only at launch, only on grepfi.xyz and official channels: x.com/grepfi and t.me/GrepFiann. Nobody from K3RN will ever DM you first or ask for your key.

New tokens can rug or be honeypots. The checks lower the odds, they can't remove them.
Only trade what you can lose. Start with a small size and small daily limits.
K3RN is software, not financial advice.

FAQ

Does the bot keep running when my laptop / phone is off?

Yes. The scanner, signals, Telegram alerts and 24/7 auto run on the server. Only the in-tab auto mode needs the page open.

Why didn't the agent buy anything?

It's picky on purpose. Check the real log: no match lists why tokens were rejected, skip gives the reason for a specific token. Also check your ETH: size + gas reserve must fit in your balance.

"trades on another DEX"?

K3RN swaps through Uniswap v3 and v4 on Robinhood Chain. Tokens that only trade elsewhere are skipped.

Why is my stop loss worse than my setting?

Stops are checked every minute and sell at the price at that moment. A fast crash between checks fills lower.

Can K3RN take my funds?

K3RN never holds your key. With 24/7 auto on, the server can only send trades within your limits, and you can revoke it any time from the agent page.