addMarket

Create a pool — submit a create-pool application to the permissionless listing service. addMarket lists a new token: it records the token and its pool economics, resolves the token’s name / ticker / decimals from the contract, provisions a custodial deposit wallet to seed the pool, and returns the accepted CreatedPool.

import { addMarket, ListingDepositChainId } from "@symmio/trading-core";
 
const pool = await addMarket(config, {
  accessToken: token.accessToken,
  tokenContractAddress: "0xToken…",
  buyBackRatio: 5,
  maxLeverage: 20,
  depositChain: ListingDepositChainId.HYPER_EVM,
});
// send the listing deposit to `pool.walletPublicKey` to seed the pool

The application starts at ListingMarketStatus.WAITING_FOR_DEPOSIT and stays there until the listing deposit lands at walletPublicKey. This is the authenticated write twin of the Pools reads — it takes the same Bearer accessToken as getUserListingMarkets.

Token metadata for your UI

addMarket needs only the token’s contract address — the listing backend resolves the name, ticker, and decimals from the chain itself and returns them on CreatedPool. A create-pool form, though, usually wants to show the token before the user submits: its name, symbol, price, market cap, and liquidity.

That preview data is not part of this SDK. When you need it, fetch it from DexScreener by token address:

GET https://api.dexscreener.com/latest/dex/tokens/<token_address>

Use the response to display and sanity-check the token — confirm it exists, show its name / logo, and check its liquidity — in your “new pool” UI before calling addMarket.

The access token

accessToken is required — the endpoint is authed and rejects an unauthenticated request. Mint it once with authenticateListing (the SIWE exchange), hold it, and pass it on the call. A bad or expired token comes back as a 401 (see Throws) — refresh it and retry.

Parameters

accessToken, tokenContractAddress, buyBackRatio, maxLeverage, and depositChain are required. Every other field is an optional listing extra — the SDK leaves it absent from the request unless you set it, so an integrating app supplies its own defaults rather than the SDK inventing them.

Returns

Mutation options

import { addMarketMutationOptions } from "@symmio/trading-core";
import { useMutation } from "@tanstack/react-query";
 
const { mutateAsync } = useMutation(addMarketMutationOptions(config));
const pool = await mutateAsync({
  accessToken,
  tokenContractAddress: "0xToken…",
  buyBackRatio: 5,
  maxLeverage: 20,
  depositChain: ListingDepositChainId.HYPER_EVM,
});

addMarket is modeled as a mutation, not a query: it submits an application that provisions a deposit wallet, so it is a one-shot write rather than cached data. addMarketMutationOptions(config) returns the { mutationKey, mutationFn } bag to hand to useMutation. The mapping helpers toAddMarketRequest (parameters → wire request) and toCreatedPool (response → CreatedPool) are exported too for callers driving the request themselves.

Throws

• LISTING_NOT_CONFIGURED — a SymmError (kind: "config") when the chain has no listing backend configured. Gate with supportsListingService to hide the create-pool flow instead of erroring. Only chains with a listing backend have Pools.
• ADD_MARKET_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. The service’s weekly-listing-limit rejections also surface here, with the service’s own message and status.

Related

• Listing auth — mints the accessToken this write requires.
• getListingConfig — the recommended initial deposit and the deposit chains this form should offer.
• getWeeklyListingLimit — the protocol-wide weekly cap (public); block this write when remaining is 0.
• getUserListingMarkets — the authed read that lists the pools you have created.
• ListingMarket — the catalog row shape and its 18-decimal value contract.
• useAddMarket — the React hook.
• DexScreener token API  — token name, price, market cap, and liquidity to preview a token before listing it (/latest/dex/tokens/<token_address>).
• Pools — the slice overview.