Skip to main content
This guide provides practical examples for interacting with Neutron’s DEX module through the web interface and command-line tools.

​
User Interfaces

​
Neutron App (Web Interface)

The primary web interface is available at app.neutron.org

​
Orderbook Interface

Access the orderbook at app.neutron.org/orderbook Features:
  • Live Price Chart: The charting technology is provided by TradingView, a platform for traders and investors. It offers advanced charting tools so that you can plan your trade with the context of your own saved notes and measurements, and other features such as major upcoming events in the TradingView economic calendar
  • Order Book Table: Real-time liquidity depth and price levels
  • Recent Trades: Live trade feed with transaction links
  • Order Form: Interface for placing limit and market orders
  • Order History: Track your active and completed orders
Token Pair Navigation:
  • Use the pair selector to choose from available trading pairs
  • View pair summary with recent activity metrics
  • Access price history and volume data
Order Form Usage:
  • Limit Orders: Specify exact price and expiration (optional)
  • Market Orders: Execute immediately with slippage protection
  • Order Types: Choose from GTC, GTT, FOK, IOC based on your strategy
  • Simulation: Preview trade outcomes before execution
Order Management:
  • Active Orders: Monitor open positions in the Trades tab
  • Order History: Review completed trades
  • Withdraw/Cancel: Manage filled or active orders

​
Bridge Interface

Access the bridge at app.neutron.org/bridge
  • Transfer tokens from other chains to Neutron
  • View current token balances on Neutron
  • Withdraw tokens back to origin chains
  • Support for major IBC-enabled chains

​
CLI Interface

All DEX functionality is available through the neutrond command-line interface using positional arguments.

​
Adding Liquidity

​
Basic Single-Tick Deposit

neutrond tx dex deposit \
  alice \
  untrn \
  ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2 \
  1000000 \
  1000000 \
  0 \
  3000 \
  false \
  false \
  --from mykey \
  --chain-id neutron-1
Arguments:
  1. receiver - Address to receive the liquidity position
  2. token-a - First token denomination
  3. token-b - Second token denomination
  4. amounts-a - Comma-separated amounts of token A (e.g., “1000000,500000”)
  5. amounts-b - Comma-separated amounts of token B (e.g., “1000000,500000”)
  6. tick-indexes - Comma-separated tick indexes (e.g., “0,-100,100”)
  7. fees - Comma-separated fee tiers (e.g., “3000,3000,3000”)
  8. disable-autoswap - Comma-separated boolean values (e.g., “false,false,false”)
  9. fail-tx-on-bel - Comma-separated boolean values (e.g., “false,false,false”)

​
Multi-Tick Liquidity Strategy

neutrond tx dex deposit \
  alice \
  untrn \
  ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2 \
  1000000,1000000,1000000 \
  1000000,1000000,1000000 \
  [-100,0,100] \
  3000,3000,3000 \
  false,false,false \
  false,false,false \
  --from mykey \
  --chain-id neutron-1

​
Removing Liquidity

​
Basic Withdrawal

neutrond tx dex withdrawal \
  alice \
  untrn \
  ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2 \
  500000 \
  0 \
  3000 \
  --from mykey \
  --chain-id neutron-1
Arguments:
  1. receiver - Address to receive withdrawn tokens
  2. token-a - First token denomination
  3. token-b - Second token denomination
  4. shares-to-remove - Comma-separated share amounts to remove
  5. tick-indexes-a-to-b - Comma-separated tick indexes
  6. fees - Comma-separated fee tiers

​
Trading

​
Multi-Hop Swap

neutrond tx dex multi-hop-swap \
  alice \
  "untrn,ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2" \
  1000000 \
  0.95 \
  true \
  --from mykey \
  --chain-id neutron-1
Arguments:
  1. receiver - Address to receive output tokens
  2. routes - Semicolon-separated routes, each route is comma-separated tokens
  3. amount-in - Amount of input tokens
  4. exit-limit-price - Minimum acceptable output price
  5. pick-best-route - Whether to pick the best route (true/false)

​
Place Limit Order

neutrond tx dex place-limit-order \
  alice \
  untrn \
  ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2 \
  100 \
  1000000 \
  GOOD_TIL_CANCELLED \
  --from mykey \
  --chain-id neutron-1
Arguments:
  1. receiver - Address to receive proceeds
  2. token-in - Token being sold
  3. token-out - Token being bought
  4. tick-index - Price tick for the order
  5. amount-in - Amount of input token
  6. order-type - Order type (GOOD_TIL_CANCELLED, GOOD_TIL_TIME, FILL_OR_KILL, IMMEDIATE_OR_CANCEL, JUST_IN_TIME)
  7. expiration-time - (Optional) Expiration time for GTT orders

​
Order Management

​
Cancel Limit Order

neutrond tx dex cancel-limit-order \
  tranche-key-here \
  --from mykey \
  --chain-id neutron-1

​
Withdraw Filled Limit Order

neutrond tx dex withdraw-filled-limit-order \
  tranche-key-here \
  --from mykey \
  --chain-id neutron-1

​
Querying DEX State

​
Pool Information

​
List All Pool Metadata

neutrond query dex list-pool-metadata

​
Get Pool by ID

neutrond query dex show-pool-by-id 1

​
Get Pool by Parameters

neutrond query dex show-pool "untrn<>uatom" 0 3000

​
Check Pool Reserves

neutrond query dex show-pool-reserves "untrn<>uatom" untrn 0 3000

​
List All Pool Reserves for Pair

neutrond query dex list-pool-reserves "untrn<>uatom" untrn

​
User Positions

​
Check Your Liquidity Positions

neutrond query dex list-user-deposits neutron1... --include-pool-data

​
Check Your Limit Orders

neutrond query dex list-user-limit-orders neutron1...

​
Get Specific Limit Order Tranche User

neutrond query dex show-limit-order-tranche-user neutron1... tranche-key

​
Market Data

​
View Tick Liquidity

neutrond query dex list-tick-liquidity "untrn<>uatom" untrn

​
List Limit Order Tranches

neutrond query dex list-limit-order-tranche "untrn<>uatom" untrn

​
Get Specific Limit Order Tranche

neutrond query dex show-limit-order-tranche "untrn<>uatom" untrn 100 tranche-key

​
Simulation and Testing

Use simulation queries to preview operations before executing them.

​
Simulate Deposit

Use the simulate-deposit endpoint with a JSON message body containing the same parameters as the deposit transaction.

​
Simulate Withdrawal

Use the simulate-withdrawal endpoint with a JSON message body containing the same parameters as the withdrawal transaction.

​
Simulate Multi-Hop Swap

Use the simulate-multi-hop-swap endpoint with a JSON message body containing the same parameters as the swap transaction.

​
Simulate Limit Order

Use the simulate-place-limit-order endpoint with a JSON message body containing the same parameters as the place limit order transaction.

​
Best Practices

​
For Liquidity Providers

  1. Fee Tier Selection: Choose appropriate fee tiers based on pair volatility
  2. Position Management: Regularly monitor and rebalance positions
  3. Risk Assessment: Understand impermanent loss implications

​
For Traders

  1. Order Type Selection: Choose the right order type for your strategy
  2. Price Protection: Always set reasonable exit limit prices
  3. Gas Optimization: Consider transaction costs vs. trade size

​
General

  1. Testing: Always use simulation endpoints before executing transactions
  2. Validation: Verify all parameters before submitting transactions
  3. Monitoring: Track your positions and orders regularly
For complete command syntax and additional options, use neutrond tx dex --help and neutrond query dex --help.