Documentation

Everything you need to deploy, configure, and extend your trading agent.

Quick Start

Get your personal trading agent running in under 2 minutes.

1

Create a Telegram bot

Message @BotFather on Telegram. Send /newbot and follow the prompts. Copy the API token.

2

Get your chat ID

Send /start to your new bot. Your chat ID appears in the welcome message.

3

Fund a wallet

Create or import a Solana wallet. Export the private key (base58 or base64). Send SOL to it.

4

Configure

Set TELEGRAM_BOT_TOKEN, OWNER_CHAT_ID, and WALLET_SECRET in your .env file.

5

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 status

Risk Modes

Three preset risk profiles. Switch between them mid-conversation.

MODESIZINGTPSLMIN SCORE
Cautious0.05-0.20 SOL+10%-5%6+
Balanced0.10-0.50 SOL+15%-8%5+
Degen0.10-1.00 SOL+20%-12%4+

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.

Skill lifecycle hooks
pre-buy    → Filter or modify buy decisions before execution
post-scan  → Process scan results, boost or penalize scores
on-cycle   → Run logic every scan cycle (monitoring, tracking)
pre-sell   → Adjust sell logic, override stop loss / take profit

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.

skill.config.json
{
  "name": "my-rug-detector",
  "version": "1.0.0",
  "type": "filter",
  "hooks": ["pre-buy"],
  "pricing": {
    "model": "performance",
    "revShare": 0.10
  }
}
skill.mjs
export function preBuy(context) {
  const { token, holders, narratives } = context;
  
  // Reject if top wallet holds > 40%
  if (holders?.top1Pct > 40) {
    return { action: 'reject', reason: 'concentrated holder' };
  }
  
  // Boost score if riding a narrative
  const metaBoost = narratives.some(n => 
    token.name.toLowerCase().includes(n.keyword)
  ) ? 2 : 0;
  
  return { 
    action: 'allow',
    scoreModifier: metaBoost 
  };
}

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.

Testing requirements
1. Submit skill to reference agent
2. Minimum 20 live trades on mainnet
3. Positive PnL over testing period
4. No critical failures (missed sells, etc)
5. Skill self-update cycle verified
6. Performance metrics published on-chain

Testing period: 48-168 hours depending on market activity
Results: publicly visible on the Live Terminal

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.

Lock options
  7 days   — Basic trust signal
  30 days  — Strong commitment  
  90 days  — Maximum trust

Vesting: Linear unlock over the period
         (1% per day over 100 days)
         vs cliff unlock (all at once)

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.

Multiplier tiers
Hold duration    Multiplier
─────────────    ──────────
1 day            1.0x
7 days           1.5x
30 days          3.0x
90 days          5.0x

Selling resets your multiplier.
Rewards paid in SOL, not tokens.

The agent snapshots holder wallets periodically, calculates proportional rewards with hold-duration multipliers, and distributes SOL via on-chain transactions.