@symmio/trading-core 1.1.0 → 3.0.0

package/dist/solvers/symbols/to-solver-symbol.d.ts

@@ -0,0 +1,11 @@
+import { ApiSymbolResponse } from '../types/generated/enigma-solver.js';
+import { SolverSymbol } from './types.js';
+/**
+ * Normalize raw Enigma `/symbols` rows to {@link SolverSymbol}. Rows missing an
+ * identity field are skipped; every other solver-optional field is filled with a
+ * neutral default so the normalized shape has no optional noise.
+ *
+ * @param symbols - Raw `ApiSymbolResponse` rows from the solver.
+ */
+export declare function toSolverSymbols(symbols: readonly ApiSymbolResponse[]): SolverSymbol[];
+//# sourceMappingURL=to-solver-symbol.d.ts.map

package/dist/solvers/symbols/to-solver-symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-solver-symbol.d.ts","sourceRoot":"","sources":["../../../src/solvers/symbols/to-solver-symbol.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAsB5C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,GAAG,YAAY,EAAE,CAErF"}

package/dist/solvers/symbols/to-solver-symbol.js

@@ -0,0 +1,46 @@
+import { toThresholdSeconds as e } from "../shared/solver-close-fee.js";
+import { toFiniteNumber as t } from "@symmio/utils/number";
+//#region src/solvers/symbols/to-solver-symbol.ts
+function n(e) {
+	return e.symbol_id !== void 0 && e.name !== void 0 && e.symbol !== void 0;
+}
+function r(e) {
+	return e.filter(n).map(i);
+}
+function i(n) {
+	return {
+		symbolId: n.symbol_id,
+		name: n.name,
+		symbol: n.symbol,
+		asset: n.asset ?? "",
+		isValid: n.is_valid ?? !1,
+		pricePrecision: n.price_precision ?? 0,
+		quantityPrecision: n.quantity_precision ?? 0,
+		maxLeverage: t(n.max_leverage),
+		maxNotionalValue: n.max_notional_value ?? 0,
+		rfqAllowed: n.rfq_allowed ?? !1,
+		tradingFee: n.trading_fee ?? "0",
+		hedgerFeeOpen: n.hedger_fee_open ?? "0",
+		hedgerFeeClose: n.hedger_fee_close ?? "0",
+		hedgerFeeCloseEarlyRate: n.hedger_fee_close_early_rate ?? n.hedger_fee_close ?? "0",
+		hedgerFeeCloseEarlyThreshold: e(n.hedger_fee_close_early_threshold),
+		hedgerFeeCloseStandardThreshold: e(n.hedger_fee_close_standard_threshold),
+		maxFundingRate: n.max_funding_rate ?? "0",
+		minNotionalValue: n.min_notional_value ?? "0",
+		maxQuantity: n.max_quantity ?? "0",
+		lotSize: n.lot_size ?? "0",
+		minAcceptableQuoteValue: n.min_acceptable_quote_value ?? "0",
+		minAcceptablePortionLf: n.min_acceptable_portion_lf ?? "0",
+		tokenAddress: n.token_address ?? "",
+		fundingRateEpochDuration: n.funding_rate_epoch_duration ?? "0",
+		fundingRateWindowTime: n.funding_rate_window_time ?? "0",
+		stateLong: n.state_long ?? 0,
+		stateShort: n.state_short ?? 0,
+		minOpenSolverFeeCap: n.min_open_solver_fee_cap ?? "0",
+		minCloseSolverFeeCap: n.min_close_solver_fee_cap ?? "0"
+	};
+}
+//#endregion
+export { r as toSolverSymbols };
+
+//# sourceMappingURL=to-solver-symbol.js.map

