orderly-onboarding

Orderly Network 入门：全链永续合约基础设施、MCP 服务器、SDK 和 CLI 快速入门。在开始使用 Orderly 时使用（例如安装 Orderly MCP、设置 DEX 模板、集成 React SDK、使用 orderly CLI）。

18Star

9Fork

更新于 2026/7/14

获取 Skill 源代码

Orderly Network：智能体入门

Orderly 是一个基于订单簿的全链交易基础设施，为去中心化交易所提供永续合约流动性。本技能是您构建或学习 Orderly Network 的起点。

何时使用

首次接触 Orderly Network
为 Orderly 开发设置 AI 智能体工具
了解 Orderly 生态系统和产品
为您的任务找到合适的技能或资源
了解 AI 智能体可用的工具

什么是 Orderly Network

Orderly 是一个结合了订单簿交易基础设施和强大流动性层的平台，提供永续合约订单簿。与传统平台不同，Orderly 没有前端界面——它在生态系统的核心运行，为上层构建的项目提供基础服务。

主要特点：

全链 CLOB：共享中央限价订单簿，可从所有主流 EVM 链和 Solana 访问
后端基础设施：无官方前端；构建者在其上创建 DEX 和交易界面
链上结算：所有交易在链上结算，同时保持完全自托管
统一流动性：一个订单簿服务于所有集成的前端
永续合约：交易 BTC、ETH、SOL 等，最高 50 倍杠杆
无 Gas 交易：资金存入并激活交易密钥后无需 Gas 费
一键交易：每次会话生成新的交易密钥对，无需额外签名

主要用例：

用例	描述
构建者/DEX	使用即插即用 SDK 在 EVM 和 Solana 上创建自己的永续合约 DEX
永续聚合器	通过 API 或 SDK 直接访问 Orderly 的共享流动性
交易台	使用 API 进行 CEX 级别交易，低延迟订单簿
交易机器人	连接订单簿获取最优价格、止损/限价单、无 Gas 交易

关键优势

统一订单簿与流动性：通过单一交易基础设施访问所有主流链
快速开发：使用我们的 SDK 在几天内启动一个 DEX
即用流动性：由多个顶级做市商提供支持
收入分成：从您的平台产生的费用中获得分成
CEX 级别性能：低延迟撮合引擎，链上结算
自托管：您控制自己的资产和私钥
协作生态系统：加入蓬勃发展的构建者社区

架构

您的应用程序（DEX、机器人、钱包、聚合器）

Orderly 基础设施
- CLOB — 共享中央限价订单簿（跨所有链统一）
- 撮合引擎 — 低延迟订单撮合（CEX 级别性能）
- 金库 — 链上结算，自托管
- 风险管理 — 清算引擎和仓位监控
结算网络
- EVM：Arbitrum、Optimism、Base、Ethereum、Polygon、Mantle
- 非 EVM：Solana

快速开始：AI 智能体工具

要在 Orderly 上构建，安装 MCP 服务器以获得最佳开发体验。它提供 8 个强大的工具，用于文档搜索、SDK 模式、合约地址、工作流和 API 参考。

MCP 服务器（推荐）

MCP 服务器为 AI 助手提供对 Orderly 文档、代码模式和 API 参考的即时访问。

快速安装：

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

支持的客户端：

