elizaos-plugin-auto-trader 2.0.0a5

elizaOS Auto Trader Plugin - automated trading strategies

@elizaos/plugin-auto-trader

Autonomous trading plugin for elizaOS with LLM-powered strategies, Jupiter DEX integration, and comprehensive safety features.

Features

• LLM-Powered Trading - AI analyzes trending tokens and makes intelligent trading decisions
• Trade ANY Token - Dynamic token resolution by symbol, name, or address via Birdeye API
• Jupiter DEX Integration - Execute swaps with optimal routing on Solana
• Honeypot Detection - Blocks scam tokens (no sells, suspicious ratios, low volume)
• RugCheck Validation - Automatic token safety checks before trading
• Risk Management - Stop-loss, take-profit, position limits, daily loss caps
• Multiple Strategies - LLM, Momentum, Mean-Reversion, Rule-based
• Paper Trading - Test strategies without risking real funds

Installation

npm install @elizaos/plugin-auto-trader

Quick Start

import { AgentRuntime } from '@elizaos/core';
import autoTraderPlugin from '@elizaos/plugin-auto-trader';

const runtime = new AgentRuntime({
  character: {
    name: 'Trader',
    settings: {
      SOLANA_PRIVATE_KEY: 'your-base58-private-key',
      BIRDEYE_API_KEY: 'your-birdeye-api-key',
      TRADING_MODE: 'paper', // Start with paper trading!
    },
  },
  plugins: [autoTraderPlugin],
});

await runtime.initialize();

Configuration

Required Settings

Setting	Description
SOLANA_PRIVATE_KEY	Base58-encoded private key for trading wallet
BIRDEYE_API_KEY	Birdeye API key for market data and token resolution

Optional Settings

Setting	Default	Description
SOLANA_RPC_URL	https://api.mainnet-beta.solana.com	Solana RPC endpoint
TRADING_MODE	paper	paper or live
STOP_LOSS_PERCENT	5	Stop loss percentage
TAKE_PROFIT_PERCENT	15	Take profit percentage
MAX_DAILY_LOSS_USD	500	Maximum daily loss before stopping
MIN_LIQUIDITY_USD	50000	Minimum token liquidity
MIN_VOLUME_24H_USD	100000	Minimum 24h trading volume
MIN_SELL_COUNT_24H	50	Minimum sells in 24h (honeypot filter)
MAX_BUY_SELL_RATIO	5	Max buy/sell ratio (honeypot filter)

Usage

Natural Language Commands

Start Trading:

"Start trading with LLM strategy"
"Begin momentum trading on BONK"
"Start paper trading"

Manual Trades:

"Buy 0.5 SOL worth of BONK"
"Sell 1000 WIF"
"Swap 1 SOL for PEPE"

Check Status:

"Check portfolio"
"Show performance"
"Analyze market"

Configure:

"Set stop loss to 3%"
"Set take profit to 20%"
"Configure liquidity to $100k"

Programmatic Usage

const tradingManager = runtime.getService('AutoTradingManager');

// Start automated trading
await tradingManager.startTrading({
  strategy: 'llm',
  tokens: ['auto'], // Auto-discover trending tokens
  maxPositionSize: 0.1, // 10% of portfolio
  intervalMs: 60000,
  stopLossPercent: 5,
  takeProfitPercent: 15,
});

// Check status
const status = tradingManager.getStatus();
console.log('Trading:', status.isTrading);
console.log('P&L:', status.performance.totalPnL);

// Stop trading
await tradingManager.stopTrading();

Direct Swap Execution

const swapService = runtime.getService('SwapService');

// Buy tokens
const result = await swapService.buy('TOKEN_ADDRESS', 0.5); // 0.5 SOL
console.log(result.success, result.outputAmount);

// Sell tokens  
await swapService.sell('TOKEN_ADDRESS', 1000);

Token Resolution

const resolver = runtime.getService('TokenResolverService');

// Resolve by symbol
const bonk = await resolver.resolve('BONK');
console.log(bonk.address, bonk.price);

// Get trending tokens
const trending = await resolver.getTrendingTokens(20);

Safety Features

Honeypot Detection

The plugin automatically detects and blocks potential honeypots:

Check	What It Detects	Default
Zero Sells	Tokens with 0 sells in 24h	minSellCount24h: 50
Buy/Sell Ratio	Suspicious trading patterns	maxBuySellRatio: 5
Zero Sell Volume	No sell volume despite buys	Automatic
Token Age	Tokens less than 24h old	minTokenAgeSeconds: 86400
Unique Traders	Low trader count	minUniqueTraders24h: 100

RugCheck Integration

• Risk score assessment
• Holder concentration analysis
• Liquidity lock verification
• Mint/freeze authority checks

Strategies

LLM Strategy (Recommended)

AI-powered trading using language models:

1. Fetches trending tokens from Birdeye
2. Pre-filters honeypots and scam tokens
3. LLM analyzes remaining safe tokens
4. Validates selection via RugCheck
5. Executes trade with automatic stop-loss/take-profit

Momentum Strategy

Technical breakout detection using:

• Price momentum indicators
• Volume analysis
• Trend identification

Mean Reversion Strategy

Trades based on:

• Moving average deviation
• RSI overbought/oversold
• Bollinger Bands

Rule-Based Strategy

Configurable technical rules:

• Custom RSI thresholds
• SMA/EMA crossovers
• Volume conditions

Services

Service	Description
AutoTradingManager	Main trading orchestrator
SwapService	Jupiter DEX integration
TokenValidationService	RugCheck + honeypot detection
TokenResolverService	Dynamic token resolution
TradingTrajectoryService	RL training data capture

Actions

Action	Trigger Keywords
START_TRADING	start, begin, enable trading
STOP_TRADING	stop, pause, disable trading
CHECK_PORTFOLIO	portfolio, positions, balance
EXECUTE_LIVE_TRADE	buy, sell, swap, trade
GET_MARKET_ANALYSIS	analyze, market, trending
ANALYZE_PERFORMANCE	performance, p&l, stats
COMPARE_STRATEGIES	compare, strategies, which
CONFIGURE_STRATEGY	configure, set, adjust

Risk Warnings

⚠️ Important: Cryptocurrency trading involves significant risk.

• Paper Trade First - Always test strategies before using real funds
• Start Small - Begin with small position sizes when going live
• Monitor Closely - Keep track of performance
• Secure Keys - Never share or commit private keys

Architecture

plugin-auto-trader/
├── package.json
├── prompts/
└── typescript/src/
    ├── index.ts           # Plugin entry point
    ├── services/
    │   ├── AutoTradingManager.ts
    │   ├── SwapService.ts
    │   ├── TokenValidationService.ts
    │   ├── TokenResolverService.ts
    │   └── TradingTrajectoryService.ts
    ├── strategies/
    │   ├── LLMStrategy.ts
    │   ├── MomentumBreakoutStrategy.ts
    │   ├── MeanReversionStrategy.ts
    │   ├── RuleBasedStrategy.ts
    │   └── RandomStrategy.ts
    ├── actions/
    └── providers/

License

MIT