Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Serum DEX UI

An implementation of a UI for the Serum DEX.

Running the UI

Run yarn to install dependencies, then run yarn start to start a development server or yarn build to create a production build that can be served by a static file server. Note that prior to compiling you need to add charts yourself (see below).

Collect referral fees

If you are hosting a public UI using this codebase, you can collect referral fees when your users trade through your site.

To do so, set the REACT_APP_USDT_REFERRAL_FEES_ADDRESS and REACT_APP_USDC_REFERRAL_FEES_ADDRESS environment variables to the addresses of your USDT and USDC SPL token accounts.

You may want to put these in local environment files (e.g. .env.development.local, .env.production.local). See the documentation on environment variables for more information.

NOTE: remember to re-build your app before deploying for your referral addresses to be reflected.

Add Trading View charts

It is now required to add OHLCV candles built from on chain data using Bonfida's API. Here is how to do it:

  1. Get access to the TradingView Charting Library repository. This is a private repository and it will return a 404 if you don't have access to it. To get access to the repository please refer to TradingView's website

  2. Once you have access to the Charting Library repository:

See the Create React App documentation for other commands and options.

See A technical introduction to the Serum DEX to learn more about the Serum DEX.

See serum-js for DEX client-side code. Serum DEX UI uses this library.

See sol-wallet-adapter for an explanation of how the Serum DEX UI interacts with wallet services to sign and send requests to the Serum DEX.

See spl-token-wallet for an implementation of such a wallet, live at


Example implementation of a UI for the Serum DEX







No releases published


No packages published