Jupiter DEX Node for n8n

A custom n8n node that integrates with Jupiter DEX on Solana, providing automated DeFi operations through n8n workflows.

🚀 Quick Start

1. Set Up Credentials

1. Open n8n → Settings → Credentials
2. Click "Add Credential"
3. Search for "Jupiter DEX"
4. Fill in the fields:

For Secret Key (Recommended):

Keypair Input Method: Secret Key
Secret Key: [your-64-character-base58-secret-key]
RPC Endpoint: (leave empty for default)
Custom RPC URL: https://your-syndica-endpoint.solana-mainnet.quiknode.pro/
RPC API Key: [your-syndica-api-key]

For Keypair Array:

Keypair Input Method: Keypair Array
Keypair Array: [1,2,3,...,64]  // Your keypair as JSON array
RPC Endpoint: (leave empty for default)
Custom RPC URL: https://your-syndica-endpoint.solana-mainnet.quiknode.pro/
RPC API Key: [your-syndica-api-key]

2. Use in Workflows

The Jupiter DEX node will now appear in your node palette. Drag it into your workflow and configure:

📋 Available Operations

🔄 Swap Tokens

Execute token swaps through Jupiter DEX with optimal routing.

Required Fields:

• Input Token Mint: Token to swap from (e.g., So11111111111111111111111111111111111111112 for SOL)
• Output Token Mint: Token to swap to (e.g., EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v for USDC)
• Amount: Amount to swap (in smallest (raw) units)
• Slippage (bps): Slippage tolerance (default: 50 = 0.5%)

Example:

Input Mint: So11111111111111111111111111111111111111112 (SOL)
Output Mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC)
Amount: 1000000000 (1 SOL)
Slippage: 50

💰 Check Balance

Check your wallet balances for SOL and tokens.

Balance Check Types:

• All Balances: Complete portfolio overview
• Specific Token: Check individual token balance
• Native SOL Only: Quick SOL balance check

Example - Check All Balances:

Balance Check Type: All Balances
Include Token 2022: true

Example - Check Specific Token:

Balance Check Type: Specific Token
Token Mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC)

📊 Price Check

Get real-time prices for multiple tokens.

Required Fields:

• Token Mints: Comma-separated list of token mint addresses

Example:

Token Mints: So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

🔧 Configuration Details

RPC Endpoints

• Default: Uses public Solana RPC (https://api.mainnet-beta.solana.com)
• Custom: Supports premium providers like Syndica, Helius, Triton
• API Keys: Securely stored and automatically appended to requests

Wallet Security

• Secret Key Format: 64-character base58-encoded private key
• Keypair Array: JSON array of 64 numbers (0-255)
• Encrypted Storage: All credentials are encrypted in n8n

📝 Workflow Examples

Automated Price Monitoring

Schedule Trigger → Jupiter DEX (Price Check) → Email (Send Alert)

Balance Monitoring

Schedule Trigger → Jupiter DEX (Check Balance) → Filter (Low Balance) → Notification

Token Swapping

Webhook → Jupiter DEX (Check Balance) → Filter (Sufficient Funds) → Jupiter DEX (Swap)

⚠️ Important Notes

Testing

• Always test on devnet first before using mainnet
• Use small amounts for initial testing
• Verify all token mint addresses are correct

Security

• Never share your private keys
• Use dedicated trading wallets with limited funds
• Keep RPC API keys secure and rotate regularly

Rate Limits

• Jupiter API has rate limits - implement appropriate delays
• Use premium RPC providers for better performance
• Monitor API usage in production

🐛 Troubleshooting

Node Not Appearing

# Check if node is in correct directory
ls -la ~/.n8n/custom/jupiternode/

# Rebuild if needed
cd ~/.n8n/custom/jupiternode
npm run build

# Restart n8n completely

Transaction Failures

• Verify sufficient SOL for transaction fees
• Check token mint addresses are valid
• Ensure wallet has necessary token balances
• Confirm RPC endpoint is accessible

Balance Check Issues

• Verify wallet address is correct
• Check if token accounts exist
• Ensure RPC endpoint supports Token 2022 (if using)

📞 Support

For issues with the Jupiter DEX node:

1. Check n8n logs: tail -f ~/.n8n/logs/n8n.log
2. Verify Jupiter API status: https://status.jup.ag/
3. Test with smaller amounts first
4. Ensure all parameters are correctly formatted

🔗 Useful Links

• Jupiter DEX: https://jup.ag/
• Solana Explorer: https://solscan.io/
• Token Mint Addresses: Search on Solscan or Jupiter
• RPC Providers: Syndica, Helius, Triton

⚠️ Disclaimer: This software is provided as-is. Always test thoroughly before using with real funds. The authors are not responsible for any financial losses.