Coinfair 技术文档

Appearance

Token 列表接口文档 ​

接口信息 ​

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

请求示例 ​

bash
GET /api/tokens

响应数据结构 ​

响应格式 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "coin_list": [
      {
        "coinType": "0x83556891f4a0f233ce7b05cfe7f957d4020492a34f5405b2cb9377d060bef4bf::spring_sui::SPRING_SUI",
        "symbol": "sSUI",
        "name": "Spring SUI",
        "decimals": 9,
        "logoURI": "https://statics.noodles.fi/logo/7912714130489027328.png",
        "price": "1.7543546763043825",
        "marketData": {
          "hour1": {
            "priceChange": 0.12,
            "volume": 280531.1027627877,
            "buyVolume": 140465.03062535284,
            "sellVolume": 140066.07213743488
          },
          "hour24": {
            "priceChange": -2.43,
            "volume": 1265960.1598681442,
            "buyVolume": 632981.8793852952,
            "sellVolume": 632978.2804828491
          },
          "hour4": {
            "priceChange": 0.37,
            "volume": 761994.7879818098,
            "buyVolume": 381224.7571676368,
            "sellVolume": 380770.03081417293
          },
          "m30": {
            "priceChange": 0.02,
            "volume": 161382.06658884676,
            "buyVolume": 80699.55189173302,
            "sellVolume": 80682.51469711376
          }
        },
        "marketCap": "14551259.339768803",
        "fdv": "152690783.64233437",
        "liquidity": "104820.57694631077",
        "holders": 31364,
        "age": 1729702447127,
        "audit": {
          "isHoneypot": false,
          "top10Holder": "0.006654",
          "mintAuthority": "Disable"
        },
        "verified": true,
        "rank": 1
      }
    ]
  }
}

响应字段说明 ​

data 对象字段 ​

字段名类型必填说明
coin_listarray是Token 列表

coin_list 数组项字段 ​

Token 基础信息 ​
字段名类型必填说明
coinTypestring是Token 的 Coin Type，完整类型标识符
symbolstring是Token 符号，如 "sSUI"、"TBTC"
namestring是Token 名称，如 "Spring SUI"
decimalsnumber是Token 精度（小数位数）
logoURIstring否Token 图标 URL
verifiedboolean否是否已验证
ranknumber否排名，数值越小越靠前
Token 价格数据 ​
字段名类型必填说明
pricestring否当前价格，字符串格式的数字
marketCapstring否市值
fdvstring否完全稀释估值（Fully Diluted Valuation）
liquiditystring否流动性
marketData 对象字段 ​
字段名类型必填说明
hour1object否1 小时市场数据
hour24object否24 小时市场数据
hour4object否4 小时市场数据
m30object否30 分钟市场数据
marketData 时间段对象字段（hour1/hour24/hour4/m30） ​
字段名类型必填说明
priceChangenumber否价格变化百分比，正数表示上涨，负数表示下跌
volumenumber否总交易量
buyVolumenumber否买入交易量
sellVolumenumber否卖出交易量
Token 其他信息 ​
字段名类型必填说明
holdersnumber否持有者数量
agenumber否Token 创建时间戳（毫秒）
auditobject否审计检查信息
audit 对象字段 ​
字段名类型必填说明
isHoneypotboolean否是否为蜜罐
top10Holderstring否前 10 名持有者占比，字符串格式的百分比
mintAuthoritystring否铸造权限状态，"Enable" 或 "Disable"

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "coin_list": [
      {
        "coinType": "0x83556891f4a0f233ce7b05cfe7f957d4020492a34f5405b2cb9377d060bef4bf::spring_sui::SPRING_SUI",
        "symbol": "sSUI",
        "name": "Spring SUI",
        "decimals": 9,
        "logoURI": "https://statics.noodles.fi/logo/7912714130489027328.png",
        "price": "1.7543546763043825",
        "marketData": {
          "hour24": {
            "priceChange": -2.43,
            "volume": 1265960.1598681442,
            "buyVolume": 632981.8793852952,
            "sellVolume": 632978.2804828491
          }
        },
        "marketCap": "14551259.339768803",
        "liquidity": "104820.57694631077",
        "holders": 31364,
        "verified": true,
        "rank": 1
      }
    ]
  }
}

注意事项 ​

  1. 接口不需要传参，直接返回所有 Token 数据，不分页
  2. 响应格式参照 Cetus API 标准：code 为 0 表示成功，msg 为状态消息
  3. 数据包装在 data.coin_list 数组中
  4. price、marketCap、fdv、liquidity 等字段为字符串格式的数字，前端需要根据需要进行格式化显示
  5. priceChange 为数值类型，正数表示上涨，负数表示下跌
  6. age 为时间戳（毫秒），前端需要转换为可读的时间格式
  7. marketData 中的时间段数据可能不完整，前端需要做兼容处理
  8. 搜索、收藏、分类筛选等功能由前端本地实现
  9. 可选字段可能为 null 或不存在，前端需要做兼容处理