Swap

Get best swap quote

post

Get best swap quote

Finds the best swap route and calculates the optimal quote for a token swap across available pools.

Body

application/json

amountinteger · int64Required

Token amount

Example: 1000000

input_mintstringRequired

Input token mint address

Example: ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx

output_mintstringRequired

Output token mint address

Example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

slippage_bpsinteger · int64Required

Slippage in basis points

Example: 50

swap_modestring · enumRequiredPossible values:

Responses

200

Quote

application/json

500

Internal server error.

post

/api/best_quote/

HTTPcURLJavaScriptPython

POST /internal-api/neptune/api/best_quote/ HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 179

{
  "amount": 1000000,
  "input_mint": "ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx",
  "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "slippage_bps": 50,
  "swap_mode": "ExactIn"
}

{
  "result": {
    "amm_config_index": 1,
    "in_amount": 1,
    "input_mint": "ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx",
    "other_amount_threshold": 1,
    "out_amount": 1,
    "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "slippage_bps": 1,
    "swap_mode": "ExactIn"
  },
  "status": "success"
}

Swap tokens

post

Swap tokens

Executes a token swap in the specified pool. Returns transaction for user to sign.

Body

application/json

amm_config_indexinteger · int32Required

AMM configuration index

Example: 16

amountinteger · int64Required

Token amount

Example: 1000000

input_mintstringRequired

Input token mint address

Example: ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx

output_mintstringRequired

Output token mint address

Example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

slippage_bpsinteger · int64Required

Slippage in basis points

Example: 50

swap_modestring · enumRequiredPossible values:

user_walletstringRequired

User wallet address

Example: EQdJjaPwUL6X3GjUp3ZQ1T3QA4XL9g9v3Z6rSUMGALMt

Responses

200

Swap

application/json

500

Internal server error.

post

/api/swap/

HTTPcURLJavaScriptPython

POST /internal-api/neptune/api/swap/ HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 262

{
  "amm_config_index": 16,
  "amount": 1000000,
  "input_mint": "ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx",
  "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "slippage_bps": 50,
  "swap_mode": "ExactIn",
  "user_wallet": "EQdJjaPwUL6X3GjUp3ZQ1T3QA4XL9g9v3Z6rSUMGALMt"
}

{
  "result": {
    "input_amount": 10000,
    "input_mint": "ATLASXmbPQxBUYbxPsV97usA3fPQYEqzQBUHgiFCUsXx",
    "other_amount_threshold": 19,
    "output_amount": 20,
    "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "slippage_bps": 50,
    "swap_mode": "ExactIn",
    "transaction": "AAABAYui1UgtJHZBScK5yyV3MFlkebqQax1WtFUSMla/fc/sRbfP2zsXzPb65RtKOoylvJknEyPiPWh3PTG7IaxVpsMG+TucnHHBklH++x2lN8hIAgAAAQDB/lVjVn9HGyT5DXUmfXkxopXxXsTP89cx0jz2UbjAzQAAAAA="
  },
  "status": "success"
}