package/dist/solvers/symbols/to-solver-symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-solver-symbol.js","names":[],"sources":["../../../src/solvers/symbols/to-solver-symbol.ts"],"sourcesContent":["import { toFiniteNumber } from \"@symmio/utils/number\";\nimport { toThresholdSeconds } from \"../shared/solver-close-fee\";\nimport type { ApiSymbolResponse } from \"../types/generated/enigma-solver\";\nimport type { SolverSymbol } from \"./types\";\n\n/**\n * An `ApiSymbolResponse` row with the identity fields present. Enigma marks\n * every field optional in its OpenAPI spec, so we narrow to rows carrying a\n * usable identity (`symbol_id` / `name` / `symbol`) before mapping — a row\n * without identity cannot be traded or displayed.\n */\ntype IdentifiedSymbol = ApiSymbolResponse & {\n  symbol_id: number;\n  name: string;\n  symbol: string;\n};\n\n/**\n * Type guard: does a raw `/symbols` row carry the identity fields the SDK\n * requires? Rows failing this are dropped by {@link toSolverSymbols}.\n */\nfunction hasIdentity(symbol: ApiSymbolResponse): symbol is IdentifiedSymbol {\n  return symbol.symbol_id !== undefined && symbol.name !== undefined && symbol.symbol !== undefined;\n}\n\n/**\n * Normalize raw Enigma `/symbols` rows to {@link SolverSymbol}. Rows missing an\n * identity field are skipped; every other solver-optional field is filled with a\n * neutral default so the normalized shape has no optional noise.\n *\n * @param symbols - Raw `ApiSymbolResponse` rows from the solver.\n */\nexport function toSolverSymbols(symbols: readonly ApiSymbolResponse[]): SolverSymbol[] {\n  return symbols.filter(hasIdentity).map(toSolverSymbol);\n}\n\nfunction toSolverSymbol(symbol: IdentifiedSymbol): SolverSymbol {\n  return {\n    symbolId: symbol.symbol_id,\n    name: symbol.name,\n    symbol: symbol.symbol,\n    asset: symbol.asset ?? \"\",\n    isValid: symbol.is_valid ?? false,\n    pricePrecision: symbol.price_precision ?? 0,\n    quantityPrecision: symbol.quantity_precision ?? 0,\n    maxLeverage: toFiniteNumber(symbol.max_leverage),\n    maxNotionalValue: symbol.max_notional_value ?? 0,\n    rfqAllowed: symbol.rfq_allowed ?? false,\n    tradingFee: symbol.trading_fee ?? \"0\",\n    hedgerFeeOpen: symbol.hedger_fee_open ?? \"0\",\n    hedgerFeeClose: symbol.hedger_fee_close ?? \"0\",\n    // No early rate published → no decay: the early rate collapses to the standard rate.\n    hedgerFeeCloseEarlyRate: symbol.hedger_fee_close_early_rate ?? symbol.hedger_fee_close ?? \"0\",\n    hedgerFeeCloseEarlyThreshold: toThresholdSeconds(symbol.hedger_fee_close_early_threshold),\n    hedgerFeeCloseStandardThreshold: toThresholdSeconds(symbol.hedger_fee_close_standard_threshold),\n    maxFundingRate: symbol.max_funding_rate ?? \"0\",\n    minNotionalValue: symbol.min_notional_value ?? \"0\",\n    maxQuantity: symbol.max_quantity ?? \"0\",\n    lotSize: symbol.lot_size ?? \"0\",\n    minAcceptableQuoteValue: symbol.min_acceptable_quote_value ?? \"0\",\n    minAcceptablePortionLf: symbol.min_acceptable_portion_lf ?? \"0\",\n    tokenAddress: symbol.token_address ?? \"\",\n    fundingRateEpochDuration: symbol.funding_rate_epoch_duration ?? \"0\",\n    fundingRateWindowTime: symbol.funding_rate_window_time ?? \"0\",\n    stateLong: symbol.state_long ?? 0,\n    stateShort: symbol.state_short ?? 0,\n    minOpenSolverFeeCap: symbol.min_open_solver_fee_cap ?? \"0\",\n    minCloseSolverFeeCap: symbol.min_close_solver_fee_cap ?? \"0\",\n  };\n}\n"],"mappings":";;;AAqBA,SAAS,EAAY,GAAuD;CAC1E,OAAO,EAAO,cAAc,KAAA,KAAa,EAAO,SAAS,KAAA,KAAa,EAAO,WAAW,KAAA;AAC1F;AASA,SAAgB,EAAgB,GAAuD;CACrF,OAAO,EAAQ,OAAO,CAAW,EAAE,IAAI,CAAc;AACvD;AAEA,SAAS,EAAe,GAAwC;CAC9D,OAAO;EACL,UAAU,EAAO;EACjB,MAAM,EAAO;EACb,QAAQ,EAAO;EACf,OAAO,EAAO,SAAS;EACvB,SAAS,EAAO,YAAY;EAC5B,gBAAgB,EAAO,mBAAmB;EAC1C,mBAAmB,EAAO,sBAAsB;EAChD,aAAa,EAAe,EAAO,YAAY;EAC/C,kBAAkB,EAAO,sBAAsB;EAC/C,YAAY,EAAO,eAAe;EAClC,YAAY,EAAO,eAAe;EAClC,eAAe,EAAO,mBAAmB;EACzC,gBAAgB,EAAO,oBAAoB;EAE3C,yBAAyB,EAAO,+BAA+B,EAAO,oBAAoB;EAC1F,8BAA8B,EAAmB,EAAO,gCAAgC;EACxF,iCAAiC,EAAmB,EAAO,mCAAmC;EAC9F,gBAAgB,EAAO,oBAAoB;EAC3C,kBAAkB,EAAO,sBAAsB;EAC/C,aAAa,EAAO,gBAAgB;EACpC,SAAS,EAAO,YAAY;EAC5B,yBAAyB,EAAO,8BAA8B;EAC9D,wBAAwB,EAAO,6BAA6B;EAC5D,cAAc,EAAO,iBAAiB;EACtC,0BAA0B,EAAO,+BAA+B;EAChE,uBAAuB,EAAO,4BAA4B;EAC1D,WAAW,EAAO,cAAc;EAChC,YAAY,EAAO,eAAe;EAClC,qBAAqB,EAAO,2BAA2B;EACvD,sBAAsB,EAAO,4BAA4B;CAC3D;AACF"}

