Orderly Onboarding

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:

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:

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:

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:

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