OISY Trade
OISY Trade lets you trade tokens on a fully onchain order-book exchange, directly from your OISY wallet. Deposited funds are held by the OISY Trade canister on the Internet Computer rather than by a centralized company. But as with any onchain protocol, this comes with smart-contract risk: you're trusting the canister's code, not handing custody to a person or company.
It's a separate way to trade alongside OISY's existing Swap: Swap gives you an instant trade at the best price a liquidity pool offers right now. OISY Trade lets you set the price you're willing to trade at and place a limit order — it waits until the market reaches your price (or fills right away if your price already crosses the book).
What are limit orders
A limit order says "buy or sell this token at this price or better," instead of trading immediately at whatever the market offers. You choose:
a pair — e.g. ICP priced in ckUSDC (the base token is what you're trading, the quote token is what the price is measured in)
a side — Buy or Sell
an amount of the base token
a price you're willing to trade at
Your order then rests in the order book until another trader's order matches it, or you cancel it. If your price already crosses the current best price on the book, it fills right away instead of resting — but you're always the one who set the price.
How it works, in general
Deposit a supported token from your OISY wallet into OISY Trade.
Place a limit order — pick a pair, a side, an amount, and a price.
Your order rests until it's matched (filled) or you cancel it; you can track its status.
Withdraw funds back to your OISY wallet any time — you can withdraw whatever isn't currently tied up in an open order.
Where to find it in OISY
OISY Trade lives in a Trading tab under Assets, alongside Tokens, NFTs, and Earning. It has two sections: My assets (what you've deposited into OISY Trade, with an "Available" amount showing what isn't reserved by open orders) and Orders (Active and History). Balances held in OISY Trade also count toward your total net worth shown in the wallet.
The existing Swap button is unaffected — it still opens the regular Swap flow. OISY Trade is entirely separate and reached only through the Trading tab.
Deposit
From the Trading tab, "+ Deposit" opens a form where you pick one of your wallet tokens that OISY Trade supports and enter an amount. Depositing takes two onchain steps (approve, then deposit), so a small network fee applies before the funds are ready to trade with.
Withdraw
Each deposited token has a Withdraw link that opens a form pre-filled with that token. Enter how much to withdraw — only your available (free) balance can be withdrawn; anything reserved by an open order can't be, until that order fills or is canceled. A small network fee applies, so what lands back in your wallet is slightly less than what you entered.
Create a limit order
From the Trading tab's Orders section, "+ Limit order" opens the order form. Choose Buy or Sell, pick the token you're trading and the token you're pricing it in, enter the amount, and set your price — you can use a quick preset relative to the current price, or match the best available price on the book. Review the order (it flags if your price will fill immediately), then place it.
Cancel a limit order
Tap any order in your Active list to open its details. From there, "Cancel order" is available for any order that hasn't filled yet. Confirming releases the funds that were reserved for it back to your available balance.
Technical details
For developers, integrators, and anyone who wants the underlying mechanics.
Architecture
OISY Trade is a separate onchain order-book exchange (a DEX) built on the Internet Computer. It implements a central limit order book (CLOB): all order state, matching, and settlement happen inside a single canister, with an event-sourced state log for auditability. OISY's wallet UI is a client — order matching itself runs entirely inside the DEX canister.
Full technical documentation: https://dfinity.github.io/oisy-trade/introduction.html
Governance & control
The OISY Trade mainnet canister (sy2xe-miaaa-aaaar-qb7sq-cai) lists the NNS Root canister as one of its controllers — the same governance root that solely controls the ckBTC Minter, and the same NNS governance that controls the Chain Fusion Signer used elsewhere in OISY. In practice, this means upgrades to the canister that holds deposited funds are expected to go through NNS proposals rather than a single team-held key, the same governance model OISY already relies on for its native-asset signing.
Deposit-first model & balances
Tokens must be deposited into the DEX before they can be traded. Depositing requires an ICRC-2 approval on the token's ledger, followed by a deposit call to the DEX canister — both steps incur the ledger's standard transfer fee. The DEX tracks balances per user and token as:
free— available for new orders or withdrawalreserved— locked by open orders
Order matching & lifecycle
Placing an order (add_limit_order) returns an order ID immediately; the matching engine processes it on its next tick. Orders move through four states: Pending (accepted, awaiting matching), Open (resting in the book), Filled (fully executed), or Canceled.
Trading pairs & order limits
Each pair defines a base token (what's traded) and a quote token (what the price is denominated in), plus:
tick_size— smallest allowed price incrementlot_size— smallest allowed quantity incrementmin_notional/max_notional— minimum and maximum order value (price × quantity)
Fees
Each pair sets a maker fee and a taker fee, in basis points, deducted from the proceeds at fill time (from the asset the filling side receives). Maker fees apply when an order was already resting and got matched; taker fees apply when an order matched immediately against a resting order. OISY always displays these as a percentage (e.g. "0.20%"), converted from basis points.
API reference
For direct canister interaction (CLI or programmatic), see the full method reference and walkthrough: https://dfinity.github.io/oisy-trade/usage/for-users.html
Last updated