Solana Jupiter Trading Bot

This is a simple demo uses Jupiter's Metis API and Quicknode's Metis add-on to create a simple Solana trading bot. The bot monitors price differences between token pairs and executes trades when profitable opportunities arise.

Ver repositório

Framework/Biblioteca de front-end:

Kit Solana

Idioma:

TypeScript

Ferramenta de compilação/Servidor de desenvolvimento:

Jupiter Metis API

Pré-visualização da aplicação de exemplo

Visão geral

This example is for educational purposes only. Quicknode does not provide financial advice or endorse any trading strategies. Always do your own research and consult with a financial advisor before making any investment decisions.

The demo uses:

Kit Solana (@solana/kit)
Token program client (@solana-program/token)
Address Lookup Table client (@solana-program/address-lookup-table)
Jupiter API TypeScript client (@jup-ag/api)

Supporting resources:

Introdução

Install Dependencies

Open the project directory:

cd solana/jupiter-bot

Then, install the dependencies:

npm install
# or
pnpm install
# or
bun install

Set Environment Variables

Make sure you have a Quicknode endpoint handy. You can get one here.

Rename .env.example para .env and update with your Quicknode Solana Node and Metis Add-on Endpoints.
Specify your SECRET_KEY (the private key of the wallet you want to use for the bot). You can generate a new one with solana-keygen new command using the Solana CLI.
Specify your SOLANA_ENDPOINT (get one here) and METIS_ENDPOINT (get one here) or use the public endpoint, https://public.jupiterapi.com.

SECRET_KEY=[00, ..., 00]
SOLANA_ENDPOINT=https://example.solana-mainnet.quiknode.pro/abc123/
METIS_ENDPOINT=https://jupiter-swap-api.quiknode.pro/abc123

Ensure your wallet is funded and modify the trading strategy in bot.ts to suit your needs.

First, run the development server:

npm run start
# or
pnpm start
# or
bun start

How it Works

Arquitetura

- bot.ts # Main bot logic
- index.ts # Entry point
- .env # Environment variables
- package.json # Dependencies

ArbBot Class

The main class that handles all trading logic:

constructor: Sets up the bot with configuration parameters including RPC endpoints, wallet details, and trading parameters
init: Initializes the bot by checking wallet balances and starting the price monitoring
initiatePriceWatch: Creates an interval to regularly check for arbitrage opportunities
getQuote: Fetches current price quotes from Jupiter Exchange
evaluateQuoteAndSwap: Analyzes quotes to determine if they meet profit thresholds
executeSwap: Handles the creation and submission of swap transactions
refreshBalances: Updates the current SOL and USDC balances
logSwap: Records successful trades to a JSON file
updateNextTrade: Prepares for the next trade after a successful swap
terminateSession: Safely shuts down the bot when conditions require it
jupiterInstructionToKitInstruction: Converts Jupiter API instruction format to @solana/kit instructions
getAddressLookupTableAccounts: Fetches address lookup tables for optimized transactions
postTransactionProcessing: Handles tasks after a successful transaction

Main Application

A simple runner script that:

Loads environment variables
Creates an instance of the ArbBot with configuration
Initializes and starts the bot

Example Trading Strategy

The bot uses a simple arbitrage strategy:

Start with an initial token (USDC or SOL)
Execute a trade when the price exceeds the target threshold
Update parameters for the reverse trade with a profit margin
Continue the cycle as long as profitable opportunities exist

Contribuições e comentários

Adoraríamos receber os vossos comentários e agradecemos quaisquer contribuições para esta aplicação de exemplo!

Para comunicar problemas ou partilhar comentários, abra uma issue no GitHub na qn-guia-exemplos repositório.

Para contribuir, siga estes passos:

Fazer um fork do repositório
Criar um ramo de funcionalidades:
git checkout -b feature/amazing-feature
Envie as suas alterações:
git commit -m "Adicionar uma funcionalidade fantástica"
Envie o seu branch:
git push origin feature/amazing-feature
Abrir um Pull Request.

Explore mais aplicações de exemplo

Titan Meta-Aggregation Swap

A single-page Solana swap UI built on the Titan Gateway Meta-Aggregation API, served through Quicknode. Surfaces competing provider quotes, the onchain venues a route touches, and a self-custodial build → sign → send flow with transactions confirmed via Quicknode RPC.