# WhatToMine API
> Live multi-coin crypto mining economics — no key needed. For every mineable coin: its algorithm, current network difficulty and hashrate, block reward and block time, the coin's exchange rate in BTC, market cap, a relative profitability index and the estimated 24h BTC revenue. List all coins ranked by how profitable they are to mine right now, look one coin up by ticker or name, or pull the coins for a specific mining algorithm (KawPow, Ethash, RandomX, Scrypt, Autolykos…) — or the full algorithm list with coin counts. Data comes live from the public WhatToMine feed — nothing stored. This is mining-economics data across the whole GPU/ASIC coin complex, distinct from the Bitcoin-only mining API and from the exchange-ticker and on-chain APIs in the catalogue. Built for mining dashboards, profitability switchers, rig tooling and analytics.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/whattomine-api/..."
```

## Pricing
- **Free** (Free) — 22,800 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 298,000 calls/Mo, 10 req/s
- **Growth** ($25/Mo) — 1,305,000 calls/Mo, 25 req/s
- **Scale** ($58/Mo) — 4,620,000 calls/Mo, 50 req/s

## Endpoints

### Coin

#### `GET /v1/coin` — Full mining stats for one coin

**Parameters:**
- `tag` (query, optional, string) — Coin ticker Example: `RVN`
- `name` (query, optional, string) — Coin name Example: `Ravencoin`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/whattomine-api/v1/coin?tag=RVN&name=Ravencoin"
```

**Response:**
```json
{
    "data": {
        "tag": "RVN",
        "name": "Ravencoin",
        "source": "WhatToMine",
        "nethash": 1954625201458,
        "updated": "2026-06-11T16:44:09.000Z",
        "algorithm": "KawPow",
        "difficulty": 27305.79862546014,
        "last_block": 4406440,
        "market_cap": 68458997,
        "btc_revenue": 5.11e-6,
        "block_reward": 1250,
        "block_time_s": 60,
        "profitability": 370,
        "btc_exchange_rate": 6.704518529569208e-8,
        "estimated_rewards": 76.24668,
        "profitability_24h": 336
    },
    "meta": {
        "timestamp": "2026-06-11T16:47:01.505Z",
        "request_id": "fbaa77fa-7552-4871-bb99-94f044bb4299"
    },
    "status": "ok",
    "message": "Coin retrieved successfully",
    "success": true
}
```

### Coins

#### `GET /v1/coins` — All mineable coins ranked by profitability

**Parameters:**
- `algorithm` (query, optional, string) — Filter by algorithm Example: `KawPow`
- `limit` (query, optional, string) — Max results (1-500) Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/whattomine-api/v1/coins?algorithm=KawPow&limit=100"
```

**Response:**
```json
{
    "data": {
        "coins": [
            {
                "tag": "QUAI",
                "name": "Quai-KawPow",
                "nethash": 386743913979,
                "updated": "2026-06-11T16:45:16.000Z",
                "algorithm": "KawPow",
                "difficulty": 613762591485,
                "last_block": 8457606,
                "market_cap": 15309245,
                "btc_revenue": 1.583e-5,
                "block_reward": 6.2363549236342095,
                "block_time_s": 1.587,
                "profitability": 1145,
                "btc_exchange_rate": 2.393331221883344e-7,
                "estimated_rewards": 66.13371,
                "profitability_24h": 637
            },
            {
                "tag": "NICEHASH",
                "name": "Nicehash-KawPow",
                "nethash": 262998922188,
                "updated": "2026-06-11T16:45:14.000Z",
                "algorithm": "KawPow",
                "difficulty": 1,
                "last_block": 0,
                "market_cap": 0,
                "btc_revenue": 1.384e-5,
                "block_reward": 1,
                "block_time_s": 1,
                "profitability": 1001,
                "btc_exchange_rate": 0.00017055075099091905,
                "estimated_rewards": 1.0e-5,
                "profitability_24h": 674
            },
            {
                "tag": "FREN",
                "name": "Frencoin",
                "nethash": 481638716,
                "updated": "2026-
…(truncated, see openapi.json for full schema)
```

### Algorithm

#### `GET /v1/algorithm` — Coins for an algorithm, or all algorithms

**Parameters:**
- `algorithm` (query, optional, string) — Mining algorithm (omit for full list) Example: `KawPow`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/whattomine-api/v1/algorithm?algorithm=KawPow"
```

**Response:**
```json
{
    "data": {
        "coins": [
            {
                "tag": "QUAI",
                "name": "Quai-KawPow",
                "nethash": 386743913979,
                "updated": "2026-06-11T16:45:16.000Z",
                "algorithm": "KawPow",
                "difficulty": 613762591485,
                "last_block": 8457606,
                "market_cap": 15309245,
                "btc_revenue": 1.583e-5,
                "block_reward": 6.2363549236342095,
                "block_time_s": 1.587,
                "profitability": 1145,
                "btc_exchange_rate": 2.393331221883344e-7,
                "estimated_rewards": 66.13371,
                "profitability_24h": 637
            },
            {
                "tag": "NICEHASH",
                "name": "Nicehash-KawPow",
                "nethash": 262998922188,
                "updated": "2026-06-11T16:45:14.000Z",
                "algorithm": "KawPow",
                "difficulty": 1,
                "last_block": 0,
                "market_cap": 0,
                "btc_revenue": 1.384e-5,
                "block_reward": 1,
                "block_time_s": 1,
                "profitability": 1001,
                "btc_exchange_rate": 0.00017055075099091905,
                "estimated_rewards": 1.0e-5,
                "profitability_24h": 674
            },
            {
                "tag": "FREN",
                "name": "Frencoin",
                "nethash": 481638716,
                "updated": "2026-
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/whattomine-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "profitability is WhatToMine's relative profitability index (higher = more profitable to mine right now); btc_revenue is the estimated 24h BTC revenue at the reference hashrate; btc_exchange_rate is the coin's price in BTC. Stats are cached briefly and refresh every few minutes.",
        "source": "WhatToMine (whattomine.com/coins.json, live)",
        "service": "whattomine-api",
        "endpoints": {
            "GET /v1/coin": "Full mining stats for one coin (tag=RVN or name=Ravencoin).",
            "GET /v1/meta": "This document.",
            "GET /v1/coins": "All mineable coins with mining stats, ranked by profitability (algorithm=, limit=100).",
            "GET /v1/algorithm": "Coins for a mining algorithm (algorithm=KawPow); no param lists all algorithms with counts."
        },
        "coin_count": 45,
        "description": "Live multi-coin crypto mining economics from WhatToMine. The coins endpoint lists every mineable coin with algorithm, network difficulty and hashrate, block reward and time, BTC exchange rate, market cap, relative profitability and 24h BTC revenue; the coin endpoint returns one coin by ticker or name; the algorithm endpoint lists the coins for a mining algorithm (or all algorithms with coin counts). Live, no key, nothing stored. Mining-economics data across the GPU/ASIC coin complex, distinct from the Bitcoin-only mining API and the exchange-ticker and on-chain APIs.",
        "upstream_status": "ok"
    },
 
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/whattomine-api
OpenAPI spec: https://www.oanor.com/api/whattomine-api/openapi.json
