Orderly Network: Agent Onboarding

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

• 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

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

• 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

MCP Server (Recommended)

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

--client claude

.mcp.json

--client cursor

.cursor/mcp.json

--client vscode

.vscode/mcp.json

--client codex

~/.codex/config.toml

--client opencode

.opencode/mcp.json

.mcp.json

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

.cursor/mcp.json

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

.vscode/mcp.json

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

.opencode/mcp.json

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

~/.codex/config.toml

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

search_orderly_docs

get_sdk_pattern

get_contract_addresses

explain_workflow

get_api_info

get_indexer_api_info

get_component_guide

get_orderly_one_api_info

Agent Skills

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

npx skills add OrderlyNetwork/skills --all

# 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 (

  -g

  ): Available across all projects, installed to user directory
• Local: Project-specific, creates

  .skills/

  in repo, can be committed to version control

orderly-api-authentication

orderly-trading-orders

orderly-positions-tpsl

orderly-websocket-streaming

orderly-deposit-withdraw

orderly-sdk-react-hooks

orderly-ui-components

orderly-sdk-install-dependency

orderly-sdk-dex-architecture

orderly-sdk-page-components

orderly-sdk-theming

orderly-sdk-trading-workflows

orderly-sdk-wallet-connection

orderly-sdk-debugging

orderly-one-dex

For Builders (SDK & DEX Development)

# 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

• OrderEntry

  - Order placement form

• Orderbook

  - Market depth display

• PositionsView

  - Position management table

• TradingPage

  - Full trading page

• Portfolio

  - User portfolio dashboard

• ConnectWalletButton

  - Wallet connection UI

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

• 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

https://api.orderly.org

https://testnet-api.orderly.org

wss://ws.orderly.org/ws

wss://testnet-ws.orderly.org/ws

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

PERP_<TOKEN>_USDC

PERP_ETH_USDC

PERP_BTC_USDC

PERP_SOL_USDC

• 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

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

Supported Chains

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

$ORDER Token

• 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

0xABD4C63d2616A5201454168269031355f4764337

0x4E200fE2f3eFb977d5fd9c430A41531FB04d97B8

ABt79MkRXUsoHuV2CVQT32YMXQhTparKFjmidQxgiQ6E

Key Links

Recommended Next Steps

1. Load orderly-sdk-install-dependency and orderly-sdk-dex-architecture
2. Install MCP server:

   npx @orderly.network/mcp-server init

3. Set up wallet connection with orderly-sdk-wallet-connection
4. Build your UI with orderly-ui-components

1. Load orderly-api-authentication first
2. Install MCP server for API reference
3. Load orderly-trading-orders and orderly-websocket-streaming

1. Install MCP server for Orderly One API tools:

   npx @orderly.network/mcp-server init

2. Load orderly-one-dex skill for DEX creation and management workflows
3. Load orderly-sdk-theming skill to understand theme structure for API updates

1. Load orderly-sdk-debugging
2. Use MCP server to search documentation

• Use Testnet environment for development
• Request testnet USDC from the faucet:

  POST /v1/faucet/usdc

  (testnet only)
• Each account can use faucet up to 3 times

Common Issues

"Where do I start building?"

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

"What's the difference between MCP server and Skills?"

• MCP Server: Runtime tools for your AI assistant (documentation search, pattern lookup, API reference)
• Skills: Procedural knowledge embedded in your context (how-to guides, code examples, best practices)

"How do I test without real funds?"

• API:

  https://testnet-api.orderly.org

• WebSocket:

  wss://testnet-ws.orderly.org/ws

• Get test USDC:

  POST https://testnet-operator-evm.orderly.org/v1/faucet/usdc

"Do I need to handle authentication manually?"

Related Skills

API / Protocol

• orderly-api-authentication - Complete authentication setup
• orderly-trading-orders - Order management
• orderly-positions-tpsl - Position and risk management
• orderly-websocket-streaming - Real-time data streaming
• orderly-deposit-withdraw - Asset management

SDK / React

• orderly-sdk-react-hooks - React hooks reference
• orderly-ui-components - Pre-built UI components
• orderly-sdk-install-dependency - SDK installation
• orderly-sdk-dex-architecture - DEX architecture
• orderly-sdk-page-components - Page components
• orderly-sdk-theming - Theming guide
• orderly-sdk-trading-workflows - Trading workflows

Platform

• orderly-sdk-wallet-connection - Wallet integration
• orderly-sdk-debugging - Debugging guide
• orderly-one-dex - Orderly One DEX management