Token 交易记录接口文档

接口信息

• 接口路径: /api/coin/trades
• 请求方法: GET
• 接口描述: 获取指定 Token 的交易记录列表，支持分页查询

请求参数

Query 参数

参数名	类型	必填	说明
coinType	string	是	Token 的 Coin Type，如 "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI"
limit	number	否	每页数量，默认值根据接口实现而定

请求示例

GET /api/coin/trades?coinType=0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI&limit=10

响应数据结构

响应格式

{
  "code": 200,
  "message": "OK",
  "result": {
    "data": [
      {
        "type": "buy",
        "txDigest": "FHFUqhxvTEHPEbU5EmPLWccnFYQRM5MM9ZXS6rep9EiF",
        "eventSeq": 9,
        "timestamp": 1764909625554,
        "sender": "0x1bd28ae3d9d31d6df035f5ab83eeb18ee8153a39261cec2fba22b5e1eb2ebfd1",
        "poolId": "0xfa54f1de53af9135aea64d31e8e4b543fc0b073a6c218f520f5b015d28951a0a",
        "coinChanges": [
          {
            "amount": "414905425226",
            "coinType": "0x549e8b69270defbfafd4f94e17ec44cdbdd99820b33bda2278dea3b9a32d3f55::cert::CERT",
            "balance": "414.905425",
            "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/vSUI.png/public",
            "symbol": "vSUI",
            "decimals": 9
          },
          {
            "amount": "438107185290",
            "coinType": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
            "balance": "438.107185",
            "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/sui-coin.svg/public",
            "symbol": "SUI",
            "decimals": 9
          }
        ],
        "price": "1.6410428985436992",
        "usdValue": "718.952685221123096576"
      }
    ],
    "nextPageCursor": "1764909621771"
  }
}

响应字段说明

result 对象字段

字段名	类型	必填	说明
data	array	是	交易记录列表数据
nextPageCursor	string	否	下一页游标，无下一页为空

data 数组项字段

字段名	类型	必填	说明
type	string	是	交易类型，"buy" 或 "sell"
txDigest	string	是	交易哈希
eventSeq	number	是	事件序号
timestamp	number	是	交易时间戳（毫秒）
sender	string	是	交易发起者地址
poolId	string	是	交易池 ID
coinChanges	array	是	涉及的代币变化列表
price	string	是	交易价格，字符串格式的数字
usdValue	string	是	交易 USD 价值，字符串格式的数字

coinChanges 数组项字段

字段名	类型	必填	说明
amount	string	是	代币数量（原始精度），字符串格式的数字
coinType	string	是	代币的 Coin Type，完整类型标识符
balance	string	是	代币余额（格式化后），字符串格式的数字
logo	string	否	代币图标 URL
symbol	string	是	代币符号，如 "SUI"、"vSUI"
decimals	number	是	代币精度（小数位数）

响应示例

{
  "code": 200,
  "message": "OK",
  "result": {
    "data": [
      {
        "type": "buy",
        "txDigest": "FHFUqhxvTEHPEbU5EmPLWccnFYQRM5MM9ZXS6rep9EiF",
        "eventSeq": 9,
        "timestamp": 1764909625554,
        "sender": "0x1bd28ae3d9d31d6df035f5ab83eeb18ee8153a39261cec2fba22b5e1eb2ebfd1",
        "poolId": "0xfa54f1de53af9135aea64d31e8e4b543fc0b073a6c218f520f5b015d28951a0a",
        "coinChanges": [
          {
            "amount": "414905425226",
            "coinType": "0x549e8b69270defbfafd4f94e17ec44cdbdd99820b33bda2278dea3b9a32d3f55::cert::CERT",
            "balance": "414.905425",
            "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/vSUI.png/public",
            "symbol": "vSUI",
            "decimals": 9
          },
          {
            "amount": "438107185290",
            "coinType": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
            "balance": "438.107185",
            "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/sui-coin.svg/public",
            "symbol": "SUI",
            "decimals": 9
          }
        ],
        "price": "1.6410428985436992",
        "usdValue": "718.952685221123096576"
      }
    ],
    "nextPageCursor": "1764909621771"
  }
}

注意事项

1. coinType 参数为必填项，需要传入完整的 Token Coin Type
2. limit 参数为可选，用于控制每页返回的记录数
3. type 字段值为 "buy" 表示买入交易，"sell" 表示卖出交易
4. timestamp 为时间戳（毫秒），前端需要转换为可读的时间格式
5. coinChanges 数组通常包含两个元素，分别表示交易中涉及的两种代币的变化
6. amount 为原始精度的代币数量，balance 为格式化后的余额，前端可根据需要选择使用
7. price 和 usdValue 为字符串格式的数字，前端需要根据需要进行格式化显示
8. nextPageCursor 用于分页查询，当存在时表示还有下一页，可通过该游标获取下一页数据
9. logo 字段可能为空或不存在，前端需要做兼容处理
10. 当 nextPageCursor 不存在或为空时，表示没有下一页数据