> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rialto.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer Introduction

> Integrate Rialto as an execution venue, or list liquidity as a propAMM source.

## Overview

Rialto is an onchain swap router. It takes a sell token, a buy token, and an
amount, finds the best available execution across the liquidity sources it
supports, and returns a ready-to-send transaction that settles the trade
atomically onchain.

Rialto's defining liquidity source are propAMMs: onchain market makers that quote
a price from their own logic and inventory rather than from a passive
constant-product pool. Rialto quotes every candidate source onchain at request
time, ranks routes by output net of gas, and settles the winning route through the
RialtoRouter settlement contract. propAMMs compete alongside conventional DEX
pools on every quote, so takers get the best price without choosing a venue.

## Two ways to integrate

There are two distinct developer integrations, covered as separate tracks in this
section:

1. Swap API. For wallets, frontends, and other routers that want to use Rialto as
   an execution venue. You request a quote and submit the transaction Rialto
   returns. You never build route calldata, fee logic, slippage math, Permit2
   witnesses, or settlement actions yourself.

2. propAMM integration. For onchain market makers that want to list liquidity on
   Rialto. You deploy a pair contract that exposes a quote function and an atomic
   settlement function, and Rialto routes order flow to it when it wins.

## Choosing a track

* To let users trade through your app, use the Swap API.
* To provide liquidity and receive order flow, integrate as a propAMM source.

The two are independent. An integration can consume the Swap API, provide propAMM
liquidity, or do both.