Production-grade TypeScript arbitrage scanner and execution framework for Solana, built around the Axiom on-chain trading terminal and Jupiter aggregator routing. Detects cross-DEX, triangular, and CEX-DEX spread opportunities with configurable risk controls, circuit breakers, and dry-run execution by default.

Safety first: This bot does not move mainnet funds by default. DRY_RUN=true and EXECUTION_ENABLED=false are the defaults. Review risk limits and wallet configuration before enabling live execution.

src/
├── config/          Zod-validated environment configuration
├── types/           Shared domain types
├── market/          Token registry + price feed
├── exchanges/       Jupiter, Axiom, mock DEX clients
├── strategies/      Cross-DEX, triangular, CEX-DEX
├── core/            Arbitrage engine orchestrator
├── risk/            Risk manager + circuit breaker
├── execution/       Trade executor (dry-run / live)
├── api/             Express HTTP server
├── utils/           Logger, math, retry helpers
├── cli.ts           Command-line interface
└── index.ts         Main entry (API + continuous scan)

cd axiom-arbitrage-trading-bot
cp .env.example .env
npm install
npm test
npm run build
npm start

Verify the API:

curl http://127.0.0.1:8790/api/health
curl -X POST http://127.0.0.1:8790/api/v1/scan

npm run scan:once

npm run scan

npm run cli -- scan --once --json
npm run cli -- stats
npm run cli -- health

Copy .env.example to .env and adjust:

Buys a token on the cheapest venue and sells on the most expensive venue for the same pair. Ideal for memecoin volatility on Solana where Raydium, Orca, Meteora, and Jupiter routes diverge briefly.

Finds three-hop cycles (e.g. SOL → USDC → BONK → SOL) where the round-trip output exceeds input after fees and estimated gas.

Compares centralized exchange mid prices (simulated in mock mode; wire Binance/Bybit/OKX websockets for production) against on-chain DEX quotes for latency-arbitrage windows.

1. Set BOT_MODE=live and configure a reliable SOLANA_RPC_URL (Helius, QuickNode, or Alchemy).
2. Add your AXIOM_API_KEY for Axiom terminal routing.
3. Wire CEX websocket feeds into CexDexStrategy for real CEX-DEX spreads.
4. Set conservative MIN_PROFIT_BPS, MAX_TRADE_SIZE_SOL, and MAX_DAILY_TRADES.
5. Only enable EXECUTION_ENABLED=true after thorough dry-run validation.
6. Store WALLET_PRIVATE_KEY securely — never commit it to version control.

MIT — see LICENSE.

Need help deploying, configuring strategies, or integrating with Axiom / Jupiter?

Contact us on Telegram for technical support:

We respond to setup questions, configuration issues, and integration requests.