with one click
orderly-onboarding
// Agent onboarding for Orderly Network - omnichain perpetual futures infrastructure, MCP server, skills, and developer quickstart
// Agent onboarding for Orderly Network - omnichain perpetual futures infrastructure, MCP server, skills, and developer quickstart
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | orderly-onboarding |
| description | Agent onboarding for Orderly Network - omnichain perpetual futures infrastructure, MCP server, skills, and developer quickstart |
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.
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 |
Your Application (DEX, Bot, Wallet, Aggregator)
To build on Orderly, use the MCP server for the best development experience. It provides 8 powerful tools for documentation search, SDK patterns, contract addresses, workflows, and API reference. You can either connect to the remote server (no installation) or install it locally via npx.
Connect to the hosted MCP server at https://mcp.orderly.network — no installation required. Uses Streamable HTTP transport with no authentication needed. Point your AI client's MCP config to this URL.
Install the MCP server locally via npx — works offline and gives you full control.
npx @orderly.network/mcp-server init --client <client>
If automatic setup doesn't work, manually configure your AI client to run npx @orderly.network/mcp-server@latest.
What the MCP Server Provides (both remote and local):
| 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 |
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:
-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 |
Build custom trading interfaces using Orderly's React SDK v2.
Fork the DEX Template to get a working DEX in minutes.
.env with your broker ID and nameThis template uses the components SDK — pre-built page components that work out of the box with less customization. For full control over individual components, use the MCP server and load SDK skills (especially orderly-sdk-react-hooks and orderly-sdk-ui-components) for hooks-level development.
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 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:
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_<TOKEN>_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:
A terminal trading tool (@orderly.network/cli) wrapping the full Orderly REST API. AI-safe: keys in OS keychain, signing internal, agents only see results. orderly --help covers everything.
Install & Quick Start (Testnet):
npm install -g @orderly.network/cli
orderly wallet-create --type EVM --network testnet
orderly wallet-register --broker-id demo --network testnet
orderly faucet-usdc <address> --chain-id 421614 --network testnet
orderly wallet-add-key --network testnet
orderly auth-list --network testnet
orderly order-place PERP_ETH_USDC BUY MARKET 0.01 --account <id> --network testnet
Note: --account is required for authenticated commands (get IDs via auth-list). Hex IDs must be shell-quoted. Default network is testnet — pass --network mainnet for production. Linux requires libsecret.
demo — For testing, development, and personal use. No setup required.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.
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
| Resource | URL | Notes |
|---|---|---|
| Documentation | https://orderly.network/docs | |
| SDK Repository | https://github.com/orderlynetwork/js-sdk | |
| DEX Template | https://github.com/OrderlyNetwork/dex-template | Fastest start, uses components SDK |
| MCP Server (Remote) | https://mcp.orderly.network | No install needed |
| MCP Server (npm) | https://www.npmjs.com/package/@orderly.network/mcp-server | Local install |
| CLI (npm) | https://www.npmjs.com/package/@orderly.network/cli | |
| Skills (npm) | https://www.npmjs.com/package/@orderly.network/skills | |
| Skills.sh | https://skills.sh | |
| DEX Dashboard | https://dex.orderly.network | |
| Orderly App | https://app.orderly.network | |
| Discord | https://discord.gg/OrderlyNetwork | |
| https://twitter.com/OrderlyNetwork |
If you're building a DEX:
npx @orderly.network/mcp-server init or connect to https://mcp.orderly.network.env and customize your themeIf you're building trading bots or API integrations:
https://mcp.orderly.network for API referenceIf you want to trade from the terminal or use the CLI:
npm install -g @orderly.network/cliorderly --help to see all commands--broker-id demo for testing, or get a custom broker ID at dex.orderly.network ($10, manual browser interaction required)If you're launching a white-label DEX:
npx @orderly.network/mcp-server init or connect to https://mcp.orderly.networkIf you're troubleshooting:
For testing:
POST /v1/faucet/usdc (testnet only)For a quick DEX: Fork the DEX Template, configure .env, and deploy. Uses pre-built components — fastest path.
For more control: Set up the MCP server — either connect to https://mcp.orderly.network (remote, no install) or install locally with npx @orderly.network/mcp-server init --client <your-client>. Then load SDK skills like orderly-sdk-react-hooks and orderly-sdk-dex-architecture to build with the hooks SDK.
Then ask: "How do I connect to Orderly Network?" or load orderly-sdk-wallet-connection.
https://mcp.orderly.network or installable locally via npxUse both for the best experience.
Use the Testnet environment:
https://testnet-api.orderly.orgwss://testnet-ws.orderly.org/wsPOST https://testnet-operator-evm.orderly.org/v1/faucet/usdcThe SDK handles authentication automatically. For API-only integration, load orderly-api-authentication for the complete auth flow.
Go to dex.orderly.network, select the "Custom API integration" option, and follow the steps. It costs $10. This requires manual browser interaction and cannot be done via CLI or agent. For testing and development, use --broker-id demo — no setup needed.