On-Chain Market Config

Get market config

GET /api/v1/config

Returns on-chain exchange configuration for the current chainId + productType scope: cashier buffers, exchange fee settings, and per-token cashier limits/rates.

Permission: READ_ONLY. No query parameters.

This endpoint is separate from direct on-chain stock reference-price reads. For the StockOracle contract interface, see Stock Oracle.

Response

Standard envelope. data contains:

Field	Type	Description
cashierBuffer	object	Cashier-level buffer snapshot for instant deposit eligibility.
exchangeFeeConfig	object	Exchange fee and minimum order settings.
cashierTokenConfig	object	Map of lowercase token address → per-token cashier config.

Field naming note

cashierBuffer and each cashierTokenConfig entry use chain. exchangeFeeConfig uses chainId. Both represent the scoped chain ID.

Value encoding

Area	Format	Example
cashierBuffer.creditBuffer, creditBufferCapacity, totalBalance	Raw WAD integer strings (18 decimals)	"743810467000000000000" ≈ 743.81 mUSD
cashierTokenConfig.withdrawalBuffer, withdrawalBufferCapacity	Raw integer strings in token decimals	"253689533" with decimals: 6
exchangeFeeConfig.mintFeeRate, protocolFeeRate, minOrderValue	Human-readable decimal strings	"0", "0.001"
cashierTokenConfig.depositRate, withdrawalRate	Human-readable decimal strings	"1", "0.9969"

Do not parse WAD or token-amount fields as human-readable decimals.

cashierBuffer

Field	Type	Description
chain	number	Chain ID for the scoped context.
productType	string	Product type, e.g. Synfutures.
address	string	Cashier contract address. Matches cashierAddress in cashierTokenConfig entries.
instantThresholdDivisor	string	Divisor used to cap instant operation size relative to buffer capacity. See buffer mechanism — Instant Eligibility.
creditBuffer	string	Current mUSD credit buffer balance (WAD).
creditBufferCapacity	string	Maximum mUSD credit buffer capacity (WAD).
totalBalance	string	Total cashier balance snapshot (WAD).

Per-token withdrawalBuffer values live under cashierTokenConfig, not in this object.

exchangeFeeConfig

Field	Type	Description
chainId	number	Chain ID.
productType	string	Product type.
mintFeeRate	string	Mint fee rate, human-readable (e.g. 0.001 = 0.1%). "0" means no mint fee.
protocolFeeRate	string	Protocol fee rate, human-readable. "0" means no protocol fee.
minOrderValue	string	Minimum order notional in USD, human-readable (e.g. "1.00"). "0" means no minimum enforced in config.
txHash	string	Tx hash of the latest on-chain config update. May be empty when no update tx is recorded.
updatedAt	number	Unix seconds when config was last updated.

Use minOrderValue, mintFeeRate, and protocolFeeRate when validating or displaying order economics before calling order endpoints.

cashierTokenConfig entries

Map keys are lowercase ERC-20 token addresses. Each value includes:

Field	Type	Description
chain	number	Chain ID.
productType	string	Product type.
cashierAddress	string	Cashier contract address.
tokenAddress	string	ERC-20 token address.
minAmount	string	Minimum deposit/withdraw amount in whole tokens.
decimals	number	Token decimals.
depositPaused	boolean	Deposit flow paused for this token.
withdrawPaused	boolean	Withdraw flow paused for this token.
depositRate	string	Deposit rate, human-readable (e.g. 1 = no fee).
withdrawalRate	string	Withdrawal rate, human-readable (e.g. 0.9969).
withdrawalBuffer	string	Current on-chain token buffer for instant withdrawals (token decimals).
withdrawalBufferCapacity	string	Maximum token buffer capacity for instant withdrawals (token decimals).

Check depositPaused, withdrawPaused, and buffer fields before building deposit or withdrawal calldata. See cash deposits and withdrawals.

Integration notes

• For instant vs queued cash behavior, pair buffer fields here with buffer mechanism.

Example payload: sample-responses.md — Market config.