# SaucerSwap

> Official documentation for SaucerSwap, the decentralized exchange on the Hedera network: trading, liquidity, staking, developer guides, and API reference.

- [SaucerSwap documentation](https://docs.saucerswap.finance/index.md): Learn how to swap, trade on the order book, provide liquidity, stake SAUCE, and build on SaucerSwap, the largest decentralized exchange on Hedera by volume.
- [Quickstart: your first swap](https://docs.saucerswap.finance/get-started/quickstart.md): Go from zero to your first token swap on SaucerSwap in five steps: create a Hedera wallet, fund it with HBAR, associate a token, swap, and verify.
- [Create a Hedera wallet](https://docs.saucerswap.finance/get-started/wallet.md): Set up a self-custody wallet for Hedera: SaucerSwap Wallet, HashPack, Kabila Wallet, or MetaMask with the Hedera JSON-RPC relay.
- [Get HBAR](https://docs.saucerswap.finance/get-started/hbar.md): HBAR pays every network fee on Hedera. Acquire it through centralized exchanges, fiat on-ramps like MoonPay and Banxa, or by bridging and swapping.
- [Bridge to Hedera](https://docs.saucerswap.finance/get-started/bridge-to-hedera.md): Move assets from Ethereum, Base, and other chains onto Hedera using the in-app bridge, Squid via Axelar, or Stargate via LayerZero — Hashport is gone.
- [SaucerSwap Wallet](https://docs.saucerswap.finance/get-started/saucerswap-wallet.md): SaucerSwap Wallet is a self-custody mobile wallet for Hedera on iOS and Android: swap, stake, explore tokens, and connect to Hedera dApps on the go.
- [Swap tokens](https://docs.saucerswap.finance/tutorials/swap.md): Swap any listed HTS token on SaucerSwap: pick tokens, set slippage tolerance, review the quote and fees, approve an allowance, and confirm in your wallet.
- [Trade on the order book](https://docs.saucerswap.finance/tutorials/trade.md): Learn to trade on SaucerSwap V3: read an order book, choose a market or limit order, review token permissions and fees, sign, and check your fills.
- [Manage V3 orders](https://docs.saucerswap.finance/tutorials/manage-v3-orders.md): Track SaucerSwap V3 orders and partial fills, cancel unfilled amounts, check settlement history, and review the standing token permissions in your wallet.
- [Provide liquidity on V1](https://docs.saucerswap.finance/tutorials/liquidity-v1.md): Supply tokens to SaucerSwap V1 constant-product pools, stake LP tokens in the yield farm, harvest SAUCE and HBAR rewards, and withdraw liquidity.
- [Provide liquidity on V2](https://docs.saucerswap.finance/tutorials/liquidity-v2.md): Create and manage SaucerSwap V2 concentrated liquidity positions: choose a fee tier, set a price range, claim fees, earn LARI, or use auto pools.
- [Stake SAUCE](https://docs.saucerswap.finance/tutorials/stake.md): Stake SAUCE in the Infinity Pool and receive xSAUCE, a liquid staking token that accrues revenue-funded SAUCE buybacks from fees and HBAR staking.
- [Bridge assets in the app](https://docs.saucerswap.finance/tutorials/bridge.md): Move tokens between Hedera and other chains from SaucerSwap's bridge page, with routing over Axelar and LayerZero, fee expectations, and fixes.
- [Track your portfolio](https://docs.saucerswap.finance/tutorials/portfolio.md): Use the SaucerSwap dashboard to monitor token balances, V1 and V2 positions, farm and LARI rewards, xSAUCE, order history, and any watched address.
- [Wrap between HTS and ERC-20](https://docs.saucerswap.finance/tutorials/erc20-wrapping.md): Use SaucerSwap's ERC-20 wrapping tool to convert tokens between their HTS and ERC-20 forms for MetaMask and EVM tooling, and unwrap them back.
- [Frequently asked questions](https://docs.saucerswap.finance/get-started/faq.md): Answers to common questions about SaucerSwap: getting started, swapping, order book trading, liquidity, staking, fees, tokens, and troubleshooting.
- [Troubleshooting](https://docs.saucerswap.finance/resources/troubleshooting.md): Fixes for the most common SaucerSwap errors: token association, insufficient HBAR, contract reverts, slippage failures, allowances, and stuck bridges.
- [How SaucerSwap works](https://docs.saucerswap.finance/protocol/overview.md): How SaucerSwap's parts fit together on Hedera: AMM pools, the V3 order book, protocol fees, farm and LARI incentives, xSAUCE staking, and the DAO.
- [Swap routing](https://docs.saucerswap.finance/protocol/routing.md): How SaucerSwap compares V1/V2 AMM routes with V3 order-book quotes, selects a venue for your swap, and uses AMM-backed settlement for eligible V3 orders.
- [SaucerSwap V1](https://docs.saucerswap.finance/protocol/saucerswap-v1.md): How SaucerSwap V1's constant-product AMM works on Hedera: the xy=k formula, the 0.30% swap fee and its split, price impact, and the yield farm.
- [Farm weights](https://docs.saucerswap.finance/protocol/saucerswap-v1/farm-weights.md): SaucerSwap V1 farm allocation points and each pool's share of the 1,200-point Phase 1 reward budget, with live data and Masterchef verification links.
- [SaucerSwap V2](https://docs.saucerswap.finance/protocol/saucerswap-v2.md): How SaucerSwap V2's concentrated-liquidity AMM works: price ranges and ticks, fee tiers, volatility strategies, position NFTs, and LARI rewards.
- [LARI weights](https://docs.saucerswap.finance/protocol/saucerswap-v2/lari-weights.md): SaucerSwap V2 LARI reward funding under Phase 1, published per-pool SAUCE and HBAR epoch allocations, and links to official distribution results.
- [SaucerSwap V3](https://docs.saucerswap.finance/protocol/saucerswap-v3.md): Understand SaucerSwap V3's order book: bids and asks, maker and taker orders, wallet-held funds, off-chain matching, and on-chain settlement on Hedera.
- [V3 markets](https://docs.saucerswap.finance/protocol/saucerswap-v3/markets.md): Explore SaucerSwap V3 markets, minimum order sizes, price and quantity increments, market-making inventory, trading halts, and settlement permissions.
- [V3 fees and rebates](https://docs.saucerswap.finance/protocol/saucerswap-v3/fees.md): Understand SaucerSwap V3 trading fees, maker rebates, xSAUCE discount tiers, and how net fees fund SAUCE buybacks through the Unified BrewSaucer.
- [Single-sided staking](https://docs.saucerswap.finance/protocol/single-sided-staking.md): How the Infinity Pool works: stake SAUCE for xSAUCE, earn a share of Unified BrewSaucer buybacks, and understand the rate math behind staking APR.
- [SAUCE tokenomics](https://docs.saucerswap.finance/tokenomics/overview.md): SAUCE supply and Phase 1 tokenomics: Masterchef emissions, liquidity rewards, devcut burn, and Unified BrewSaucer revenue routing for the protocol.
- [SaucerSwap governance](https://docs.saucerswap.finance/governance/overview.md): How the SaucerSwap DAO works: token-weighted voting with SAUCE and xSAUCE, the RFC-to-election proposal lifecycle, scope, and treasury contracts.
- [DAO reporting](https://docs.saucerswap.finance/governance/dao-reporting.md): Downloadable transaction-level reports for the SaucerSwap DAO treasury, published as CSV files to the official DAO-Reporting GitHub repository.
- [Developer overview](https://docs.saucerswap.finance/developers/overview.md): Start here to build on SaucerSwap: choose between the REST data API, the V3 Orderbook API, and on-chain contracts, with auth models and testnet setup.
- [Developer quickstart](https://docs.saucerswap.finance/developers/quickstart.md): Make your first SaucerSwap API calls in minutes: fetch token data and pools from the REST API and get a live on-chain swap quote from QuoterV2.
- [Contract deployments](https://docs.saucerswap.finance/developers/contracts.md): SaucerSwap contract and token IDs on Hedera mainnet and testnet, with explorer verification, Phase 1 fee routing, V3 signing, and SAUCE on Base.
- [Swap quote (V1)](https://docs.saucerswap.finance/developers/v1/swap/swap-quote.md): Get SaucerSwap V1 swap quotes with the getAmountsOut and getAmountsIn functions through the Hedera JSON-RPC relay or mirror node, at no gas cost.
- [Swap HBAR for tokens (V1)](https://docs.saucerswap.finance/developers/v1/swap/swap-hbar-for-tokens.md): Swap HBAR for HTS tokens through the SaucerSwap V1 router: exact-input, exact-output, and fee-on-transfer variants with Hedera SDK TypeScript examples.
- [Swap tokens for HBAR (V1)](https://docs.saucerswap.finance/developers/v1/swap/swap-tokens-for-hbar.md): Swap HTS tokens for HBAR through the SaucerSwap V1 router: exact-input, exact-output, and fee-on-transfer variants with allowance and association checks.
- [Swap tokens for tokens (V1)](https://docs.saucerswap.finance/developers/v1/swap/swap-tokens-for-tokens.md): Swap HTS tokens for other HTS tokens through the SaucerSwap V1 router, covering exact-input, exact-output, and fee-on-transfer variants with examples.
- [Track swap events (V1)](https://docs.saucerswap.finance/developers/v1/swap/track-swap-events.md): Monitor SaucerSwap V1 Swap events in near real time by polling the Hedera mirror node REST API or the JSON-RPC relay, with log grouping by transaction.
- [V1 liquidity operations](https://docs.saucerswap.finance/developers/v1/liquidity/overview.md): Developer guide to SaucerSwap V1 liquidity operations: fetch pools, check pool existence, read reserves, create pools, and add or remove liquidity.
- [Adding liquidity (V1)](https://docs.saucerswap.finance/developers/v1/liquidity/adding-liquidity.md): Add liquidity to existing SaucerSwap V1 pools with the addLiquidityETH and addLiquidity functions, including allowance and LP token association setup.
- [Removing liquidity (V1)](https://docs.saucerswap.finance/developers/v1/liquidity/removing-liquidity.md): Remove liquidity from SaucerSwap V1 pools with the removeLiquidityETH, removeLiquidity, and fee-on-transfer functions, including allowance requirements.
- [Create a new pool (V1)](https://docs.saucerswap.finance/developers/v1/liquidity/create-a-new-pool.md): Create new SaucerSwap V1 liquidity pools with addLiquidityETHNewPool and addLiquidityNewPool, including the pool creation fee and auto-association setup.
- [Check if a pool exists (V1)](https://docs.saucerswap.finance/developers/v1/liquidity/check-if-a-pool-exists.md): Check whether a SaucerSwap V1 liquidity pool exists on-chain with the factory getPair function before creating a pool or adding liquidity on Hedera.
- [Fetch all pools (V1)](https://docs.saucerswap.finance/developers/v1/liquidity/fetch-all-pools.md): Retrieve every SaucerSwap V1 liquidity pool with reserves and token metadata from the SaucerSwap REST API, including the response schema and an example.
- [Get pool reserves (V1)](https://docs.saucerswap.finance/developers/v1/liquidity/get-pool-reserves.md): Read current SaucerSwap V1 pool reserves through the Hedera mirror node REST API or the getReserves contract function over the public JSON-RPC relay.
- [Pool creation fee (V1)](https://docs.saucerswap.finance/developers/v1/liquidity/pool-creation-fee.md): Fetch the current SaucerSwap V1 pool creation fee from the factory contract in tinycent and convert it to HBAR with the mirror node exchange rate API.
- [Track pool updates (V1)](https://docs.saucerswap.finance/developers/v1/liquidity/track-pool-updates.md): Track SaucerSwap V1 liquidity reserve changes in near real time by polling Sync events for one pool or all pools via the mirror node REST or JSON-RPC.
- [Swap quote (V2)](https://docs.saucerswap.finance/developers/v2/swap/swap-quote.md): Get SaucerSwap V2 swap quotes from the QuoterV2 contract with quoteExactInput and quoteExactOutput over JSON-RPC or the mirror node, at no gas cost.
- [Swap HBAR for tokens (V2)](https://docs.saucerswap.finance/developers/v2/swap/swap-hbar-for-tokens.md): Swap HBAR for HTS tokens through the SaucerSwap V2 SwapRouter using exactInput and exactOutput multicalls with refundETH, with TypeScript code examples.
- [Swap tokens for HBAR (V2)](https://docs.saucerswap.finance/developers/v2/swap/swap-tokens-for-hbar.md): Swap HTS tokens for HBAR through the SaucerSwap V2 SwapRouter using exactInput and exactOutput with unwrapWHBAR multicalls and allowance pre-checks.
- [Swap tokens for tokens (V2)](https://docs.saucerswap.finance/developers/v2/swap/swap-tokens-for-tokens.md): Swap HTS tokens for other HTS tokens through the SaucerSwap V2 SwapRouter with exactInput and exactOutput, including path encoding with pool fee tiers.
- [Track swap events (V2)](https://docs.saucerswap.finance/developers/v2/swap/track-swap-events.md): Monitor SaucerSwap V2 Swap events in near real time by polling the Hedera mirror node REST API or JSON-RPC relay, including price and liquidity fields.
- [New liquidity position (V2)](https://docs.saucerswap.finance/developers/v2/liquidity/new-liquidity-position.md): Mint a new SaucerSwap V2 concentrated liquidity position NFT with the mint multicall, including tick range selection built with the Uniswap V3 SDK.
- [Increasing liquidity (V2)](https://docs.saucerswap.finance/developers/v2/liquidity/increasing-liquidity.md): Add more liquidity to an existing SaucerSwap V2 position with increaseLiquidity, including slippage-safe amounts computed with the Uniswap V3 SDK.
- [Decreasing liquidity (V2)](https://docs.saucerswap.finance/developers/v2/liquidity/decreasing-liquidity.md): Decrease or fully exit a SaucerSwap V2 liquidity position with the decreaseLiquidity, collect, unwrapWHBAR, and optional burn calls in one multicall.
- [Claiming fees (V2)](https://docs.saucerswap.finance/developers/v2/liquidity/claiming-fees.md): Claim accrued swap fees from a SaucerSwap V2 liquidity position with the collect function, adding an unwrapWHBAR multicall for pools that include HBAR.
- [Get user positions (V2)](https://docs.saucerswap.finance/developers/v2/liquidity/get-user-positions.md): List all SaucerSwap V2 liquidity positions for a Hedera account from the SaucerSwap REST API, including liquidity, tick range, and fees earned data.
- [Liquidity position fee (V2)](https://docs.saucerswap.finance/developers/v2/liquidity/liquidity-position-fee.md): Fetch the current SaucerSwap V2 mint fee from the factory contract in tinycent and convert it to HBAR using the mirror node network exchange rate API.
- [Fetch all pools (V2)](https://docs.saucerswap.finance/developers/v2/liquidity/fetch-all-pools.md): Retrieve every SaucerSwap V2 concentrated liquidity pool with fee tier, tick, and liquidity data from the SaucerSwap REST API, with response schemas.
- [Fetch pool token ratio (V2)](https://docs.saucerswap.finance/developers/v2/liquidity/fetch-pool-token-ratio.md): Read the current token price ratio of a SaucerSwap V2 pool with slot0 and the Uniswap V3 SDK to size both token amounts of a new liquidity position.
- [Check if a pool exists (V2)](https://docs.saucerswap.finance/developers/v2/liquidity/check-if-a-pool-exists.md): Check whether a SaucerSwap V2 pool exists for a token pair and fee tier with the factory getPool function before minting a new liquidity position.
- [TypeScript bot client](https://docs.saucerswap.finance/developers/orderbook/typescript-client.md): Reference TypeScript client pattern for server-side SaucerSwap V3 Orderbook API bots: authenticate, build, sign, save, stream, and cancel orders.
- [Single-sided staking operations](https://docs.saucerswap.finance/developers/staking/single-sided-staking.md): Contract operations for SAUCE single-sided staking: convert between SAUCE and xSAUCE amounts and stake or unstake through the Mothership contract.
- [Yield farming operations](https://docs.saucerswap.finance/developers/staking/yield-farming.md): Contract operations for SaucerSwap yield farms: deposit and withdraw LP tokens and read pending SAUCE and HBAR rewards from the Masterchef contract.
- [WHBAR overview](https://docs.saucerswap.finance/developers/whbar/overview.md): How the WHBAR and WhbarHelper contracts wrap HBAR for smart contract use on SaucerSwap, plus the WHBAR allowance security advisory for integrators.
- [Wrap HBAR for WHBAR](https://docs.saucerswap.finance/developers/whbar/wrap-hbar-for-whbar.md): Wrap native HBAR into WHBAR tokens at a 1:1 ratio through the WhbarHelper deposit function, with token association requirements and a code example.
- [Unwrap WHBAR for HBAR](https://docs.saucerswap.finance/developers/whbar/unwrap-whbar-for-hbar.md): Unwrap WHBAR tokens back into native HBAR at a 1:1 ratio through the WhbarHelper unwrapWhbar function, including the required spender allowance setup.
- [Security audits](https://docs.saucerswap.finance/developers/security/audits.md): Independent security audits of SaucerSwap V1, V2, V3, and the mobile wallet by Hacken, Omniscia, Halborn, and Quantstamp, with links to every report.
- [Bug bounty](https://docs.saucerswap.finance/developers/security/bug-bounty.md): SaucerSwap bug bounty program: material loss of funds requirement, eligible vulnerabilities, exclusions, rewards, and responsible disclosure rules.
- [Build with AI](https://docs.saucerswap.finance/developers/ai.md): Build on SaucerSwap with AI coding tools: llms.txt indexes, the docs MCP server, per-client setup, and a rules file with canonical endpoints and gotchas.
- [SaucerSwap API reference](https://docs.saucerswap.finance/api-reference/overview.md): Orientation for SaucerSwap's two HTTP APIs — the REST data API and the V3 Orderbook API — with base URLs, authentication models, and an endpoint index.
- [REST API authentication](https://docs.saucerswap.finance/api-reference/authentication.md): Request a SaucerSwap REST API key, authenticate requests with the x-api-key header over HTTPS, and read the monthly quota headers on every response.
- [REST API conventions](https://docs.saucerswap.finance/api-reference/conventions.md): How the SaucerSwap REST API represents money and time: tinybar prices, smallest-unit amounts as strings, unix timestamps, and interval endpoints.
- [REST API errors and rate limits](https://docs.saucerswap.finance/api-reference/errors.md): Interpret REST API error statuses including 401, 403, and 429, monitor monthly quota headers, and build retry logic that respects your limits.
- [REST API: General statistics](https://docs.saucerswap.finance/api-reference/rest/stats/general-stats.md): Retrieve protocol-wide SaucerSwap statistics in one call: circulating SAUCE supply, total swap count, TVL in tinybar and USD, and all-time volume.
- [REST API: Single-sided staking statistics](https://docs.saucerswap.finance/api-reference/rest/stats/sss-stats.md): Retrieve single-sided staking statistics: the current xSAUCE to SAUCE ratio, 5-day average APR, and staked SAUCE and xSAUCE amounts in smallest units.
- [REST API: Historical HBAR prices](https://docs.saucerswap.finance/api-reference/rest/stats/hbar-historical-prices.md): Query minutely historical HBAR prices in USD between two unix-second timestamps, for charting, backtesting, and converting tinybar values to dollars.
- [REST API: Platform liquidity and volume history](https://docs.saucerswap.finance/api-reference/rest/stats/platform-data.md): Query historical platform-wide liquidity or volume in tinybar over hourly, daily, or weekly intervals between two unix-second timestamps you choose.
- [REST API: List all tokens (compact)](https://docs.saucerswap.finance/api-reference/rest/tokens/list-tokens.md): List every token traded on SaucerSwap in compact form: token id, symbol, decimals, icon path, price in tinybar and USD, and due-diligence flags.
- [REST API: List all tokens (detailed)](https://docs.saucerswap.finance/api-reference/rest/tokens/list-tokens-full.md): List every token traded on SaucerSwap with full detail per token: description, website, X handle, sentinel report link, prices, and decimal places.
- [REST API: Get token by id](https://docs.saucerswap.finance/api-reference/rest/tokens/get-token.md): Retrieve detailed data for one token by Hedera token id, including price in tinybar and USD, decimals, description, website, and due-diligence flags.
- [REST API: Default listed tokens](https://docs.saucerswap.finance/api-reference/rest/tokens/default-listed-tokens.md): List default listed tokens, the tokens that have completed SaucerSwap due diligence, with full metadata, prices in tinybar and USD, and decimals.
- [REST API: Price changes for default listed tokens](https://docs.saucerswap.finance/api-reference/rest/tokens/default-token-price-changes.md): Retrieve hourly, daily, and weekly price change percentages plus USD price and liquidity for every default listed token on SaucerSwap in one call.
- [REST API: 24-hour price change map](https://docs.saucerswap.finance/api-reference/rest/tokens/price-change-map.md): Retrieve a mapping from Hedera token id to 24-hour price change percentage for tokens on SaucerSwap, suited to fast dashboard and ticker updates.
- [REST API: Daily metrics for all tokens](https://docs.saucerswap.finance/api-reference/rest/tokens/all-tokens-daily.md): Retrieve daily price, volume, and liquidity datapoints for all SaucerSwap tokens, with prices in tinybar and amounts in each token's smallest unit.
- [REST API: Weekly metrics for all tokens](https://docs.saucerswap.finance/api-reference/rest/tokens/all-tokens-weekly.md): Retrieve weekly price, volume, and liquidity datapoints for all SaucerSwap tokens, with prices in tinybar and amounts in each token's smallest unit.
- [REST API: Monthly metrics for all tokens](https://docs.saucerswap.finance/api-reference/rest/tokens/all-tokens-monthly.md): Retrieve monthly price, volume, and liquidity datapoints for all SaucerSwap tokens, prices in tinybar and amounts in each token's smallest unit.
- [REST API: Yearly metrics for all tokens](https://docs.saucerswap.finance/api-reference/rest/tokens/all-tokens-yearly.md): Retrieve yearly price, volume, and liquidity datapoints for all SaucerSwap tokens, with prices in tinybar and amounts in each token's smallest unit.
- [REST API: Daily metrics for a token](https://docs.saucerswap.finance/api-reference/rest/tokens/token-daily.md): Retrieve daily price, volume, and liquidity history for a single token by Hedera token id, with prices in tinybar and unix-second timestamps.
- [REST API: Weekly metrics for a token](https://docs.saucerswap.finance/api-reference/rest/tokens/token-weekly.md): Retrieve weekly price, volume, and liquidity history for a single token by Hedera token id, with prices in tinybar and unix-second timestamps.
- [REST API: Monthly metrics for a token](https://docs.saucerswap.finance/api-reference/rest/tokens/token-monthly.md): Retrieve monthly price, volume, and liquidity history for a single token by Hedera token id, with prices in tinybar and unix-second timestamps.
- [REST API: Yearly metrics for a token](https://docs.saucerswap.finance/api-reference/rest/tokens/token-yearly.md): Retrieve yearly price, volume, and liquidity history for a single token by Hedera token id, with prices in tinybar and unix-second timestamps.
- [REST API: Pools containing a token](https://docs.saucerswap.finance/api-reference/rest/tokens/associated-pools.md): List every SaucerSwap V1 pool that contains a given token, with pool contract ids, paired-token metadata, current reserves, and LP token details.
- [REST API: Token price history (candlesticks)](https://docs.saucerswap.finance/api-reference/rest/tokens/token-price-history.md): Query historical OHLCV candlestick data for a token between two unix-second timestamps at five-minute, hourly, daily, or weekly interval sizes.
- [REST API: Latest token candlestick](https://docs.saucerswap.finance/api-reference/rest/tokens/token-price-latest.md): Retrieve the most recent OHLCV candlestick for a token at a chosen interval, with open, high, low, close, and average prices in tinybar and USD.
- [REST API: Latest candlesticks for all tokens](https://docs.saucerswap.finance/api-reference/rest/tokens/ohlcv-latest.md): Retrieve the latest OHLCV candlestick for every SaucerSwap token in one call at a chosen interval, the bulk endpoint for price and chart refreshes.
- [REST API: List V1 pools (compact)](https://docs.saucerswap.finance/api-reference/rest/pools-v1/list-pools.md): List all SaucerSwap V1 liquidity pools in compact form, with pool and contract ids, paired token summaries, current reserves, and LP token metadata.
- [REST API: List V1 pools (detailed)](https://docs.saucerswap.finance/api-reference/rest/pools-v1/list-pools-full.md): List all SaucerSwap V1 liquidity pools with full token detail, including descriptions, websites, prices in tinybar and USD, and current reserves.
- [REST API: Get V1 pool by id](https://docs.saucerswap.finance/api-reference/rest/pools-v1/get-pool.md): Retrieve detailed data for one SaucerSwap V1 pool by pool id, including contract id, paired token metadata, current reserves, and LP token details.
- [REST API: Default listed V1 pools](https://docs.saucerswap.finance/api-reference/rest/pools-v1/default-listed-pools.md): List default listed SaucerSwap V1 pools, the pools whose tokens completed due diligence, with contract ids, token metadata, and current reserves.
- [REST API: Daily metrics for all V1 pools](https://docs.saucerswap.finance/api-reference/rest/pools-v1/all-pools-daily.md): Retrieve daily volume and liquidity datapoints for all SaucerSwap V1 pools, in each pool's smallest unit, keyed by pool id and unix timestamp.
- [REST API: Weekly metrics for all V1 pools](https://docs.saucerswap.finance/api-reference/rest/pools-v1/all-pools-weekly.md): Retrieve weekly volume and liquidity datapoints for all SaucerSwap V1 pools, in each pool's smallest unit, keyed by pool id and unix timestamp.
- [REST API: Monthly metrics for all V1 pools](https://docs.saucerswap.finance/api-reference/rest/pools-v1/all-pools-monthly.md): Retrieve monthly volume and liquidity datapoints for all SaucerSwap V1 pools, in each pool's smallest unit, keyed by pool id and unix timestamp.
- [REST API: Yearly metrics for all V1 pools](https://docs.saucerswap.finance/api-reference/rest/pools-v1/all-pools-yearly.md): Retrieve yearly volume and liquidity datapoints for all SaucerSwap V1 pools, in each pool's smallest unit, keyed by pool id and unix timestamp.
- [REST API: Daily metrics for a V1 pool](https://docs.saucerswap.finance/api-reference/rest/pools-v1/pool-daily.md): Retrieve daily volume and liquidity history for a single SaucerSwap V1 pool by pool id, in smallest units, with unix-second timestamps per point.
- [REST API: Weekly metrics for a V1 pool](https://docs.saucerswap.finance/api-reference/rest/pools-v1/pool-weekly.md): Retrieve weekly volume and liquidity history for a single SaucerSwap V1 pool by pool id, in smallest units, with unix-second timestamps per point.
- [REST API: Monthly metrics for a V1 pool](https://docs.saucerswap.finance/api-reference/rest/pools-v1/pool-monthly.md): Retrieve monthly volume and liquidity history for a single SaucerSwap V1 pool by pool id, in smallest units, with unix-second timestamps per point.
- [REST API: Yearly metrics for a V1 pool](https://docs.saucerswap.finance/api-reference/rest/pools-v1/pool-yearly.md): Retrieve yearly volume and liquidity history for a single SaucerSwap V1 pool by pool id, in smallest units, with unix-second timestamps per point.
- [REST API: V1 pool price history (candlesticks)](https://docs.saucerswap.finance/api-reference/rest/pools-v1/pool-conversion-rates.md): Query historical candlestick conversion rates for a V1 pool between two unix-second timestamps, with optional pair inversion and four interval sizes.
- [REST API: Latest V1 pool candlestick](https://docs.saucerswap.finance/api-reference/rest/pools-v1/pool-conversion-rates-latest.md): Retrieve the latest candlestick conversion rate for a V1 pool at a chosen interval, with open, high, low, close, volume, and liquidity fields.
- [REST API: List V2 pools (compact)](https://docs.saucerswap.finance/api-reference/rest/pools-v2/list-v2-pools.md): List all SaucerSwap V2 concentrated-liquidity pools in compact form, with fee tier, current tick, sqrt price ratio, liquidity, and token amounts.
- [REST API: List V2 pools (detailed)](https://docs.saucerswap.finance/api-reference/rest/pools-v2/list-v2-pools-full.md): List all SaucerSwap V2 concentrated-liquidity pools with full token metadata alongside fee tier, current tick, sqrt price ratio, and liquidity.
- [REST API: Get V2 pool by id](https://docs.saucerswap.finance/api-reference/rest/pools-v2/get-v2-pool.md): Retrieve one SaucerSwap V2 pool by pool id, including contract id, token pair detail, fee tier, current tick, sqrt price ratio, and liquidity.
- [REST API: V2 pool price history (candlesticks)](https://docs.saucerswap.finance/api-reference/rest/pools-v2/v2-pool-conversion-rates.md): Query historical candlestick conversion rates for a SaucerSwap V2 pool between two unix-second timestamps, with optional inversion of the pair.
- [REST API: V2 liquidity positions by account](https://docs.saucerswap.finance/api-reference/rest/pools-v2/v2-positions-by-account.md): List all SaucerSwap V2 liquidity positions for a Hedera account, with NFT serials, tick ranges, liquidity, fee growth, and tokens owed per position.
- [REST API: LARI rewards by account](https://docs.saucerswap.finance/api-reference/rest/pools-v2/lari-rewards-by-account.md): Retrieve estimated LARI rewards accrued by a Hedera account for the current epoch, updated hourly, with pool id, token id, and an epoch-final flag.
- [REST API: List active farms](https://docs.saucerswap.finance/api-reference/rest/farms/list-farms.md): List all active SaucerSwap yield farms with farm and pool ids, SAUCE and HBAR emission rates per minute, and total staked LP token amounts per farm.
- [REST API: Farm LP totals by account](https://docs.saucerswap.finance/api-reference/rest/farms/farm-totals-by-account.md): Retrieve the LP token amounts a Hedera account has staked in each SaucerSwap farm, with farm id, pool id, and the timestamp of the latest update.
- [Orderbook API overview](https://docs.saucerswap.finance/api-reference/orderbook/overview.md): Integrate with the SaucerSwap V3 Orderbook API: the integration flow, testnet and mainnet environments, and a full endpoint summary with auth requirements.
- [Orderbook API authentication](https://docs.saucerswap.finance/api-reference/orderbook/authentication.md): Authenticate with the SaucerSwap V3 Orderbook API: the challenge and verify JWT flow, supported account and key types, and how to protect your tokens.
- [Orderbook API market data](https://docs.saucerswap.finance/api-reference/orderbook/market-data.md): Read public SaucerSwap V3 market data: order book discovery, depth snapshots, the trade tape, exact-input and exact-output quotes, and pip fee units.
- [Orderbook API orders](https://docs.saucerswap.finance/api-reference/orderbook/orders.md): Place and cancel SaucerSwap V3 orders: fetch the EIP-712 domain, build orders, sign with the mode-byte prefix, save them, and confirm cancellations.
- [Orderbook API WebSockets](https://docs.saucerswap.finance/api-reference/orderbook/websockets.md): Subscribe to SaucerSwap V3 Orderbook API WebSocket streams: depth diffs and user events, token authentication, and snapshot-plus-diff book handling.
- [Orderbook API limits and errors](https://docs.saucerswap.finance/api-reference/orderbook/limits-and-errors.md): SaucerSwap V3 Orderbook API policy limits, the error response format, common HTTP status codes, and a production readiness checklist for clients.
- [For projects: list your token](https://docs.saucerswap.finance/resources/for-projects.md): How to list an HTS token on SaucerSwap: pool creation, token classes, icon and metadata submission, farm and LARI incentives, and cross-chain listing.
- [Market makers](https://docs.saucerswap.finance/resources/market-makers.md): How professional trading firms and bot operators onboard to the SaucerSwap V3 order book: mechanism, API access, policy limits, and contact path.
- [Analytics](https://docs.saucerswap.finance/resources/analytics.md): Where to find SaucerSwap data: in-app token, pool, staking, and portfolio analytics, plus third-party trackers like DefiLlama, GeckoTerminal, and CoinGecko.
- [Glossary](https://docs.saucerswap.finance/resources/glossary.md): Definitions of the AMM, Hedera, SaucerSwap, and API terms used across these docs, from concentrated liquidity and slippage to pips and token association.
- [Changelog](https://docs.saucerswap.finance/changelog.md): Dated record of notable SaucerSwap protocol, app, API, and documentation changes, including the V3 order book launch and the 2026 documentation overhaul.
- [Roadmap](https://docs.saucerswap.finance/roadmap.md): SaucerSwap Labs' development priorities: what shipped, including the V3 order book in June 2026, what is in progress, and longer-term directions.
- [SaucerSwap Labs team](https://docs.saucerswap.finance/contributors/saucerswap-labs.md): The SaucerSwap Labs company and team: who builds the SaucerSwap protocol and web app, each person's role, and one official channel per team member.
- [Careers](https://docs.saucerswap.finance/contributors/careers.md): Open positions at SaucerSwap Labs and how to send a speculative application to the team building DeFi infrastructure on the Hedera network.
- [Community](https://docs.saucerswap.finance/contributors/community.md): Where to find the SaucerSwap developer community, including the public Discord server and how to get involved in protocol governance discussions.
- [Brand assets](https://docs.saucerswap.finance/resources/brand-assets.md): Official SaucerSwap logos, the Larry mascot icon, SAUCE and xSAUCE token icons, brand colors, and typography for press, partners, and listings.
- [Contact SaucerSwap](https://docs.saucerswap.finance/contact.md): How to reach SaucerSwap Labs: user support through Discord and email, business development for partnerships, and the official social channels.
- [Partnership inquiries](https://docs.saucerswap.finance/contact/partnership-inquiries.md): Contact the SaucerSwap Labs business development team for partnerships, integrations, and co-marketing, or jump to the token listing guide for projects.
- [User support](https://docs.saucerswap.finance/contact/user-support.md): Get help with SaucerSwap: check the troubleshooting guide, open a support ticket in the official Discord server, or email the support team directly.
- [Socials](https://docs.saucerswap.finance/contact/socials.md): The verified official SaucerSwap channels on Discord, X, Reddit, Telegram, Medium, YouTube, Threads, Instagram, and LinkedIn — trust nothing else.
- [Terms of Service](https://docs.saucerswap.finance/legal/terms-of-service.md): The terms and conditions governing access to SaucerSwap Labs services, including the web app, APIs, Orderbook Services, and market-maker access.
- [Privacy Policy](https://docs.saucerswap.finance/legal/privacy-policy.md): How SaucerSwap Labs collects, uses, discloses, and retains information across its websites, interfaces, mobile applications, APIs, and related services.
- [V3 Orderbook Risk Notice](https://docs.saucerswap.finance/legal/orderbook-risk-notice.md): Required risk disclosures for SaucerSwap V3 order book trading, covering off-chain infrastructure, on-chain settlement, order lifecycle, and data risks.

## OpenAPI Specs

- [openapi](/openapi.yml)

## Optional

- [Launch app](https://www.saucerswap.finance/swap)