Skip to content

How it works

Every corridor (say cNGN ↔ USDT) has its own order book. Fillers post prices, traders fill against them, and the swap settles on-chain in one transaction.

The filler order book

Fillers post signed limit orders: a commitment to trade a specific amount at a specific price, valid until it expires or is replaced. Each corridor's book has two sides:

  • a buy side of fillers spending USDT to buy the local stablecoin (cNGN),
  • a sell side of fillers selling the local stablecoin for USDT.

Posting an order is free and gasless. A filler's funds only move when a trader actually fills the order, and each order can fill exactly once.

Filling a swap

When you swap, the app matches your order against the book, best price first, and executes it on-chain:

  1. You choose a pair and an amount, e.g. sell cNGN, receive USDT.
  2. The app quotes the effective rate from the book, fees included, and shows it before you sign.
  3. You submit. The matched filler orders execute through the settlement contract, and the output lands in your wallet in the same transaction.

Most swaps clear instantly and in full. If your amount is larger than the depth available at a good price, the app tells you before you commit, and you can fill what the book covers now and come back for the rest as filler depth replenishes.

Limit orders: name your own price

Instant swaps take the book's best price now. A limit order flips that: you set the price, sign a gasless order, and it rests in the same book fillers quote into — first-class liquidity like any other order. It fills when the market reaches your price, from either side of the market:

  • another trader's instant swap matches it, exactly as it would match a filler's quote, or
  • a filler bot decides your price is worth taking and fills it directly.

Your funds stay in your wallet until the fill, the order expires on its own (5 minutes to a year, your choice), and cancelling is a small on-chain transaction that permanently revokes the order's signature. See How to place a limit order.

What you pay

Swaps carry a small taker fee, set per chain on-chain and already baked into the quoted rate. The filler earns the spread between their quoted price and the market; the protocol earns the taker fee. There are no other charges. See Fees for the per-chain rates and a worked example.

Next