SettleMint
System addonsTrading venue

List a market

Request a new market with the new-market wizard, then complete the listing ceremony: custodian-role grants from each issuer, feed-writer registration, and fee-account eligibility.

Listing a market is a ceremony, not a single step. The venue operator requests the market with its pair, trading grid, price protection band, and fee schedule. The market then stays pending until every precondition completes: the issuer of each listed token grants the venue the token's custodian role, the venue verifies its feed-writer registration, and the fee account passes eligibility. A missing precondition blocks go-live and the checklist shows which step is blocked.

Before you list

  • You hold the venue-operator role: platform administrator or organization owner.
  • The base and quote tokens are two distinct platform tokens in the deployment.
  • The issuer of each token has agreed to grant the venue the token's custodian role. This grant carries the token's full custodial powers, so it is a real delegation the issuer must decide on. A declined grant leaves the market unlistable.
  • The fee account that will receive quote-leg fees is identity-registered.

Request the market

Open the new-market wizard

Go to Venue operations and choose List a new market.

Define the market

Complete the wizard fields:

FieldMeaning
Venue contractThe Trading Venue settlement contract to list the market on.
Base tokenThe token bought and sold on the market.
Quote tokenThe token prices and fees are denominated in. Must differ from the base token.
Tick sizeQuote base units per price tick.
Lot sizeBase token units per lot; order quantities are lot multiples.
Minimum notionalThe smallest quote notional a resting remainder may carry before it auto-cancels.
Maker fee (bps)0 to 10000 basis points, charged in the quote token. Zero is allowed.
Taker fee (bps)0 to 10000 basis points, charged in the quote token. Zero is allowed.
Price protection band (bps)1 to 10000 basis points; bounds market-order execution around the reference price.
Fee accountThe identity-registered account that receives quote-leg fees.

The wizard validates each field and refuses a pair where base and quote are the same token.

Submit the listing request

Click Request listing and complete wallet verification. DALP queues the on-chain market creation and records the listing as pending.

Complete the listing ceremony

Open the market's detail page. The Listing ceremony checklist tracks four items, each marked Complete, Blocked, or Awaiting:

  1. Base token custodian role granted to the venue.
  2. Quote token custodian role granted to the venue.
  3. Feed writer registered for the market, so the venue can publish traded prices.
  4. Fee account identity-registered and eligible.

Ask the issuer of each listed token to grant the venue the custodian role from the token's role administration. The checklist summary states the outcome: when every item completes, the market can go live; while items await verification, the market stays pending; and when a precondition was declined, listing is blocked until the issuer grants it.

The fee account stays monitored after go-live. A fee account that loses eligibility halts the affected markets until you restore an eligible account.

Troubleshooting

IssueWhat to check
The wizard refuses the pairBase and quote must be two distinct platform tokens.
The ceremony shows BlockedAn issuer declined a custodian-role grant. The market cannot go live until the issuer grants it.
The ceremony stays AwaitingThe role grant, feed-writer registration, or fee-account check has not been verified yet. Confirm the issuer's grant transaction completed.
The market halted after go-liveCheck fee-account eligibility on the ceremony checklist and the venue health panel.

On this page