客户端	命令	配置文件
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`

手动配置：

如果自动设置不起作用，请将以下配置添加到您的 AI 客户端：

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"]

MCP 服务器提供的工具：

工具	描述
`search_orderly_docs`	搜索 Orderly 文档中的特定主题
`get_sdk_pattern`	获取 SDK v2 钩子和模式的代码示例
`get_contract_addresses`	查找任何链的智能合约地址
`explain_workflow`	常见任务的分步指南
`get_api_info`	REST API 和 WebSocket 端点文档
`get_indexer_api_info`	交易指标、事件、成交量统计
`get_component_guide`	React UI 组件构建指南
`get_orderly_one_api_info`	Orderly One 的 DEX 创建和管理 API

智能体技能

安装 Orderly 技能以增强您的 AI 智能体在 Orderly 上构建的程序性知识。

全局安装所有技能（推荐）：

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

本地安装所有技能：

npx skills add OrderlyNetwork/skills --all

安装特定技能：

# 列出可用技能
npx skills add OrderlyNetwork/skills --list

# 安装特定技能
npx skills add OrderlyNetwork/skills --skill orderly-trading-orders

# 安装多个技能
npx skills add OrderlyNetwork/skills --skill orderly-api-authentication --skill orderly-trading-orders

# 为特定智能体安装
npx skills add OrderlyNetwork/skills --all --agent claude-code -g

全局 vs 本地：

全局（-g）：所有项目可用，安装到用户目录
本地：项目特定，在仓库中创建 .skills/，可提交到版本控制

可用技能：

类别	技能	描述
API / 协议	`orderly-api-authentication`	双层认证：EIP-712（EVM）+ Ed25519（Solana）
	`orderly-trading-orders`	通过 REST API 或 SDK 下单、管理、取消订单
	`orderly-positions-tpsl`	监控仓位、止盈止损、杠杆、盈亏
	`orderly-websocket-streaming`	订单簿和成交的实时 WebSocket
	`orderly-deposit-withdraw`	代币充值、提现、跨链操作
SDK / React	`orderly-sdk-react-hooks`	所有 React SDK 钩子的参考
	`orderly-ui-components`	预构建的 React UI 组件
	`orderly-sdk-install-dependency`	安装 Orderly SDK 包
	`orderly-sdk-dex-architecture`	完整的 DEX 项目结构和设置
	`orderly-sdk-page-components`	预构建的页面组件
	`orderly-sdk-theming`	CSS 变量主题和自定义
	`orderly-sdk-trading-workflows`	端到端交易流程
平台	`orderly-sdk-wallet-connection`	EVM 和 Solana 的钱包集成
	`orderly-sdk-debugging`	调试/排查 SDK 错误
	`orderly-one-dex`	使用 Orderly One API 创建/管理自定义 DEX

面向构建者（SDK 和 DEX 开发）

使用 Orderly 的 React SDK v2 构建自定义交易界面。

最快入门方式

Fork DEX 模板，几分钟内即可获得一个可运行的 DEX。

将仓库 Fork 到您的 GitHub 账户
配置 .env 文件，设置您的 broker ID 和名称
使用 orderly-sdk-theming 自定义主题（CSS 变量和颜色令牌）
部署到您偏好的托管平台

该模板使用 components SDK——预构建的页面组件，开箱即用，自定义较少。如需完全控制单个组件，请使用 MCP 服务器并加载 SDK 技能（尤其是 orderly-sdk-react-hooks 和 orderly-sdk-ui-components）进行钩子级别开发。

核心 SDK 包：

# 完整 DEX 设置
npm install @orderly.network/react-app \
            @orderly.network/trading \
            @orderly.network/portfolio \
            @orderly.network/markets \
            @orderly.network/wallet-connector \
            @orderly.network/i18n

# 必需：EVM 钱包支持
npm install @web3-onboard/injected-wallets @web3-onboard/walletconnect

# 必需：Solana 钱包支持
npm install @solana/wallet-adapter-base @solana/wallet-adapter-wallets

可用的关键组件：

OrderEntry - 下单表单
Orderbook - 市场深度显示
PositionsView - 仓位管理表格
TradingPage - 完整交易页面
Portfolio - 用户投资组合仪表盘
ConnectWalletButton - 钱包连接 UI

Orderly One（白标 DEX）：

启动您自己品牌的永续合约 DEX，无需从头构建。Orderly One 提供交钥匙解决方案，包括：

自定义域名和品牌
支付毕业费后的费用收入分成
完整的交易基础设施
自定义主题

加载以下技能进行 SDK 开发：

orderly-sdk-install-dependency - 包安装指南
orderly-sdk-dex-architecture - 项目结构和提供者
orderly-sdk-wallet-connection - 钱包集成
orderly-sdk-trading-workflows - 完整交易流程
orderly-sdk-theming - 自定义指南

面向 API / 机器人开发者

直接集成 Orderly 的 REST API 和 WebSocket 流。

API 基础 URL：

网络	URL
主网	`https://api.orderly.org`
测试网	`https://testnet-api.orderly.org`

WebSocket URL：

网络	URL
主网	`wss://ws.orderly.org/ws`
测试网	`wss://testnet-ws.orderly.org/ws`

认证：

用于 API 签名的 Ed25519 密钥对生成
用于 EVM 账户的 EIP-712 钱包签名
用于 Solana 账户的 Ed25519 消息签名

交易对格式：

PERP_<TOKEN>_USDC

示例：PERP_ETH_USDC、PERP_BTC_USDC、PERP_SOL_USDC

关键端点：

POST /v1/order - 下单
GET /v1/positions - 获取仓位
GET /v1/orders - 获取订单
GET /v1/orderbook/{symbol} - 订单簿快照
GET /v1/public/futures - 市场信息

加载以下技能进行 API 开发：

