Limit Orders - LeoKit Documentation

Overview

Limit orders are a native feature of THORChain and MAYAChain — they’re stored as memo-encoded transactions on the source chain, and the protocol’s outbound vault settles them when the target price is met. The SDK exposes both the high-level client methods (recommended) and the low-level building blocks (for custom flows). LIMIT_ORDER_NATIVE_ASSETS lists the assets eligible as the order’s source/destination. Currently this includes RUNE, BTC.BTC, ETH.ETH, ETH.USDC, BCH.BCH, LTC.LTC, DOGE.DOGE, AVAX.AVAX, BSC.BNB, MAYA.CACAO, and others.

High-Level API

Submit

import { LIMIT_ORDER_NATIVE_ASSETS } from "leokit-sdk";

const orderId = await sdk.submitLimitOrder({
  fromAsset: "ETH.ETH",
  toAsset: "BTC.BTC",
  amount: "1000000000000000000",   // 1 ETH in wei
  targetPrice: "0.05",             // 0.05 BTC per ETH
  destination: "bc1q...",
  protocol: "thorchain",           // or "mayachain"
});

Returns the protocol-assigned order ID. The SDK builds the memo, signs the deposit transaction with the active wallet, and broadcasts it.

Cancel

const cancelMemo = await sdk.cancelLimitOrder({
  orderId,
  protocol: "thorchain",
});

The cancel transaction is signed and broadcast for you. Returns the memo string used (useful for receipts/logs).

Low-Level Utilities

For custom flows where you don’t want the SDK to sign or broadcast:

import {
  fetchLimitQuote,
  toBaseUnits,
  getLimitOrderStatus,
  fetchInboundAddress,
  buildCancelMemo,
  getCancelVaultAddress,
} from "leokit-sdk";

// Quote first (no on-chain action)
const quote = await fetchLimitQuote({
  fromAsset: "ETH.ETH",
  toAsset: "BTC.BTC",
  amount: "1000000000000000000",
  targetPrice: "0.05",
  protocol: "thorchain",
});

// Inbound vault (where the user must deposit)
const vault = await fetchInboundAddress("thorchain", "ETH");

// After broadcasting, check status
const status = await getLimitOrderStatus(quote.quoteId);
// LimitOrderStatus { state: "open" | "filled" | "cancelled", ... }

// To cancel manually
const memo = buildCancelMemo({ orderId, protocol: "thorchain" });
const cancelVault = getCancelVaultAddress("thorchain"); // chain-specific
// Sign + broadcast a transaction with `memo` to `cancelVault`

toBaseUnits (under the limit-orders namespace) is a thin wrapper that handles THORChain’s 1e8 normalization correctly across decimals — use it instead of generic amount math when building memos by hand.

Types

Type	Description
`LimitQuoteParams`	Input to `fetchLimitQuote` / `submitLimitOrder`
`LimitQuoteResponse`	Quote details + recommended slippage
`LimitOrderStatus`	Lifecycle state + fill details
`CancelLimitOrderParams`	Input to `cancelLimitOrder` / `buildCancelMemo`

All types are exported from the main leokit-sdk entry point.

Notes

Limit orders only work for protocols that support them (THORChain, MAYAChain). Other protocols throw on submitLimitOrder.
The SDK handles asset normalization (THORChain uses ASSET~ suffix in some memos); you don’t need to format the memo yourself when using submitLimitOrder / cancelLimitOrder.
Use getLimitOrderStatus (or sdk.watchTransaction(orderId, ...) if your status feed exposes the order id) for fill tracking.

​Overview

​High-Level API

​Submit

​Cancel

​Low-Level Utilities

​Types

​Notes