跳到导航
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+
梅文Maven 3.9+
座標com.sixmm.exchange.sdk:agent:0.3.0

GitHub 託管源代碼；它不會使這些座標可以從 Maven Central 解析。使用標記的本地安裝或您批准的工件存儲庫。

SDK 涵蓋什麼

類別設想SDK API描述
用戶綁定綁定用戶bind創建或獲取合作伙伴用戶和 6MM 平臺用戶之間的綁定
資產查詢查詢合作伙伴賬戶queryAccount查詢合作伙伴保證金或資金賬戶
資產查詢查詢用戶資產queryUserAssets查詢合約資產；使用 withFunding() 包括資金餘額
接送服務固定金額轉賬transfer將資金轉入或轉出 6MM
接送服務全部轉出transferAllOut將所有可提取的用戶餘額移回合作伙伴平臺
接送服務顛倒順序reverse當後端支持補償流時反轉成功的傳輸
接送服務查詢訂單queryOrder按合作伙伴訂單號查詢一張調撥訂單
接送服務列出訂單listOrders翻閱調撥單以進行調節
Webhook簽名驗證WebhookVerifier.verify驗證資金事件和強平預警的原始正文簽章；時間、歸屬及持久去重校驗由商戶程式碼處理。見 Webhook 事件與強平預警.
資金錢包資金轉移walletTransfer合作伙伴 ↔ 資助或資助 ↔ 合同；確認返回狀態
資金錢包資金轉移狀態queryWalletTransfer使用原始合作伙伴訂單號恢復資金操作
交易入場直接輸入URLcreateEntryUrl為重定向模式創建一次性 SSO URL
交易入場嵌入代幣createEmbedToken為 Trading Widget tokenProvider 模式創建一個短期令牌
永久數據當前永續訂單listCurrentPerpetualOrders查詢當前NORMAL或CONDITIONAL訂單
永久數據永久訂單歷史記錄listPerpetualOrderHistory查詢終端NORMAL或CONDITIONAL訂單
永久數據永續交易listPerpetualTrades查詢交易填充以獲取明確的公開玩家列表
永久數據目前的永久頭寸listCurrentPerpetualPositions查詢當前位置
永久數據永久持倉歷史記錄listPerpetualPositionHistory查詢已平倉位
永久數據永續賬本listPerpetualLedger查詢單個合約餘額變動記錄
法定貨幣參考利率列出支持的法定貨幣listSupportedFiatCurrencies列出當前可兌換為 USDT 的法定貨幣
法定貨幣參考利率查詢外匯參考匯率queryExchangeRates查詢所有或選定貨幣的每日法幣兌USDT參考比率
服務信息服務版本version查詢Agent服務版本信息

配置

之前從6MM獲取以下值 整合。

物品例子描述
baseUrlhttps://agent-api.6mm.com代理 API 基礎 URL，不帶尾部斜槓
agentCodeAGENT001合作伙伴代碼
apiSecretyour-api-secretAPI簽名秘密。僅將其保留在後端
defaultCurrencyUSDT默認貨幣，通常為 USDT
webhookUrlhttps://partner.example.com/6mm/webhook商家回呼URL由所有四種事件類型共享；由正文 event 調度，沒有單獨的警告 URL。

製作建議：

  • 對代理 API 和 webhook 端點使用 HTTPS。
  • 將 apiSecret 存儲在秘密管理器、配置中心或環境變量中。
  • 保持服務器時間同步，最好與 NTP 同步。
  • 保留所有合作伙伴訂單號並保持其全球唯一性。
  • 切勿將 apiSecret 發送到瀏覽器、應用程序、小程序或前端源代碼。

自動簽名字段

對於簽名代理 API 調用，SDK 自動注入：

場地來源描述
agentCodeAgentClientConfig.agentCode合作伙伴代碼
timestamp當前 UTC Unix 時間戳秒數
nonce安全隨機生成器重放保護
signHMAC-SHA256請求籤名
currencydefaultCurrency當轉賬/賬戶請求省略貨幣時填寫

簽名規則：

  1. 排除sign。
  2. 排除空值。
  3. 按 ASCII 順序對鍵進行排序。
  4. 作為 k=v&k2=v2 加入。
  5. 使用 apiSecret 計算 HMAC-SHA256 十六進制。

在加入簽名有效負載之前，數組值被序列化為緊湊的 JSON。例如，platformUserIds 標記為 ["1188041528"]，在 k=v 有效負載中給出 platformUserIds=["1188041528"]。保留數組元素順序、雙引號和字符串 ID；請勿插入格式空格或使用 Java List.toString()（例如 [1188041528]）。 SDK 自動處理此序列化。

正常的業務代碼不應該計算簽名或者手動設置 agentCode、timestamp、nonce 或 sign。

來源及相關指南