getTradeVolume
Read one market’s daily traded notional from the solver — the series behind a pool page’s volume chart.
import { getTradeVolume } from "@symmio/trading-core";
const volume = await getTradeVolume(config, { symbolId: 1 });
const latest = volume.at(-1); // { timestamp: "2026-07-09T00:00:00Z", volume: "448.69…" }One GET /trade-volume/{symbol_id} against the chain’s solver. This is the solver’s own bookkeeping — not the inventory service’s TVL and not the listing backend’s rewards. A pool page that charts volume next to TVL next to rewards is plotting three different vendors; see Pools for how they divide up.
GetTradeVolumeParameters and GetTradeVolumeReturnType are both exported, so you can name them in your own wrappers.
Keyed by the solver market id
symbolId is the solver’s market id — ListingMarket.symbolId on a listed pool, SolverSymbol.symbolId on the solver’s own catalog. It is not the pool’s token contract address, and a pool that has not reached LISTED has no symbolId at all: gate the read rather than guessing one.
An id the solver does not know answers 400, not an empty series. Treat the failure as “no chart” and render the
chart’s empty state — a market that has simply never traded is a different, successful response.
Parameters
symbolIdnumberrequiredSolver market id to read daily volume for.
chainIdnumberoptionalTarget chain id. Defaults to the config’s defaultChainId. Selects which chain’s solver is used, and is folded into
the query key.
solverIdstringoptionalTarget a specific solver on that chain. Defaults to the chain’s default solver.
Returns
Promise<SolverDailyVolume[]>Valid daily observations, ascending. An empty array means there are no usable observations; this can also happen when every returned row is malformed.
timestampstringrequiredThe day bucket, as the ISO 8601 datetime string the solver reports (e.g. "2026-07-09T00:00:00Z", midnight UTC).
Rows with missing or invalid timestamps are omitted.
volumestringrequiredNotional traded that day, as the decimal string the solver reports. Missing, blank or non-numeric volumes are
omitted; a genuine "0" is retained.
Both fields are surfaced as strings, deliberately: the solver reports a plain decimal rather than a fixed-point
integer, and parsing it into a number in the SDK would round it before you ever saw it. Convert at the display edge.
That is the opposite convention from the listing backend and the inventory service, whose values arrive as 18-decimal bigints. Do not carry a formatUnits helper across to this read.
Enigma-only
/trade-volume/{symbol_id} exists only on Enigma solvers. The action asserts the resolved solver’s kind and throws UNSUPPORTED_BY_SOLVER before hitting the wire on any other, so a rasa-kind target fails immediately rather than 404-ing.
import { getTradeVolume } from "@symmio/trading-core";
// Explicit target: this deployment's enigma solver.
const volume = await getTradeVolume(config, { symbolId: 1, chainId, solverId: "enigma" });Query options
import { getTradeVolumeQueryOptions } from "@symmio/trading-core";
import { useQuery } from "@tanstack/react-query";
useQuery(getTradeVolumeQueryOptions(config, { symbolId }));GetTradeVolumeOptions is the action’s parameters plus a query bag of TanStack overrides. The factory folds config.getChainConfigKey(chainId) into the key, so a runtime config override pointed at another solver deployment refetches instead of serving the previous one’s cache. getTradeVolumeQueryKey builds the same ["getTradeVolume", …] key, and GetTradeVolumeData / GetTradeVolumeQueryKey / GetTradeVolumeQueryOptions name the factory’s other halves.
Gate it on an unlisted pool, so a market with no symbolId stays idle:
useQuery({
...getTradeVolumeQueryOptions(config, { symbolId: pool.symbolId ?? 0 }),
enabled: pool.symbolId !== null,
});toSolverDailyVolume
The exported mapper retains its existing SolverDailyVolume return type and missing-field defaults: an omitted timestamp becomes "", and an omitted volume becomes "0". Supplied strings pass through unchanged. It does not validate or omit observations. getTradeVolume validates each wire row before calling this mapper, so the action and its query/hook omit malformed observations without changing direct mapper callers.
import { toSolverDailyVolume } from "@symmio/trading-core";
const row = toSolverDailyVolume({ timestamp: "2026-07-09T00:00:00Z", volume: "0" });
console.log(row); // { timestamp: "2026-07-09T00:00:00Z", volume: "0" }
const fallback = toSolverDailyVolume({});
console.log(fallback); // { timestamp: "", volume: "0" }Throws
UNSUPPORTED_BY_SOLVER— aSymmError(kind: "config") when the resolved solver is not anenigmasolver. Raised before any request goes out.UNSUPPORTED_CHAIN— aSymmError(kind: "config") when thechainIdis not one the config knows about at all.FETCH_TRADE_VOLUME_FAILED— the request itself failed, including the400on a market id the solver does not know. Any axios failure becomes aSymmApiErrorcarryingstatus,statusText,responseData,urlandmethod; a non-axios throw becomes a plainSymmError(kind: "api").
Related
- Solvers — the slice overview and the rest of the Enigma-only reads.
getSolverRevenue— the solver’s earnings over a trailing window.getInventoryTvlHistory— a pool page’s TVL series, from the inventory service.getPoolRewardChart— a pool page’s rewards series, from the listing backend.@symmio/trading-react—useTradeVolumeis the React binding over this read.- Errors — the
SymmError/SymmApiErrorhierarchy these codes belong to.
Malformed observations
Rows with missing/null/blank/non-numeric volume or an invalid timestamp are omitted by default. Valid "0" volume remains a real observation; decimal strings are retained without rounding. There is no missingVolume option. useTradeVolume and query factories inherit this policy with unchanged query keys.