Orderly Onboarding
by @tarnadas
Agent onboarding for Orderly Network - omnichain perpetual futures infrastructure, MCP server, skills, and developer quickstart
clawhub install orderly-onboardingπ About This Skill
name: orderly-onboarding description: Agent onboarding for Orderly Network - omnichain perpetual futures infrastructure, MCP server, skills, and developer quickstart
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
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:
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
Architecture
Your Application (DEX, Bot, Wallet, Aggregator)
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
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 --listInstall specific skill
npx skills add OrderlyNetwork/skills --skill orderly-trading-ordersInstall multiple skills
npx skills add OrderlyNetwork/skills --skill orderly-api-authentication --skill orderly-trading-ordersInstall for specific agent
npx skills add OrderlyNetwork/skills --all --agent claude-code -g
Global vs Local:
-g): Available across all projects, installed to user directory.skills/ in repo, can be committed to version controlAvailable 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/i18nRequired: EVM wallet support
npm install @web3-onboard/injected-wallets @web3-onboard/walletconnectRequired: Solana wallet support
npm install @solana/wallet-adapter-base @solana/wallet-adapter-wallets
Key Components Available:
OrderEntry - Order placement formOrderbook - Market depth displayPositionsView - Position management tableTradingPage - Full trading pagePortfolio - User portfolio dashboardConnectWalletButton - Wallet connection UIOrderly One (White-Label DEX):
Launch your own branded perpetuals DEX without building from scratch. Orderly One provides a turnkey solution with:
Load these skills for SDK development:
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:
Symbol Format:
PERP__USDC
Examples: PERP_ETH_USDC, PERP_BTC_USDC, PERP_SOL_USDC
Key Endpoints:
POST /v1/order - Place orderGET /v1/positions - Get positionsGET /v1/orders - Get ordersGET /v1/orderbook/{symbol} - Orderbook snapshotGET /v1/public/futures - Market infoLoad these skills for API development:
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:
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 | https://github.com/orderlynetwork/js-sdk | | Example DEX | https://github.com/orderlynetwork/example-dex | | MCP Server (npm) | https://www.npmjs.com/package/@orderly.network/mcp-server | | Skills (npm) | https://www.npmjs.com/package/@orderly.network/skills | | Skills.sh | https://skills.sh | | Orderly App | https://app.orderly.network | | Discord | https://discord.gg/OrderlyNetwork | | Twitter | https://twitter.com/OrderlyNetwork |
Recommended Next Steps
If you're building a DEX:
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
If you're building trading bots or API integrations:
1. Load orderly-api-authentication first 2. Install MCP server for API reference 3. Load orderly-trading-orders and orderly-websocket-streaming
If you're launching a white-label DEX:
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
If you're troubleshooting:
1. Load orderly-sdk-debugging 2. Use MCP server to search documentation
For testing:
POST /v1/faucet/usdc (testnet only)Common Issues
"Where do I start building?"
Install the MCP server first: npx @orderly.network/mcp-server init --client
Then ask: "How do I connect to Orderly Network?" or load orderly-sdk-wallet-connection.
"What's the difference between MCP server and Skills?"
Use both for the best experience.
"How do I test without real funds?"
Use the Testnet environment:
https://testnet-api.orderly.orgwss://testnet-ws.orderly.org/wsPOST https://testnet-operator-evm.orderly.org/v1/faucet/usdc"Do I need to handle authentication manually?"
The SDK handles authentication automatically. For API-only integration, load orderly-api-authentication for the complete auth flow.