Jupiter Volatility Trader 🚀

An automated trading bot that monitors token price volatility using Jupiter APIs and can automatically place limit orders when volatility spikes are detected.

Built for the Jupiter "Not Your Regular Bounty" Hackathon

Features

• 📊 Real-time Price Monitoring: Uses Jupiter Price API to track token prices
• ⚡ Volatility Detection: Automatically detects price volatility spikes
• 📝 Limit Orders: Integrates with Jupiter Trigger API for automated limit orders
• 🔍 Token Verification: Uses Jupiter Tokens API to verify token authenticity
• 🖥️ CLI Interface: Easy-to-use command-line interface

Installation

# Clone the repository
git clone <your-repo-url>
cd jupiter-volatility-trader

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Create a .env file in the root directory:

JUPITER_API_KEY=your_api_key_from_developers.jup.ag

Usage

Get Token Price

npm run dev -- price EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Get Token Information

npm run dev -- token DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

Start Volatility Monitor

npm run dev -- monitor -t "So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" -p 5 -i 30

Options:

• -t, --tokens: Comma-separated token mints to monitor
• -p, --threshold: Volatility threshold percentage (default: 5)
• -i, --interval: Check interval in seconds (default: 30)

Place a Limit Order (Demo)

npm run dev -- limit-order -m EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v -s buy -p 0.95 -a 100

Run Demo Mode

npm run dev -- demo

Architecture

src/
├── index.ts           # CLI entry point and command handlers
├── priceMonitor.ts    # Price API integration and volatility detection
├── triggerOrders.ts   # Trigger API integration for limit orders
└── tokens.ts          # Tokens API integration for metadata

API Integration

This project uses the following Jupiter APIs:

1. Price API (https://price.jup.ag/v6)

   • Real-time token prices
   • 24h price change percentage
   • Historical price data

2. Trigger API (https://trigger.jup.ag)

   • Limit orders
   • OCO (One-Cancels-Other) orders
   • OTOCO orders

3. Tokens API (https://token.jup.ag)

   • Token metadata
   • Verification status
   • Logo URIs

Example Output

🚀 Starting Jupiter Volatility Monitor
📊 Tokens: So11111111111111111111111111111111111111112, EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
⚡ Volatility Threshold: 5%
⏱️  Check Interval: 30s
---

🚨 VOLATILITY SPIKE DETECTED!
Token: So11111111111111111111111111111111111111112
Price: 145.23
Change: 7.8%
Name: Wrapped SOL
Symbol: SOL
Verified: ✅

📝 Would place limit order via Trigger API
   Side: SELL
   Price: 146.68

License

MIT

Acknowledgments

• Built with Jupiter Developer Platform
• Part of the Solana ecosystem