API 接口文档

RNOISE Records 提供了开放的 REST API，用于检索生态统计数据、代币流通指标、音乐 NFT 元数据以及 Presale 的公募状态。所有 API 请求的基准 URL 为：

https://api.rnoise.cn

核心 API 端点

1. 系统健康检查

返回服务器健康状态以及当前区块链节点的连接情况。

GET /health

{
  "status": "healthy",
  "timestamp": "2026-06-16T09:25:00Z",
  "blockchain": {
    "connected": true,
    "blockNumber": 48293
  }
}

2. RNS 代币指标

获取 RNS 代币的当前流通量、持有地址总数、已销毁量以及当前公募价格等基本指标。

GET /api/token/info

{
  "symbol": "RNS",
  "name": "RNOISE Token",
  "totalSupply": "1000000000",
  "burnedSupply": "2498200",
  "holders": 3204,
  "presalePriceUSDT": "0.10"
}

3. 生态统计摘要

汇总获取链上铸造的音乐 NFT 总量、Beat 交易市场累计成交额以及全网质押总和等参数。

GET /api/stats/summary

{
  "totalNftsMinted": 1284,
  "totalVolumeRNS": "18402900",
  "activeStakers": 842,
  "totalStakedRNS": "82940200"
}

在线测试沙盒 (Sandbox)

在这里您可以向运行中的 RNOISE Records API 服务发送实时请求，并在控制台中直接观察返回的 JSON 数据结构。