Orderly Network: Agent Onboarding

Orderly is an omnichain orderbook-based trading infrastructure providing perpetual futures liquidity for decentralized exchanges. This skill is your starting point for building on or learning about Orderly Network.

When to Use

• First time encountering Orderly Network
• Setting up AI agent tools for Orderly development
• Understanding the Orderly ecosystem and offerings
• Finding the right skill or resource for your task
• Understanding what tools are available for AI agents

What is Orderly Network

Orderly is a combination of an orderbook-based trading infrastructure and a robust liquidity layer offering perpetual futures orderbooks. Unlike traditional platforms, Orderly doesn't have a front end—it operates at the core of the ecosystem, providing essential services to projects built on top.

Key Characteristics:

• Omnichain CLOB: Shared Central Limit Order Book accessible from all major EVM chains and Solana
• Backend Infrastructure: No official front end; builders create DEXes and trading interfaces on top
• On-chain Settlement: All trades settle on-chain while maintaining full self-custody
• Unified Liquidity: One orderbook serves all integrated front-ends
• Perpetual Futures: Trade BTC, ETH, SOL, and more with up to 50x leverage
• Gasless Trading: No gas fees once funds are deposited and trading keys activated
• One-Click Trading: New trading key pair per session, no further signatures needed

Primary Use Cases:

Use Case	Description
Builders/DEXes	Create your own Perps DEX on EVM and Solana with plug-and-play SDKs
Perps Aggregators	Access Orderly's shared liquidity directly via API or SDK
Trading Desks	Use APIs for CEX-level trading with low latency orderbook
Trading Bots	Connect to orderbook for best rates, SL/limit orders, gasless transactions

Key Advantages

• Unified Orderbook & Liquidity: Access all major chains through a single trading infrastructure
• Quick Development: Launch a DEX within days using our SDKs
• Ready-to-Use Liquidity: Powered by multiple top-tier market makers
• Revenue Sharing: Earn a share of generated fees from your platform
• CEX-Level Performance: Low latency matching engine with on-chain settlement
• Self-Custody: You control your assets and private keys
• Collaborative Ecosystem: Join a thriving community of builders

Architecture

Your Application (DEX, Bot, Wallet, Aggregator)

• Orderly Infrastructure
  • CLOB — Shared Central Limit Order Book (unified across all chains)
  • Matching Engine — Low-latency order matching (CEX-level performance)
  • Vault — On-chain settlement with self-custody
  • Risk Management — Liquidation engine and position monitoring
• Settlement Networks
  • EVM: Arbitrum, Optimism, Base, Ethereum, Polygon, Mantle
  • Non-EVM: Solana

Getting Started: AI Agent Tools

To build on Orderly, install the MCP server for the best development experience. It provides 8 powerful tools for documentation search, SDK patterns, contract addresses, workflows, and API reference.

MCP Server (Recommended)

The MCP server provides AI assistants with instant access to Orderly documentation, code patterns, and API references.

Quick Install:

npx @orderly.network/mcp-server init --client <client>

Supported Clients:

Client	Command	Config File
Claude Code	--client claude	.mcp.json
Cursor	--client cursor	.cursor/mcp.json
VS Code	--client vscode	.vscode/mcp.json
Codex	--client codex	~/.codex/config.toml
OpenCode	--client opencode	.opencode/mcp.json

Manual Configuration:

If automatic setup doesn't work, add this configuration to your AI client:

Claude Code (.mcp.json):

