文档

了解如何在 DEX 上交易永续、现货，参与质押、金库与激励。

简介

DEX 是一个去中心化的永续合约与现货交易所，由 BFT 共识的验证者网络驱动，订单撮合、清算、资金费、质押与代币经济均以确定性方式记录上链，可在区块浏览器中查询每一笔交易。当前运行于测试网。

快速开始

连接钱包：点击右上角「连接钱包」，支持浏览器注入式钱包与 WalletConnect。
充值：通过「资金」入口从 USDC 充入抵押品（见充值与提现）。
交易：选择市场、设定杠杆与数量，下限价或市价单。
管理：在投资组合查看权益、持仓与历史。

永续合约

永续合约是没有到期日的衍生品，通过资金费机制使合约价格锚定现货指数价。支持限价单（Limit）、市价单（Market）、只减仓（Reduce-Only）、止盈止损（TP/SL）、条件单与 TWAP 拆单。

标记价：用于计算未实现盈亏与强平，抗操纵。
强平：当账户维持保证金不足时触发，按标记价清算。
全仓 / 逐仓：可选全仓共享保证金，或逐仓隔离单个市场风险。

保证金与杠杆

开仓时选定杠杆（不同市场上限不同，最高可达 50×）。保证金 = 名义价值 ÷ 杠杆。杠杆越高，强平价越接近开仓价，风险越大。维持保证金率不足会触发强平，请合理控制仓位。

资金费率

资金费每 1 小时结算一次。正费率时多头向空头支付，负费率时反之。费率随合约相对指数的溢价/折价动态变化。各市场实时费率与年化见资金费率比较。

现货交易

现货市场支持即时买卖，如 DEX/USDC。现货余额与永续抵押品相互独立，可在DEX 代币页管理与划转。

质押 (PoS)

持有 DEX 代币可质押给验证者以保障网络安全并获得出块奖励。质押份额决定验证者投票权。奖励从排放储备按质押份额发放，由 keeper 周期分发。质押/解质押入口见质押。

金库

金库允许你把资金委托给操盘策略（如 HLP 协议金库），按份额净值分享盈亏。也可创建自建金库、设定利润分成，吸引 LP 存入。入口见交易页「金库」。

子账户

在主账户下创建独立子账户，隔离不同策略的保证金与持仓。资金可在主账户与子账户间划转，需主钱包签名，总量守恒并记录上链。

充值与提现

通过桥从 USDC 充入抵押品即可交易。提现将抵押品经桥提回，可能有最小额度、手续费与争议期。当前网络与桥参数见测试网页。

API

DEX 提供 REST 与 Hyperliquid 兼容的 /info、/exchange 接口，便于程序化交易与数据接入。完整接口说明见 API 文档。项目方自建接入(市场数据 / 签名下单 / 注册市场)见下方自建接入 · Builder API。

自建接入 · Builder API

面向项目方与开发者,DEXLIQUID 提供两种接入模式:模式 A——在主链上注册市场、通过 REST/MCP 接入并嵌入白标前端;模式 B——私有化部署整套开源栈,运行你自己的主权链。产品定位见为 Builder 而生。以下为程序化接入所需的核心接口,所有金额/数量均为 Fixed 十进制字符串(最多 8 位小数),下单市场 market 使用引擎整数 ID(见 /api/perpmarkets 的 engine 字段)。

1 · 市场数据(公开只读)

无需鉴权,直接 GET。

GET /api/perpmarkets — 永续市场列表(含 id 币名、engine 下单 ID、mark、max_leverage)
GET /api/perp/:coin — 单币行情 + 盘口(标记价、指数、资金费、买卖档、最近成交)
GET /api/klines/:coin?interval=1m&limit=300 — K 线,interval 支持 1m…1w
GET /api/book/:market?levels=15 — 指定市场(引擎 ID)的订单簿深度
GET /api/account/:account · /api/orders/:account · /api/fills/:account — 账户权益/持仓、挂单、成交
GET /api/leverage/:account — 各市场杠杆设置

2 · 会话鉴权

需要鉴权的写接口用 Authorization: Bearer <token>。签名下单(/api/tx/submit)本身即授权,无需 Bearer。

# 1) 取 nonce  → 2) 钱包 personal_sign(message) → 3) 换 token
GET  /api/auth/nonce                     → { nonce, message }
POST /api/auth/verify  { nonce, signature } → { token, account }

3 · 签名下单(非托管)

生产环境订单以 EIP-712 由本地私钥(或网页授权的 agent 子密钥)签名,提交到 /api/tx/submit,网关永不接触主私钥。签名工具见 /vendor/crypto/dex-sign.js(window.DexSign)。

// 一次性:授权 agent 子密钥(主钱包 signTypedData)
POST /api/tx/submit {
  account, nonce,
  command: { ApproveAgent: { user, agent, name:"my-bot", valid_until_ms:0 } },
  signature   // approveAgentTypedData 主钱包签名
}

// 设杠杆(可选,开仓前)
POST /api/leverage { account, market: 0, leverage: 20 }   // Bearer

// 下单:市价做多 0.01 BTC
const cmd = DexSign.cmdPlace({ account, market:0, side:"Bid",
  price:"1000000000", qty:"0.01", tif:"Ioc", reduceOnly:false });
const { nonce } = await GET(`/api/tx/nonce/${account}`);
const digest = DexSign.l1Digest(account, nonce, cmd);
const signature = await DexSign.signDigest(agentPriv, digest);
POST /api/tx/submit { account, nonce, command: cmd, signature }
  → { ok:true, events:[…], signed:true }

side:"Bid" 买/多 · "Ask" 卖/空;市价用极端价 + tif:"Ioc"(买 "1000000000"、卖 "0.00000001")
tif:Gtc / Ioc / Fok / PostOnly;reduce_only 只减仓
撤单 DexSign.cmdCancel、条件单/TWAP 等命令同样经 /api/tx/submit 提交

4 · 注册市场 & 私有化部署

注册市场(模式 A):质押 $DEX 后发起链上 RegisterMarket 交易,将标的登记为一等链上市场,并配置杠杆、保证金、费率与品牌;手续费链上自动分账。开通自助注册请联系工程团队。
私有化部署(模式 B):获取完整开源 Rust 栈(BFT L1 + CLOB + 清算 + 预言机 + HLP + 桥 + 前端),运行独立验证者集与自有代币,可复现构建、逐块可核验。商业授权与工程支持请联系我们。

AI Agent 接入 (MCP)

DEX 支持 Model Context Protocol，可把 Claude / Cursor 等 AI 客户端直接接到本链：用自然语言查行情、看持仓、下单、平仓、挂止盈止损与 TWAP。私钥只在你本机，订单本地按 EIP-712 签名后逐块可验证上链，网关永不接触私钥。

在 ~/.cursor/mcp.json（或 Claude Desktop 配置）加入：

{
  "mcpServers": {
    "dexliquid": {
      "command": "npx",
      "args": ["-y", "dexliquid-mcp"],
      "env": { "DEX_PRIVATE_KEY": "0x…", "DEX_MAX_NOTIONAL": "5000" }
    }
  }
}

只读模式：去掉 DEX_PRIVATE_KEY 或设 DEX_MCP_READONLY=1，只允许查询。
额度护栏：DEX_MAX_NOTIONAL 限制单笔最大名义。
更稳妥：用网页端授权的 agent 子密钥（可随时吊销）+ DEX_ACCOUNT 指向主账户。

面向项目方/开发者的定位与用法见为 Builder 而生。

文档

简介