Orderly Network：Orderly One DEX

Orderly One 是一个白标 DEX 平台。用户配置 DEX（名称、品牌标识、支持链），API 会 Fork 一个 GitHub 模板仓库，并通过 GitHub Actions 自动部署至 GitHub Pages。完成“毕业”流程的 DEX 可获得手续费分成。

适用场景

• 构建自定义永续合约 DEX
• 管理 DEX 的部署、域名或主题样式
• 处理“毕业”流程以启用手续费共享

API 基础 URL

API 分类

使用 get_orderly_one_api_info MCP 工具获取全部端点的详细信息。

创建 / 更新 DEX

POST /api/dex（创建）与 PUT /api/dex/{id}（更新）均采用 multipart/form-data 编码格式。

必填字段

可选字段

链支持（Chains）：

品牌标识（Branding，文件上传）：

主题样式（Theming）：

社交链接（Social）：

认证与钱包（Auth/Wallet）：

网络环境（Network）：

交易功能（Trading）：

菜单配置（Menus）：

SEO 设置（SEO）：

其他设置（Other）：

响应结果

创建成功（201）： { id, brokerId, brokerName, repoUrl, userId, createdAt }

更新成功（200）： 返回完整的 DEX 对象（含全部字段）

核心工作流

认证流程

1. 向 POST /api/auth/nonce 提交 { address } → 获取待签名消息
2. 签名内容："Sign this message to authenticate with Orderly One: {nonce}"
3. 向 POST /api/auth/verify 提交 { address, signature } → 获取 JWT Token
4. 后续所有请求均需携带请求头：Authorization: Bearer {token}

创建 DEX 流程

1. 按上述字段组装 multipart/form-data 请求体
2. 调用 POST /api/dex → 返回 { id, brokerId, repoUrl }
3. 轮询 GET /api/dex/{id}/workflow-status，直至响应中 conclusion: "success"

毕业流程（手续费共享）

1. 调用 GET /api/graduation/fee-options → 获取 USDC/ORDER 支付金额及 receiverAddress
2. 在 Ethereum、Arbitrum 或 Base 网络上将对应代币转账至 receiverAddress
3. 调用 POST /api/graduation/verify-tx，提交参数：{ txHash, chain, chainId, chainType: "EVM", brokerId, makerFee, takerFee, rwaMakerFee, rwaTakerFee, paymentType } → 创建 broker ID

broker ID 创建完成后，需完成管理员钱包注册：

EVM 钱包： 第 4 步：调用 Orderly Network API 完成注册：

• GET https://api.orderly.org/v1/registration_nonce
• 使用 EIP-712 标准对以下数据签名：{ brokerId, chainId, timestamp, registrationNonce }
• POST https://api.orderly.org/v1/register_account，提交参数：{ message, signature, userAddress, chainType: "EVM" }

5. 调用 POST /api/graduation/finalize-admin-wallet（请求体为空）

Solana 钱包： 第 4 步：调用 Orderly Network API 完成注册：

• GET https://api.orderly.org/v1/registration_nonce
• 使用 Solana 钱包对以下消息签名：{ brokerId, chainId: 900900900, timestamp, registrationNonce }
• POST https://api.orderly.org/v1/register_account，提交参数：{ message, signature, userAddress, chainType: "SOL" }

5. 调用 POST /api/graduation/finalize-admin-wallet（请求体为空）

EVM 多签钱包 / Gnosis Safe： 第 4 步：在 Safe 钱包中使用 Transaction Builder 创建批量交易：

• 目标地址（To）： Orderly Vault 合约（按链区分）
• 方法（Method）： delegateSigner
• 调用数据（Data）： [keccak256(brokerId), userAddress]

5. 在 Safe 钱包中执行该批量交易（需满足签名人数要求）
6. 调用 POST /api/graduation/finalize-admin-wallet，提交参数：{ multisigAddress, multisigChainId }

Orderly MCP

本技能依赖 Orderly MCP 服务。若尚未安装，请参考 orderly-onboarding 技能完成初始化配置。

工具： get_orderly_one_api_info

• { endpoint: "/api/dex" } —— 查询指定端点详情
• { category: "graduation" } —— 查询某分类下全部端点
• {} —— 获取完整 API 概览

常见问题

相关技能

• orderly-onboarding —— 账户初始化配置
• orderly-trading-orders —— 交易订单功能