perp-cli 0.15.0 → 0.16.0

package/dist/exchanges/txflow/adapter.js

@@ -6,13 +6,28 @@
  * CAPABILITY_UNSUPPORTED before any request — there is no TxFlow account or order code.
  */
 import { PerpError } from "../../errors.js";
+import { assertCandleInterval } from "../interface.js";
 import { unsupported } from "../trading-v2.js";
 import { roleUnsupported, networkConfig } from "../venue.js";
 import { toLegacyMarketInfo } from "../venue-types.js";
 import { txflowShapeError, TxflowClient } from "./client.js";
 import { fetchTxflowDirectory, fetchTxflowMarkets, resolveTxflowMarket } from "./public.js";
-/** Candle intervals the TxFlow app requests (HL-style). */
-export const TXFLOW_KLINE_INTERVALS = new Set(["1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "8h", "12h", "1d", "3d", "1w", "1M"]);
+/**
+ * Candle intervals that return bars (verified live 2026-10-19, coin 1). 3d / 1w / 1M are
+ * accepted by the API but answer [] for every window, so they are not offered.
+ */
+export const TXFLOW_KLINE_MS = {
+    "1m": 60_000, "3m": 180_000, "5m": 300_000, "15m": 900_000, "30m": 1_800_000, "1h": 3_600_000,
+    "2h": 7_200_000, "4h": 14_400_000, "8h": 28_800_000, "12h": 43_200_000, "1d": 86_400_000,
+};
+export const TXFLOW_KLINE_INTERVALS = new Set(Object.keys(TXFLOW_KLINE_MS));
+/**
+ * candleSnapshot answers `200 []` (no error) when the window spans more than ~3000 bars
+ * (measured 2026-10-19: 3000 bars OK, 3050 → [] at 1h; same at 1m / 5m / 1d), so ranges are
+ * read in windows of at most 2900 bars and merged.
+ */
+export const TXFLOW_KLINE_WINDOW_BARS = 2900;
+export const TXFLOW_KLINE_MAX_WINDOWS = 50;
 function dec(v, what) {
     if (typeof v !== "string" || !/^-?\d+(\.\d+)?$/.test(v))
         throw txflowShapeError(`${what} is not a decimal string`);
@@ -68,7 +83,7 @@ export class TxflowPublicAdapter {
                 throw txflowShapeError(`trade side ${String(x.side)}`);
             if (typeof x.time !== "number")
                 throw txflowShapeError("trade without time");
-            // Public tape carries no fee; "0" follows the legacy ExchangeTrade convention for public trades.
+            // Public tape: no fee applies to the viewer → null (ExchangePublicTrade), never "0".
             return { time: x.time, symbol: m.symbol, side: x.side === "B" ? "buy" : "sell", price: dec(x.px, "trade px"), size: dec(x.sz, "trade sz"), fee: null };
         });
     }
@@ -76,27 +91,44 @@ export class TxflowPublicAdapter {
         throw unsupported("txflow", "fundingHistory", "TxFlow's unofficial API refuses funding-history reads (HTTP 403)", "Current TxFlow funding (unverified, per hour): perp -e txflow market info <symbol>, or perp arb scan --rates --include-unverified");
     }
     async getKlines(symbol, interval, startTime, endTime) {
-        if (!TXFLOW_KLINE_INTERVALS.has(interval)) {
+        const ms = TXFLOW_KLINE_MS[interval];
+        if (ms === undefined) {
             throw new PerpError("INVALID_PARAMS", `TxFlow: unsupported candle interval "${interval}"`, {
                 remediation: `Use one of: ${[...TXFLOW_KLINE_INTERVALS].join(", ")}`,
             });
         }
+        const span = TXFLOW_KLINE_WINDOW_BARS * ms;
+        const windows = Math.max(1, Math.ceil((endTime - startTime) / span));
+        if (windows > TXFLOW_KLINE_MAX_WINDOWS) {
+            throw new PerpError("INVALID_PARAMS", `TxFlow: ${interval} candles over this range need ${windows} requests (max ${TXFLOW_KLINE_MAX_WINDOWS})`, {
+                remediation: "Narrow --start / --end or use a longer interval",
+            });
+        }
         const m = await this.market(symbol);
-        const res = await this.client.info({ type: "candleSnapshot", req: { coin: String(m.index), interval, startTime, endTime } });
-        if (!Array.isArray(res))
-            throw txflowShapeError("candleSnapshot is not an array");
-        return res.map(c => {
-            const x = c;
-            if (typeof x.t !== "number")
-                throw txflowShapeError("candle without t");
-            return {
-                time: x.t,
-                open: dec(x.o, "candle o"), high: dec(x.h, "candle h"), low: dec(x.l, "candle l"), close: dec(x.c, "candle c"),
-                volume: dec(x.v, "candle v"),
-                quoteVolume: null,
-                trades: typeof x.n === "number" ? x.n : null,
-            };
-        });
+        const byTime = new Map();
+        // Disjoint windows [from, to), each within the venue's silent ~3000-bar cap; merged by open time.
+        for (let from = startTime;; from += span) {
+            const to = Math.min(from + span, endTime);
+            const res = await this.client.info({ type: "candleSnapshot", req: { coin: String(m.index), interval, startTime: from, endTime: to } });
+            if (!Array.isArray(res))
+                throw txflowShapeError("candleSnapshot is not an array");
+            for (const c of res) {
+                const x = c;
+                if (typeof x.t !== "number")
+                    throw txflowShapeError("candle without t");
+                assertCandleInterval("txflow", interval, x.i);
+                byTime.set(x.t, {
+                    time: x.t,
+                    open: dec(x.o, "candle o"), high: dec(x.h, "candle h"), low: dec(x.l, "candle l"), close: dec(x.c, "candle c"),
+                    volume: dec(x.v, "candle v"),
+                    quoteVolume: null,
+                    trades: typeof x.n === "number" ? x.n : null,
+                });
+            }
+            if (to >= endTime)
+                break;
+        }
+        return [...byTime.values()].sort((a, b) => a.time - b.time);
     }
     // ── Account / trading: refused (market-data-only venue, unofficial API) ──
     refuse(feature) {

package/dist/exchanges/txflow/client.js

@@ -67,7 +67,9 @@ export class TxflowClient {
             });
         }
         if (!res.ok) {
-            throw new PerpError("EXCHANGE_ERROR", `TxFlow ${body.type}: HTTP ${res.status} ${text.slice(0, 200)}`, {
+            // A 5xx can be a raw Cloudflare HTML page (live: candleSnapshot 1w / 3d → HTTP 500): tags stripped.
+            const clean = text.replace(/<(script|style)[\s\S]*?<\/\1>/gi, " ").replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim().slice(0, 200);
+            throw new PerpError("EXCHANGE_ERROR", `TxFlow ${body.type}: HTTP ${res.status} ${clean}`, {
                 exchange: "txflow", status: res.status, remediation: UNOFFICIAL_REMEDIATION(body.type),
             });
         }

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

@@ -6,6 +6,9 @@
  *                                         name "BTC-USDC", baseCurrency, szDecimals (can be
  *                                         NEGATIVE: lot 10, 100 …), priceTick, maxLeverage,
  *                                         haltTrading, delisted, tagIds
+ *   POST /info {type:"allMarketTickers"}  per instrument: dayNtlVlm (24 h USD notional), prevDayPx …;
+ *                                         `instrumentId` == perpMeta `index` (spot rows ≥ 10000),
+ *                                         empty fields are "" (→ null). `market list|prices` only.
  *   WS allAssetCtxs (one-shot snapshot)   per coin: markPx, oraclePx, funding, openInterest,
  *                                         nextFundingTime, prevFundingTime. `coin` == perpMeta
  *                                         `index` (as a string) — joined by id, never by position.
@@ -41,6 +44,7 @@ export interface TxflowMarketMeta {
 export declare function stepFromSzDecimals(sz: number): string;
 /** Exact percent → fraction (two-place decimal shift on the string; "0.00125" → "0.0000125"). */
 export declare function percentToFraction(pct: string): string;
+export declare function looksTxflowTradFi(symbol: string, tagIds: readonly number[], fullName: string | null, description: string | null): boolean;
 /** Parse one perpMeta row; shape drift is EXCHANGE_ERROR. Returns null for a delisted market. */
 export declare function toTxflowMarketMeta(raw: unknown): TxflowMarketMeta | null;
 export declare function fetchTxflowDirectory(client: TxflowClient): Promise<TxflowMarketMeta[]>;
@@ -64,7 +68,14 @@ export declare function joinSnapshot(dir: readonly TxflowMarketMeta[], ctxs: rea
  * interval cannot be PROVEN from next − prev funding time (a missing time is unknown, never assumed 1h).
  */
 export declare function hourlyFundingOf(ctx: TxflowCtx): string | null;
-export declare function toTxflowVenueMarket(m: TxflowMarketMeta, ctx: TxflowCtx): VenueMarket;
+/** First spot instrumentId in allMarketTickers (perp ids are the perpMeta index, below it). */
+export declare const TXFLOW_SPOT_ID_BASE = 10000;
+/**
+ * 24 h USD notional volume per perp coin id from allMarketTickers. "" (no trades) → null, never
+ * "0"; a non-list answer or a row without a numeric instrumentId is EXCHANGE_ERROR.
+ */
+export declare function fetchTxflowDayVolumes(client: TxflowClient): Promise<Map<number, string | null>>;
+export declare function toTxflowVenueMarket(m: TxflowMarketMeta, ctx: TxflowCtx, volume24h: string | null): VenueMarket;
 export interface TxflowPublicDeps {
     wsFactory: WsFactory;
     warn: (msg: string) => void;

package/dist/exchanges/txflow/public.js

@@ -6,6 +6,9 @@
  *                                         name "BTC-USDC", baseCurrency, szDecimals (can be
  *                                         NEGATIVE: lot 10, 100 …), priceTick, maxLeverage,
  *                                         haltTrading, delisted, tagIds
+ *   POST /info {type:"allMarketTickers"}  per instrument: dayNtlVlm (24 h USD notional), prevDayPx …;
+ *                                         `instrumentId` == perpMeta `index` (spot rows ≥ 10000),
+ *                                         empty fields are "" (→ null). `market list|prices` only.
  *   WS allAssetCtxs (one-shot snapshot)   per coin: markPx, oraclePx, funding, openInterest,
  *                                         nextFundingTime, prevFundingTime. `coin` == perpMeta
  *                                         `index` (as a string) — joined by id, never by position.
@@ -65,14 +68,55 @@ export function percentToFraction(pct) {
         return "0";
     return neg ? `-${out}` : out;
 }
-function assetClassOf(symbol, tagIds) {
-    if (!tagIds.includes(TXFLOW_TRADFI_TAG))
+/**
+ * TradFi markets listed WITHOUT the TradFi tag (live 2026-10-19: ~38 rows with `tagIds: []`, e.g.
+ * COPPER, NATGAS, MRNA, GS, PATH, TEAM, TLT, SOXS) were classed as crypto and got a crypto
+ * canonical, so arb could pair GS or PATH with same-named crypto tokens. A row is TradFi when it is
+ * tagged, its description reads like a share / ETF / commodity / FX / pre-IPO contract, its
+ * fullName reads like a company or fund (as Variational's looksTradFi), or it is one of the
+ * untagged equities whose perpMeta row has no description (UNTAGGED_TRADFI, from the live listing).
+ */
+const TRADFI_DESCRIPTION = /\b(common stock|ordinary shares|shares\b|ETF\b|Pre-IPO|exchange rate|price reference for|priced in US dollars, representing)/i;
+const TRADFI_FULLNAME = /\b(Inc|Corp|Corporation|Company|Holdings?|Ltd|Limited|plc|PBC|N\.V|Group|ETF|Shares|Currency FX|Co\.)\b\.?/i;
+const UNTAGGED_TRADFI = new Set([
+    "CRDO", "APP", "ADBE", "COST", "BX", "DKNG", "BRKB", "KO", "IBM", "QNTX", "UNH", "TWST", "CVNA", "MCD", "NKE",
+    "AAOI", "ASTS", "VST", "SNPS", "BSP",
+]);
+/** Crypto tokens whose description reads like a commodity contract (Tether Gold is a token). */
+const CRYPTO_DESPITE_DESCRIPTION = new Set(["XAUT"]);
+export function looksTxflowTradFi(symbol, tagIds, fullName, description) {
+    if (tagIds.includes(TXFLOW_TRADFI_TAG))
+        return true;
+    if (CRYPTO_DESPITE_DESCRIPTION.has(symbol))
+        return false;
+    if (description !== null && TRADFI_DESCRIPTION.test(description))
+        return true;
+    if (fullName !== null && TRADFI_FULLNAME.test(fullName))
+        return true;
+    return UNTAGGED_TRADFI.has(symbol);
+}
+/** Class of an unclassified TradFi row from its listing text (its canonical stays null either way). */
+function textClassOf(fullName, description) {
+    const text = `${fullName ?? ""} ${description ?? ""}`;
+    if (/exchange rate|Currency FX/i.test(text))
+        return "fx";
+    if (/Pre-IPO|\bPBC\b|private artificial intelligence company/i.test(text))
+        return "preIpo";
+    if (/\bETF\b|\bShares\b/.test(text))
+        return "etf";
+    if (/priced in US dollars, representing/i.test(text))
+        return "commodity";
+    return "equity";
+}
+function assetClassOf(symbol, tradFi, fullName, description) {
+    if (!tradFi)
         return "crypto";
-    return TRADFI_CLASS[symbol] ?? "equity";
+    const known = TRADFI_CLASS[symbol];
+    return known !== undefined ? known : textClassOf(fullName, description);
 }
-function canonicalOf(symbol, tagIds, assetClass) {
-    // An unclassified TradFi market is never matched across venues.
-    if (tagIds.includes(TXFLOW_TRADFI_TAG) && TRADFI_CLASS[symbol] === undefined)
+function canonicalOf(symbol, tradFi, assetClass) {
+    // An unclassified TradFi market (tagged or not) is never matched across venues.
+    if (tradFi && TRADFI_CLASS[symbol] === undefined)
         return null;
     return canonicalFor("txflow", symbol, assetClass);
 }
@@ -101,7 +145,10 @@ export function toTxflowMarketMeta(raw) {
         return null;
     const symbol = r.baseCurrency.toUpperCase();
     const tagIds = r.tagIds;
-    const assetClass = assetClassOf(symbol, tagIds);
+    const fullName = typeof r.fullName === "string" ? r.fullName : null;
+    const description = typeof r.description === "string" ? r.description : null;
+    const tradFi = looksTxflowTradFi(symbol, tagIds, fullName, description);
+    const assetClass = assetClassOf(symbol, tradFi, fullName, description);
     return {
         index: r.index,
         name: r.name,
@@ -113,7 +160,7 @@ export function toTxflowMarketMeta(raw) {
         halted: r.haltTrading,
         tagIds,
         assetClass,
-        canonical: canonicalOf(symbol, tagIds, assetClass),
+        canonical: canonicalOf(symbol, tradFi, assetClass),
     };
 }
 export async function fetchTxflowDirectory(client) {
@@ -189,7 +236,28 @@ export function hourlyFundingOf(ctx) {
     return percentToFraction(ctx.fundingPct);
 }
 // ── Mapping ──
-export function toTxflowVenueMarket(m, ctx) {
+/** First spot instrumentId in allMarketTickers (perp ids are the perpMeta index, below it). */
+export const TXFLOW_SPOT_ID_BASE = 10_000;
+/**
+ * 24 h USD notional volume per perp coin id from allMarketTickers. "" (no trades) → null, never
+ * "0"; a non-list answer or a row without a numeric instrumentId is EXCHANGE_ERROR.
+ */
+export async function fetchTxflowDayVolumes(client) {
+    const res = await client.info({ type: "allMarketTickers" });
+    if (!Array.isArray(res))
+        throw txflowShapeError("allMarketTickers is not an array");
+    const out = new Map();
+    for (const r of res) {
+        const x = r;
+        if (typeof x.instrumentId !== "number" || !Number.isInteger(x.instrumentId))
+            throw txflowShapeError("allMarketTickers row without a numeric instrumentId");
+        if (x.instrumentId >= TXFLOW_SPOT_ID_BASE)
+            continue;
+        out.set(x.instrumentId, decOrNull(x.dayNtlVlm));
+    }
+    return out;
+}
+export function toTxflowVenueMarket(m, ctx, volume24h) {
     return {
         venue: "txflow",
         venueSymbol: String(m.index),
@@ -205,7 +273,7 @@ export function toTxflowVenueMarket(m, ctx) {
         settlementIntervalHours: 1,
         // Base units (as Hyperliquid publishes it) [inferred].
         openInterest: ctx.openInterest,
-        volume24h: null,
+        volume24h,
         tickSize: m.tickSize,
         stepSize: m.stepSize,
         minSize: null,
@@ -246,7 +314,10 @@ async function fetchJoined(net, deps) {
     return out;
 }
 export async function fetchTxflowMarkets(net, deps = DEFAULT_DEPS) {
-    return (await fetchJoined(net, deps)).map(({ meta, ctx }) => toTxflowVenueMarket(meta, ctx));
+    const { client } = clientFor(net); // testnet → NOT_IMPLEMENTED before any request
+    const [joined, volumes] = await Promise.all([fetchJoined(net, deps), fetchTxflowDayVolumes(client)]);
+    // A market absent from allMarketTickers has no published volume → null.
+    return joined.map(({ meta, ctx }) => toTxflowVenueMarket(meta, ctx, volumes.has(meta.index) ? volumes.get(meta.index) : null));
 }
 export async function fetchTxflowFundingRates(net, deps = DEFAULT_DEPS) {
     const out = [];

package/dist/exchanges/unknown-symbol.d.ts

@@ -12,7 +12,12 @@ import { PerpError } from "../errors.js";
 import type { ExchangeMarketInfo } from "./interface.js";
 /** SYMBOL_NOT_FOUND for `symbol` on `venue`, with the listing command as remediation. */
 export declare function symbolNotFound(venue: string, symbol: string, message?: string): PerpError;
-/** Directory match: case-insensitive, a "-PERP" display suffix ignored on either side. */
+/**
+ * Directory match on the exact wire symbol (case-sensitive), a "-PERP" display suffix ignored on
+ * either side. Case-sensitive on purpose: the venues are (Pacifica `KPEPE` answers `200 []` where
+ * `kPEPE` has rows), so a casing miss must be SYMBOL_NOT_FOUND, never "no data". The adapter
+ * resolves the typed symbol to the venue's spelling before the request.
+ */
 export declare function listsSymbol(markets: readonly Pick<ExchangeMarketInfo, "symbol">[], symbol: string): boolean;
 /**
  * `rows` as returned by the venue, unless they are empty and the market is not in the venue's

package/dist/exchanges/unknown-symbol.js

@@ -16,9 +16,14 @@ export function symbolNotFound(venue, symbol, message) {
         remediation: `List markets: perp -e ${venue} market list`,
     });
 }
-/** Directory match: case-insensitive, a "-PERP" display suffix ignored on either side. */
+/**
+ * Directory match on the exact wire symbol (case-sensitive), a "-PERP" display suffix ignored on
+ * either side. Case-sensitive on purpose: the venues are (Pacifica `KPEPE` answers `200 []` where
+ * `kPEPE` has rows), so a casing miss must be SYMBOL_NOT_FOUND, never "no data". The adapter
+ * resolves the typed symbol to the venue's spelling before the request.
+ */
 export function listsSymbol(markets, symbol) {
-    const norm = (s) => s.toUpperCase().replace(/-PERP$/, "");
+    const norm = (s) => s.replace(/-PERP$/i, "");
     const want = norm(symbol);
     return markets.some(m => norm(m.symbol) === want);
 }

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

@@ -7,7 +7,7 @@
  * getFundingHistory refuse with CAPABILITY_UNSUPPORTED (with the command that does work), and every
  * account / trading method refuses before any request.
  */
-import type { CurrentFundingTerms, RfqQuotes, ExchangeAdapter, ExchangeBalance, ExchangeFundingPayment, ExchangeKline, ExchangeMarketInfo, ExchangeOrder, ExchangePosition, ExchangeTrade, ExchangePublicTrade } from "../interface.js";
+import type { CurrentFundingTerms, RfqQuotes, ExchangeAdapter, ExchangeBalance, ExchangeFundingPayment, ExchangeKline, ExchangeMarketInfo, ExchangeOrder, ExchangePosition, ExchangeTrade, ExchangePublicTrade, FundingHistoryRow } from "../interface.js";
 import { type VenueDefinition } from "../venue.js";
 import { type Network } from "../venue-types.js";
 import { type VariationalSwapRate } from "./public.js";
@@ -48,11 +48,7 @@ export declare class VariationalPublicAdapter implements ExchangeAdapter {
         asks: [string, string][];
     }>;
     getRecentTrades(): Promise<ExchangePublicTrade[]>;
-    getFundingHistory(): Promise<{
-        time: number;
-        rate: string;
-        price: string | null;
-    }[]>;
+    getFundingHistory(): Promise<FundingHistoryRow[]>;
     getKlines(): Promise<ExchangeKline[]>;
     private refuse;
     getBalance(): Promise<ExchangeBalance>;

package/dist/exchanges/venue-types.d.ts

@@ -4,7 +4,7 @@
  * SSOT Rule #2: every "unknown" value is `T | null`, never optional, never a
  * silently substituted default.
  */
-import type { ExchangeMarketInfo } from "./interface.js";
+import type { ExchangeMarketInfo, FundingRateKind } from "./interface.js";
 import type { ResolvedSlippage, SlippageSource } from "./slippage.js";
 import type { AppliedBuilderFee } from "./builder-fee.js";
 export type VenueId = "pacifica" | "hyperliquid" | "lighter" | "aster" | "lighter-rh" | "ondo" | "arcus" | "qfex" | "risex" | "txflow" | "variational" | "grvt" | "extended";
@@ -23,7 +23,12 @@ export type FundingRateBasis = {
 };
 /** Convert a raw quoted rate to a per-hour rate. */
 export declare function rateToHourly(rate: number, basis: FundingRateBasis): number;
-export type AssetClass = "crypto" | "equity" | "index" | "etf" | "commodity" | "fx" | "preIpo";
+/**
+ * "unclassified": listed, but its class is ambiguous (a ticker that names different instruments
+ * on different venues: SPX6900 vs the S&P 500, Pacifica BP / CHIP, Lighter BB / BOT / WEN / QNT,
+ * Lighter RH USELESS). Its canonical is always null, so it is never matched across venues.
+ */
+export type AssetClass = "crypto" | "equity" | "index" | "etf" | "commodity" | "fx" | "preIpo" | "unclassified";
 export interface MarketSession {
     /** Whether the underlying (e.g. US equity) market is open right now. */
     underlyingOpen: boolean;
@@ -73,7 +78,18 @@ export interface VenueMarket {
     session: MarketSession | null;
     /** false = listed but not tradable right now (offline / paused / corporate action). */
     tradable: boolean;
+    /**
+     * The venue's listing status as the CLI market row shows it (Extended "ACTIVE" / "REDUCE_ONLY",
+     * Ondo "active" / …, QFEX "active" / "nonUsdQuote"); absent = the venue states none.
+     */
+    status?: string | null;
 }
+/**
+ * Quantity decimals of a lot step, or null when the step is not a power of ten ≤ 1 ("0.001" → 3,
+ * "1" → 0; TxFlow "10" / "100" and a "0.5" step → null): a decimals count cannot express them, and
+ * 0 next to stepSize "10" read as "any integer". `stepSize` is the authoritative grid.
+ */
+export declare function decimalsOf(step: string): number | null;
 /** Pure mapping used by new-venue adapters to serve the legacy getMarkets(). */
 /** Tick/step/leverage required for order entry. Throws when the venue did not publish them. */
 export declare function requireTradingPrecision(m: VenueMarket): {
@@ -81,16 +97,35 @@ export declare function requireTradingPrecision(m: VenueMarket): {
     stepSize: string;
     maxLeverage: number;
 };
+export declare function fundingRateKindOf(venue: VenueMarket["venue"], fundingRate: string | null): FundingRateKind | null;
+/**
+ * THE market-row shape (`perp market list` / `info` / `prices`, ExchangeMarketInfo) of a
+ * VenueMarket — the one mapper for the CLI adapters of VenueMarket venues and the keyless MCP
+ * `get_markets` public directory rows. It does not require trading precision: a public row
+ * without a published tick / lot / leverage maps those to null.
+ */
+export declare function venueMarketRow(m: VenueMarket): ExchangeMarketInfo & {
+    tradable: boolean;
+    quoteAsset: string | null;
+    status: string | null;
+};
+/** venueMarketRow for an adapter that trades the market: tick / lot / leverage must be published. */
 export declare function toLegacyMarketInfo(m: VenueMarket): ExchangeMarketInfo;
 export interface VenueFundingRate {
     venue: VenueId;
     venueSymbol: string;
     symbol: string;
     canonical: string | null;
-    rate: string;
+    /** null = no funding right now (`marketClosed` true: outside the market's funding hours). */
+    rate: string | null;
     basis: FundingRateBasis;
     markPrice: string | null;
     nextFundingTime: number | null;
+    /**
+     * true = the current funding window is outside the market's funding hours (QFEX market_hours):
+     * `rate` is null — the venue's 0 is "no funding", not a 0 rate. Absent = funds around the clock.
+     */
+    marketClosed?: boolean;
 }
 /** CLI-level TIF inputs. "TOB" = Pacifica top-of-book, "GTX" = Aster post-only. */
 export type TimeInForce = "GTC" | "GTT" | "IOC" | "FOK" | "ALO" | "TOB" | "GTX";
@@ -228,3 +263,11 @@ export interface LeverageResult {
 export declare function orderRefOf(r: Pick<OrderResult, "orderId" | "clientOrderId">): OrderRef;
 /** Parse a CLI order reference: "c:<id>" → clientOrderId, otherwise orderId. */
 export declare function parseOrderRef(s: string): OrderRef;
+/**
+ * Next funding settlement of a venue that documents hourly settlement on the hour (UTC): the next
+ * top of the hour after `now`. Used only where the venue's docs say so — Hyperliquid ("paid every
+ * hour"), Lighter ("at each hour mark"), Pacifica ("at the end of each 1-hour interval") — and
+ * their settled history is stamped on the hour (live 2026-10-19: HL 18:00:00.139 … 21:00:00.032,
+ * Pacifica 18:00:02.674 … 21:00:02.574). Other venues keep null unless they publish the time.
+ */
+export declare function nextTopOfHourMs(now?: number): number;

package/dist/exchanges/venue-types.js

@@ -21,10 +21,17 @@ export function rateToHourly(rate, basis) {
         return rate / basis.hours;
     return rate / (24 * 365);
 }
-function decimalsOf(step) {
-    const s = step.includes("e") || step.includes("E") ? Number(step).toFixed(20).replace(/0+$/, "") : step;
-    const dot = s.indexOf(".");
-    return dot === -1 ? 0 : s.length - dot - 1;
+/**
+ * Quantity decimals of a lot step, or null when the step is not a power of ten ≤ 1 ("0.001" → 3,
+ * "1" → 0; TxFlow "10" / "100" and a "0.5" step → null): a decimals count cannot express them, and
+ * 0 next to stepSize "10" read as "any integer". `stepSize` is the authoritative grid.
+ */
+export function decimalsOf(step) {
+    const s = step.includes("e") || step.includes("E") ? Number(step).toFixed(20) : step;
+    const t = s.includes(".") ? s.replace(/0+$/, "").replace(/\.$/, "") : s;
+    if (!/^(1|0\.0*1)$/.test(t))
+        return null;
+    return t === "1" ? 0 : t.length - 2;
 }
 /** Pure mapping used by new-venue adapters to serve the legacy getMarkets(). */
 /** Tick/step/leverage required for order entry. Throws when the venue did not publish them. */
@@ -34,9 +41,54 @@ export function requireTradingPrecision(m) {
     }
     return { tickSize: m.tickSize, stepSize: m.stepSize, maxLeverage: m.maxLeverage };
 }
-export function toLegacyMarketInfo(m) {
-    const p = requireTradingPrecision(m);
+/**
+ * What a VenueMarket.fundingRate is per venue (REST source), consistent with the WS `rateKind` where
+ * both read the same field. null = not verified. Venues with per-row kinds (GRVT, Extended,
+ * Variational) set their own on top.
+ *  - arcus: /v1/markets fundingRate = the last hourly settlement (WS markets channel: lastSettled).
+ *  - risex: current_funding_rate equals the last settled print (venues/risex.ts, verified 2026-10-14).
+ *  - txflow: allAssetCtxs `funding` moves every tick — the running period's accruing estimate.
+ *  - hyperliquid: metaAndAssetCtxs `funding` (WS allDexsAssetCtxs) — accruing.
+ *  - aster: premiumIndex lastFundingRate moves during the period (WS markPrice@arr `r`) — accruing.
+ *  - pacifica: /info/prices `funding` = the last settled hourly rate (WS prices `funding`).
+ *  - lighter, lighter-rh: WS market_stats funding_rate = the newest /fundings print — lastSettled.
+ *  - grvt: the ticker's funding rate is the next settlement's (predicted) — as the adapter labels it.
+ *  - extended: /info/markets fundingRate is the current hour's accruing rate.
+ *  - variational: the quoted rate is the predicted next payment.
+ *  - ondo, qfex: not verified against settled prints → null.
+ */
+const VENUE_MARKET_RATE_KIND = {
+    arcus: "lastSettled",
+    risex: "lastSettled",
+    txflow: "accruing",
+    hyperliquid: "accruing",
+    aster: "accruing",
+    pacifica: "lastSettled",
+    lighter: "lastSettled",
+    "lighter-rh": "lastSettled",
+    grvt: "predicted",
+    extended: "accruing",
+    variational: "predicted",
+    // Ondo /v1/perps/contracts `fundingRate` is the last settled print: live 2026-10-19 21:17 UTC it
+    // equalled the 21:00 funding_rate_history row on every market whose rate moves (CXMT 0.0001139,
+    // BB 0.00003, PURR 0.0000182, WTI 0.0000038, USDJPY 0.000001 — each different from the 20:00 print).
+    ondo: "lastSettled",
+};
+export function fundingRateKindOf(venue, fundingRate) {
+    if (fundingRate === null)
+        return null;
+    const k = VENUE_MARKET_RATE_KIND[venue];
+    return k === undefined ? null : k;
+}
+/**
+ * THE market-row shape (`perp market list` / `info` / `prices`, ExchangeMarketInfo) of a
+ * VenueMarket — the one mapper for the CLI adapters of VenueMarket venues and the keyless MCP
+ * `get_markets` public directory rows. It does not require trading precision: a public row
+ * without a published tick / lot / leverage maps those to null.
+ */
+export function venueMarketRow(m) {
     const hours = m.fundingRateBasis.kind === "perHours" ? m.fundingRateBasis.hours : null;
+    const status = m.status;
     return {
         symbol: m.symbol,
         markPrice: m.markPrice,
@@ -44,13 +96,22 @@ export function toLegacyMarketInfo(m) {
         fundingRate: m.fundingRate,
         volume24h: m.volume24h,
         openInterest: m.openInterest,
-        maxLeverage: p.maxLeverage,
-        sizeDecimals: decimalsOf(p.stepSize),
-        stepSize: p.stepSize,
+        maxLeverage: m.maxLeverage,
+        sizeDecimals: m.stepSize === null ? null : decimalsOf(m.stepSize),
+        stepSize: m.stepSize,
         fundingHours: hours,
         marginTiers: m.marginTiers,
+        tradable: m.tradable,
+        fundingRateKind: fundingRateKindOf(m.venue, m.fundingRate),
+        quoteAsset: m.quoteAsset,
+        status: typeof status === "string" ? status : null,
     };
 }
+/** venueMarketRow for an adapter that trades the market: tick / lot / leverage must be published. */
+export function toLegacyMarketInfo(m) {
+    requireTradingPrecision(m);
+    return venueMarketRow(m);
+}
 /**
  * Attach an execution record to a result built without one. Fields of `partial`
  * that are absent are recorded as null (unknown), never defaulted to a value.
@@ -85,3 +146,13 @@ export function parseOrderRef(s) {
         return { kind: "clientOrderId", value: s.slice(2) };
     return { kind: "orderId", value: s };
 }
+/**
+ * Next funding settlement of a venue that documents hourly settlement on the hour (UTC): the next
+ * top of the hour after `now`. Used only where the venue's docs say so — Hyperliquid ("paid every
+ * hour"), Lighter ("at each hour mark"), Pacifica ("at the end of each 1-hour interval") — and
+ * their settled history is stamped on the hour (live 2026-10-19: HL 18:00:00.139 … 21:00:00.032,
+ * Pacifica 18:00:02.674 … 21:00:02.574). Other venues keep null unless they publish the time.
+ */
+export function nextTopOfHourMs(now = Date.now()) {
+    return (Math.floor(now / 3_600_000) + 1) * 3_600_000;
+}