Serum DEX v3 IDL

Serum DEX v3 is the original fully on-chain central limit order book on Solana, created by Project Serum. Pioneered permissionless order book trading with NewOrder, CancelOrder, MatchOrders, and SettleFunds instructions. Now superseded by OpenBook.

  • serum
  • v0.0.0
  • DEX / Order Book

Program address

9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
A quiet stack of pagesAn abstract drawing of light on the page's dark ground. A neat stack of thin, solid pages, the top one lit, with faint streams of light drifting toward it from the left.A quiet stack of pagesAn abstract drawing of light on the page's dark ground. A neat stack of thin, solid pages, the top one lit, with faint streams of light drifting toward it from the left.
Instructions
18
Accounts
9
Events
0
Types
10

What the program exposes

Instructions 18

  • InitializeMarket
  • NewOrder
  • MatchOrders
  • ConsumeEvents
  • CancelOrder
  • SettleFunds
  • CancelOrderByClientId
  • DisableMarket
  • SweepFees
  • NewOrderV2
  • NewOrderV3
  • CancelOrderV2
  • and 6 more

Accounts 9

  • MarketStateV2
  • MarketState
  • OpenOrders
  • RequestQueueHeader
  • Request
  • RequestView
  • EventQueueHeader
  • Event
  • and 1 more

Use it in your code

Load the Serum DEX v3 IDL with Anchor in TypeScript, Rust or Python.

import { Connection, PublicKey } from "@solana/web3.js";
import { Program, AnchorProvider, Idl } from "@coral-xyz/anchor";

// Load the Serum DEX v3 IDL
import idl from "./serum dex v3.json";

const PROGRAM_ID = new PublicKey("9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin");

// Set up the provider and program
const connection = new Connection("https://api.mainnet-beta.solana.com");
const provider = new AnchorProvider(connection, wallet, {
  commitment: "confirmed",
});
const program = new Program(idl as Idl, provider);

// Fetch and decode an account
const accountData = await program.account.serum_DEX_v3
  .fetch(accountPublicKey);
console.log("Account data:", accountData);

// Build and send an instruction
const tx = await program.methods
  .initialize(/* ...args */)
  .accounts({
    /* ...required accounts */
  })
  .rpc();
console.log("Transaction signature:", tx);

The JSON

The first 30 lines of serum dex v3.json.

serum dex v3.json
{
  "version": "0.0.0",
  "name": "Serum Dex",
  "instructions": [
    {
      "name": "InitializeMarket",
      "accounts": [
        {
          "name": "marketToInitialize",
          "isMut": true,
          "isSigner": false,
          "docs": [
            "the market to initialize"
          ]
        },
        {
          "name": "requestQueue",
          "isMut": true,
          "isSigner": false,
          "docs": [
            "zeroed out request queue"
          ]
        },
        {
          "name": "eventQueue",
          "isMut": true,
          "isSigner": false,
          "docs": [
            "zeroed out event queue"
          ]
...

Frequently asked questions

What is the Serum DEX v3 IDL?

The Serum DEX v3 IDL (Interface Definition Language) is a JSON schema that describes the on-chain program interface for the Serum DEX v3 smart contract on Solana. It defines all available instructions, account structures, events, and types needed to interact with the program. This one has 18 instructions, 9 account types, 0 events and 10 type definitions.

How do I use the Serum DEX v3 IDL in my project?

You can use the Serum DEX v3 IDL with Anchor framework clients in TypeScript (@coral-xyz/anchor), Rust (anchor-client), or Python (anchorpy). Download the JSON file, import it in your project, and use it to create a Program instance that can call instructions and decode accounts.

What is the Serum DEX v3 program address on Solana?

The Serum DEX v3 program is deployed at address 9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin on Solana mainnet.

What version of the Serum DEX v3 IDL is this?

This is version 0.0.0 of the Serum DEX v3 IDL. IDL versions follow program deployments and change as the protocol evolves, so check it against the program on-chain before you integrate.

Build on Serum DEX v3 with AllenHark

Stream the program's accounts and transactions with Yellowstone gRPC, read its state over Solana RPC, or see its transactions before the block is built with ShredStream. To trade against it, try the trading bots or the PumpFun sniper.

Browse all Solana IDLs