# TokenMarket — Full LLM Reference Documentation
> Version: 1.0 | Updated: 2026-06-16 | https://fundingcloud.com

---

## 1. Overview

TokenMarket is a financial data platform that computes a proprietary **AI Sector Index** 
for the decentralised AI compute token market. It provides standardised pricing 
benchmarks, a novel Compute-to-Market Ratio (CMR), live token data, and a free 
public REST API.

**Covered tokens:** RNDR, TAO, FET, AGIX, NMR, OCEAN, AKT

**Primary use cases:**
- Benchmarking the AI compute token sector
- Building dashboards or data feeds for crypto/AI analytics
- Quantitative research into compute cost vs. market value
- Integrating live AI token data into applications

---

## 2. Methodology

### 2.1 Sector Index Score

The Sector Index is a composite weighted score calculated hourly. It uses:

- **Price (USD):** sourced from CoinGecko API
- **24h Volume:** market trading volume over 24 hours
- **Market Cap:** circulating supply × price
- **Normalisation:** each metric is normalised 0–100 across the tracked universe
- **Weight:** each token is weighted by relative market cap within the sector

The final index value is a single float representing the aggregate sector health 
(higher = stronger sector, lower = broader sell-off or compression).

### 2.2 Compute-to-Market Ratio (CMR)

CMR = Sector Index Value ÷ OpenRouter Mock Compute Cost

This ratio expresses how much market value exists per unit of compute cost. 
A rising CMR suggests the market is pricing in increasing compute demand; 
a falling CMR suggests compression or compute oversupply.

---

## 3. REST API Reference

Base URL: `https://api.fundingcloud.com`

All endpoints return `application/json`. No authentication required for public endpoints.

---

### 3.1 GET /api/tokenmarket/index/latest

Returns the most recent Sector Index calculation including all token weights.

**Request:**
```
GET https://api.fundingcloud.com/api/tokenmarket/index/latest
```

**Response fields:**
| Field | Type | Description |
|---|---|---|
| `indexValue` | number | Composite sector index score |
| `cmrRatio` | number | Compute-to-market ratio |
| `timestamp` | string | ISO 8601 calculation time |
| `totalMarketCap` | number | Sum of all tracked token market caps (USD) |
| `totalVolume24h` | number | Sum of all tracked token 24h volumes (USD) |
| `tokens` | object[] | Per-token breakdown with weight, price, volume |

**Example response:**
```json
{
  "indexValue": 72.4,
  "cmrRatio": 1.8432,
  "timestamp": "2026-06-16T13:00:00Z",
  "totalMarketCap": 18420000000,
  "totalVolume24h": 890000000,
  "tokens": [
    { "symbol": "RNDR", "priceUSD": 7.24, "weight": 0.28, "change24h": 3.1 },
    { "symbol": "TAO", "priceUSD": 412.0, "weight": 0.22, "change24h": -1.4 }
  ]
}
```

**cURL example:**
```bash
curl https://api.fundingcloud.com/api/tokenmarket/index/latest
```

---

### 3.2 GET /api/tokenmarket/index/history

Returns historical Sector Index records.

**Query parameters:**
| Param | Values | Default |
|---|---|---|
| `timeframe` | `24h`, `7d`, `30d` | `24h` |

**Request:**
```
GET https://api.fundingcloud.com/api/tokenmarket/index/history?timeframe=7d
```

**Response:** array of records in chronological order

```json
[
  {
    "timestamp": "2026-06-10T00:00:00Z",
    "indexValue": 68.1,
    "cmrValue": 1.7201,
    "totalMarketCap": 17800000000,
    "totalVolume24h": 780000000
  }
]
```

**cURL example:**
```bash
curl "https://api.fundingcloud.com/api/tokenmarket/index/history?timeframe=7d"
```

---

### 3.3 GET /api/tokenmarket/live/prices

Returns live per-token prices and 24h metrics, sorted by volume descending.

**Request:**
```
GET https://api.fundingcloud.com/api/tokenmarket/live/prices
```

**Response:** array of token objects

```json
[
  {
    "id": "render-token",
    "symbol": "RNDR",
    "priceUSD": 7.24,
    "change24h": 3.12,
    "marketVolume": 120000000
  }
]
```

**cURL example:**
```bash
curl https://api.fundingcloud.com/api/tokenmarket/live/prices
```

---

### 3.4 GET /api/tokenmarket/live/summary

Returns an aggregated market summary across all tracked tokens.

**Request:**
```
GET https://api.fundingcloud.com/api/tokenmarket/live/summary
```

**Response:**
```json
{
  "totalMarketCap": 18420000000,
  "totalVolume24h": 890000000,
  "overallTrend": 1.24,
  "activeTickersCount": 7,
  "lastUpdate": "2026-06-16T13:12:00Z"
}
```

| Field | Description |
|---|---|
| `totalMarketCap` | Aggregated market cap of all tracked tokens (USD) |
| `totalVolume24h` | Total 24h trading volume (USD) |
| `overallTrend` | Average 24h % change across all tokens |
| `activeTickersCount` | Number of tokens currently tracked |

**cURL example:**
```bash
curl https://api.fundingcloud.com/api/tokenmarket/live/summary
```

---

## 4. Frequently Asked Questions

**Q: What is the TokenMarket AI Sector Index?**
A: It is a composite weighted score that benchmarks the aggregate health and performance 
of the decentralised AI compute token market. It is updated hourly using live market data 
from CoinGecko, normalised and weighted by market cap.

**Q: What is the Compute-to-Market Ratio (CMR)?**
A: CMR is a proprietary metric computed as Sector Index ÷ OpenRouter Mock Compute Cost. 
It expresses how much aggregate market value exists per unit of AI compute cost, 
helping traders and analysts understand whether the market is over- or under-pricing 
compute capacity.

**Q: Which tokens are included in the index?**
A: RNDR (Render Network), TAO (Bittensor), FET (Fetch.ai), AGIX (SingularityNET), 
NMR (Numeraire), OCEAN (Ocean Protocol), AKT (Akash Network).

**Q: How do I access the API?**
A: All four endpoints listed above are free and public. No API key is required. 
Send a standard HTTP GET request to `https://api.fundingcloud.com`.

**Q: How often is the index updated?**
A: The Sector Index is recalculated hourly by an automated indexer service. 
Live prices are updated each time the indexer runs.

**Q: Is the API free to use?**
A: Yes. The public API tier is free with no rate limits for reasonable usage. 
Contact us via the app for enterprise SLA or higher-throughput plans.

---

## 5. Terms of Use

- Data provided for informational purposes only. Not financial advice.
- Attribution requested when publishing derived works: "Powered by TokenMarket / fundingcloud.com"
- No warranty for uptime, accuracy, or completeness of data.
- Commercial redistribution of raw data requires written permission.

---

## 6. Contact & Support

- Website: https://fundingcloud.com
- API Documentation: https://fundingcloud.com/api-docs.html
- LLM Manifest: https://fundingcloud.com/llms.txt