API 总览 (API Overview)

Version: v1.0 Last Updated: 2026-01-06

服务 URL

环境	REST API	WebSocket
主网	https://api.axblade.com/api/v1	wss://api.axblade.com/ws
测试网	https://api.8a27.xyz/api/v1	wss://api.8a27.xyz/ws
本地开发	http://localhost:8080/api/v1	ws://localhost:8080/ws

认证

AXBlade 使用 EIP-712 签名认证保护私有端点。

EIP-712 Domain 配置

const domain = {
  name: "AXBlade",
  version: "1",
  chainId: 421614,  // Arbitrum Sepolia
  verifyingContract: "0xFDe43f8e6e082975d246844DEF4fE8E704403d43"
};

认证流程

1. GET /auth/nonce/:address - 获取 nonce 和 typed data
2. 使用钱包对 typed data 签名
3. POST /auth/login - 提交签名，获取 JWT token
4. 使用 Authorization: Bearer <token> header 访问受保护端点

---

API 端点概览

公开端点 (无需认证)

认证

方法	端点	描述
GET	/auth/nonce/:address	获取登录 nonce
POST	/auth/login	EIP-712 签名登录

市场数据

方法	端点	描述
GET	/markets	获取所有市场
GET	/markets/:symbol/orderbook	获取订单簿
GET	/markets/:symbol/trades	获取最近成交
GET	/markets/:symbol/ticker	获取 24h 行情
GET	/markets/:symbol/price	获取当前价格
GET	/markets/:symbol/candles	获取 K 线数据
GET	/markets/:symbol/candles/latest	获取最新 K 线

外部市场 (Hyperliquid 代理)

方法	端点	描述
GET	/external/markets	外部市场列表
GET	/external/markets/:symbol/orderbook	外部订单簿
GET	/external/markets/:symbol/trades	外部成交
GET	/external/markets/:symbol/ticker	外部行情
GET	/external/markets/:symbol/candles	外部 K 线

资金费率

方法	端点	描述
GET	/funding-rates	获取所有资金费率
GET	/funding-rates/:symbol	获取指定币对资金费率
GET	/funding-rates/:symbol/history	资金费率历史

清算 (公开)

方法	端点	描述
GET	/liquidations/:symbol	市场清算
GET	/liquidations/:symbol/config	清算配置
GET	/insurance-fund/:symbol	保险基金状态

ADL (自动减仓)

方法	端点	描述
GET	/adl/:symbol/rankings	ADL 排名
GET	/adl/:symbol/events	ADL 事件
GET	/adl/:symbol/config	ADL 配置

推荐系统 (公开)

方法	端点	描述
GET	/referral/on-chain/user-rebate/:address	链上返佣信息
GET	/referral/on-chain/referral-info/:address	推荐关系
GET	/referral/on-chain/claimed/:address	已领取金额
GET	/referral/on-chain/operator-status	运营商状态

---

受保护端点 (需要认证)

账户

方法	端点	描述
GET	/account/profile	用户资料
GET	/account/balances	账户余额
GET	/account/positions	所有仓位
GET	/account/orders	所有订单
GET	/account/trades	成交历史

订单

方法	端点	描述
POST	/orders	创建订单
GET	/orders/:order_id	获取订单详情
DELETE	/orders/:order_id	取消订单
POST	/orders/batch	批量取消订单

仓位

方法	端点	描述
GET	/positions	仓位列表
POST	/positions	开仓
GET	/positions/:id	仓位详情
POST	/positions/:id/close	平仓
POST	/positions/:id/collateral/add	追加保证金
POST	/positions/:id/collateral/remove	减少保证金
GET	/positions/:id/liquidation	检查清算
POST	/positions/:id/tp-sl	设置止盈止损
GET	/positions/:id/tp-sl	获取止盈止损

条件单

方法	端点	描述
POST	/trigger-orders	创建条件单
GET	/trigger-orders	条件单列表
GET	/trigger-orders/executions	执行历史
GET	/trigger-orders/:order_id	条件单详情
DELETE	/trigger-orders/:order_id	取消条件单
GET	/trigger-orders/:symbol/stats	用户统计

充值提现

方法	端点	描述
POST	/deposit/prepare	准备充值
GET	/deposit/history	充值历史
POST	/withdraw/request	请求提现
GET	/withdraw/history	提现历史
GET	/withdraw/:id	提现详情
DELETE	/withdraw/:id/cancel	取消提现
POST	/withdraw/:id/confirm	确认提现

推荐系统 (受保护)

方法	端点	描述
POST	/referral/codes	创建推荐码
POST	/referral/bind	绑定推荐码
POST	/referral/unbind	解绑推荐码
GET	/referral/status	推荐状态
GET	/referral/logs	推荐日志
GET	/referral/dashboard	推荐仪表板
POST	/referral/claim	领取收益
POST	/referral/on-chain/claim-signature	获取领取签名

资金与清算 (用户)

方法	端点	描述
GET	/funding/settlements	用户资金结算
GET	/liquidations/history	用户清算历史
GET	/adl/history	用户 ADL 历史
GET	/adl/:symbol/stats	用户 ADL 统计

---

内部端点 (仅开发)

方法	端点	描述
POST	/internal/trade	创建内部交易
POST	/internal/trades/batch	批量创建交易
POST	/internal/orderbook	设置订单簿
DELETE	/internal/klines/clear	清除 K 线
POST	/internal/klines/import	导入 K 线
GET	/internal/klines/repair	修复 K 线
POST	/internal/virtual/order	创建虚拟订单
POST	/internal/virtual/orders/batch	批量虚拟订单
POST	/internal/virtual/trade	创建虚拟交易
POST	/internal/virtual/trades/batch	批量虚拟交易

---

管理端点 (需要 API Key)

方法	端点	描述
GET	/admin/stats/trade-volume	交易量统计

---

智能合约地址

Arbitrum Sepolia (测试网)

合约	地址
AXBladeVault	0xFDe43f8e6e082975d246844DEF4fE8E704403d43
USDT	0x572E474C3Cf364D085760784F938A1Aa397a8B9b
ReferralRebate	0xaF486e11c824389E4Ab3ced7608ac3Bd43c176B8
ReferralStorage	0x984BC1C4Aa3995F9B78BA54372a10d3088C249D5

Chain ID: 421614 RPC: https://sepolia-rollup.arbitrum.io/rpc Explorer: https://sepolia.arbiscan.io

---

错误码

错误码	描述
INVALID_SIGNATURE	EIP-712 签名验证失败
TIMESTAMP_EXPIRED	签名时间戳过期 (5分钟有效期)
INSUFFICIENT_BALANCE	可用余额不足
POSITION_NOT_FOUND	仓位不存在
ORDER_NOT_FOUND	订单不存在
INVALID_AMOUNT	无效金额参数
MARKET_NOT_FOUND	交易对不存在
UNAUTHORIZED	JWT token 无效或过期

---

频率限制

端点类型	限制
公开接口	100 请求/分钟
私有接口	60 请求/分钟
订单接口	30 请求/分钟
WebSocket	10 订阅/连接

---

相关文档

• 交易 API - 交易接口详情
• WebSocket API - WebSocket 订阅