TanTrace API

v1 · 碳市场数据接口

TanTrace API 提供中国碳市场实时数据、政策法规和CCER项目数据的 RESTful 接口。覆盖全国碳市场、8大地方试点、CCER自愿减排及欧盟碳市场。

免费开始

无需API密钥，匿名30次/小时

API密钥

通过 x-api-key 请求头传递，100次/小时

11个市场

全国CEA + 8试点 + CCER + EU ETS

认证方式

# 匿名访问 (30次/小时)
curl https://tantrace.com/api/v1/prices

# 使用API密钥 (100次/小时)
curl -H "x-api-key: YOUR_KEY" https://tantrace.com/api/v1/prices

# 或通过查询参数
curl https://tantrace.com/api/v1/prices?apiKey=YOUR_KEY

超出限制将返回 429 状态码。响应头包含 X-RateLimit-Remaining。

速率限制

层级	限制	价格
匿名	30次/小时	免费
Free Key	100次/小时	免费
Pro Key	1,000次/小时	¥500/月

接口文档

GET/api/v1/prices

获取所有交易所最新碳价

请求示例

curl https://tantrace.com/api/v1/prices

响应示例

{
  "data": [
    {
      "exchange": "national",
      "nameZh": "全国碳市场",
      "price": 97.42,
      "changePercent": 1.23,
      "volume": 812000,
      "currency": "CNY"
    }
  ],
  "timestamp": "2026-03-27T08:00:00.000Z"
}

GET/api/v1/prices?exchange=national&days=90

获取指定交易所历史OHLCV数据

参数

exchangestring交易所代码: national, shenzhen, beijing, eu_ets, ccer...

daysnumber历史天数 (默认365, 最大1825)

请求示例

curl https://tantrace.com/api/v1/prices?exchange=national&days=30

响应示例

{
  "data": {
    "exchange": "national",
    "days": 30,
    "count": 22,
    "data": [
      { "date": "2026-02-25", "open": 95.10, "high": 96.80, "low": 94.50, "close": 96.20, "volume": 750000 }
    ]
  }
}

GET/api/v1/policies

获取碳市场政策法规（分页）

参数

sourcestring来源: MEE, NDRC, MIIT, State Council

impactstring影响等级: high, medium, low

pagenumber页码 (默认1)

limitnumber每页数量 (默认20, 最大100)

请求示例

curl https://tantrace.com/api/v1/policies?source=MEE&limit=5

响应示例

{
  "data": [...],
  "pagination": { "page": 1, "limit": 5, "total": 17, "hasMore": true }
}

GET/api/v1/ccer

获取CCER自愿减排项目（分页）

参数

statusstring状态: registered, issued, retired

typestring项目类型: 造林碳汇, 海上风电, 光热发电, 红树林营造

pagenumber页码 (默认1)

limitnumber每页数量 (默认50, 最大200)

请求示例

curl https://tantrace.com/api/v1/ccer?status=issued

响应示例

{
  "data": [
    { "name": "福建平潭200MW海上风电项目", "creditVolume": 380000, "status": "issued" }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 3, "hasMore": false }
}

交易所代码

national全国碳市场 (CEA)

shenzhen深圳

shanghai上海

beijing北京

guangdong广东

tianjin天津

hubei湖北

chongqing重庆

fujian福建

eu_ets欧盟碳市场

ccerCCER自愿减排

进入终端 →