交易对列表接口文档

接口信息

• 接口路径: /api/pairs
• 请求方法: GET
• 接口描述: 获取所有交易对列表，包含交易对基本信息、价格、交易量、TVL 等数据。接口不需要传参，直接返回全部交易对数据。

请求示例

GET /api/pairs

响应数据结构

响应格式

{
  "code": 0,
  "msg": "success",
  "data": {
    "pair_list": [
      {
        "id": 1,
        "poolAddress": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "base": {
          "coinType": "0x83556891f4a0f233ce7b05cfe7f957d4020492a34f5405b2cb9377d060bef4bf::bitcoin::BTC",
          "symbol": "BTC",
          "name": "Bitcoin",
          "decimals": 8,
          "logoURI": "https://statics.noodles.fi/logo/btc.png"
        },
        "quote": {
          "coinType": "0x83556891f4a0f233ce7b05cfe7f957d4020492a34f5405b2cb9377d060bef4bf::tether::USDT",
          "symbol": "USDT",
          "name": "Tether USD",
          "decimals": 8,
          "logoURI": "https://statics.noodles.fi/logo/usdt.png"
        },
        "feePct": "0.01%",
        "tvlUsd": 200000000,
        "vol24hUsd": 200210000,
        "vol7dUsd": 2000000000,
        "change24h": 2.45,
        "priceUsd": 120000.0
      }
    ]
  }
}

响应字段说明

data 对象字段

字段名	类型	必填	说明
pair_list	array	是	交易对列表

pair_list 数组项字段

交易对基础信息

字段名	类型	必填	说明
id	number	是	交易对 ID，用于排序和标识
poolAddress	string	是	Pool 池子地址，Aptos 链上的完整地址
base	object	是	基础 Token 信息
quote	object	是	计价 Token 信息
feePct	string	是	手续费百分比，如 "0.01%"、"0.05%"

base/quote 对象字段（Token 信息）

字段名	类型	必填	说明
coinType	string	是	Token 的 Coin Type，完整类型标识符
symbol	string	是	Token 符号，如 "BTC"、"USDT"
name	string	是	Token 名称，如 "Bitcoin"
decimals	number	是	Token 精度（小数位数）
logoURI	string	否	Token 图标 URL

交易对市场数据

字段名	类型	必填	说明
tvlUsd	number	是	总锁定价值（Total Value Locked），美元
vol24hUsd	number	是	24 小时交易量，美元
vol7dUsd	number	是	7 天交易量，美元
change24h	number	是	24 小时价格变化百分比，正数表示上涨
priceUsd	number	是	当前价格（以 quote token 计价），美元

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "pair_list": [
      {
        "id": 1,
        "poolAddress": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "base": {
          "coinType": "0x83556891f4a0f233ce7b05cfe7f957d4020492a34f5405b2cb9377d060bef4bf::bitcoin::BTC",
          "symbol": "BTC",
          "name": "Bitcoin",
          "decimals": 8,
          "logoURI": "https://statics.noodles.fi/logo/btc.png"
        },
        "quote": {
          "coinType": "0x83556891f4a0f233ce7b05cfe7f957d4020492a34f5405b2cb9377d060bef4bf::tether::USDT",
          "symbol": "USDT",
          "name": "Tether USD",
          "decimals": 8,
          "logoURI": "https://statics.noodles.fi/logo/usdt.png"
        },
        "feePct": "0.01%",
        "tvlUsd": 200000000,
        "vol24hUsd": 200210000,
        "vol7dUsd": 2000000000,
        "change24h": 2.45,
        "priceUsd": 120000.0
      },
      {
        "id": 2,
        "poolAddress": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
        "base": {
          "coinType": "0x1::aptos_coin::AptosCoin",
          "symbol": "APT",
          "name": "Aptos",
          "decimals": 8,
          "logoURI": "https://statics.noodles.fi/logo/apt.png"
        },
        "quote": {
          "coinType": "0x83556891f4a0f233ce7b05cfe7f957d4020492a34f5405b2cb9377d060bef4bf::usdc::USDC",
          "symbol": "USDC",
          "name": "USD Coin",
          "decimals": 8,
          "logoURI": "https://statics.noodles.fi/logo/usdc.png"
        },
        "feePct": "0.05%",
        "tvlUsd": 12560000,
        "vol24hUsd": 860000,
        "vol7dUsd": 5600000,
        "change24h": -1.23,
        "priceUsd": 2.2912
      }
    ]
  }
}

注意事项

1. 接口不需要传参，直接返回所有交易对数据，不分页
2. 响应格式参照 Cetus API 标准：code 为 0 表示成功，msg 为状态消息
3. 数据包装在 data.pair_list 数组中
4. tvlUsd、vol24hUsd、vol7dUsd、priceUsd 为数值类型，前端需要根据需要进行格式化显示
5. change24h 为数值类型，正数表示上涨，负数表示下跌，前端需要根据正负值显示不同的颜色和图标
6. poolAddress 为 Aptos 链上的完整地址，长度为 64 个字符（32 字节的十六进制表示）
7. feePct 为字符串格式，包含百分号，如 "0.01%"、"0.05%"
8. base 和 quote 对象中的 logoURI 为可选字段，可能为 null 或空字符串，前端需要做兼容处理
9. 搜索、排序等功能由前端本地实现
10. 可选字段可能为 null 或不存在，前端需要做兼容处理