Skip to content

Jupiter and Other Solana Routers

🛠 Connector Info

Component Status Notes
Router Connector ✅ DEX Aggregator

ℹī¸ Exchange Info

🔑 How to Connect

Jupiter operates on Solana networks.

Chain Networks
solana mainnet-beta, devnet

See Gateway Connect for instructions on connecting your wallet to Gateway.

Configuration

Configure Jupiter settings in /conf/connectors/jupiter.yml.

Below are the Jupiter configuration parameters and their default values: 

# Default slippage percentage for swaps (as a decimal, e.g., 1 = 1%)
slippagePct: 1

# Priority level for swap transaction processing
# Options: medium, high, veryHigh
priorityLevel: 'veryHigh'

# Maximum priority fee in lamports (for dynamic priority fees)
# Used when priorityLevel is set and no explicit priorityFeeLamports is provided
maxLamports: 1000000

# Restrict routing to only go through 1 market
# Default: false (allows multi-hop routes for better prices)
onlyDirectRoutes: false

# Restrict routing through highly liquid intermediate tokens only
# Default: true (for better price and stability)
restrictIntermediateTokens: true

# Jupiter API key (optional)
# For free tier, leave empty (uses https://lite-api.jup.ag)
# For paid plans, generate key at https://portal.jup.ag (uses https://api.jup.ag)
apiKey: ''

Other Solana Routers

Starting with Gateway v2.16.0, three additional Solana router connectors implement the same Router schema as Jupiter:

Router Connector Name Folder
Titan titan https://github.com/hummingbot/gateway/tree/development/src/connectors/titan
DFlow dflow https://github.com/hummingbot/gateway/tree/development/src/connectors/dflow
OKX DEX okx https://github.com/hummingbot/gateway/tree/development/src/connectors/okx

Each router has its own configuration file in /conf/connectors/ (e.g. titan.yml, dflow.yml, okx.yml).

How to Change Routers

The swapProvider setting in the Solana network configuration determines which router Gateway uses for the unified /trading/swap endpoints. The default is jupiter/router.

To change it, edit swapProvider in /conf/chains/solana/mainnet-beta.yml and restart Gateway:

# Options: jupiter/router, titan/router, dflow/router, okx/router
swapProvider: titan/router

Or run the gateway config command in the interactive Hummingbot client, which takes effect without a restart:

gateway config solana-mainnet-beta update swapProvider titan/router

Router Endpoints

Jupiter DEX aggregator for optimal swap routing across Solana

  • /connectors/jupiter/router/quote-swap
  • /connectors/jupiter/router/execute-quote
  • /connectors/jupiter/router/execute-swap

For more info, run Gateway in development mode and go to http://localhost:15888 in your browser to see detailed documentation for each endpoint.