跳到导航
Agent Java SDK

Agent Java SDK

Agent Java SDK: Agent Java SDK v0.3.0 接入、示例、参数及响应说明。

以 Markdown 格式查看

本文对应 Agent Java SDK v0.3.0、Java 8+ 与该标签的公开契约。示例在合作方后端运行；先按快速开始初始化 client。

文档核对基线：SDK v0.3.0，提交 54aa3c1。Webhook 接收约定另同步至 WEBHOOKS.md 提交 fa6c7b6；此次仅更新文档，没有发布包含预警辅助方法的新 SDK 制品。

版本与安装

项目值
稳定源码标签v0.3.0
JavaJava 8+
MavenMaven 3.9+
坐标com.sixmm.exchange.sdk:agent:0.3.0

GitHub 托管源码，不代表这些坐标已发布到 Maven Central。使用指定标签本地安装，或使用已核对的制品仓库。

典型接入场景

分类场景SDK 方法说明
用户绑定绑定用户bind为代理商用户创建或获取 6MM 平台用户绑定关系
资产查询查询代理商资金queryAccount查询代理商保证金账户
资产查询查询用户资产queryUserAssets查询合约资产；withFunding() 可同时查询 Funding 余额
资金划转固定金额划转transfer支持转入平台和转出平台
资金划转一键全部划出transferAllOut把用户在 6MM 侧可划出的余额划回代理商平台
资金划转冲正reverse对已成功的划转订单发起反向处理
资金划转查询订单queryOrder按代理商订单号查询单笔划转订单
资金划转查询订单列表listOrders分页查询划转订单
Webhook签名验证WebhookVerifier.verify验证资金事件和强平预警的原始正文签名；时间、归属校验和持久去重由商户处理，见 Webhook 事件与强平预警
Funding 钱包Funding 划转walletTransfer商户与 Funding 增减，或 Funding 与 Contract 互转
Funding 钱包Funding 查单queryWalletTransfer按原商户单号恢复 Funding 操作结果
交易入口直接跳转入口createEntryUrl生成一次性 SSO 跳转链接
交易入口内嵌交易 tokencreateEmbedToken给 Trading Widget tokenProvider 模式签发短期 token
合约数据当前合约委托listCurrentPerpetualOrders查询普通或条件委托当前状态
合约数据合约委托历史listPerpetualOrderHistory查询普通或条件委托终态
合约数据合约成交明细listPerpetualTrades按显式公开玩家列表查询成交
合约数据当前合约持仓listCurrentPerpetualPositions查询当前持仓
合约数据合约持仓历史listPerpetualPositionHistory查询已结束持仓
合约数据合约账变明细listPerpetualLedger查询逐条合约资金账变
法币汇率查询支持法币listSupportedFiatCurrencies查询当前支持换算为 USDT 的法币列表
法币汇率查询参考汇率queryExchangeRates查询全部或指定法币兑 USDT 的日级参考比例
服务信息服务版本version查询 agent 服务版本信息

接入前准备

请先从 6MM 获取以下配置：

配置项示例说明
baseUrlhttps://agent-api.6mm.comAgent API 服务地址，不带末尾 /
agentCodeAGENT001代理商编码
apiSecretyour-api-secretAPI 签名密钥，只能保存在后端
defaultCurrencyUSDT默认币种，通常为 USDT
webhookUrlhttps://partner.example.com/6mm/webhook商户配置的回调地址；四类事件共用，按正文 event 分流，无需为预警另配 URL

生产环境建议：

  • baseUrl 使用 HTTPS。
  • apiSecret 存放在配置中心或密钥管理系统，不写死到代码仓库。
  • 服务器时间保持同步，建议使用 NTP。
  • 所有订单号使用代理商侧全局唯一 ID，并持久化保存。

SDK 自动处理的字段

调用需要签名的 Agent API 时，SDK 会自动补充：

字段来源说明
agentCodeAgentClientConfig.agentCode代理商编码
timestamp当前 UTC 秒级时间戳Unix 时间戳，单位：秒
nonce安全随机生成防重放随机串
signHMAC-SHA256请求签名
currencydefaultCurrency仅在划转、全部划出、代理商账户查询中空值时自动补齐

签名规则由 SDK 内部实现。规则是：排除 sign，空值不参与，按 key ASCII 升序排序，拼接为 k=v&k2=v2，再使用 apiSecret 计算 HMAC-SHA256 hex。

数组值参与签名前先序列化为紧凑 JSON。例如，platformUserIds 使用 ["1188041528"]，签名原文中的键值片段为 platformUserIds=["1188041528"]。保留数组元素顺序、双引号和字符串 ID，不插入格式化空格，不使用 Java List.toString()（例如 [1188041528]）。SDK 自动完成该序列化。

正常接入时不要自己计算签名，也不要手动设置 agentCode、timestamp、nonce、sign。

来源与相关指南