# Docs

- User docs: Trade, earn, and launch on Motoswap
  - [Getting started](/user/start): What Motoswap is, in one page, and where everything lives.
  - [MOTO](/user/moto): The MOTO token, what it is, and where it trades.
  - The story
    - [You are the house's revenue](/user/why/the-question): Every DEX since 2018 was built for institutions. You paid every fee. You got nothing.
    - [Uniswap built the NYSE and nobody came](/user/why/the-uniswap-problem): The house that keeps the rake for the market makers. The mechanics show it, version by version.
    - [Solana paid the dealers](/user/why/what-solana-figured-out): One plumbing decision built the Solana flywheel. The creators got paid in cash. The players still paid for everything.
    - [Nobody paid the players](/user/why/the-fix): Uniswap v2 math, PumpSwap plumbing, and the fee routed to the people who create it.
    - [Paid players come back](/user/why/the-flywheel): Every moto.fun graduation leaves MOTO under a new market for good, with the pool tokens burned. A house that pays its players grows.
    - [Home base](/user/why/home-base): The house lives on Ethereum, where the money is. The same house is built to run on every EVM chain, with the floors talking to each other.
  - [The 1%](/user/fee): One fee, in cash, users first. The split, and what the same swap costs everywhere else.
  - [Trading](/user/trade): Quotes, routing, guardrails, and importing tokens. Every swap pays you back.
  - [Earning](/user/earn): Three seats at the table: provide liquidity, stake MOTO, stake Motocats.
  - [Motocats](/user/motocats): 20,000 cats that arrive already staked and get paid by every PvE launch.
  - [Points](/user/points): Five ways to earn Points. All of them count toward the SZN 1 airdrop.
  - [Rakeback](/user/rakeback): 0.20% of every swap comes back to you, in the quote asset of the trade.
  - [Launch farming](/user/launch-farming): Motoswap's opening 14-day farm for Uniswap LPs and MOTO holders. Launch farming has ended.
  - [Tokenomics](/user/tokenomics): Where the 10 billion MOTO goes, and why the token has no owner.
  - [moto.fun](/user/moto-fun): A bonding-curve launch surface on Motoswap's rails. Free to launch, trading from the first block.
  - [Reference](/user/reference): Motocats, the MOTO token, FAQ, and safe self-custody habits.
  - [Contracts](/user/contracts): Every Motoswap and moto.fun contract on Ethereum, with its address and what it does.
- moto.fun: Launch and trade new coins on a bonding curve
  - [What moto.fun is](/fun): A bonding-curve launch surface on Motoswap. Free to launch, trading from the first block, graduating into burned-LP pools.
  - [Launching a coin](/fun/launch): A signature launches a coin for free. A dev buy makes it a transaction. Ticker rules, metadata, and the limits.
  - [Trading on the curve](/fun/trade): Buys, sells, fees, slippage, and the frozen window. What the curve does that a pool does not.
  - [Graduation](/fun/graduation): What happens when a curve fills. Two pools, burned LP, and the MOTO buy in the middle of it.
  - [Creator fees](/fun/creator-fees): 0.5% of every curve trade and 0.3% of every swap after graduation, paid in the trade's quote asset and claimed when you want.
  - [PvE on the curve](/fun/pve): Point a launch at Motocat stakers instead of yourself, and let anyone else add to it while the coin bonds.
  - [Points and Rakeback on the curve](/fun/points-and-rakeback): Curve trades count the same as DEX swaps. Same Points, same 0.20% back, same balances.
  - [The board and your coins](/fun/board): How the feed is ordered, what a coin card shows, and where to find what you launched and what you hold.
  - [FAQ](/fun/faq): The questions that come up most, answered against what the contracts actually do.
- PvE mode: Token launches that pay the Motocat stakers
  - [What PvE mode is](/pve): Launches that pay the cat pool. A slice of a PvE launch goes to staked Motocats.
  - [Earn as a cat holder](/pve/earn): Stake your Motocats, and every PvE launch pays you a share. Claim whenever you want.
  - [Launch with PvE on](/pve/launch): Point your launch buy at the cats instead of your own wallet, and get the cat holders in return.
- Developer docs: Build with us
  - [Overview](/dev/overview): What Motoswap is, the surfaces you can integrate with, and a single-page mental model.
  - [Quickstart](/dev/quickstart): Read the deployed addresses, one price and one on-chain value, then run the DEX examples end to end.
  - Integrations: Integration paths by what you are building
    - [Pick your path](/dev/integrations): Five integration paths into Motoswap. Pick by what you are building, not by what you already know.
    - [Aggregators](/dev/integrations/aggregators): Quote and execute Motoswap swaps from a routing engine, with the swap perimeter, the FeeRouter interface, the fee model in basis points, and pair discovery.
    - [Trading bots](/dev/integrations/trading-bots): The single-wallet swap loop for Telegram and trading bots. Discover, quote, submit and confirm, with the failure modes handled.
    - [Scanners and indexers](/dev/integrations/scanners): The event catalog, attribution rules, and enumeration patterns for indexing Motoswap from raw logs.
    - [Listing moto.fun coins](/dev/integrations/moto-fun): Discover launches, price a bonding curve, detect graduation, and fill a listing card. The path for listing and scanner sites.
    - [AI agents](/dev/integrations/ai-agents): The REST-only integration. A machine-readable spec, a self-describing config, ETag polling and no keys.
  - [Architecture](/dev/architecture): How Motoswap's contracts, indexer, and REST API fit together for integrators.
  - [Contract Addresses](/dev/addresses): Deployment status of every Motoswap contract on Ethereum, the deployed addresses, and how to read them at runtime.
  - [Contracts](/dev/contracts): Every Solidity contract in the Motoswap system, grouped by concern, with which are deployed.
  - [SDK - @motoswap/sdk](/dev/sdk): TypeScript library of pure functions for routing, pricing, slippage, and APR math.
  - [REST API](/dev/api): The Motoswap REST API - endpoint groups, wire types, caching, pagination.
  - moto.fun
    - [moto.fun overview](/dev/fun): One curve contract, cloned tokens, a read lens and two APIs. Which one to build against.
    - [Contracts](/dev/fun/contracts): The curve singleton, the token template, the read lens, and the shared creator-fee pair. Call surface, events, and the traps.
    - [Addresses and discovery](/dev/fun/addresses): Resolve the curve, the lens and the coin set at runtime from /config. Nothing here is hardcoded, including by us.
    - [REST API](/dev/fun/api): The two HTTP surfaces for moto.fun. The Motoswap API is the one to integrate against, and the app's own backend carries the rest.
    - [Realtime and candles](/dev/fun/realtime): The Server-Sent Events stream, what it carries and what it does not, and the exact candle rules, including who fills empty buckets.
  - Guides
    - [Swap via FeeRouter](/dev/guides/swap-via-fee-router): The only way for outside integrators to swap. It takes the protocol fee on the quote side, then routes through Router02.
    - [Read Prices](/dev/guides/read-prices): Four ways to read token prices: one token over REST, the bulk price book, the chart route, or reserves on chain.
    - [Watch on-chain events](/dev/guides/watch-events): Stream events via your own eth_getLogs provider, or poll the REST activity feed.
    - [Add and remove liquidity](/dev/guides/add-remove-liquidity): Add or remove liquidity through the Motoswap router, including the ETH, permit and fee-on-transfer variants.
    - [Zap into LP (single-sided)](/dev/guides/zap-in): Swap the optimal fraction and add balanced LP in one transaction, with UniswapZap on Uniswap V2 pairs and MotoSwapZap on Motoswap pairs.
    - [Stake LP in a farm](/dev/guides/stake-lp-into-farm): The chef ABI for Motoswap farms, as contract reference. No farm program is running or planned.
    - [Stake MOTO](/dev/guides/stake-moto): Lock MOTO to earn a boosted share of protocol fees.
    - [Stake Motocat NFTs](/dev/guides/stake-motocats): Escrow-stake Motocats, read the historical checkpoints, and claim PvE drops from the vault.
    - [Claim Rakeback](/dev/guides/claim-rakeback): Fetch a merkle proof and claim your share of protocol fees weekly.
    - [Points and referrals](/dev/guides/points-and-referrals): Read Points balances and bind referrals. Scoring internals are not published.
    - [Caching and ETags](/dev/guides/caching-and-etags): Send If-None-Match and respect Cache-Control so you make far fewer requests.
    - [Cursor Pagination](/dev/guides/cursor-pagination): HMAC-scoped cursors and unpaginated bounded sets on the REST API.
  - Reference
    - [Motoswap Contracts - Full Inventory](/dev/reference/contracts-full-inventory): Complete API reference for external integrators - every Solidity contract, function, event, and error.
    - [Motoswap SDK - Full Public API Inventory](/dev/reference/sdk-full-inventory): Every exported function of @motoswap/sdk, with types and formulas.
    - [Motoswap REST API - Full Inventory](/dev/reference/api-full-inventory): Complete REST API reference for integrators - every endpoint, params, response shape, cache tier.
    - [Addresses, config and events](/dev/reference/addresses-config-events): Combined reference - deployed addresses, chain config, wire types, fee schedule, and event signatures.
    - [moto.fun Contracts - Full Inventory](/dev/reference/fun-contracts-full-inventory): Complete API reference for external integrators - every moto.fun Solidity contract, function, event, error, constant, access rule and invariant, plus the canonical contracts the curve depends on.
    - [moto.fun API - Full Inventory](/dev/reference/fun-api-full-inventory): Every moto.fun REST endpoint across both services - path, params, response shape, caps, caching, and rate limits.
    - [moto.fun Addresses, Config and Events](/dev/reference/fun-addresses-config-events): Addresses and discovery, chain config, fee constants, and every moto.fun event signature with its indexed fields.
  - [Glossary](/dev/glossary): Every term used across Motoswap docs and code, from actor points to zap.
  - [Brand Kit](/dev/brand-kit): Downloadable Motoswap logos, token icons, and Motocats.