Building on QuantDesk

This tutorial walks through the V2 crankless execution path using place_order_v2 — the atomic entry point for all trades on QuantDesk V2.

Complete the Developer quickstart first — you need gateway health and Swagger access. You also need a funded Solana wallet on your target cluster (devnet or mainnet).

Limit-order makers must claim a seat before placing orders. This spam-protection gate is enforced on-chain.

Initialize your portfolio

Every trader needs a PortfolioAccount PDA before placing orders. Pass subaccount_index (usually 0) and a referrer pubkey (PublicKey.default if none).

const subaccountIndex = 0;

const [portfolioPDA] = PublicKey.findProgramAddressSync(
  [
    Buffer.from("portfolio"),
    user.publicKey.toBuffer(),
    Buffer.from([subaccountIndex & 0xff, (subaccountIndex >> 8) & 0xff]),
  ],
  program.programId
);

await program.methods
  .initializePortfolio(subaccountIndex, PublicKey.default)
  .accounts({
    portfolio: portfolioPDA,
    user: user.publicKey,
    relayer: user.publicKey, // or a gasless relayer signer
    systemProgram: SystemProgram.programId,
  })
  .signers([user])
  .rpc();

If this account already exists for the wallet + subaccount pair, skip to seat claim. Confirm via RPC or GET /api/v2/portfolio after indexing.

Claim a market seat

const [seatPDA] = PublicKey.findProgramAddressSync(
  [Buffer.from("seat"), marketV2PDA.toBuffer(), user.publicKey.toBuffer()],
  program.programId
);

await program.methods
  .claimSeat()
  .accounts({
    seat: seatPDA,
    market: marketV2PDA,
    user: user.publicKey,
  })
  .signers([user])
  .rpc();

Place the order

import * as anchor from "@coral-xyz/anchor";
import { PublicKey, SystemProgram } from "@solana/web3.js";

// PDAs from steps 1–2 above: portfolioPDA, seatPDA

await program.methods
  .placeOrderV2(
    1,                        // bid — side 1 = bid, 2 = ask
    new anchor.BN(10_000),    // size (check market lot_size)
    new anchor.BN(50_000)     // price (check market tick_size)
  )
  .accounts({
    market: marketV2PDA,
    bids: bidsPDA,
    asks: asksPDA,
    portfolio: portfolioPDA,
    seat: seatPDA,
    user: user.publicKey,
    relayer: user.publicKey,
    jitMaker: null,
    jitPortfolio: null,
  })
  .signers([user])
  .rpc();

If the user wallet holds less than ~0.005 SOL, the QuantDesk frontend routes the same instruction through a relayer that deducts fees from relayer_fee_balance on the portfolio.

Verify execution

Fetch the transaction signature on your cluster explorer.
Read portfolio state via RPC (portfolio parsing) or GET /api/v2/portfolio.
Compare open orders against GET /api/v2/markets/orderbook/:market for depth context.

V2 execution model (30-second version)

In a single transaction, place_order_v2:

Validates oracle health and portfolio policy (including scoped session keys).
Attempts a JIT institutional fill window when configured.
Matches against the on-chain BST slab (bids and asks red-black trees).
Routes any remainder to the qLP backstop vault.

No off-chain keeper crank is required for core matching — see Reading the order book.

Side encoding

Value	Meaning
`1`	Bid (buy / long)
`2`	Ask (sell / short)

Always confirm against the exported IDL in your environment. Client SDKs may expose friendlier enums that map to these values.

Common program errors

Error	Typical cause
`PriceStale`	Oracle last update older than ~20 seconds
`InvalidOraclePrice`	Zero or negative oracle price
`SlippageExceeded`	Social vault trade outside the 100bps band
`PolicyViolationMarket`	Scoped session key not authorized for this market

Full HTTP and program error guidance: Errors and rate limits.

Next steps

Portfolio parsing

Decode portfolio bytes from RPC.

Order entry

Terminal UX context for order types.

Copy trading

Social vault mechanics.

Errors & rate limits

HTTP and program error reference.

SDK & APIs

Building on QuantDesk: place_order_v2 tutorial

Building on QuantDesk

V2 execution model (30-second version)

Side encoding

Common program errors

Next steps

Portfolio parsing

Order entry

Copy trading

Errors & rate limits

​Building on QuantDesk

​V2 execution model (30-second version)

​Side encoding

​Common program errors

​Next steps

Portfolio parsing

Order entry

Copy trading

Errors & rate limits

Building on QuantDesk

V2 execution model (30-second version)

Side encoding

Common program errors

Next steps