# List your mining pool on MiningBoard

> Listing is free. There is no listing fee, no paid placement, and no ranking that can be bought.
> Publish your pool's stats in the JSON format below and we scrape them every 5 minutes — your live
> hashrate, miner count and blocks appear on your coin's page automatically.

- **Submit at:** https://miningboard.com/zh/pools/submit
- **JSON Schema:** https://miningboard.com/zh/pools/spec/v1
- **Spec version:** `miningboard-pool-v1`
- **Poll interval:** every 5 minutes

## 流程说明

1. **** — 
2. **** — 
3. **** — 

## 两种收录方式

接口并非必需。我们目录中的大多数矿池根本没有公开的数据接口——我们依据目录信息收录它们，算力则来自聚合数据源。提供接口只是让您的数据成为第一手的、实时且准确的数据。

| Track | | |
|---|---|---|
| **完整收录——您提供接口** | 推荐 | 我们每五分钟直接从您那里读取数据。您的矿池将显示实时算力、矿工数、24 小时内爆块数和最近爆块时间，并根据接口响应的稳定程度获得可靠性评分。 |
| **目录收录** | 无需接口 | 名称、官网、费率、结算方式、支持的币种和 Logo。您的矿池会出现在目录以及您所挖币种的页面上，算力由聚合数据源推算而非由您提供。 |

## 接口规范

每种币一个公开的 GET 接口，返回 application/json。每个字段都直接对应我们存储的数据，不存在要求了却不使用的字段。

```json
{
  "spec": "miningboard-pool-v1",
  "coin": "ZEC",
  "algorithm": "Equihash",
  "updated_at": "2026-09-08T22:34:15Z",
  "pool": {
    "hashrate": 1.23e15,
    "miners": 412,
    "workers": 980,
    "blocks_24h": 7,
    "last_block_at": "2026-09-08T22:15:15Z",
    "fee_percent": 1.5,
    "payout_scheme": "PPS+",
    "min_payout": 0.001
  },
  "network": {
    "hashrate": 8.9e15,
    "difficulty": 120000000,
    "height": 2900123,
    "block_reward": 1.5625,
    "block_time": 75
  },
  "stratum": [
    { "url": "stratum+tcp://zec.example.com:3333", "region": "eu", "tls": false }
  ]
}
```

### 字段说明

| 字段 | 必填 | 说明 |
|---|---|---|
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |
| `` | 可选 |  |

### 可选：索引接口

如果您公开支持的币种列表及各自的数据地址，日后新增币种就无需重新提交——我们会直接从索引中读取。

```json
{
  "spec": "miningboard-pool-index-v1",
  "pool": { "name": "Example Pool", "homepage": "https://example.com", "fee_percent": 1.5 },
  "coins": [
    { "coin": "ZEC", "stats_url": "https://api.example.com/v1/pool/zec" },
    { "coin": "BTC", "stats_url": "https://api.example.com/v1/pool/btc" }
  ]
}
```

## 接口必须遵守的规则

这些不是偏好。每一条都是我们数据流程实际执行的约束，违反其中任何一条的接口都无法作为实时数据源收录。

1. **** — 
2. **** — 
3. **** — 
4. **** — 
5. **** — 
6. **** — 

## Validate before you submit

`POST https://miningboard.com/zh/pools/submit/validate` with `{"url": "https://api.example.com/v1/pool/zec"}` returns a
field-by-field conformance report:

```json
{
  "ok": true,
  "url": "https://api.example.com/v1/pool/zec",
  "checks": [
    { "field": "pool.hashrate", "status": "pass", "detail": "1.23 PH/s (1230000000000000 H/s)" },
    { "field": "network.hashrate.cross_check", "status": "pass", "detail": "Within 10x of our ZEC consensus." }
  ]
}
```

`status` is one of `pass`, `warn`, `fail`, `info`. `ok` is true when nothing failed. The same check
runs server-side when you submit, so the report you see is the report our team sees.

The most valuable check is `network.hashrate.cross_check`: we compare your self-reported network
hashrate against our own multi-source chain consensus. Unit errors — publishing TH/s where the spec
says raw H/s — are the most common mistake and this catches them immediately.

## 提交之后

- **** — 
- **** — 
- **** — 
- **** —