getUserListingMarkets

Fetch a page of Your Pools — the listing markets that generated a deposit address for the signed-in user, whether or not they have deposited into them yet. It is the authenticated twin of getListingMarkets: the same catalog rows, enriched with the caller’s own position in each pool.

import { getUserListingMarkets, ListingMarketStatus } from "@symmio/trading-core";
 
const page = await getUserListingMarkets(config, {
  accessToken: token.accessToken,
  marketStatus: ListingMarketStatus.LISTED,
  sortBy: "tvl",
  orderBy: "desc",
  limit: 50,
});

Each row is a UserListingMarket — a ListingMarket plus userDeposit, userSharePercentage, and userRevenue. A pool appears here once it has minted a deposit address for the user, so the list includes pools the user has been allocated but not yet funded; userDeposit is then null.

The access token

accessToken is the one required parameter — the endpoint returns nothing without it. Mint it once with authenticateListing (the SIWE exchange), hold it, and pass it on every call.

Parameters

accessToken is required; every other field is optional and shares the exact search, filter, sort, and pagination semantics of getListingMarkets — see that page for the full sortBy key list and the 18-decimal filters contract. In brief:

Returns

A UserListingMarket extends ListingMarket with three fields describing the user’s position:

Query options

import { getUserListingMarketsQueryOptions } from "@symmio/trading-core";
import { useQuery } from "@tanstack/react-query";
 
useQuery(getUserListingMarketsQueryOptions(config, { accessToken, sortBy: "tvl", limit: 50 }));

GetUserListingMarketsOptions is the action’s parameters (including the required accessToken) plus a query bag of TanStack overrides. The factory folds config.getChainConfigKey(chainId) into the key but leaves accessToken out of it, so a refreshed token reuses the cache rather than refetching. getUserListingMarketsQueryKey builds the same key for cache matching and invalidation.

The rest of the factory’s types are exported too: GetUserListingMarketsData is what the query resolves to (the same UserListingMarketPage), GetUserListingMarketsReturnType is the action’s return alias, GetUserListingMarketsQueryKey is the key the factory builds, and GetUserListingMarketsQueryOptions is the options bag it produces.

Because search, filtering, sorting and paging are all server-side, each distinct combination is its own cache entry — change one and the query refetches rather than re-slicing a page you already hold.

Throws

• LISTING_NOT_CONFIGURED — a SymmError (kind: "config") when the chain has no listing backend configured. Gate with supportsListingService to hide Pools instead of erroring. Only chains with a listing backend have Pools.
• FETCH_USER_LISTING_MARKETS_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 here means the accessToken was missing, malformed, or expired — re-run authenticateListing and retry.

Related

• Listing auth — mints the accessToken this read requires.
• getListingMarkets — the public catalog, with the full sort-key and filter reference.
• ListingMarket — the base row shape and its 18-decimal value contract.
• useUserListingMarkets — the React hook.
• Pools — the slice overview.