API Documentation

ThreatLedger REST API · 链上威胁情报查询接口

Base URLhttps://api.threatledger.net

🔓 所有 GET 端点无需 API Key · Rate Limit: 30 次/分钟, 1000 次/天

Response Headers

X-ThreatLedger-Version— API 版本号 (e.g. "1.0")

X-Data-Sources— 数据来源列表 (e.g. "ofac,slowmist,community")

X-RateLimit-Remaining— 剩余请求次数

GET/v1/health

健康检查 — 验证 API 是否正常运行

Health check — verify the API is running

Response

{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2024-03-15T00:00:00Z"
}

curl -s "https://api.threatledger.net/v1/health"

GET/v1/address/:chain/:address

地址查询 — 获取区块链地址的威胁情报

Address lookup — get threat intelligence for a blockchain address

参数	类型	必需	描述
chain	string	✓	Blockchain name (ethereum, bitcoin, bsc, polygon, solana)
address	string	✓	Blockchain address to look up

Response

{
  "found": true,
  "address": "0x098b716b8aaf21512996dc57eb0615e2383e2f96",
  "chain": "ethereum",
  "risk_score": 95,
  "risk_details": {
    "score": 95,
    "level": "critical"
  },
  "labels": [
    {
      "type": "lazarus-group",
      "source": "ofac",
      "confidence": 99,
      "evidence_url": "https://..."
    },
    {
      "type": "hack-proceeds",
      "source": "slowmist",
      "confidence": 95,
      "evidence_url": "https://..."
    }
  ],
  "label_count": 2,
  "first_seen": "2022-06-24",
  "sources": [
    "ofac",
    "slowmist"
  ],
  "evidence_urls": [
    "https://..."
  ],
  "version": "1.0"
}

curl -s "https://api.threatledger.net/v1/address/ethereum/0x098b716b8aaf21512996dc57eb0615e2383e2f96"

GET/v1/stats

平台统计 — 获取平台整体指标

Platform statistics — get overall platform metrics

Response

{
  "total_addresses": 15432,
  "total_labels": 48921,
  "total_events": 342,
  "contributors": 1205,
  "last_updated": "2024-03-15T12:00:00Z"
}

curl -s "https://api.threatledger.net/v1/stats"

GET/v1/feed?limit=N

威胁源 — 获取最新的威胁情报条目

Threat feed — get latest threat intelligence entries

参数	类型	必需	描述
limit	number	—	Number of entries to return (default: 20, max: 100)

Response

{
  "entries": [
    {
      "address": "0xabc...def",
      "chain": "ethereum",
      "label": "phishing",
      "risk_score": 85,
      "submitted_at": "2024-03-15T10:30:00Z"
    }
  ],
  "total": 1,
  "limit": 20
}

curl -s "https://api.threatledger.net/v1/feed?limit=10"

POST/v1/labels

提交情报 — 提交新的威胁标签（需要 API Key）

Submit intelligence — submit a new threat label (requires API key)

参数	类型	必需	描述
X-API-Key	string (header)	✓	Your API key for authentication
address	string	✓	Target blockchain address
chain	string	✓	Blockchain name
label	string	✓	Threat label to apply
evidence	string	—	Supporting evidence or notes

Response

{
  "success": true,
  "id": "lbl_abc123",
  "message": "Label submitted for review"
}

curl -X POST "https://api.threatledger.net/v1/labels" \
  -H "X-API-Key: tl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"address":"0x...","chain":"ethereum","label":"phishing"}'

🧪 Playground

实时测试 API · Try it live

🔓 无需 API Key 即可查询 · 注册后获得更高配额

ChainAddress

📊 Rate Limit: 30 req/min · 1,000 req/day · No API Key required