# Kaspa Hashrate, Supply & Emission API
> Kaspa's network economics and BlockDAG state, live from the public Kaspa REST API — no key, nothing cached. Kaspa is the fastest proof-of-work BlockDAG (GHOSTDAG): it confirms many blocks per second in parallel and emits coins on a unique smooth, monthly "chromatic" halving schedule. The existing Kaspa reader covers addresses, UTXOs and transactions; this opens the mining-and-emission layer it does not. Read the live network hashrate (in TH/s) and BlockDAG state — the block and header counts, the number of current DAG tips and the difficulty. Read the coin supply with the circulating and maximum KAS (Kaspa caps near 28.7 billion), the percent of the supply already mined and the current per-block reward. And read the next halving — its timestamp, date and the reward it drops to. The mining-and-economics layer for Kaspa miners, wallets, explorers and analytics. Live from api.kaspa.org.

## 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/kaspametrics-api/..."
```

## Pricing
- **Free** (Free) — 7,350 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 133,000 calls/Mo, 9 req/s
- **Pro** ($35/Mo) — 798,000 calls/Mo, 22 req/s
- **Business** ($91/Mo) — 4,980,000 calls/Mo, 55 req/s

## Endpoints

### Mining

#### `GET /v1/hashrate` — Live hashrate (TH/s) and BlockDAG state: block/header counts, tips, difficulty

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

**Response:**
```json
{
    "data": {
        "note": "Live Kaspa network hashrate (in TH/s) and BlockDAG state: the total block and header counts, the number of current DAG tips and the difficulty. Kaspa is a parallel proof-of-work BlockDAG, so many blocks confirm per second.",
        "source": "Kaspa REST",
        "network": "kaspa-mainnet",
        "tip_count": 10,
        "difficulty": 20595965226266084,
        "block_count": 1430378,
        "hashrate_th": 411919.3,
        "header_count": 1430378,
        "past_median_time": 1781456537927,
        "virtual_daa_score": 460370634
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:31.194Z",
        "request_id": "8ef293a8-485a-4dba-9a53-1e351b59e4e8"
    },
    "status": "ok",
    "message": "Hashrate retrieved successfully",
    "success": true
}
```

### Emission

#### `GET /v1/halving` — The next emission halving: timestamp, date and the reward it drops to

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

**Response:**
```json
{
    "data": {
        "note": "Kaspa's next emission halving: the timestamp and date it occurs and the per-block reward it drops to. Unlike Bitcoin's four-year step, Kaspa halves smoothly roughly once a month (a 'chromatic' schedule).",
        "source": "Kaspa REST",
        "next_halving_date": "2026-07-05 19:45:05 UTC",
        "next_halving_timestamp": 1783280705,
        "next_halving_reward_kas": 2.44997148
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:31.388Z",
        "request_id": "ab8762fa-51fa-47b9-89b4-58dcd10021d8"
    },
    "status": "ok",
    "message": "Halving retrieved successfully",
    "success": true
}
```

#### `GET /v1/supply` — Coin supply: circulating/max KAS, percent mined, current block reward

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

**Response:**
```json
{
    "data": {
        "note": "Kaspa coin supply: the circulating and maximum KAS (Kaspa caps at ~28.7 billion), the percent of the supply already mined and the current per-block reward. The reward shrinks on a smooth monthly halving curve.",
        "source": "Kaspa REST",
        "max_kas": 28704035605,
        "pct_mined": 95.8358,
        "circulating_kas": 27508742214.4754,
        "block_reward_kas": 2.59565436
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:31.816Z",
        "request_id": "5bbd2415-8651-49ab-b275-0f4bf9470d6a"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "sample": {
            "pct_mined": 95.8358,
            "circulating_kas": 27508742214.4754
        },
        "source": "public Kaspa REST API (api.kaspa.org), keyless",
        "service": "kaspametrics-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/supply": "Coin supply: circulating/max KAS, percent mined, current block reward.",
            "GET /v1/halving": "The next emission halving: timestamp, date and the reward it drops to.",
            "GET /v1/hashrate": "Live hashrate (TH/s) and BlockDAG state: block/header counts, tips, difficulty."
        },
        "description": "Read Kaspa's network economics and BlockDAG state live from the public Kaspa REST API: the live hashrate and BlockDAG state (block/header counts, tips, difficulty), the coin supply (circulating/max KAS, percent mined, block reward) and the next emission halving (timestamp, date, new reward). The mining-and-economics layer for Kaspa miners, wallets and explorers. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:31.913Z",
        "request_id": "2c79eef1-9122-4b8c-92df-d769f4cf9a4c"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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