perp-cli 0.14.2 → 0.15.0

package/dist/exchanges/lighter-spot.js

@@ -291,7 +291,7 @@ export class LighterSpotAdapter {
     }
     async spotMarketOrder(symbol, side, size, opts) {
         // Everything up to sendTx is pre-send: a failure there is a definite "not placed"
-        // (ORDER_REJECTED); sendTx transport failures are ORDER_PENDING (design §12.3).
+        // (ORDER_REJECTED); sendTx transport failures are ORDER_PENDING.
         let prep;
         try {
             prep = await this._prepareMarketOrder(symbol, side, size, opts.slippage.bps);
@@ -400,7 +400,7 @@ export class LighterSpotAdapter {
         if (minSize && sizeNum < minSize.base) {
             throw new Error(`Size ${size} below min_base_amount ${minSize.base} for ${resolved}`);
         }
-        // Protection price = best opposite quote ± the resolved slippage bound (design §13.2)
+        // Protection price = best opposite quote ± the resolved slippage bound
         const ob = await this.getSpotOrderbook(resolved);
         let refPrice;
         if (side === "buy") {
@@ -453,7 +453,7 @@ export class LighterSpotAdapter {
         const sizeStep = dec.size <= 0 ? "1" : `0.${"0".repeat(dec.size - 1)}1`;
         const tick = dec.price <= 0 ? "1" : `0.${"0".repeat(dec.price - 1)}1`;
         // Size floored to the size step (never rounded up); price must already be on tick
-        // (INVALID_TICK, never rounded — design §10.10).
+        // (INVALID_TICK, never rounded).
         const sentSize = floorSize(size, sizeStep);
         const sentPrice = requireOnTick(price, tick);
         // Venue minimums: refused, never bumped up to the minimum (the order would exceed the request).
@@ -505,7 +505,7 @@ export class LighterSpotAdapter {
         };
     }
     /**
-     * TIF mapping, as perps (§13.3): GTC/GTT → GTT, IOC → IOC, ALO / POST_ONLY → post-only (2).
+     * TIF mapping, as perps: GTC/GTT → GTT, IOC → IOC, ALO / POST_ONLY → post-only (2).
      * FOK and anything else → CAPABILITY_UNSUPPORTED (never silently GTT).
      */
     _limitTif(tif) {
@@ -656,7 +656,7 @@ export class LighterSpotAdapter {
     async transferUsdcToPerp(amount) {
         return this._selfTransfer(String(amount), 1, 0); // route: Spot(1) → Perp(0)
     }
-    /** SpotTransferCapable (§12.4 #4): only the venue collateral (USDC on Lighter, USDG on Lighter RH). */
+    /** SpotTransferCapable: only the venue collateral (USDC on Lighter, USDG on Lighter RH). */
     async transferToSpot(amount, asset) {
         return this._selfTransfer(this._transferAmount(amount, asset), 0, 1);
     }
@@ -864,8 +864,7 @@ export class LighterSpotAdapter {
         return nonce;
     }
     /**
-     * POST /sendTx. `kind` "place" (order placement): failures are typed (design
-     * §12.3): before the request → ORDER_REJECTED; transport error, HTTP 5xx or an
+     * POST /sendTx. `kind` "place" (order placement): failures are typed: before the request → ORDER_REJECTED; transport error, HTTP 5xx or an
      * unreadable body after it → ORDER_PENDING (the tx may have been accepted — never
      * resubmit); an explicit non-200 code → ORDER_REJECTED. "order" (cancels) / "action"
      * (transfers): an explicit non-200 code → ORDER_REJECTED / ACTION_REJECTED

package/dist/exchanges/lighter.d.ts

@@ -1,4 +1,4 @@
-import type { ExchangeAdapter, ExchangeMarketInfo, ExchangePosition, ExchangeOrder, ExchangeBalance, ExchangeTrade, ExchangeFundingPayment, ExchangeKline } from "./interface.js";
+import type { ExchangeAdapter, ExchangeMarketInfo, ExchangePosition, ExchangeOrder, ExchangeBalance, ExchangeTrade, ExchangePublicTrade, ExchangeFundingPayment, ExchangeKline } from "./interface.js";
 import type { ResolvedSlippage } from "./slippage.js";
 import type { EvmSigner } from "../signer/index.js";
 import type { AgentMeta } from "../settings.js";
@@ -34,7 +34,7 @@ export declare const LIGHTER_TIF: {
     readonly POST_ONLY: 2;
 };
 /**
- * CLI format rule for a Lighter client order id (§13.10 #9): the venue's
+ * CLI format rule for a Lighter client order id: the venue's
  * `clientOrderIndex` is numeric, so the id must be a plain decimal integer string
  * (digits only, no sign / leading zero / exponent) in 1 ≤ n ≤ 2^48 − 1.
  * Anything else → INVALID_PARAMS before anything is sent.
@@ -276,7 +276,7 @@ export interface LighterAdapterOpts {
     apiKeyIndex?: number;
 }
 export declare class LighterAdapter implements ExchangeAdapter {
-    /** GTC→GTT resting-order lifetime (28 days) for the execution record (§13.10 #14). */
+    /** GTC→GTT resting-order lifetime (28 days) for the execution record. */
     static readonly gttExpiryMs: number;
     /** Venue id ("lighter" | "lighter-rh"). */
     readonly name: LighterVenueId;
@@ -468,7 +468,7 @@ export declare class LighterAdapter implements ExchangeAdapter {
      */
     private pollTx;
     /**
-     * Definite IOC outcome (§13.10 #4) from the executed tx: poll /tx by hash. A taker order the
+     * Definite IOC outcome from the executed tx: poll /tx by hash. A taker order the
      * venue reports "filled" (event_info `to.st` 3, `is` = sent) filled the whole order. Any other
      * status (the remainder was cancelled — the venue zeroes `rs`, so is − rs is NOT a fill) →
      * the venue's own `filled_base_amount` from accountOrders by client order index. Zero fill →
@@ -501,7 +501,7 @@ export declare class LighterAdapter implements ExchangeAdapter {
      */
     orderRowOutcome(clientOrderIndex: number, orderId: string | null, what: string, settled?: (out: LighterOrderOutcome, row: Record<string, unknown>) => boolean, match?: LighterRowMatch | null): Promise<LighterOrderOutcome | null>;
     /**
-     * Final outcome of a placed resting / post-only order (§13.10 #4 analogue for non-IOC): poll
+     * Final outcome of a placed resting / post-only order (analogue for non-IOC): poll
      * /tx (rejected → ORDER_REJECTED). Our order (`to`, matched by client order index) reported
      * "filled" in event_info → filled = is (the whole order). Any other status — open, or a
      * canceled-* whose remainder the venue zeroed (`rs` 0, so is − rs is NOT a fill) — or an
@@ -558,7 +558,7 @@ export declare class LighterAdapter implements ExchangeAdapter {
     /** Order / trade side from Lighter's `is_ask`; a missing / non-boolean value throws (never defaults to "buy"). */
     private sideOfIsAsk;
     /**
-     * Slippage-bounded IOC (§13.2): protection price = orderbook mid ± opts.slippage.bps,
+     * Slippage-bounded IOC: protection price = orderbook mid ± opts.slippage.bps,
      * tick-aligned toward crossing. The returned raw sendTx result carries `protection`
      * and, when the venue reported the fill, `iocOutcome` (see iocOutcomeOf).
      * `opts.clientOrderIndex` (optional) = caller's numeric client order id (lighterClientOrderIndex rule).
@@ -569,9 +569,9 @@ export declare class LighterAdapter implements ExchangeAdapter {
         clientOrderIndex?: number;
     }): Promise<unknown>;
     /**
-     * TIF mapping (§13.3): GTC/GTT → GTT (28-day expiry, gttExpiryMs), IOC → IOC,
+     * TIF mapping: GTC/GTT → GTT (28-day expiry, gttExpiryMs), IOC → IOC,
      * ALO / POST_ONLY → time-in-force 2 (POST_ONLY per apidocs trading.md and the official
-     * lighter-go signer; 28-day expiry like GTT — testnet confirmation pending, design §11).
+     * lighter-go signer; 28-day expiry like GTT — testnet confirmation pending).
      * FOK and any other value → CAPABILITY_UNSUPPORTED (never silently GTT).
      * `opts.clientOrderIndex` as in marketOrder.
      * IOC: the same definite outcome as marketOrder (awaitIocOutcome — zero fill →
@@ -640,7 +640,7 @@ export declare class LighterAdapter implements ExchangeAdapter {
     /**
      * Trigger order. Market trigger (no limitPrice): execution price bound = trigger price ±
      * `opts.slippage` bps (the caller's resolveSlippage() output — required; the adapter never
-     * reads settings, §13.10 #1), tick-aligned toward crossing (§13.10 #3), recorded in the
+     * reads settings), tick-aligned toward crossing, recorded in the
      * result as `protection`. Accepted risk: a fast move through the bound leaves the
      * triggered order unfilled.
      * TP vs SL: `opts.kind` given (TP/SL legs) → that type as given (a trigger already crossed
@@ -665,7 +665,7 @@ export declare class LighterAdapter implements ExchangeAdapter {
     private _withdrawRaw;
     editOrder(symbol: string, orderId: string, price: string, size: string): Promise<unknown>;
     setLeverage(symbol: string, leverage: number, marginMode?: "cross" | "isolated"): Promise<unknown>;
-    getRecentTrades(symbol: string, limit?: number): Promise<ExchangeTrade[]>;
+    getRecentTrades(symbol: string, limit?: number): Promise<ExchangePublicTrade[]>;
     getFundingHistory(symbol: string, limit?: number): Promise<{
         time: number;
         rate: string;
@@ -779,7 +779,7 @@ export declare class LighterAdapter implements ExchangeAdapter {
     private nextClientOrderIndex;
     private ensureSigner;
     /**
-     * One WASM signer (one Go runtime) per `${venueId}:${network}` (design §10.5).
+     * One WASM signer (one Go runtime) per `${venueId}:${network}`.
      * lighter-go keys its clients by (accountIndex, apiKeyIndex) only and keeps a
      * package-global chainId for L1 messages, so two venues must never share a
      * runtime. Keyed by venue+network rather than chainId because Lighter testnet

package/dist/exchanges/lighter.js

@@ -40,7 +40,7 @@ function lighterStep(decimals) {
     return decimals <= 0 ? "1" : `0.${"0".repeat(decimals - 1)}1`;
 }
 /**
- * CLI format rule for a Lighter client order id (§13.10 #9): the venue's
+ * CLI format rule for a Lighter client order id: the venue's
  * `clientOrderIndex` is numeric, so the id must be a plain decimal integer string
  * (digits only, no sign / leading zero / exponent) in 1 ≤ n ≤ 2^48 − 1.
  * Anything else → INVALID_PARAMS before anything is sent.
@@ -409,8 +409,16 @@ export function lighterSelectAccount(accounts, accountIndex, venue) {
  * window is unknown (SYMBOL_NOT_FOUND) until the entry expires.
  */
 export const LIGHTER_MARKET_LIST_TTL_MS = 5 * 60_000;
+/** A candle volume field: a finite number / numeric string → its string form; absent or non-numeric → null (never "" / "undefined"). */
+function candleNumber(v) {
+    if (typeof v === "number" && Number.isFinite(v))
+        return String(v);
+    if (typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v)))
+        return v;
+    return null;
+}
 export class LighterAdapter {
-    /** GTC→GTT resting-order lifetime (28 days) for the execution record (§13.10 #14). */
+    /** GTC→GTT resting-order lifetime (28 days) for the execution record. */
     static gttExpiryMs = LIGHTER_GTT_EXPIRY_MS;
     /** Venue id ("lighter" | "lighter-rh"). */
     name;
@@ -679,7 +687,7 @@ export class LighterAdapter {
             return { tier: "master" };
         if (this._evmKey)
             return { tier: "pk" };
-        // Lighter RH master key is OWS-only (design §10.3): no env-key remediation for it.
+        // Lighter RH master key is OWS-only: no env-key remediation for it.
         const remediation = this.venueId === "lighter"
             ? "Run one of: (a) perp wallet agent approve lighter --master <wallet>; (b) perp wallet generate && perp -e lighter --ows <wallet>; (c) export LIGHTER_PRIVATE_KEY=0x..."
             : `Run one of: (a) perp wallet agent approve ${this.name} --master <wallet>; (b) perp wallet generate && perp -e ${this.name} --ows <wallet>`;
@@ -863,7 +871,7 @@ export class LighterAdapter {
     getMarketIndex(symbol) {
         const idx = this._marketMap.get(symbol.toUpperCase());
         if (idx === undefined)
-            throw new PerpError("SYMBOL_NOT_FOUND", `Unknown Lighter market: ${symbol}`, { exchange: this.name });
+            throw new PerpError("SYMBOL_NOT_FOUND", `Unknown Lighter market: ${symbol}`, { exchange: this.name, remediation: `List markets: perp -e ${this.name} market list` });
         return idx;
     }
     /**
@@ -976,7 +984,7 @@ export class LighterAdapter {
         return last;
     }
     /**
-     * Definite IOC outcome (§13.10 #4) from the executed tx: poll /tx by hash. A taker order the
+     * Definite IOC outcome from the executed tx: poll /tx by hash. A taker order the
      * venue reports "filled" (event_info `to.st` 3, `is` = sent) filled the whole order. Any other
      * status (the remainder was cancelled — the venue zeroes `rs`, so is − rs is NOT a fill) →
      * the venue's own `filled_base_amount` from accountOrders by client order index. Zero fill →
@@ -1117,7 +1125,7 @@ export class LighterAdapter {
         return null;
     }
     /**
-     * Final outcome of a placed resting / post-only order (§13.10 #4 analogue for non-IOC): poll
+     * Final outcome of a placed resting / post-only order (analogue for non-IOC): poll
      * /tx (rejected → ORDER_REJECTED). Our order (`to`, matched by client order index) reported
      * "filled" in event_info → filled = is (the whole order). Any other status — open, or a
      * canceled-* whose remainder the venue zeroed (`rs` 0, so is − rs is NOT a fill) — or an
@@ -1451,7 +1459,7 @@ export class LighterAdapter {
         return isAsk ? "sell" : "buy";
     }
     /**
-     * Slippage-bounded IOC (§13.2): protection price = orderbook mid ± opts.slippage.bps,
+     * Slippage-bounded IOC: protection price = orderbook mid ± opts.slippage.bps,
      * tick-aligned toward crossing. The returned raw sendTx result carries `protection`
      * and, when the venue reported the fill, `iocOutcome` (see iocOutcomeOf).
      * `opts.clientOrderIndex` (optional) = caller's numeric client order id (lighterClientOrderIndex rule).
@@ -1502,9 +1510,9 @@ export class LighterAdapter {
         return this.awaitIocOutcome(result, symbol, baseAmount, `market ${side} ${size} ${symbol}`, { protection, clientOrderIndex }, match);
     }
     /**
-     * TIF mapping (§13.3): GTC/GTT → GTT (28-day expiry, gttExpiryMs), IOC → IOC,
+     * TIF mapping: GTC/GTT → GTT (28-day expiry, gttExpiryMs), IOC → IOC,
      * ALO / POST_ONLY → time-in-force 2 (POST_ONLY per apidocs trading.md and the official
-     * lighter-go signer; 28-day expiry like GTT — testnet confirmation pending, design §11).
+     * lighter-go signer; 28-day expiry like GTT — testnet confirmation pending).
      * FOK and any other value → CAPABILITY_UNSUPPORTED (never silently GTT).
      * `opts.clientOrderIndex` as in marketOrder.
      * IOC: the same definite outcome as marketOrder (awaitIocOutcome — zero fill →
@@ -1841,7 +1849,7 @@ export class LighterAdapter {
     /**
      * Trigger order. Market trigger (no limitPrice): execution price bound = trigger price ±
      * `opts.slippage` bps (the caller's resolveSlippage() output — required; the adapter never
-     * reads settings, §13.10 #1), tick-aligned toward crossing (§13.10 #3), recorded in the
+     * reads settings), tick-aligned toward crossing, recorded in the
      * result as `protection`. Accepted risk: a fast move through the bound leaves the
      * triggered order unfilled.
      * TP vs SL: `opts.kind` given (TP/SL legs) → that type as given (a trigger already crossed
@@ -2013,10 +2021,13 @@ export class LighterAdapter {
             side: t.is_maker_ask ? "buy" : "sell",
             price: String(t.price ?? "0"),
             size: String(t.size ?? t.base_amount ?? t.amount ?? ""),
-            fee: String(t.fee ?? "0"),
+            // The tape's taker_fee / maker_fee are the parties' fee RATES, not a fee the viewer paid.
+            fee: null,
         }));
     }
     async getFundingHistory(symbol, limit = 10) {
+        await this.ensureMarketMap();
+        this.getMarketIndex(symbol); // unlisted market: SYMBOL_NOT_FOUND, not an empty history
         const rates = await this.getFundingRates();
         const r = rates.get(symbol.toUpperCase());
         if (!r)
@@ -2035,8 +2046,11 @@ export class LighterAdapter {
             high: String(c.high ?? c.h ?? "0"),
             low: String(c.low ?? c.l ?? "0"),
             close: String(c.close ?? c.c ?? "0"),
-            volume: String(c.base_token_volume ?? c.v ?? ""),
-            trades: Number(c.trades_count ?? c.n ?? 0),
+            volume: candleNumber(c.base_token_volume ?? c.v),
+            // /candles: v = base volume, V = quote (USD) volume; no per-candle trade count (live
+            // 2026-10-14 keys: t o h l c v V i — `i` is the last trade id, not a count).
+            quoteVolume: candleNumber(c.V),
+            trades: typeof c.trades_count === "number" ? c.trades_count : typeof c.n === "number" ? c.n : null,
         }));
     }
     /**
@@ -2428,7 +2442,7 @@ export class LighterAdapter {
         }
     }
     /**
-     * One WASM signer (one Go runtime) per `${venueId}:${network}` (design §10.5).
+     * One WASM signer (one Go runtime) per `${venueId}:${network}`.
      * lighter-go keys its clients by (accountIndex, apiKeyIndex) only and keeps a
      * package-global chainId for L1 messages, so two venues must never share a
      * runtime. Keyed by venue+network rather than chainId because Lighter testnet

package/dist/exchanges/ondo/adapter.d.ts

@@ -1,6 +1,5 @@
 /**
  * Ondo Perps adapter — native TradingV2 + legacy ExchangeAdapter shim
- * (design §10.7, §10.10).
  *
  * Signer: HMAC API key only (OndoAgentMeta → ~/.perp/ondo-agents/<keyId>.json).
  * There is no master-key signing path for trading; read-only adapters serve
@@ -9,8 +8,8 @@
  * Order entry:
  *   - market orders: IOC LIMIT at the protection price
  *     alignProtectionPrice(slippagePrice(mark, side, bps), quoteIncrement, side),
- *     bps = the caller's resolveSlippage() value (design §13.2);
- *   - TIF (design §13.3): GTC | IOC | ALO, where ALO = GTC + postOnly; FOK is
+ *     bps = the caller's resolveSlippage() value;
+ *   - TIF: GTC | IOC | ALO, where ALO = GTC + postOnly; FOK is
  *     not offered (uniform CAPABILITY_UNSUPPORTED, never emulated); a limit order
  *     without a TIF is GTC;
  *   - limit orders without a caller clientOrderId get a generated one that
@@ -19,7 +18,7 @@
  *   - TP/SL attached to the entry via takeProfit/stopLoss;
  *   - stopMarket = position-level stop (POST /v1/perps/stop_order), reduce-only,
  *     mark-triggered; stopLimit is not offered by the venue;
- *   - amend = cancel, then place (design §13.10 #10, #11). `size` is the NEW OPEN
+ *   - amend = cancel, then place. `size` is the NEW OPEN
  *     size. The replacement keeps side / reduceOnly / TIF; post-only comes from
  *     the original's generated clientOrderId, or the caller's explicit TIF — an
  *     order whose post-only flag is not decodable (placed elsewhere / caller id)
@@ -35,7 +34,7 @@
  * Limit prices and TP/SL triggers must be on tick (INVALID_TICK); sizes are
  * floored to the step (SIZE_TOO_SMALL when that reaches zero).
  */
-import type { ExchangeAdapter, ExchangeBalance, ExchangeFundingPayment, ExchangeKline, ExchangeMarketInfo, ExchangeOrder, ExchangePosition, ExchangeTrade } from "../interface.js";
+import type { ExchangeAdapter, ExchangeBalance, ExchangeFundingPayment, ExchangeKline, ExchangeMarketInfo, ExchangeOrder, ExchangePosition, ExchangeTrade, ExchangePublicTrade } from "../interface.js";
 import type { ResolvedSlippage } from "../slippage.js";
 import type { TradingV2 } from "../trading-v2.js";
 import type { VenueCreateContext, VenueDefinition } from "../venue.js";
@@ -105,7 +104,7 @@ export declare class OndoAdapter implements ExchangeAdapter, TradingV2 {
         bids: [string, string][];
         asks: [string, string][];
     }>;
-    getRecentTrades(symbol: string, limit?: number): Promise<ExchangeTrade[]>;
+    getRecentTrades(symbol: string, limit?: number): Promise<ExchangePublicTrade[]>;
     getFundingHistory(symbol: string, limit?: number): Promise<{
         time: number;
         rate: string;

package/dist/exchanges/ondo/adapter.js

@@ -1,6 +1,5 @@
 /**
  * Ondo Perps adapter — native TradingV2 + legacy ExchangeAdapter shim
- * (design §10.7, §10.10).
  *
  * Signer: HMAC API key only (OndoAgentMeta → ~/.perp/ondo-agents/<keyId>.json).
  * There is no master-key signing path for trading; read-only adapters serve
@@ -9,8 +8,8 @@
  * Order entry:
  *   - market orders: IOC LIMIT at the protection price
  *     alignProtectionPrice(slippagePrice(mark, side, bps), quoteIncrement, side),
- *     bps = the caller's resolveSlippage() value (design §13.2);
- *   - TIF (design §13.3): GTC | IOC | ALO, where ALO = GTC + postOnly; FOK is
+ *     bps = the caller's resolveSlippage() value;
+ *   - TIF: GTC | IOC | ALO, where ALO = GTC + postOnly; FOK is
  *     not offered (uniform CAPABILITY_UNSUPPORTED, never emulated); a limit order
  *     without a TIF is GTC;
  *   - limit orders without a caller clientOrderId get a generated one that
@@ -19,7 +18,7 @@
  *   - TP/SL attached to the entry via takeProfit/stopLoss;
  *   - stopMarket = position-level stop (POST /v1/perps/stop_order), reduce-only,
  *     mark-triggered; stopLimit is not offered by the venue;
- *   - amend = cancel, then place (design §13.10 #10, #11). `size` is the NEW OPEN
+ *   - amend = cancel, then place. `size` is the NEW OPEN
  *     size. The replacement keeps side / reduceOnly / TIF; post-only comes from
  *     the original's generated clientOrderId, or the caller's explicit TIF — an
  *     order whose post-only flag is not decodable (placed elsewhere / caller id)
@@ -35,6 +34,7 @@
  * Limit prices and TP/SL triggers must be on tick (INVALID_TICK); sizes are
  * floored to the step (SIZE_TOO_SMALL when that reaches zero).
  */
+import { nonEmptyOrListed } from "../unknown-symbol.js";
 import { randomUUID } from "node:crypto";
 import { PerpError, orderNotSent, orderOutcomeUnknown } from "../../errors.js";
 import { alignProtectionPrice, floorSize, formatComputedPrice, requireOnTick, slippagePrice, subDecimal } from "../precision.js";
@@ -57,7 +57,7 @@ function isPositive(s) {
     return Number(s) > 0;
 }
 /**
- * Generated clientOrderId carrying the post-only flag (design §13.10 #11): the
+ * Generated clientOrderId carrying the post-only flag: the
  * Ondo API never returns postOnly, so amend recovers it from the id instead of
  * a local file. `pcli-p-` = post-only, `pcli-n-` = not post-only; 39 chars of
  * [A-Za-z0-9_-] (venue rule: 1–64).
@@ -410,7 +410,7 @@ export class OndoAdapter {
         }
     }
     async placeOrderOnVenue(input) {
-        // §13.3: GTC is the uniform default for a limit order without a TIF.
+        // GTC is the uniform default for a limit order without a TIF.
         const tifRequested = input.tif;
         const req = input.type === "limit" && input.tif === null ? { ...input, tif: "GTC" } : input;
         if (req.tif === "FOK") {
@@ -558,7 +558,7 @@ export class OndoAdapter {
                 remediation: `Do NOT resubmit. Check the order: perp trade status ${original.orderId} --symbol ${req.symbol} -e ondo`,
             });
         }
-        // req.size = new OPEN size; fills that raced the cancel reduce the replacement (§13.10 #10).
+        // req.size = new OPEN size; fills that raced the cancel reduce the replacement.
         const racedFill = subDecimal(cancelled.filledSize, filledAtRead);
         const replace = subDecimal(req.size, racedFill.startsWith("-") ? "0" : racedFill);
         let size = null;
@@ -669,14 +669,15 @@ export class OndoAdapter {
         const trades = await this.client.publicGet("/v1/perps/trades", {
             market: ondoVenueSymbol(symbol), limit: limit === undefined ? null : limit,
         });
-        return listOf(trades).map(t => ({
+        // `200 []` for an unlisted market (live 2026-10-14): checked against the market directory.
+        return nonEmptyOrListed(this, symbol, listOf(trades).map(t => ({
             time: parseOndoTime(t.time, "trade"),
             symbol: ondoPlainSymbol(t.market),
             side: t.aggressor_side,
             price: t.price,
             size: t.size,
-            fee: "0", // public tape: no fee applies to the viewer
-        }));
+            fee: null, // public tape: no fee applies to the viewer
+        })), ondoPlainSymbol(ondoVenueSymbol(symbol)));
     }
     async getFundingHistory(symbol, limit) {
         const rows = await this.client.publicGet("/v1/perps/funding_rate_history", {
@@ -692,15 +693,16 @@ export class OndoAdapter {
             from: Math.floor(startTime / 1000),
             to: Math.floor(endTime / 1000),
         });
-        return listOf(candles).map(c => ({
+        return nonEmptyOrListed(this, symbol, listOf(candles).map(c => ({
             time: parseOndoTime(c.startTime, "candle"),
             open: c.open,
             high: c.high,
             low: c.low,
             close: c.close,
             volume: c.volume,
+            quoteVolume: null,
             trades: null, // Ondo publishes no per-candle trade count
-        }));
+        })), ondoPlainSymbol(ondoVenueSymbol(symbol)));
     }
     // ── Legacy ExchangeAdapter: account ──
     async getBalance() {
@@ -760,7 +762,7 @@ export class OndoAdapter {
         const rows = await this.client.get("/v1/perps/funding_fees", { limit: limit === undefined ? null : limit });
         return listOf(rows).map(r => ({ time: parseOndoTime(r.time, "funding fee"), symbol: ondoPlainSymbol(r.market), payment: r.amount }));
     }
-    // ── Legacy ExchangeAdapter: trading (shim → TradingV2, design §10.7) ──
+    // ── Legacy ExchangeAdapter: trading (shim → TradingV2) ──
     async marketOrder(symbol, side, size, opts) {
         return this.placeOrder({
             symbol, side, type: "market", size, price: null, triggerPrice: null, triggerSource: null, tif: null,
@@ -768,7 +770,7 @@ export class OndoAdapter {
         });
     }
     async limitOrder(symbol, side, price, size, opts) {
-        // §13.3: no TIF → GTC (uniform default); FOK → uniform CAPABILITY_UNSUPPORTED.
+        // no TIF → GTC (uniform default); FOK → uniform CAPABILITY_UNSUPPORTED.
         const tifInput = opts?.tif;
         const tif = tifInput === undefined || tifInput === "" ? null : validateLegacyTif(this.venue, this.caps, tifInput);
         return this.placeOrder({

package/dist/exchanges/ondo/agent.d.ts

@@ -1,5 +1,5 @@
 /**
- * Ondo Perps API-key ("agent") registration (design §10.4).
+ * Ondo Perps API-key ("agent") registration.
  *
  * The HMAC key id + secret are created by the user in the Ondo Perps UI and
  * entered via stdin by the CLI (never flags). The secret is persisted only in

package/dist/exchanges/ondo/agent.js

@@ -1,5 +1,5 @@
 /**
- * Ondo Perps API-key ("agent") registration (design §10.4).
+ * Ondo Perps API-key ("agent") registration.
  *
  * The HMAC key id + secret are created by the user in the Ondo Perps UI and
  * entered via stdin by the CLI (never flags). The secret is persisted only in

package/dist/exchanges/ondo/client.d.ts

@@ -1,5 +1,5 @@
 /**
- * Ondo Perps raw REST client (design §9.2: raw fetch + node:crypto HMAC, no SDK).
+ * Ondo Perps raw REST client (raw fetch + node:crypto HMAC, no SDK).
  *
  * Auth (live-verified, scratchpad/sdk-findings.md §2 — the OpenAPI spec's
  * `X-API-KEY-ID` header name is wrong):

package/dist/exchanges/ondo/client.js

@@ -1,5 +1,5 @@
 /**
- * Ondo Perps raw REST client (design §9.2: raw fetch + node:crypto HMAC, no SDK).
+ * Ondo Perps raw REST client (raw fetch + node:crypto HMAC, no SDK).
  *
  * Auth (live-verified, scratchpad/sdk-findings.md §2 — the OpenAPI spec's
  * `X-API-KEY-ID` header name is wrong):
@@ -220,7 +220,7 @@ export class OndoClient {
         }
         // Timeout covers the whole exchange (headers + body). A GET failure is definite
         // (nothing changed); a POST failure may have reached the venue → outcome unknown
-        // (ORDER_PENDING, never resubmit — design §12.3).
+        // (ORDER_PENDING, never resubmit).
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), ONDO_REQUEST_TIMEOUT_MS);
         let res;

package/dist/exchanges/ondo/public.d.ts

@@ -1,5 +1,5 @@
 /**
- * Ondo Perps public market data (design §10.6).
+ * Ondo Perps public market data.
  *
  * Sources (all public, live-verified 2026-09-30):
  *   GET /v1/markets           result.perps.tradingPairs[] — increments, margin
@@ -88,6 +88,13 @@ export declare function ondoPlainSymbol(venueSymbol: string): string;
 export declare function ondoVenueSymbol(symbol: string): string;
 /** Empty string / absent → null. Ondo omits or blanks fields it does not publish. */
 export declare function strOrNull(v: string | undefined | null): string | null;
+/**
+ * A price field that the venue zeroes when it has no value: /v1/perps/contracts reports
+ * indexPrice "0" (and lastPrice "0") on disabled contracts (live 2026-10-14: ADBE, BE, CELH, IBM,
+ * NOK, OKLO, RDDT, SHEIN, SMCI, IBB, VXX, EURUSD — all `disabled: true`). A price is never 0, so
+ * "0" means "no index" → null (unknown), never $0.00. Volume / OI zeros stay: 0 is a real amount.
+ */
+export declare function priceOrNull(v: string | undefined | null): string | null;
 export declare function parseOndoTime(iso: string, what: string): number;
 export declare function ondoPublicClient(net: Network): OndoClient;
 export declare function fetchOndoTradingPairs(client: OndoClient): Promise<OndoTradingPair[]>;

package/dist/exchanges/ondo/public.js

@@ -1,5 +1,5 @@
 /**
- * Ondo Perps public market data (design §10.6).
+ * Ondo Perps public market data.
  *
  * Sources (all public, live-verified 2026-09-30):
  *   GET /v1/markets           result.perps.tradingPairs[] — increments, margin
@@ -33,6 +33,7 @@ const TAG_TO_ASSET_CLASS = {
     Index: "index",
     Commodity: "commodity",
     FX: "fx",
+    "Pre-IPO": "preIpo", // live 2026-10-19: OPENAI-USD.P
 };
 export function ondoAssetClass(market, tags) {
     if (tags === null || tags === undefined) {
@@ -64,6 +65,16 @@ export function ondoVenueSymbol(symbol) {
 export function strOrNull(v) {
     return v === undefined || v === null || v === "" ? null : v;
 }
+/**
+ * A price field that the venue zeroes when it has no value: /v1/perps/contracts reports
+ * indexPrice "0" (and lastPrice "0") on disabled contracts (live 2026-10-14: ADBE, BE, CELH, IBM,
+ * NOK, OKLO, RDDT, SHEIN, SMCI, IBB, VXX, EURUSD — all `disabled: true`). A price is never 0, so
+ * "0" means "no index" → null (unknown), never $0.00. Volume / OI zeros stay: 0 is a real amount.
+ */
+export function priceOrNull(v) {
+    const s = strOrNull(v);
+    return s === null || Number(s) === 0 ? null : s;
+}
 export function parseOndoTime(iso, what) {
     const t = Date.parse(iso);
     if (!Number.isFinite(t))
@@ -166,7 +177,7 @@ async function fetchMarkets(net) {
             settle: "USDC",
             quoteAsset: pair.pair.quote,
             markPrice: mark.markPrice,
-            indexPrice: strOrNull(contract.indexPrice),
+            indexPrice: priceOrNull(contract.indexPrice),
             fundingRate: strOrNull(contract.fundingRate),
             fundingRateBasis: ONDO_FUNDING_BASIS,
             settlementIntervalHours: ONDO_SETTLEMENT_HOURS,

package/dist/exchanges/ondo/spot.d.ts

@@ -1,5 +1,5 @@
 /**
- * Ondo Perps spot adapter (design §12, §12.4).
+ * Ondo Perps spot adapter.
  *
  * Same host and HMAC API key as perps (shares OndoAdapter's OndoClient).
  * Account model "separate": the Spot wallet ("spot") next to the Perps margin
@@ -35,7 +35,7 @@
  * Market orders: IOC LIMIT at
  *   alignProtectionPrice(slippagePrice(mid, side, bps), quoteIncrement, side)
  * which is the web app's own pattern. bps = the caller's resolveSlippage()
- * value (design §13.2). The mid comes from the spot
+ * value. The mid comes from the spot
  * ticker's bid/ask; a one-sided book is PRICE_STALE (no lastPrice fallback).
  *
  * Unverified (needs a funded key):

package/dist/exchanges/ondo/spot.js

@@ -1,5 +1,5 @@
 /**
- * Ondo Perps spot adapter (design §12, §12.4).
+ * Ondo Perps spot adapter.
  *
  * Same host and HMAC API key as perps (shares OndoAdapter's OndoClient).
  * Account model "separate": the Spot wallet ("spot") next to the Perps margin
@@ -35,7 +35,7 @@
  * Market orders: IOC LIMIT at
  *   alignProtectionPrice(slippagePrice(mid, side, bps), quoteIncrement, side)
  * which is the web app's own pattern. bps = the caller's resolveSlippage()
- * value (design §13.2). The mid comes from the spot
+ * value. The mid comes from the spot
  * ticker's bid/ask; a one-sided book is PRICE_STALE (no lastPrice fallback).
  *
  * Unverified (needs a funded key):
@@ -361,7 +361,7 @@ export class OndoSpotAdapter {
     }
 }
 /**
- * Classify a POST /v1/spot/orders failure (design §12.3). Definite: a definite-code
+ * Classify a POST /v1/spot/orders failure. Definite: a definite-code
  * PerpError (auth, signer, validation) or a venue error envelope on HTTP 4xx (generic
  * EXCHANGE_ERROR → ORDER_REJECTED). RATE_LIMITED is kept (rejected before processing).
  * Unknown → ORDER_PENDING: network failure, HTTP 5xx, a non-JSON / result-less body,