package/dist/solvers/symbols/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Long/short-side state filter accepted by {@link GetSymbolsParameters}. Mirrors
+ * the solver's `/symbols` `state_long` / `state_short` query values.
+ */
+export type SymbolStateFilter = "disabled" | "close_only" | "open_only" | "enabled";
+/**
+ * Validity filter accepted by {@link GetSymbolsParameters}. The solver defaults
+ * to `"true"` (valid symbols only); pass `"any"` to include invalid ones.
+ */
+export type SymbolValidityFilter = "true" | "false" | "any";
+/**
+ * One symbol from the Enigma solver's `/symbols` endpoint, normalized from the
+ * generated `ApiSymbolResponse` into a stable camelCase SDK shape.
+ *
+ * Distinct from {@link Market} (the `/contract-symbols` shape): `/symbols` is a
+ * paginated, filterable catalogue that reports **per-side** trading state
+ * ({@link SolverSymbol.stateLong} / {@link SolverSymbol.stateShort}) instead of
+ * the single `state`/`side` pair `/contract-symbols` returns. Treat the two as
+ * different endpoints — do not substitute one for the other.
+ */
+export interface SolverSymbol {
+    /** Numeric symbol id, e.g. `1`. */
+    symbolId: number;
+    /** Display name, e.g. `"BTCUSDT"`. */
+    name: string;
+    /** Ticker, e.g. `"BTC"`. */
+    symbol: string;
+    /** Base asset, e.g. `"BTC"`. */
+    asset: string;
+    /** Whether the symbol is currently valid/known to the solver. */
+    isValid: boolean;
+    /** Price display precision (decimal places). */
+    pricePrecision: number;
+    /** Quantity display precision (decimal places). */
+    quantityPrecision: number;
+    /** Maximum leverage. Coerced to a number (the solver returns it as a string). */
+    maxLeverage: number;
+    /** Maximum notional position value. */
+    maxNotionalValue: number;
+    /** Whether RFQ (instant-open) is allowed for this symbol. */
+    rfqAllowed: boolean;
+    /** Trading fee, as a decimal string (kept a string to avoid float loss). */
+    tradingFee: string;
+    /** Hedger fee charged on open, as a decimal string. */
+    hedgerFeeOpen: string;
+    /**
+     * Hedger fee charged on close, as a decimal string. This is the **standard**
+     * (floor) rate; a freshly opened position pays more — see
+     * {@link SolverSymbol.hedgerFeeCloseEarlyRate}. Pass the symbol to
+     * `getSolverCloseFeeRate` / `calculateSolverCloseFee` to price a close by
+     * holding time.
+     */
+    hedgerFeeClose: string;
+    /**
+     * Early (peak) close-fee rate charged flat until
+     * {@link SolverSymbol.hedgerFeeCloseEarlyThreshold} seconds, then decaying to
+     * {@link SolverSymbol.hedgerFeeClose}. Decimal string. Equals `hedgerFeeClose`
+     * when the solver publishes no decay.
+     */
+    hedgerFeeCloseEarlyRate: string;
+    /** Seconds from open during which `hedgerFeeCloseEarlyRate` applies flat. `0` when the solver publishes no decay. */
+    hedgerFeeCloseEarlyThreshold: number;
+    /** Seconds from open at/after which `hedgerFeeClose` applies; the rate decays linearly between the two thresholds. */
+    hedgerFeeCloseStandardThreshold: number;
+    /** Maximum funding rate, as a decimal string. */
+    maxFundingRate: string;
+    /** Minimum notional position value, as a decimal string. */
+    minNotionalValue: string;
+    /** Maximum order quantity, as a decimal string. */
+    maxQuantity: string;
+    /** Minimum tradable increment (lot size), as a decimal string. */
+    lotSize: string;
+    /** Minimum acceptable quote value, as a decimal string. */
+    minAcceptableQuoteValue: string;
+    /** Minimum acceptable portion of the liquidation fee, as a decimal string. */
+    minAcceptablePortionLf: string;
+    /** Collateral token address (from the price service). */
+    tokenAddress: string;
+    /** Funding-rate epoch duration, as a decimal string of seconds. */
+    fundingRateEpochDuration: string;
+    /** Funding-rate window time, as a decimal string of seconds. */
+    fundingRateWindowTime: string;
+    /** Long-side trading state: `0` Disabled, `1` Close only, `2` Open only, `3` Fully enabled. */
+    stateLong: number;
+    /** Short-side trading state: `0` Disabled, `1` Close only, `2` Open only, `3` Fully enabled. */
+    stateShort: number;
+    /** Minimum solver-fee cap a quote must allow on open, as a decimal string (perps-core v0.8.6 solver fees). */
+    minOpenSolverFeeCap: string;
+    /** Minimum solver-fee cap a quote must allow on close, as a decimal string (perps-core v0.8.6 solver fees). */
+    minCloseSolverFeeCap: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/solvers/symbols/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/solvers/symbols/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;AAEpF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAChC,qHAAqH;IACrH,4BAA4B,EAAE,MAAM,CAAC;IACrC,sHAAsH;IACtH,+BAA+B,EAAE,MAAM,CAAC;IACxC,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,uBAAuB,EAAE,MAAM,CAAC;IAChC,8EAA8E;IAC9E,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,wBAAwB,EAAE,MAAM,CAAC;IACjC,gEAAgE;IAChE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,+FAA+F;IAC/F,SAAS,EAAE,MAAM,CAAC;IAClB,gGAAgG;IAChG,UAAU,EAAE,MAAM,CAAC;IACnB,8GAA8G;IAC9G,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+GAA+G;IAC/G,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}

