API Documentation

RNOISE Records provides an open REST API to query token distributions, total burn supply, ecosystem volume, music NFT metadata, and presale milestones. The base endpoint for all queries is:

https://api.rnoise.cn

Core API Endpoints

1. System Health Status

Returns status details for the API server and block synchronization status.

GET /health

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

2. RNS Token Metrics

Fetch details on current RNS circulating supply, unique wallet holders count, total burned supply, and live presale exchange rates.

GET /api/token/info

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

3. Ecosystem Summary

Returns general metrics including total music NFTs registered, market volume, active stakers, and aggregate RNS staking metrics.

GET /api/stats/summary

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

Interactive Console Sandbox

Test real-time API endpoints directly from your browser. Click the button below to query the live backend and view actual JSON outputs.