Docs · for everyone

Trading rules

Optional limits a launcher can put on buys and sells of an aio coin while it is on its curve, and what those limits can and cannot do.

What a rule is

A rule is a limit the curve checks on every buy and sell before it lets the trade through. A launcher picks rules in step 4 of the launch form. Any number can be on, up to 64, and a coin with none launches with no rules. The rules a coin can carry lists every one.

What every rule shares

  • Rules apply to buys and sells on the curve only. They cannot see wallet to wallet transfers, so per-wallet limits can be avoided by splitting across wallets.
  • Buy rules and sell rules both end at the deadline you set, at most 7 days after launch. After it the coin trades with no rules.
  • Rules also stop for sells once the curve is full, and they never apply after graduation.
  • An aio admin can release one coin from its rules at any time. A release only removes limits and cannot be undone.
  • Rules can refuse a trade. They cannot move tokens or change the price or fees.
  • If the curve fills and then sells back below its target, graduation buys the last sliver of the raise itself, at most one ten thousandth of the target. That one buy is not rule checked, so no rule can hold a coin back from graduating.
  • The rules account rent your wallet paid comes back. A keeper run by aio closes that account after the coin graduates or its rules end, and sends the rent to the wallet that paid it. You never send that transaction yourself.

When the rules end

Every rule on a coin stops at one deadline, counted from the launch and at most 7 days after it. Left empty on the form, it is the shortest time the picked rules allow, and the form says what that is.

Freezing and loosening

An unfrozen rule can be loosened or switched off after launch by the key that holds the loosen-only right. It can never be tightened. Frozen, it cannot be touched at all until the rules end. That is a promise to buyers, and it cannot be undone: if the rule turns out to be too tight, nobody can relax it.

Rules and the opening buy

The curve checks the rules on the launcher's own opening buy as on any other buy: a cap smaller than the buy refuses it. It can only be made inside its reservation, so rules that keep buying closed for that whole window lose it.

Rules and the opening fee

Buying that is closed when trading opens skips the 99% opening fee: the first buyers the rules let through pay the steady fee.

Rules and the buyback

These rules also apply to this coin's buyback, which waits while they refuse it. The next try is smaller.

What rules cost

With rules your wallet signs extra steps before the launch: it writes the rules on chain first, then signs the launch. The rules account rent is shown before the first step. If you stop a launch after writing its rules, cancel it on the launch page: the rent is then returned to the wallet that paid it.

The custom builder

The builder lists every rule on the coin. Use it for a second rule of one kind, or for a kind with no tile (Plague, Legacy volume cap, Beacon). Every rule costs compute on each trade, and over the ceiling the rules cannot be sealed.