solana-market-id

Solana Market ID CLI Find Serum v1/v3 (and OpenBook v2 soon) market IDs for a token (pair) and inspect market metadata (bids/asks/event queue/request queue, vaults, top-of-book). Fast & reliable: uses Serum's official on-chain layout to build tight RPC filters (no heavy scans). Tip jar: 88888kfJ3SRayhz1dHj9msNm99G5iVZ7FBN8MRjhEdK8 --- Features - Find markets by base & quote mint: - RPC-only exact filters (recommended) - Optional Helius-assisted program scan with automatic RPC fallback - Inspect a known market: print metadata, queue sizes, and top-of-book (Serum) - Configurable via flags or .env (RPC URL(s), program IDs, Helius API key) - Windows-friendly (quotes & line continuation notes included) --- Installation Option A - Run instantly (no install) bash npx solana-market-id <args Works after publishing to npm. For local development, use npx ts-node against src/cli.ts or dist/cli.js after build. Option B - Global install bash npm i -g solana-market-id solana-market-id --help Option C - From source bash Requires Node.js = 18 git clone <your-repo-url cd <repo Install dependencies npm i Build to dist/ npm run build Run node dist/cli.js --help or dev run with ts-node (if installed) npx ts-node src/cli.ts --help --- Dependencies Installed automatically via npm i: - @solana/web3.js - @project-serum/serum - dotenv - node-fetch (v2) - Dev: typescript, @types/node, @types/node-fetch, rimraf --- .env Configuration (optional) Create a .env file next to your project to set defaults: ini (RECOMMENDED) Your default RPC endpoint (dedicated RPC avoids throttling) RPC_URL=https://api.mainnet-beta.solana.com Optional: comma-separated additional RPCs for failover RPC_URLS=https://api.mainnet-beta.solana.com,https://solana-api.projectserum.com Required only if you use --use-helius HELIUS_API_KEY=YOUR_HELIUS_KEY Optional overrides (mainnet defaults used if omitted) SERUM_V1_PROGRAM_ID=srmqPvymJeFKQ4zGQed1GFppgkRHL9kaELCbyksJtPX SERUM_V3_PROGRAM_ID=9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZbG8SxwP3E OPENBOOK_V2_PROGRAM_ID=opnb2LAfJYbRMAHHvqjCwQxanZn7ReEHp1k81EohpZb Which must be filled? - Required: none (the CLI will still run using public RPC) - Recommended: RPC_URL (to avoid rate limiting) - Required only when using Helius mode: HELIUS_API_KEY Do not commit .env to source control. --- CLI Usage Help bash solana-market-id --help Find markets (RPC-only; fast & reliable) bash solana-market-id <BASE_MINT --quotes <QUOTE1,QUOTE2,... --program <serum1|serum3|all --rpc "<RPC_URL" Example (Serum v1; Windows/POSIX): bash solana-market-id 9kt93AW5QMjFL6ZxomnSq3FbWiU5ibNeTSgBz9UDFSB6 --quotes EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --program serum1 --rpc "https://mainnet.helius-rpc.com/?api-key=YOUR_KEY" Optional: Helius-assisted discovery bash solana-market-id <BASE_MINT --quotes <QUOTE1,QUOTE2,... --program serum1 --use-helius --api-key <HELIUS_KEY --pages 60 --rpc "<RPC_URL" - Scans program-level transactions with source=SERUM, then verifies candidates via RPC - Auto-fallback to RPC for the pair if Helius yields nothing Inspect a known market bash solana-market-id --known-market <MARKET_ID [--depth 10] --rpc "<RPC_URL" Outputs: - Base/Quote mints - Bids / Asks / Event Queue / Request Queue accounts - Vault accounts - Live counts (Event Q, Request Q, bids, asks) - Top N price levels for bids/asks (aggregated levels; use --depth to change N) Quick tests bash solana-market-id --test1 your token vs WSOL solana-market-id --test2 token vs USDC (DEXLAB example) --- Flags (Full List) | Flag | Alias | Value | Required | Description | |---|---|---|---|---| | --help | -h | - | No | Show usage. | | --program | -P | serum1 \| serum3 \| all | No (default all) | Which DEX programs to query. | | --quotes | -q | Comma-separated mint list | No (defaults: USDC, WSOL) | One or more quote mints to check against base. | | --rpc | -r | URL | No (falls back to .env / public) | RPC endpoint for this run. | | --use-helius | -H | - | No | Enable Helius-assisted program scan. | | --api-key | -k | Helius key | Only if using --use-helius | API key for Helius. Can be set in .env. | | --pages | -pg | Number | No (default 20) | Helius pagination depth (100 tx/page). | | --known-market | -km | Market address | No | Inspect known Serum market metadata & top-of-book. | | --depth | -d | Number | No (default 10) | L2 depth for top-of-book output in --known-market. | | --json | - | - | No | Output machine-readable JSON for results. | | --test1 | - | - | No | Test: your token vs WSOL. | | --test2 | - | - | No | Test: token vs USDC (DEXLAB). | --- Examples Serum v1: Base vs USDC bash solana-market-id 9kt93A... --quotes EPjFWd... --program serum1 --rpc "https://api.mainnet-beta.solana.com" Multi-quote search bash solana-market-id 9kt93A... --quotes EPjFWd...,So1111... --program serum1 --rpc "https://api.mainnet-beta.solana.com" Serum v3 and v1 bash solana-market-id 9kt93A... --quotes EPjFWd... --program all --rpc "https://api.mainnet-beta.solana.com" Inspect known market (e.g., the one you verified) bash solana-market-id --known-market EUwL9Lg... --depth 25 --rpc "https://api.mainnet-beta.solana.com" JSON for scripting bash solana-market-id 9kt93A... --quotes EPjF... --program serum1 --json pipe to jq solana-market-id 9kt93A... --quotes EPjF... --program serum1 --json | jq . --- Windows Notes - Do not include angle brackets around values (CMD treats <... as I/O redirection). - Quote RPC URLs: --rpc "https://mainnet.helius-rpc.com/?api-key=YOUR_KEY" - Line continuation: - CMD.exe: use ^ at line end. - PowerShell: use backtick at line end. - Backslash \ (POSIX style) does not work in CMD. --- How it Works (Why it is fast) - Uses @project-serum/serum's official state layout: - We read the offsets of baseMint/quoteMint and the span for the market account. - We pass exact filters (dataSize + two memcmps) to getProgramAccounts. - RPC returns only a tiny result set avoids throttling/deprioritization. - Helius path (optional) scans program-level transactions and verifies candidates via RPC; auto-falls back to RPC if empty. Note on Top-of-Book: getL2(N) aggregates orders into price levels (e.g., multiple orders at 83 collapse into one level). So you may see Asks Length: 11 but only 7 aggregated price levels printed. --- Troubleshooting - Request deprioritized due to number of accounts requested likely using a broad scan. The default RPC-only path uses exact layout filters and should not trigger this. Use a dedicated RPC if possible. - Cannot create a string longer than 0x1fffffe8 characters That is from fetching too many accounts. The CLI avoids this by default; ensure not forcing broad scans. - No markets found - Make sure you selected the correct program (--program serum1 for legacy v1). - Try the reverse pair (quote/base). - Confirm the mints are correct base58 addresses. - Use --known-market <address to validate the market exists & belongs to that program. - Windows parsing issues - Always quote the RPC URL. - Remove < around values. - Use ^ (CMD) or (PowerShell) for multiline commands. --- Security - Read-only: no private keys required or used. - Do not commit your HELIUS_API_KEY to Git. - Prefer using .env over passing secrets inline on the command line (shell history). --- Changelog (What is different vs naive scanners) - Replaced broad scans with Serum layout-based exact filters. - Added Helius-assisted discovery with auto RPC fallback per pair. - Introduced known market inspector with queue sizes & L2 top-of-book. - Added --depth for customizable L2 output. - Windows-friendly CLI UX (quotes/continuation guidance). --- License MIT Abraham Dixit-Blessed