Documentation
Everything you need to deploy, configure, and extend your trading agent.
Quick Start
Get your personal trading agent running in under 2 minutes.
Create a Telegram bot
Message @BotFather on Telegram. Send /newbot and follow the prompts. Copy the API token.
Get your chat ID
Send /start to your new bot. Your chat ID appears in the welcome message.
Fund a wallet
Create or import a Solana wallet. Export the private key (base58 or base64). Send SOL to it.
Configure
Set TELEGRAM_BOT_TOKEN, OWNER_CHAT_ID, and WALLET_SECRET in your .env file.
Launch
Run npm run bot. Message your bot "go" and it starts hunting.
Conversational Interface
Your agent understands natural language. No slash commands, no syntax to memorize.
"go" / "hunt" / "start"Begin scanning and trading autonomously"pause" / "chill" / "stop"Pause all trading activity"status" / "how are we doing"Current balance, win rate, PnL"what are you holding"List open positions with hold time"be more aggressive"Switch to degen risk mode"play it safe"Switch to cautious risk mode"sell everything"Close all positions immediately"buy [address] [SOL]"Manual buy of a specific token"wallet"Show wallet address and balance"what are you doing"Current activity statusRisk Modes
Three preset risk profiles. Switch between them mid-conversation.
Position sizing scales within these ranges based on your agent's win rate. More wins = bigger positions, automatically.
Skills System
Skills are modular trading strategies that plug into your agent's decision loop. Each skill hooks into specific points in the trading lifecycle. All skills must pass testing on the reference agent before marketplace listing.
Skills are on-chain NFTs. Owning the NFT gives your agent the license to run the skill. Performance is tracked and verified on-chain.
Building Skills (SDK)
Write a strategy as a JavaScript module that exports hook functions. The SDK provides the context object with everything your skill needs.
Test your skill on the reference agent first. Once it proves profitable over at least 20 trades, it can be minted on the marketplace. You earn 10% of every profitable trade your skill contributes to.
Skill Testing Pipeline
Every skill goes through a rigorous testing pipeline before it can be listed on the marketplace. No exceptions.
The reference agent runs all marketplace skills simultaneously. The Live Terminal page shows every decision in real-time — which skills triggered, what they scored, and the outcome.
Dev Locks
Smart contracts that cryptographically lock developer token allocations for a verified period. Visible and verifiable by anyone on-chain.
Buyers can filter tokens by lock duration. Locked tokens receive a trust badge visible on the platform.
Holder Rewards
An agent-powered reward distribution system that pays SOL to token holders based on how long they've held.
The agent snapshots holder wallets periodically, calculates proportional rewards with hold-duration multipliers, and distributes SOL via on-chain transactions.