orderly-onboarding

Orderly Network 入門：全鏈永續合約基礎設施、MCP 伺服器、SDK 與 CLI 快速入門。當你開始使用 Orderly 時使用（例如安裝 Orderly MCP、設定 DEX 範本、整合 React SDK、使用 orderly CLI）。

18星標

9分支

更新於 2026/7/14

獲取技能源代碼

Orderly Network：AI 代理入門

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 等級效能）
- Vault — 鏈上結算，自託管
- 風險管理 — 清算引擎與部位監控
結算網路
- 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 hooks 與模式的程式碼範例
`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）：跨所有專案可用，安裝到使用者目錄
本地：專案專屬，在 repo 中建立 .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 hooks 參考
	`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 變數與色彩 token）
部署到你偏好的託管平台

此範本使用 components SDK——預建頁面元件，開箱即用，自訂較少。若需完全控制個別元件，請使用 MCP 伺服器並載入 SDK 技能（特別是 orderly-sdk-react-hooks 與 orderly-sdk-ui-components）進行 hooks 層級開發。

核心 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 安全：金鑰儲存在 OS 鑰匙圈，簽章在內部處理，代理只看到結果。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、Vault 地址與 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 App	https://app.orderly.network
Discord	https://discord.gg/OrderlyNetwork
Twitter	https://twitter.com/OrderlyNetwork

建議下一步

如果你正在建置 DEX：

Fork DEX 範本 以最快速度開始
安裝 MCP 伺服器：npx @orderly.network/mcp-server init
在 .env 中設定你的 broker 設定並自訂主題
如需更多控制，載入 orderly-sdk-install-dependency 與 orderly-sdk-dex-architecture 以從頭建置
使用 orderly-sdk-wallet-connection 設定錢包連線

如果你正在建置交易機器人或 API 整合：

先載入 orderly-api-authentication
安裝 MCP 伺服器以取得 API 參考
載入 orderly-trading-orders 與 orderly-websocket-streaming

如果你想從終端交易或使用 CLI：

安裝 CLI：npm install -g @orderly.network/cli
執行 orderly --help 查看所有指令
遵循測試網快速入門（6 個指令，請見上方 Orderly CLI 章節）
測試使用 --broker-id demo，或前往 dex.orderly.network 取得自訂 broker ID（$10，需要手動瀏覽器操作）

如果你正在啟動白標 DEX：

安裝 MCP 伺服器以取得 Orderly One API 工具：npx @orderly.network/mcp-server init
載入 orderly-one-dex 技能以進行 DEX 建立與管理工作流程
載入 orderly-sdk-theming 技能以了解 API 更新的主題結構

如果你正在除錯：

載入 orderly-sdk-debugging
使用 MCP 伺服器搜尋文件

測試相關：

開發時使用測試網環境
從水龍頭請求測試網 USDC：POST /v1/faucet/usdc（僅測試網）
每個帳戶最多可使用水龍頭 3 次

常見問題

「我該從哪裡開始建置？」

快速 DEX：Fork DEX 範本，設定 .env，然後部署。使用預建元件——最快路徑。

更多控制：先安裝 MCP 伺服器：npx @orderly.network/mcp-server init --client <your-client>，然後載入 SDK 技能如 orderly-sdk-react-hooks 與 orderly-sdk-dex-architecture 以使用 hooks 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——無需設定。

您可能也喜歡

video-editing

230Kagent-workflows

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

affaan-m

獲取

executing-plans

231Kagent-workflows

當您有書面的實作計劃要在獨立的對話階段中執行，並包含審查檢查點時使用

obra

獲取

ponytail-help

84Kagent-workflows

Quick-reference card for all ponytail modes, skills, and commands. One-shot display, not a persistent mode. Trigger: /ponytail-help, "ponytail help", "what ponytail commands", "how do I use ponytail".

dietrichgebert

獲取

繼續探索

瀏覽 agent-workflows 熱門 Skills 最近更新