orderly-api-authentication - 完整认证设置
orderly-trading-orders - 订单管理
orderly-positions-tpsl - 仓位管理
orderly-websocket-streaming - 实时数据

Orderly CLI

一个终端交易工具（@orderly.network/cli），封装了完整的 Orderly REST API。AI 安全：密钥存储在操作系统密钥链中，签名在内部完成，智能体仅看到结果。orderly --help 涵盖所有内容。

安装和快速入门（测试网）：

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

注意： 认证命令需要 --account（通过 auth-list 获取 ID）。十六进制 ID 必须用 shell 引号括起来。默认网络为测试网——生产环境请传递 --network mainnet。Linux 需要 libsecret。

Broker ID

demo — 用于测试、开发和个人使用。无需设置。
自定义 — 访问 dex.orderly.network，选择 "Custom API integration"。费用 $10，需要手动浏览器操作（无法通过 CLI 或智能体完成）。

支持的链

Orderly 支持多个 EVM 和非 EVM 链。要获取当前支持的网络列表及其链 ID、金库地址和 RPC 端点：

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

该端点返回 Orderly 当前支持的所有主网和测试网链，包括 Arbitrum、Optimism、Base、Ethereum、Polygon、Mantle、Solana、Sei、Avalanche、BSC、Abstract 等。

$ORDER 代币

$ORDER 代币是 Orderly 生态系统的核心：

最大供应量： 1,000,000,000 枚
质押： 质押 $ORDER 以赚取 VALOR 和协议收入分成
VALOR： 衡量质押仓位的不可转让指标；可兑换为 esORDER 奖励
收入分成： 协议净费用的 30% 分配给质押者
治理： 质押者参与协议治理决策
esORDER： 带有归属机制的奖励托管 ORDER

代币合约：

网络	地址
Ethereum (ERC20)	`0xABD4C63d2616A5201454168269031355f4764337`
EVM 链 (OFT)	`0x4E200fE2f3eFb977d5fd9c430A41531FB04d97B8`
Solana	`ABt79MkRXUsoHuV2CVQT32YMXQhTparKFjmidQxgiQ6E`

有关完整代币经济学详情，请访问：https://orderly.network/docs/introduction/tokenomics

关键链接

资源	URL	说明
文档	https://orderly.network/docs
SDK 仓库	https://github.com/orderlynetwork/js-sdk
DEX 模板	https://github.com/OrderlyNetwork/dex-template	最快启动方式，使用 components SDK
MCP 服务器 (npm)	https://www.npmjs.com/package/@orderly.network/mcp-server
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 仪表盘	https://dex.orderly.network
Orderly 应用	https://app.orderly.network
Discord	https://discord.gg/OrderlyNetwork
Twitter	https://twitter.com/OrderlyNetwork

常见问题

"我从哪里开始构建？"

快速 DEX：Fork DEX 模板，配置 .env，然后部署。使用预构建组件——最快路径。

更多控制：首先安装 MCP 服务器：npx @orderly.network/mcp-server init --client <your-client>，然后加载 SDK 技能，如 orderly-sdk-react-hooks 和 orderly-sdk-dex-architecture，使用钩子 SDK 构建。

然后询问：“如何连接到 Orderly Network？”或加载 orderly-sdk-wallet-connection。

"MCP 服务器和 Skills 有什么区别？"

MCP 服务器：AI 助手的运行时工具（文档搜索、模式查找、API 参考）
Skills：嵌入在上下文中的程序性知识（操作指南、代码示例、最佳实践）

两者结合使用可获得最佳体验。

"如何在没有真实资金的情况下测试？"

使用测试网环境：

API：https://testnet-api.orderly.org
WebSocket：wss://testnet-ws.orderly.org/ws
获取测试 USDC：POST https://testnet-operator-evm.orderly.org/v1/faucet/usdc

"我需要手动处理认证吗？"

SDK 自动处理认证。对于纯 API 集成，加载 orderly-api-authentication 以获取完整认证流程。

"如何获取自定义 broker ID？"

访问 dex.orderly.network，选择 "Custom API integration" 选项，然后按照步骤操作。费用 $10。这需要手动浏览器操作，无法通过 CLI 或智能体完成。对于测试和开发，使用 --broker-id demo——无需设置。

你可能还喜欢

skill-creator

385Kagent-workflows

Create, edit, audit, tidy, validate, or restructure AgentSkills and SKILL.md files.

steipete

获取

homelab-vlan-segmentation

238Kagent-workflows

Segmenting home networks into VLANs for IoT, guest, trusted, and server traffic using UniFi, pfSense/OPNsense, and MikroTik — including switch trunk config, firewall rules, and wireless SSID mapping.