package/dist/solvers/trade-volume/get-trade-volume.d.ts

@@ -0,0 +1,37 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ReadSolverParameter } from '../../shared/types/properties.js';
+import { SolverDailyVolume } from './types.js';
+/**
+ * Parameters for {@link getTradeVolume}.
+ */
+export type GetTradeVolumeParameters = Compute<ReadSolverParameter & {
+    /** Solver market id (`symbol_id`) to read daily trade volume for. Required. */
+    symbolId: number;
+}>;
+/** Return type of {@link getTradeVolume}: one entry per day, ascending. */
+export type GetTradeVolumeReturnType = SolverDailyVolume[];
+/**
+ * Fetch the last N daily trade-volume rows for one market from the chain's
+ * enigma solver `/trade-volume/{symbol_id}` endpoint. Rows are returned in
+ * ascending day order. The solver base URL is resolved from `config` per call,
+ * so multiple chains never clobber each other.
+ *
+ * `/trade-volume/{symbol_id}` is an **Enigma-only** endpoint; the action asserts
+ * the resolved solver is an `enigma` solver and throws before hitting the wire
+ * otherwise.
+ *
+ * @param config - The SDK config.
+ * @param parameters - The required `symbolId` plus optional chain id / solver.
+ * @returns Normalized daily volume, one {@link SolverDailyVolume} per day.
+ * @throws {SymmApiError} when the API request fails.
+ * @throws {SymmError} `UNSUPPORTED_BY_SOLVER` when the resolved solver is not an `enigma` solver, or when the chain is unsupported.
+ *
+ * @example
+ * ```ts
+ * const volume = await getTradeVolume(config, { symbolId: 1 });
+ * const latest = volume.at(-1);
+ * console.log(latest?.volume); // notional traded on the most recent day
+ * ```
+ */
+export declare function getTradeVolume(config: Config, parameters: GetTradeVolumeParameters): Promise<GetTradeVolumeReturnType>;
+//# sourceMappingURL=get-trade-volume.d.ts.map

