getOnchainContractMarkets

Read the contract’s getSymbols view — the authoritative on-chain market list, without solver-added metadata like precision or tick bounds.


import { getOnchainContractMarkets } from "@symmio/trading-core";
 
const markets = await getOnchainContractMarkets(config, {
  start: 0n,
  size: 100n,
});

Use this when you need on-chain truth (e.g. verifying the solver’s catalog is in sync). For UI catalogs, prefer the solver’s getMarkets — it adds precision / tick metadata the contract doesn’t carry.

Parameters

startbigint | numberrequired

Start offset passed to SYMMIO core getSymbols.

sizebigint | numberrequired

Page size passed to SYMMIO core getSymbols.

chainIdnumberoptional

Optional chain override.

Returns

readonly OnchainContractMarket[]

symbolIdbigint

SYMMIO symbol id.

namestring

Contract-level market name, such as BTCUSDT.

isValidboolean

Whether the market is currently valid for trading.

minAcceptableQuoteValuebigint

Minimum acceptable quote value in raw 18-decimal units.

minAcceptablePortionLFbigint

Minimum acceptable liquidation-fee portion in raw 18-decimal units.

tradingFeebigint

Trading fee rate in raw 18-decimal fixed point units.

maxLeveragebigint

Maximum leverage in raw 18-decimal fixed point units.

fundingRateEpochDurationbigint

Funding-rate epoch duration in seconds.

fundingRateWindowTimebigint

Funding-rate window time in seconds.

Query options


import { getOnchainContractMarketsQueryOptions } from "@symmio/trading-core";
import { useQuery } from "@tanstack/react-query";
 
useQuery(getOnchainContractMarketsQueryOptions(config, { start: 0n, size: 100n }));