AMM & On-Chain Liquidity
The x/amm module is QoreChain's native, on-chain automated market maker (AMM). It lets anyone create liquidity pools, provide liquidity, and swap between QoreChain-native assets directly at the protocol level — no off-chain order book and no external smart-contract DEX required. It is the on-chain settlement layer behind the Dashboard Trade / DEX experience.
Pools follow familiar AMM pricing curves:
constant_product— thex*y=kcurve (general-purpose pairs).stable_swap— a low-slippage curve for closely-pegged pairs, tuned by an amplification coefficient.
All amounts use QoreChain's native units. The staking and fee token is QOR, whose base denom is uqor (1 QOR = 10^6 uqor). Pool participants and addresses use the qor bech32 prefix.
Commands below use qorechaind. Append the usual transaction flags (--from, --chain-id, --gas, --fees, --node) for your environment — for example --chain-id qorechain-vladi --gas 400000 --fees 40000uqor against mainnet (the network fee floor is 0.1 uqor per unit of gas). Every tx amm command is a Cosmos-lane transaction, so it needs the hybrid post-quantum signature: add --generate-only > tx.json, then run qorechaind tx pqc cosign tx.json --from <key> --pqc-key <name> --chain-id <id> (see First Transaction).
The AMM module is live on mainnet and the testnet (mainnet on v3.2.7 since 12 November 2026; the testnet on v3.2.8 since 12 November 2026). No pool has been created on mainnet yet (checked 30 October 2026 and again on 4 November 2026: GET /qorechain/amm/v1/pools returns an empty list there). The testnet has one pool (id 1, uqor against a Fest test token; testnet only, no value). The denoms in the examples below (uusdc, uusdt) are illustrative: no such assets exist on the networks today. Until a pool exists, every swap or add-liquidity command fails with a pool-not-found error.
Module parameters
Read the live values with qorechaind query amm params or GET /qorechain/amm/v1/params. Mainnet and testnet currently report the same values:
| Parameter | Value | Meaning |
|---|---|---|
enabled | true | Module switch |
swap_fee_bps | 30 | Swap fee, 0.30 % of the input amount |
protocol_fee_bps | 10 | The part of the swap fee that leaves the pool as the protocol share (0.10 % of the input). The rest stays in the pool for liquidity providers |
pool_creation_fee | 100000000 | 100 QOR (in uqor), charged on top of the initial deposits and burned when a pool is created |
min_liquidity | 1000 | The smaller of a new pool's two initial deposits must be at least this many base units |
max_pools_per_creator | 50 | Pools one account may create |
max_swap_impact_bps | 500 | Largest price impact a swap may have (5 %); see Swap rules |
lp_token_decimals | 6 | Display decimals of a pool's LP shares (cosmetic: LP shares are ledger entries, not tokens) |
Swap rules enforced since v3.2.2
The AMM integrity fixes below were applied to mainnet with v3.2.2 (height 3,556,788, 16 October 2026) and refined in v3.2.3 (height 3,662,051, 20 October 2026). They apply to every swap, whichever lane it arrives from.
- Both denominations are bound to the pool. A swap must name the two denoms of the pool it targets. Stable-swap pools are priced with the stable-swap curve in both directions (exact-in and exact-out).
- Protocol fee. The protocol share of the swap fee leaves the pool. When it is paid in QOR it goes to the fee collector and is split with the block's other fees (see Tokenomics), with the burned part recorded under the
ammburn source; in any other denomination it goes to the community pool. The pool creation fee is burned and recorded under the sameammsource. - Price-impact cap.
max_swap_impact_bpsis enforced: a swap whose price impact over the pool's price exceeds 5 % is refused. A swap that sets no slippage bound (min-outof 0 on exact-in, or amax-inthat covers the whole input reserve on exact-out) is additionally measured against the pool's price at the start of the block and is refused if earlier trades in the same block moved it past the cap. Set a realmin-out/max-inon every swap. - Bounded end-of-block work (v3.2.3). At the end of each block the module refreshes the running weighted-average price of at most 100 pools, round-robin. While there are 100 pools or fewer, every pool is refreshed every block; beyond that, a pool's average updates once per round of
ceil(pools / 100)blocks. The average is informational (it is returned bypoolqueries) and does not change swap pricing.
Pools and LP shares
A pool holds reserves of two denoms (token_a, token_b, stored in sorted order) and records LP shares that represent a proportional claim on those reserves. Each pool has a numeric id, a type and a status (active or paused). When you add liquidity your LP share balance in that pool rises; when you remove liquidity it falls and you receive your share of the reserves.
LP shares are entries in the AMM module's own ledger, kept per pool and per account (the internal key is amm-lp/<pool id>). They are not bank coins and not ERC-20 tokens, they do not appear in your bank balance, and they cannot be transferred, sent to another account or traded. Read your share with the lp-balance query or the /lp/{address} route below.
Create a pool
create-pool takes a pool type and the two initial deposits (as coins). For a stable pair, set the amplification coefficient with --amp.
# Constant-product pool seeded with QOR and a bridged USD asset
qorechaind tx amm create-pool constant_product 1000000000uqor 1000000000uusdc \
--from qor1youraddr... --chain-id qorechain-vladi
# Stable-swap pool with an amplification coefficient
qorechaind tx amm create-pool stable_swap 1000000000uusdc 1000000000uusdt \
--amp 200 --from qor1youraddr... --chain-id qorechain-vladi
Add liquidity
add-liquidity deposits both sides into a pool and credits your LP share balance. The final argument is the minimum LP share amount you will accept — your protection against the pool ratio shifting before your transaction lands.
qorechaind tx amm add-liquidity 1 500000000uqor 500000000uusdc 100000 \
--from qor1youraddr... --chain-id qorechain-vladi
Remove liquidity
remove-liquidity debits LP shares from your balance and withdraws reserves. The two min arguments set the minimum amount of each side you will accept back.
qorechaind tx amm remove-liquidity 1 100000 490000000 490000000 \
--from qor1youraddr... --chain-id qorechain-vladi
Swaps
The AMM supports the two standard swap directions.
Exact-in
swap-exact-in spends a fixed input amount and returns however much output the curve yields, subject to a minimum-out floor (slippage protection).
# Spend exactly 1,000,000 uqor for uusdc, refusing anything below 990,000 uusdc out
qorechaind tx amm swap-exact-in 1 1000000uqor uusdc 990000 \
--from qor1youraddr... --chain-id qorechain-vladi
Exact-out
swap-exact-out requests a fixed output amount and spends however much input is required, subject to a maximum-in ceiling.
# Receive exactly 1,000,000 uusdc, spending at most 1,010,000 uqor
qorechaind tx amm swap-exact-out 1 uqor 1000000uusdc 1010000 \
--from qor1youraddr... --chain-id qorechain-vladi
The trailing min-out / max-in argument on every swap is the slippage guard: set it from a fresh quote (below) plus your tolerance, and the transaction reverts if the executed price would breach it.
Quotes (price preview)
Quotes are read-only — they preview a swap without submitting it, so a client can show an expected output and fee before the user signs. They are the natural backing for a Trade UI's price field.
# Preview the output of spending 1,000,000 uqor into pool 1
qorechaind query amm quote-exact-in 1 uqor 1000000
# -> returns amount_out and fee
# Preview the input needed to receive 1,000,000 uusdc from pool 1
qorechaind query amm quote-exact-out 1 uusdc 1000000
# -> returns amount_in and fee
The returned fee is the swap fee the AMM applies to the trade. Fee and slippage levels are pool/parameter-driven; use the quote endpoints to see their concrete effect on any given trade rather than computing them by hand.
Inspecting pools and balances
All of these are read-only queries that anyone can run.
# Module parameters
qorechaind query amm params
# A single pool by ID
qorechaind query amm pool 1
# Every pool
qorechaind query amm pools
# Resolve a pool from its denom pair (order-independent)
qorechaind query amm pool-by-denoms uqor uusdc
# An account's LP balance in a pool
qorechaind query amm lp-balance 1 qor1youraddr...
pool returns the pool's reserves, LP supply, type, status, and a running weighted-average price. lp-balance returns the LP share balance an account holds for that pool.
REST routes
The same reads are served over REST on both mainnet (https://api.qore.host) and the testnet (https://api-testnet.qore.host); they were checked on both on 27 October 2026:
| Route | Returns |
|---|---|
GET /qorechain/amm/v1/params | Module parameters |
GET /qorechain/amm/v1/pools | Every pool (an empty list while none exists) |
GET /qorechain/amm/v1/pools/{pool_id} | One pool (404 if unknown) |
GET /qorechain/amm/v1/pools/{pool_id}/lp/{address} | An address's LP balance in the pool ({address} is a qor1... bech32 address) |
GET /qorechain/amm/v1/pool_by_denoms?denom_a=&denom_b= | The pool for a denom pair (404 if none) |
GET /qorechain/amm/v1/quote/exact_in?pool_id=&denom_in=&amount_in= | Output and fee for an exact input |
GET /qorechain/amm/v1/quote/exact_out?pool_id=&denom_out=&amount_out= | Input and fee for an exact output |
A quote against a pool that does not exist answers with a pool-not-found error.
Testnet Fest tokens
Testnet governance registered three test ERC-20 contracts, fUSD (6 decimals), fETH (18) and fBTC (8), so that they exist as bank coins with the case-sensitive denominations erc20:<EIP-55 contract address> (listed on the Faucet page). Holders obtain the bank coin with MsgConvertERC20 (the sender must be a qor1... bech32 address) and can create a pool against uqor with the usual create-pool command and the 100 QOR creation fee. They are testnet-only test tokens with no value, and no pool for them exists yet (checked 27 October 2026). Mainnet has no such tokens.
Pausing and resuming a pool
Pools can be paused and resumed by the governance authority. On mainnet these two messages are currently switched off by the circuit breaker; on the testnet they are not switched off. A paused pool rejects swaps and liquidity changes until it is resumed — useful for incident response or coordinated maintenance.
Command summary
Transactions (qorechaind tx amm …):
| Command | Purpose |
|---|---|
create-pool | Create a constant_product or stable_swap pool |
add-liquidity | Deposit reserves and credit LP shares |
remove-liquidity | Debit LP shares and withdraw reserves |
swap-exact-in | Swap a fixed input amount |
swap-exact-out | Swap to a fixed output amount |
pause-pool | Pause a pool (governance authority; switched off on mainnet) |
resume-pool | Resume a paused pool (governance authority; switched off on mainnet) |
Queries (qorechaind query amm …):
| Command | Purpose |
|---|---|
params | Show module parameters |
pool | Show one pool by ID |
pools | List all pools |
pool-by-denoms | Resolve a pool from its denom pair |
lp-balance | An account's LP balance in a pool |
quote-exact-in | Preview output for a fixed-input swap |
quote-exact-out | Preview input for a fixed-output swap |
Related
- The Dashboard Trade / DEX surfaces these pools, quotes, and swaps in a graphical interface for everyday users.
- For how QOR supply, fees, and value flow through the chain, see Tokenomics.
- Try swaps yourself in the Trade / DEX interface.
- To bring assets onto QoreChain first, see Bridging Assets (the bridge is not live yet).
- Pools can also be a fee price source for Gas Abstraction; no token is accepted for fees today.