Pools, quotes, liquidity
Swap / AMM
Quote, swap and provide liquidity across DRC-20 ↔ DOGE pools. 1% of every swap pays liquidity providers.
Swap is an automated market maker for DRC-20 ↔ DOGE, plus a bonding-curve launchpad for brand-new coins.
Endpoints below are relative to https://amm.dogesoft.io/api.
Fee model
Every swap pays a 1% fee (swap_fee_bps = 100) to the
pool's liquidity providers. For a DOGE → DRC-20 swap, the fee is taken out of the DOGE going in, before it
hits the pool's reserve calculation; for a DRC-20 → DOGE swap, it's taken out of the gross DOGE coming
out. Anyone can supply liquidity to a pool and earn a pro-rata share of that fee.
Quotes & pools
| Endpoint | Description |
|---|---|
GET/POST /swap/quote | Price a swap before submitting it — includes the 1% fee. |
GET /pools | List every active pool. |
GET /pools/:tokenA/:tokenB | Reserves and depth for one specific pool. |
Executing a swap
| Endpoint | Description |
|---|---|
POST /swap/create | Initiate a swap against a quote. |
POST /swap/execute | Confirm and settle a created swap. |
GET /swap/status/:id | Poll a swap's settlement status. |
GET /swap/history/:address | Past swaps for an address. |
Providing liquidity
| Endpoint | Description |
|---|---|
GET /liquidity/positions/:walletAddress | Your open positions across all pools. |
POST /liquidity/add | Deposit both sides of a pair into a pool. |
POST /liquidity/remove | Withdraw a position. |
GET /liquidity/fees/:walletAddress | Unclaimed fee balance across your positions. |
POST /liquidity/claim-fees | Claim accrued fees — signature-gated, settles asynchronously. |
claim-fees requires a wallet-signed authorization, then atomically zeroes
your unclaimed balance and records the claim. It returns 202 Accepted —
settlement to your address happens shortly after, not in the same request.
Bonding-curve launches
Brand-new coins can launch through a bonding curve before they have enough depth for a real pool — see how bonding-curve pricing works.
| Endpoint | Description |
|---|---|
GET /bonding/active | Coins currently on the bonding curve. |
POST /bonding/launch | Launch a new bonding-curve coin. Requires a Doge Soft-issued API key — not a public self-serve endpoint. |
GET /bonding/:symbol | Current curve state for one coin. |
POST /bonding/quote | Price a bonding-curve buy before committing. |
POST /bonding/:symbol/reserve | Reserve an allocation ahead of confirmation. |
POST /bonding/confirm | Confirm a reserved purchase once payment lands on-chain. |
Status. Quotes and pool/position reads are the most exercised part of this API. Execution and liquidity management are newer — known rough edges include slippage-failure refunds not yet being fully automatic, and liquidity-removal behavior when a position has unclaimed fees still being finished. Check ecosystem status before depending on either in production.