package/dist/solvers/trade-volume/get-trade-volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trade-volume.d.ts","sourceRoot":"","sources":["../../../src/solvers/trade-volume/get-trade-volume.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIlF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,mBAAmB,GAAG;IACpB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,EAAE,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,wBAAwB,GACnC,OAAO,CAAC,wBAAwB,CAAC,CAInC"}

package/dist/solvers/trade-volume/get-trade-volume.js

@@ -0,0 +1,27 @@
+import { SymmApiError as e, SymmError as t } from "../../shared/errors/symm-error.js";
+import { getTradeVolumeSymbolId as n } from "../types/generated/enigma-solver.js";
+import { assertSolverKind as r } from "../assert-solver-kind.js";
+import { toSolverDailyVolume as i } from "./to-daily-volume.js";
+import { isAxiosError as a } from "axios";
+//#region src/solvers/trade-volume/get-trade-volume.ts
+async function o(e, t) {
+	let n = e.getSolver({
+		chainId: t.chainId,
+		solverId: t.solverId
+	});
+	return r(n, "enigma", "getTradeVolume"), s(n.url, t.symbolId);
+}
+async function s(r, o) {
+	try {
+		return ((await n(o, { baseURL: r })).data ?? []).map(i);
+	} catch (n) {
+		throw n instanceof t ? n : a(n) ? e.fromAxios(n, {
+			code: "FETCH_TRADE_VOLUME_FAILED",
+			baseURL: r
+		}) : new t("api", "FETCH_TRADE_VOLUME_FAILED", `Failed to fetch trade volume: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { o as getTradeVolume };
+
+//# sourceMappingURL=get-trade-volume.js.map

package/dist/solvers/trade-volume/get-trade-volume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trade-volume.js","names":[],"sources":["../../../src/solvers/trade-volume/get-trade-volume.ts"],"sourcesContent":["import { isAxiosError } from \"axios\";\nimport type { Config } from \"../../core/config\";\nimport { SymmApiError, SymmError } from \"../../shared/errors/symm-error\";\nimport type { Compute, ReadSolverParameter } from \"../../shared/types/properties\";\nimport { assertSolverKind } from \"../assert-solver-kind\";\nimport { getTradeVolumeSymbolId } from \"../types/generated/enigma-solver\";\nimport { toSolverDailyVolume } from \"./to-daily-volume\";\nimport type { SolverDailyVolume } from \"./types\";\n\n/**\n * Parameters for {@link getTradeVolume}.\n */\nexport type GetTradeVolumeParameters = Compute<\n  ReadSolverParameter & {\n    /** Solver market id (`symbol_id`) to read daily trade volume for. Required. */\n    symbolId: number;\n  }\n>;\n\n/** Return type of {@link getTradeVolume}: one entry per day, ascending. */\nexport type GetTradeVolumeReturnType = SolverDailyVolume[];\n\n/**\n * Fetch the last N daily trade-volume rows for one market from the chain's\n * enigma solver `/trade-volume/{symbol_id}` endpoint. Rows are returned in\n * ascending day order. The solver base URL is resolved from `config` per call,\n * so multiple chains never clobber each other.\n *\n * `/trade-volume/{symbol_id}` is an **Enigma-only** endpoint; the action asserts\n * the resolved solver is an `enigma` solver and throws before hitting the wire\n * otherwise.\n *\n * @param config - The SDK config.\n * @param parameters - The required `symbolId` plus optional chain id / solver.\n * @returns Normalized daily volume, one {@link SolverDailyVolume} per day.\n * @throws {SymmApiError} when the API request fails.\n * @throws {SymmError} `UNSUPPORTED_BY_SOLVER` when the resolved solver is not an `enigma` solver, or when the chain is unsupported.\n *\n * @example\n * ```ts\n * const volume = await getTradeVolume(config, { symbolId: 1 });\n * const latest = volume.at(-1);\n * console.log(latest?.volume); // notional traded on the most recent day\n * ```\n */\nexport async function getTradeVolume(\n  config: Config,\n  parameters: GetTradeVolumeParameters,\n): Promise<GetTradeVolumeReturnType> {\n  const solver = config.getSolver({ chainId: parameters.chainId, solverId: parameters.solverId });\n  assertSolverKind(solver, \"enigma\", \"getTradeVolume\");\n  return fetchTradeVolume(solver.url, parameters.symbolId);\n}\n\n/**\n * Call the solver's `/trade-volume/{symbol_id}` endpoint with a per-call base URL\n * and map each raw daily row into the SDK's normalized array.\n *\n * @internal\n */\nasync function fetchTradeVolume(baseURL: string, symbolId: number): Promise<SolverDailyVolume[]> {\n  try {\n    const response = await getTradeVolumeSymbolId(symbolId, { baseURL });\n    return (response.data ?? []).map(toSolverDailyVolume);\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"FETCH_TRADE_VOLUME_FAILED\", baseURL });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"FETCH_TRADE_VOLUME_FAILED\",\n      `Failed to fetch trade volume: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;;AA6CA,eAAsB,EACpB,GACA,GACmC;CACnC,IAAM,IAAS,EAAO,UAAU;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,CAAC;CAE9F,OADA,EAAiB,GAAQ,UAAU,gBAAgB,GAC5C,EAAiB,EAAO,KAAK,EAAW,QAAQ;AACzD;AAQA,eAAe,EAAiB,GAAiB,GAAgD;CAC/F,IAAI;EAEF,SAAQ,MADe,EAAuB,GAAU,EAAE,WAAQ,CAAC,GAClD,QAAQ,CAAC,GAAG,IAAI,CAAmB;CACtD,SAAS,GAAK;EAOZ,MANI,aAAe,IAAiB,IAEhC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAA6B;EAAQ,CAAC,IAG5E,IAAI,EACR,OACA,6BACA,iCAAiC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAChF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/solvers/trade-volume/index.d.ts

@@ -0,0 +1,5 @@
+export * from './get-trade-volume.js';
+export * from './query.js';
+export * from './to-daily-volume.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/solvers/trade-volume/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solvers/trade-volume/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC"}

package/dist/solvers/trade-volume/query.d.ts

@@ -0,0 +1,29 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetTradeVolumeParameters, GetTradeVolumeReturnType } from './get-trade-volume.js';
+/** Data resolved by the {@link getTradeVolumeQueryOptions} query. */
+export type GetTradeVolumeData = GetTradeVolumeReturnType;
+/** Build the TanStack Query key for {@link getTradeVolumeQueryOptions}. */
+export declare function getTradeVolumeQueryKey(options: Compute<GetTradeVolumeParameters & ConfigKeyParameter>): readonly ["getTradeVolume", Record<string, unknown>];
+/** Query-key type produced by {@link getTradeVolumeQueryKey}. */
+export type GetTradeVolumeQueryKey = ReturnType<typeof getTradeVolumeQueryKey>;
+/** Options accepted by {@link getTradeVolumeQueryOptions}: the action's parameters plus TanStack overrides. */
+export type GetTradeVolumeOptions = Compute<GetTradeVolumeParameters & QueryParameter<GetTradeVolumeData, Error, GetTradeVolumeData, GetTradeVolumeQueryKey>>;
+/** TanStack Query options returned by {@link getTradeVolumeQueryOptions}. */
+export type GetTradeVolumeQueryOptions = SymmioQueryOptions<GetTradeVolumeData, Error, GetTradeVolumeData, GetTradeVolumeQueryKey>;
+/**
+ * Build TanStack Query options for {@link getTradeVolume}. The query is disabled
+ * when `symbolId` is `0` (the sentinel for "no market selected").
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters (required `symbolId`, optional `chainId` / `solverId`) and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getTradeVolumeQueryOptions(config, { symbolId: 1 }));
+ * ```
+ */
+export declare function getTradeVolumeQueryOptions(config: Config, options: GetTradeVolumeOptions): GetTradeVolumeQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/solvers/trade-volume/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/solvers/trade-volume/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAAkB,KAAK,wBAAwB,EAAE,KAAK,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAElH,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAE1D,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,wBAAwB,GAAG,kBAAkB,CAAC,wDAErG;AAED,iEAAiE;AACjE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE/E,+GAA+G;AAC/G,MAAM,MAAM,qBAAqB,GAAG,OAAO,CACzC,wBAAwB,GAAG,cAAc,CAAC,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,CAAC,CACjH,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,CACzD,kBAAkB,EAClB,KAAK,EACL,kBAAkB,EAClB,sBAAsB,CACvB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,0BAA0B,CAerH"}

package/dist/solvers/trade-volume/query.js

@@ -0,0 +1,25 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getTradeVolume as t } from "./get-trade-volume.js";
+//#region src/solvers/trade-volume/query.ts
+function n(t) {
+	return ["getTradeVolume", e(t)];
+}
+function r(e, r) {
+	return {
+		...r.query,
+		queryKey: n({
+			...r,
+			configKey: e.getChainConfigKey(r.chainId)
+		}),
+		enabled: (r.query?.enabled ?? !0) && r.symbolId > 0,
+		queryFn: () => t(e, {
+			chainId: r.chainId,
+			solverId: r.solverId,
+			symbolId: r.symbolId
+		})
+	};
+}
+//#endregion
+export { n as getTradeVolumeQueryKey, r as getTradeVolumeQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/solvers/trade-volume/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/solvers/trade-volume/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport { getTradeVolume, type GetTradeVolumeParameters, type GetTradeVolumeReturnType } from \"./get-trade-volume\";\n\n/** Data resolved by the {@link getTradeVolumeQueryOptions} query. */\nexport type GetTradeVolumeData = GetTradeVolumeReturnType;\n\n/** Build the TanStack Query key for {@link getTradeVolumeQueryOptions}. */\nexport function getTradeVolumeQueryKey(options: Compute<GetTradeVolumeParameters & ConfigKeyParameter>) {\n  return [\"getTradeVolume\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getTradeVolumeQueryKey}. */\nexport type GetTradeVolumeQueryKey = ReturnType<typeof getTradeVolumeQueryKey>;\n\n/** Options accepted by {@link getTradeVolumeQueryOptions}: the action's parameters plus TanStack overrides. */\nexport type GetTradeVolumeOptions = Compute<\n  GetTradeVolumeParameters & QueryParameter<GetTradeVolumeData, Error, GetTradeVolumeData, GetTradeVolumeQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getTradeVolumeQueryOptions}. */\nexport type GetTradeVolumeQueryOptions = SymmioQueryOptions<\n  GetTradeVolumeData,\n  Error,\n  GetTradeVolumeData,\n  GetTradeVolumeQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getTradeVolume}. The query is disabled\n * when `symbolId` is `0` (the sentinel for \"no market selected\").\n *\n * @param config - The SDK config.\n * @param options - Query parameters (required `symbolId`, optional `chainId` / `solverId`) and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(getTradeVolumeQueryOptions(config, { symbolId: 1 }));\n * ```\n */\nexport function getTradeVolumeQueryOptions(config: Config, options: GetTradeVolumeOptions): GetTradeVolumeQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getTradeVolumeQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: (options.query?.enabled ?? true) && options.symbolId > 0,\n    queryFn: () =>\n      getTradeVolume(config, {\n        chainId: options.chainId,\n        solverId: options.solverId,\n        symbolId: options.symbolId,\n      }),\n  };\n}\n"],"mappings":";;;AAUA,SAAgB,EAAuB,GAAiE;CACtG,OAAO,CAAC,kBAAkB,EAAmB,CAAO,CAAC;AACvD;AA+BA,SAAgB,EAA2B,GAAgB,GAA4D;CACrH,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAAuB;GAC/B,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,UAAU,EAAQ,OAAO,WAAW,OAAS,EAAQ,WAAW;EAChE,eACE,EAAe,GAAQ;GACrB,SAAS,EAAQ;GACjB,UAAU,EAAQ;GAClB,UAAU,EAAQ;EACpB,CAAC;CACL;AACF"}

