Skip to main content

​
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

TypeDescription
LimitQuoteParamsInput to fetchLimitQuote / submitLimitOrder
LimitQuoteResponseQuote details + recommended slippage
LimitOrderStatusLifecycle state + fill details
CancelLimitOrderParamsInput 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.