{
  "mcpServers": {
    "orderly": {
      "command": "npx",
      "args": ["@orderly.network/mcp-server@latest"]
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "orderly": {
      "command": "npx",
      "args": ["@orderly.network/mcp-server@latest"]
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "orderly": {
      "command": "npx",
      "args": ["@orderly.network/mcp-server@latest"]
    }
  }
}

OpenCode (.opencode/mcp.json):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "orderly": {
      "type": "local",
      "command": ["npx", "@orderly.network/mcp-server@latest"],
      "enabled": true
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.orderly]
command = "npx"
args = ["@orderly.network/mcp-server@latest"]

What the MCP Server Provides:

Tool	Description
search_orderly_docs	Search Orderly documentation for specific topics
get_sdk_pattern	Get code examples for SDK v2 hooks and patterns
get_contract_addresses	Lookup smart contract addresses for any chain
explain_workflow	Step-by-step guides for common tasks
get_api_info	REST API and WebSocket endpoint documentation
get_indexer_api_info	Trading metrics, events, volume statistics
get_component_guide	React UI component building guides
get_orderly_one_api_info	DEX creation and management API for Orderly One

Agent Skills

Install Orderly skills to enhance your AI agent with procedural knowledge for building on Orderly.

Install all skills globally (recommended):

npx skills add OrderlyNetwork/skills --all --agent '*' -g

Install all skills locally:

npx skills add OrderlyNetwork/skills --all

Install specific skills:

# List available skills
npx skills add OrderlyNetwork/skills --list

# Install specific skill
npx skills add OrderlyNetwork/skills --skill orderly-trading-orders

# Install multiple skills
npx skills add OrderlyNetwork/skills --skill orderly-api-authentication --skill orderly-trading-orders

# Install for specific agent
npx skills add OrderlyNetwork/skills --all --agent claude-code -g

Global vs Local:

• Global (-g): Available across all projects, installed to user directory
• Local: Project-specific, creates .skills/ in repo, can be committed to version control

Available Skills:

Category	Skill	Description
API / Protocol	orderly-api-authentication	Two-layer auth: EIP-712 (EVM) + Ed25519 (Solana)
	orderly-trading-orders	Place, manage, cancel orders via REST API or SDK
	orderly-positions-tpsl	Monitor positions, TP/SL, leverage, PnL
	orderly-websocket-streaming	Real-time WebSocket for orderbook and executions
	orderly-deposit-withdraw	Token deposits, withdrawals, cross-chain operations
SDK / React	orderly-sdk-react-hooks	Reference for all React SDK hooks
	orderly-ui-components	Pre-built React UI components
	orderly-sdk-install-dependency	Install Orderly SDK packages
	orderly-sdk-dex-architecture	Complete DEX project structure and setup
	orderly-sdk-page-components	Pre-built page components
	orderly-sdk-theming	CSS variable theming and customization
	orderly-sdk-trading-workflows	End-to-end trading flows
Platform	orderly-sdk-wallet-connection	Wallet integration for EVM and Solana
	orderly-sdk-debugging	Debug/troubleshoot SDK errors
	orderly-one-dex	Create/manage custom DEX with Orderly One API

For Builders (SDK & DEX Development)

Build custom trading interfaces using Orderly's React SDK v2.

Core SDK Packages:

# Full DEX setup
npm install @orderly.network/react-app \
            @orderly.network/trading \
            @orderly.network/portfolio \
            @orderly.network/markets \
            @orderly.network/wallet-connector \
            @orderly.network/i18n

# Required: EVM wallet support
npm install @web3-onboard/injected-wallets @web3-onboard/walletconnect

# Required: Solana wallet support
npm install @solana/wallet-adapter-base @solana/wallet-adapter-wallets

Key Components Available:

• OrderEntry - Order placement form
• Orderbook - Market depth display
• PositionsView - Position management table
• TradingPage - Full trading page
• Portfolio - User portfolio dashboard
• ConnectWalletButton - Wallet connection UI

Orderly One (White-Label DEX):

Launch your own branded perpetuals DEX without building from scratch. Orderly One provides a turnkey solution with:

• Custom domain and branding
• Fee revenue sharing after paying graduation fee
• Full trading infrastructure
• Custom theme

Load these skills for SDK development:

• orderly-sdk-install-dependency - Package installation guide
• orderly-sdk-dex-architecture - Project structure and providers
• orderly-sdk-wallet-connection - Wallet integration
• orderly-sdk-trading-workflows - Complete trading flows
• orderly-sdk-theming - Customization guide

For API / Bot Developers

Integrate directly with Orderly's REST API and WebSocket streams.

API Base URLs:

Network	URL
Mainnet	https://api.orderly.org
Testnet	https://testnet-api.orderly.org

WebSocket URLs:

Network	URL
Mainnet	wss://ws.orderly.org/ws
Testnet	wss://testnet-ws.orderly.org/ws

Authentication:

• Ed25519 key pair generation for API signing
• EIP-712 wallet signatures for EVM accounts
• Ed25519 message signing for Solana accounts

Symbol Format:

PERP_<TOKEN>_USDC

Examples: PERP_ETH_USDC, PERP_BTC_USDC, PERP_SOL_USDC

Key Endpoints:

• POST /v1/order - Place order
• GET /v1/positions - Get positions
• GET /v1/orders - Get orders
• GET /v1/orderbook/{symbol} - Orderbook snapshot
• GET /v1/public/futures - Market info

Load these skills for API development:

• orderly-api-authentication - Complete auth setup
• orderly-trading-orders - Order management
• orderly-positions-tpsl - Position management
• orderly-websocket-streaming - Real-time data

Supported Chains

Orderly supports multiple EVM and non-EVM chains. To get the current list of supported networks with their chain IDs, vault addresses, and RPC endpoints:

GET https://api.orderly.org/v1/public/chain_info

This endpoint returns all mainnet and testnet chains currently supported by Orderly, including Arbitrum, Optimism, Base, Ethereum, Polygon, Mantle, Solana, Sei, Avalanche, BSC, Abstract, and more.

$ORDER Token

The $ORDER token is central to the Orderly ecosystem:

• Maximum Supply: 1,000,000,000 tokens
• Staking: Stake $ORDER to earn VALOR and protocol revenue share
• VALOR: Non-transferable metric measuring staking position; redeemable for esORDER rewards
• Revenue Sharing: 30% of protocol net fees distributed to stakers
• Governance: Stakers participate in protocol governance decisions
• esORDER: Escrowed ORDER for rewards with vesting mechanics

Token Contracts:

Network	Address
Ethereum (ERC20)	0xABD4C63d2616A5201454168269031355f4764337
EVM Chains (OFT)	0x4E200fE2f3eFb977d5fd9c430A41531FB04d97B8
Solana	ABt79MkRXUsoHuV2CVQT32YMXQhTparKFjmidQxgiQ6E

For full tokenomics details, visit: https://orderly.network/docs/introduction/tokenomics

Key Links

Resource	URL
Documentation	https://orderly.network/docs
SDK Repository	how to use orderly-onboarding CursorClaude CodeClineCodexWindsurfGooseGitHub CopilotVS CodeGemini CLIKiloOpencodeKimi CLIRoo ClineAiderContinueZedBolt.newLovablev0Replit AgentSweepSmol DeveloperDevinCavemanAmpAntigravity How to use orderly-onboarding on Cursor AI-first code editor with Composer 1 Prerequisites Before installing skills in Cursor, ensure your development environment meets these requirements: ›Cursor installed and configured on your development machine ›Node.js version 16.0+ with npm package manager (verify with node --version) ›Active project directory or workspace where you want to add orderly-onboarding 2 Execute installation command Execute the skills CLI command in your project's root directory to begin installation: $npx skills add https://github.com/starchild-ai-agent/official-skills --skill orderly-onboardingcopy The skills CLI fetches orderly-onboarding from GitHub repository starchild-ai-agent/official-skills and configures it for Cursor. 3 Select Cursor when prompted The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor: ◆ Which agents do you want to install to? │ │ ── Universal (.agents/skills) ── always included ──── │ • Amp │ • Antigravity │ • Cline │ • Codex │ ●Cursor(selected) │ • Cursor │ • Windsurf 4 Verify installation Confirm successful installation by checking the skill directory location: .cursor/skills/orderly-onboarding Reload or restart Cursor to activate orderly-onboarding. Access the skill through slash commands (e.g., /orderly-onboarding) or your agent's skill management interface. ⚠ Security & Verification Notice We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use. Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment. Additional Resources ›View source code on GitHub›Skills CLI documentation›Learn more about Cursor›What are agent skills? List & Monetize Your Skill Submit your Claude Code skill and start earning GET_STARTED → Use Cases▌ User Story & Requirements Generation Create detailed user stories, acceptance criteria, and feature specs Example Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios ✓ Reduce spec writing time by 50%, ensure comprehensive coverage Competitive Analysis Research competitors, compare features, identify gaps Example Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities ✓ Complete competitive research in 2 hours instead of 2 days Roadmap Prioritization Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs Example Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale ✓ Make data-driven prioritization decisions faster Stakeholder Communication Draft PRDs, status updates, and stakeholder presentations Example Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement ✓ Save 3-5 hours/week on communication overhead Implementation Guide▌ Prerequisites ›Claude Desktop or compatible AI client ›Access to product documentation and roadmap tools (Jira, Notion, etc.) ›Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.) ›Stakeholder contact information and communication channels Time Estimate 30-60 minutes to see productivity improvements Installation Steps 1.Install product management skill 2.Start with user story generation for known feature 3.Progress to competitive analysis: research 2-3 competitors 4.Use for roadmap prioritization: apply RICE/ICE scoring 5.Draft stakeholder communications and refine based on feedback 6.Build template library for recurring PM tasks 7.Share effective prompts with product team Common Pitfalls ⚠Not validating competitive research—verify facts before sharing ⚠Accepting user stories without involving engineering team ⚠Over-relying on frameworks without qualitative judgment ⚠Not customizing outputs to company culture and communication style ⚠Skipping stakeholder validation of generated requirements Best Practices▌ ✓ Do +Validate research and competitive analysis with real data +Collaborate with engineering when generating technical requirements +Customize frameworks and templates to your company context +Use skill for first drafts, refine with stakeholder input +Document successful prompt patterns for PM tasks +Combine AI efficiency with human judgment and intuition ✗ Don't −Don't publish competitive analysis without fact-checking −Don't finalize user stories without engineering review −Don't make prioritization decisions solely on AI scoring −Don't skip customer validation of generated requirements −Don't ignore company-specific context and culture 💡 Pro Tips ★Provide context: company goals, constraints, customer feedback ★Ask for alternatives: 'Show 3 ways to prioritize this roadmap' ★Request stakeholder-specific formatting: 'Executive summary vs. engineering spec' ★Use skill for 70% generation + 30% customization to company needs When to Use This▌ ✓ Use When Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work. ✗ Avoid When Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed. Learning Path▌ 1Basic: user stories, feature specs, status updates 2Intermediate: competitive analysis, prioritization frameworks, PRDs 3Advanced: product strategy, go-to-market planning, OKR setting 4Expert: product vision, market positioning, business model innovation Discussion Product Hunt–style comments (not star reviews) post comment No comments yet — start the thread. general reviews Ratings 4.6★★★★★37 reviews ★★★★★Arya Anderson· Dec 28, 2024 I recommend orderly-onboarding for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area. ★★★★★Ganesh Mohane· Dec 24, 2024 orderly-onboarding is among the better-maintained entries we tried; worth keeping pinned for repeat workflows. ★★★★★Shikha Mishra· Dec 20, 2024 We added orderly-onboarding from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront. ★★★★★Alexander Kim· Dec 16, 2024 Keeps context tight: orderly-onboarding is the kind of skill you can hand to a new teammate without a long onboarding doc. ★★★★★Amelia Kapoor· Nov 19, 2024 orderly-onboarding fits our agent workflows well — practical, well scoped, and easy to wire into existing repos. ★★★★★Sakshi Patil· Nov 15, 2024 Keeps context tight: orderly-onboarding is the kind of skill you can hand to a new teammate without a long onboarding doc. ★★★★★Sofia Iyer· Nov 7, 2024 orderly-onboarding is among the better-maintained entries we tried; worth keeping pinned for repeat workflows. ★★★★★Nikhil Menon· Oct 26, 2024 Useful defaults in orderly-onboarding — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows. ★★★★★Arya Zhang· Oct 10, 2024 Registry listing for orderly-onboarding matched our evaluation — installs cleanly and behaves as described in the markdown. ★★★★★Chaitanya Patil· Oct 6, 2024 orderly-onboarding has been reliable in day-to-day use. Documentation quality is above average for community skills. showing 1-10 of 37 prev1 / 4next bookmarkshare