package/dist/solvers/trade-volume/to-daily-volume.d.ts

@@ -0,0 +1,12 @@
+import { ApiDailyTradeVolumeResponse } from '../types/generated/enigma-solver.js';
+import { SolverDailyVolume } from './types.js';
+/**
+ * Map one raw `/trade-volume/{symbol_id}` row into the SDK's
+ * {@link SolverDailyVolume}. The timestamp is the solver's ISO 8601 datetime
+ * string, passed through unchanged; a missing timestamp or volume defaults to
+ * `""` / `"0"`.
+ *
+ * @param raw - One raw daily-volume row from the solver.
+ */
+export declare function toSolverDailyVolume(raw: ApiDailyTradeVolumeResponse): SolverDailyVolume;
+//# sourceMappingURL=to-daily-volume.d.ts.map

package/dist/solvers/trade-volume/to-daily-volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-daily-volume.d.ts","sourceRoot":"","sources":["../../../src/solvers/trade-volume/to-daily-volume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,2BAA2B,GAAG,iBAAiB,CAKvF"}

package/dist/solvers/trade-volume/to-daily-volume.js

@@ -0,0 +1,11 @@
+//#region src/solvers/trade-volume/to-daily-volume.ts
+function e(e) {
+	return {
+		timestamp: e.timestamp ?? "",
+		volume: e.volume ?? "0"
+	};
+}
+//#endregion
+export { e as toSolverDailyVolume };
+
+//# sourceMappingURL=to-daily-volume.js.map

