OpenBook DEX v1 IDL
OpenBook DEX v1 (Serum fork) is the original community-led on-chain central limit order book on Solana. Supports permissionless market creation, limit/market orders, order matching, and atomic settlement.
Program address
srmqPvymJeFKQ4zGQed1GFppgkRHL9kaELCbyksJtPX- Instructions
- 21
- Accounts
- 9
- Events
- 0
- Types
- 10
What the program exposes
Instructions 21
- InitializeMarket
- NewOrder
- MatchOrders
- ConsumeEvents
- CancelOrder
- SettleFunds
- CancelOrderByClientId
- DisableMarket
- SweepFees
- NewOrderV2
- NewOrderV3
- CancelOrderV2
- and 9 more
Accounts 9
- MarketStateV2
- MarketState
- OpenOrders
- RequestQueueHeader
- Request
- RequestView
- EventQueueHeader
- Event
- and 1 more
Use it in your code
Load the OpenBook DEX v1 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 OpenBook DEX v1 IDL
import idl from "./openbook dex v1.json";
const PROGRAM_ID = new PublicKey("srmqPvymJeFKQ4zGQed1GFppgkRHL9kaELCbyksJtPX");
// 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.openBook_DEX_v1
.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);use anchor_client::solana_sdk::pubkey::Pubkey;
use anchor_client::solana_sdk::signature::Keypair;
use anchor_client::{Client, Cluster};
use std::str::FromStr;
// OpenBook DEX v1 program ID
const PROGRAM_ID: &str = "srmqPvymJeFKQ4zGQed1GFppgkRHL9kaELCbyksJtPX";
fn main() -> anyhow::Result<()> {
let payer = Keypair::new();
let client = Client::new(Cluster::Mainnet, &payer);
let program_id = Pubkey::from_str(PROGRAM_ID)?;
let program = client.program(program_id)?;
// Fetch and deserialize an account
let account: OpenBook_DEX_v1Account = program.account(account_pubkey)?;
println!("Account data: {:?}", account);
// Build and send a transaction
let tx = program
.request()
.accounts(open_book__d_e_x_v1::accounts::Initialize {
// ...required accounts
})
.args(open_book__d_e_x_v1::instruction::Initialize {
// ...instruction args
})
.send()?;
println!("Transaction signature: {}", tx);
Ok(())
}from solana.rpc.api import Client
from solders.pubkey import Pubkey
from anchorpy import Program, Provider, Wallet
import json
# Load the OpenBook DEX v1 IDL
with open("openbook dex v1.json") as f:
idl_data = json.load(f)
PROGRAM_ID = Pubkey.from_string("srmqPvymJeFKQ4zGQed1GFppgkRHL9kaELCbyksJtPX")
# Set up the provider and program
client = Client("https://api.mainnet-beta.solana.com")
provider = Provider(client, Wallet.local())
program = Program(idl_data, PROGRAM_ID, provider)
# Fetch and decode an account
account = await program.account["OpenBook_DEX_v1"].fetch(account_pubkey)
print(f"Account data: {account}")
# Build and send an instruction
tx = await program.rpc["initialize"](
# ...instruction args
ctx=program.context(
accounts={
# ...required accounts
}
)
)
print(f"Transaction signature: {tx}")The JSON
The first 30 lines of openbook dex v1.json.
{
"version": "0.0.0",
"name": "OpenBook 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 OpenBook DEX v1 IDL?
The OpenBook DEX v1 IDL (Interface Definition Language) is a JSON schema that describes the on-chain program interface for the OpenBook DEX v1 smart contract on Solana. It defines all available instructions, account structures, events, and types needed to interact with the program. This one has 21 instructions, 9 account types, 0 events and 10 type definitions.
How do I use the OpenBook DEX v1 IDL in my project?
You can use the OpenBook DEX v1 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 OpenBook DEX v1 program address on Solana?
The OpenBook DEX v1 program is deployed at address srmqPvymJeFKQ4zGQed1GFppgkRHL9kaELCbyksJtPX on Solana mainnet.
What version of the OpenBook DEX v1 IDL is this?
This is version 0.0.0 of the OpenBook DEX v1 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 OpenBook DEX v1 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