getListingMarketConfig

Read the signed-in user’s configuration opinion for one pool — the max leverage and buyback percentage they submitted — alongside the pool-level values those opinions blend into. This is the read that prefills a pool’s configuration form: userMaxLeverage and userBuybackRatio are null until the caller has ever submitted an opinion for the pool.

import { getListingMarketConfig } from "@symmio/trading-core";
 
const marketConfig = await getListingMarketConfig(config, {
  accessToken: token.accessToken,
  tokenContractAddress: "0x1234…",
  depositChain: market.chainId,
});
 
const mine = marketConfig.userBuybackRatio; // null until this user has ever configured the pool
const inForce = marketConfig.buybackRatio; // the deposit-weighted pool value

The write on the same path is not a read: updateListingMarketConfig rejects a call with both values omitted, so this GET is the only way to read the caller’s own opinion back.

Parameters

Returns

Projecting the new pool value

projectListingMarketConfig is a pure helper — no request, no config argument — that estimates where the pool’s configuration lands once the caller’s opinion is saved. It is what a form shows next to a slider as “new pool buyback ~52.5%”, before the write.

import {
  getListingMarketDetail,
  getListingMarketConfig,
  getUserProfit,
  projectListingMarketConfig,
} from "@symmio/trading-core";
 
const detail = await getListingMarketDetail(config, { tokenContractAddress, depositChain });
const marketConfig = await getListingMarketConfig(config, { accessToken, tokenContractAddress, depositChain });
const profit = await getUserProfit(config, { accessToken, tokenContractAddress });
 
const projection = projectListingMarketConfig({
  poolBuybackRatio: detail.buybackRatio,
  poolMaxLeverage: detail.maxLeverage,
  priorBuybackRatio: marketConfig.userBuybackRatio,
  priorMaxLeverage: marketConfig.userMaxLeverage,
  buybackRatio: 75, // the value being entered
  maxLeverage: 10,
  userTokenAmount: profit.userBalanceInTokens,
  totalTokenInPool: detail.totalTokenInPool,
  tvl: detail.tvl,
  totalUsdcInPool: detail.totalUsdcInPool,
});
 
projection.projectedBuybackRatio; // e.g. 52.5 — render as "~52.5%"

How the weight is derived. The caller’s raw token share of the pool is userTokenAmount / totalTokenInPool. That share is then scaled by the token portion of TVL, (tvl - totalUsdcInPool) / tvl: part of a pool’s value is USDC — notably the one-time swap on a pool’s first deposit — and USDC carries no token-opinion weight. The product, clamped into 0..1, is share. On a mature pool the USDC fraction is negligible and the scaling is a no-op; on a tiny pool, where that fixed swap is a large slice of TVL, it removes a real skew. A tvl of null or zero yields a share of 0, and the projection is then just the pool’s current value.

How the blend is applied. For each knob, projected = pool + share * (entered - prior). The pool value already folds in the caller’s previous opinion at that same weight, so replacing it shifts the pool by exactly that much — exact to first order. When prior is null (the caller has never configured this pool) the pool value itself is substituted as the baseline, which makes the result an approximation rather than an exact shift.

Parameters

Returns

Query options

import { getListingMarketConfigQueryOptions } from "@symmio/trading-core";
import { useQuery } from "@tanstack/react-query";
 
useQuery(
  getListingMarketConfigQueryOptions(config, {
    accessToken: token.accessToken,
    tokenContractAddress: "0x1234…",
    depositChain: market.chainId,
  }),
);

GetListingMarketConfigOptions is the action’s parameters plus a query bag of TanStack overrides. The factory folds config.getChainConfigKey(chainId) into the key; getListingMarketConfigQueryKey builds the same key for cache matching and invalidation. GetListingMarketConfigData is what the query resolves to (the same ListingMarketConfig), GetListingMarketConfigReturnType is the action’s return alias, and GetListingMarketConfigQueryOptions is the options bag it produces. toListingMarketConfig maps a raw /v2/market/config body into the normalized ListingMarketConfig for callers driving the request themselves — both the GET and the POST return that same schema, so both share the mapper.

Throws

• LISTING_NOT_CONFIGURED — a SymmError (kind: "config") when the chain has no listing backend configured. Gate with supportsListingService to hide the configuration UI instead of erroring.
• FETCH_LISTING_MARKET_CONFIG_FAILED — the request itself failed. Any axios failure becomes a SymmApiError carrying status, statusText, responseData, url and method; a non-axios throw becomes a plain SymmError (kind: "api") with the original error as its cause. A 401 means the accessToken was missing, malformed, or expired — re-run authenticateListing and retry.

Related

• updateListingMarketConfig — the write that submits the opinion this read reflects.
• getListingMarketDetail — the pool values, token balance, TVL and USDC balance the projection needs.
• getUserProfit — supplies userBalanceInTokens, the caller’s stake that sets their weight.
• useListingMarketConfig — the React hook.
• Pools — the slice overview.