package/dist/solvers/trade-volume/to-daily-volume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-daily-volume.js","names":[],"sources":["../../../src/solvers/trade-volume/to-daily-volume.ts"],"sourcesContent":["import type { ApiDailyTradeVolumeResponse } from \"../types/generated/enigma-solver\";\nimport type { SolverDailyVolume } from \"./types\";\n\n/**\n * Map one raw `/trade-volume/{symbol_id}` row into the SDK's\n * {@link SolverDailyVolume}. The timestamp is the solver's ISO 8601 datetime\n * string, passed through unchanged; a missing timestamp or volume defaults to\n * `\"\"` / `\"0\"`.\n *\n * @param raw - One raw daily-volume row from the solver.\n */\nexport function toSolverDailyVolume(raw: ApiDailyTradeVolumeResponse): SolverDailyVolume {\n  return {\n    timestamp: raw.timestamp ?? \"\",\n    volume: raw.volume ?? \"0\",\n  };\n}\n"],"mappings":";AAWA,SAAgB,EAAoB,GAAqD;CACvF,OAAO;EACL,WAAW,EAAI,aAAa;EAC5B,QAAQ,EAAI,UAAU;CACxB;AACF"}

package/dist/solvers/trade-volume/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * One day's trade volume for a solver market, normalized from the generated
+ * `/trade-volume/{symbol_id}` response.
+ *
+ * Rows are daily buckets in ascending order. Both fields arrive from the solver
+ * as strings and are surfaced as-is: the timestamp is an ISO 8601 datetime
+ * string, the volume a decimal string kept unparsed to preserve precision.
+ */
+export interface SolverDailyVolume {
+    /**
+     * The day bucket, as the ISO 8601 datetime string the solver reports (e.g.
+     * `"2026-07-09T00:00:00Z"`, midnight UTC on the bucket's day). Empty string
+     * when the solver omits it. Parse with `new Date(timestamp)` to render;
+     * ISO 8601 also sorts correctly as a plain string.
+     */
+    timestamp: string;
+    /** Notional traded that day, as the decimal string the solver reports (`"0"` when absent). */
+    volume: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/solvers/trade-volume/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/solvers/trade-volume/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;CAChB"}