Skip to main content
POST
/
gateway
/
swap
/
execute
Execute Swap
curl --request POST \
  --url http://localhost:8000/gateway/swap/execute \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "connector": "<string>",
  "network": "<string>",
  "trading_pair": "<string>",
  "side": "<string>",
  "amount": 123,
  "slippage_pct": 1,
  "wallet_address": "<string>"
}
'
{
  "transaction_hash": "<string>",
  "trading_pair": "<string>",
  "side": "<string>",
  "amount": "<string>",
  "status": "submitted"
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Request to execute a swap

connector
string
required

DEX router connector (e.g., 'jupiter', '0x')

network
string
required

Network ID in 'chain-network' format (e.g., 'solana-mainnet-beta')

trading_pair
string
required

Trading pair (e.g., 'SOL-USDC')

side
string
required

Trade side: 'BUY' or 'SELL'

amount
required

Amount to swap

slippage_pct
default:1

Maximum slippage percentage (default: 1.0)

wallet_address
string | null

Wallet address (optional, uses default if not provided)

Response

Successful Response

Response after executing swap

transaction_hash
string
required

Transaction hash

trading_pair
string
required

Trading pair

side
string
required

Trade side

amount
string
required

Amount swapped

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
status
string
default:submitted

Transaction status