Overview

Ondo Perps provider — SIWE session signing, HMAC-relayed trading, setup, and configuration

This section covers Ondo-specific behavior that goes beyond the generic SDK documentation. For general concepts, see the Concepts section.

Ondo Perps authenticates trading with a Sign-In-With-Ethereum (SIWE) session. After a one-time wallet sign-in the SDK holds a venue session credential and a venue API key, both kept client-side. Trading actions are unsigned venue requests the SDK HMAC-signs with that API key before the backend relays them to the venue (see Signing Model).

import { createPerpsClient, PerpsWsClient } from '@lifi/perps-sdk';
import {
  ondoProvider,
  ondoWsProvider,
  ONDO_SANDBOX_API_URL,
} from '@lifi/perps-sdk-provider-ondo';

const sdk = createPerpsClient({
  apiKey: 'your-api-key',
  providers: [ondoProvider()],
});

const ws = new PerpsWsClient(sdk, {
  wsProviders: { ondo: ondoWsProvider() },
});

ondoProvider(options) accepts apiUrl (defaults to production; pass ONDO_SANDBOX_API_URL to trade against the sandbox venue) and storage (a StorageAdapter for the session token and API key; defaults to the SDK’s encrypted localStorageAdapter, the same default Hyperliquid uses — not raw browser localStorage).

Topics

• Signing Model — The SIWE session, the HMAC-signed trading relay, and the client-only session steps
• Setup — SIWE login, deposit-address provisioning, terms acceptance, trading-key creation, and referral
• Trading — All trading actions with parameters and Ondo’s order constraints
• WebSocket Protocol — The native WebSocket endpoint and how the SDK discovers it

Defaults & assumptions

• Margin mode: cross only. Passing marginMode: ISOLATED on placeOrder / updateLeverage is rejected.
• Order types: LIMIT and MARKET only. price is required for a limit order and is validated on the market’s price grid; size is validated on the size grid.
• Time-in-force: GTC, IOC, and POST_ONLY (post-only submits as GTC with the post-only flag set).
• Order expiry: not supported — expiresAt must be omitted.
• Trigger legs: take-profit / stop-loss execute at market; a limitPrice on a trigger is rejected.
• Quote asset: USDC. The provider advertises a single trading category (ondo).
• Deposits: getDepositFlow() provisions a per-user Ethereum USDC margin-wallet address behind the SIWE session; route to the returned toAddress.

Leverage

Ondo markets are cross-margin only. The maximum leverage is 10x by default, and 20x for index, commodity, and equity markets — US100, US500, XAU, XAG, WTI, and AAPL. The maintenance margin rate is half the initial rate at maximum leverage.

Candle intervals

The provider advertises these OHLCV intervals in supportedIntervals: 1m, 5m, 15m, 1h, 4h, 1d, 1w. Requesting any other interval raises a validation error.

Unsupported operations

The Ondo provider has no withdraw, sendAsset, modifyOrder, or updatePositionMargin methods, and advertises no account options — there is no post-setup tuning descriptor to run. Deposits are the only funds-movement path, via getDepositFlow().

Account reads

• getOrder requires an active SIWE session. With no session, it throws instead of returning an empty result — run siweLogin first.
• getRunningTwaps also reads through the session, but returns an empty array rather than throwing when the session is missing.
• getActivity returns only FUNDING, LIQUIDATION, DEPOSIT, and WITHDRAWAL items. TRANSFER is Lighter only.

Account figures

PerpsClient.getAccountSummary() builds the AccountSummary totals for Ondo directly from the venue’s account balance:

AccountSummary field	Venue source
portfolioValue	marginBalance
availableMargin	availableMargin
marginUsed	usedMargin
unrealizedPnl	unrealizedPnl

A logged-out account reads no venue balance and summarizes as zero.

getWithdrawableBalances() reads the venue’s withdrawableMargin figure for the perps route — the only route Ondo advertises.

Related Pages

• Concepts — The action pattern, streaming, and multi-provider support
• SDK / Streaming — Subscribe to live market data and user events via WebSocket
• SDK / Account — Fetch account balances, positions, and fills
• SDK / Trading — Place orders, cancel orders, and query order status
• SDK / Actions — The create -> sign -> execute pattern for all operations