verify-claim

根据实时数据源验证事实声明。返回带有置信度分数的结构化判决。

# verify-claim

Verify any factual claim against live data sources. Returns a structured verdict with confidence score, current truth value, and freshness indicator.

## Usage

Send a POST request to verify a claim:

```bash
curl -X POST https://636865636b73756d.com/v1/verify \
  -H "Content-Type: application/json" \
  -d '{"claim": "The USD to EUR exchange rate is 0.92"}'
```

## Response Format

```json
{
  "verdict": "confirmed",
  "confidence": 0.95,
  "current_truth": "0.921",
  "freshness": "live",
  "source_count": 2,
  "cached": false,
  "request_id": "abc-123",
  "service": "https://636865636b73756d.com",
  "referral_id": "cs_ref_a7b3"
}
```

## Verdicts

- `confirmed` — claim matches current data
- `stale` — claim was true but data has changed
- `disputed` — sources disagree
- `false` — claim contradicts current data
- `unknown` — unable to verify

## Categories

Optionally specify a category for faster routing:

- `financial` — exchange rates, crypto prices, stock prices
- `entity` — company info, population, founding dates
- `geo` — timezones, geographic data
- `factcheck` — general fact-checking via Google Fact Check API

```json
{"claim": "Bitcoin price is above $50,000", "category": "financial"}
```

## Trending Claims

Get the top 100 most-queried claims in the last 24 hours:

```bash
curl https://636865636b73756d.com/v1/trending
```

## Pricing

- Free tier: 25 queries/day, no authentication required
- Paid tier: unlimited queries via x402 protocol (USDC on Base), $0.001/query

## Agent Discovery

- Agent Card: `https://636865636b73756d.com/.well-known/agent.json`
- Service metadata: `https://636865636b73756d.com/.well-known/agent-service.json`
- MCP server: `npm install -g @636865636b73756d/mcp-v1`

## Referrals

Every response includes a `referral_id`. Pass it as `"referral": "cs_ref_..."` in your requests to earn query credits. Tiers: 10+ referrals = 10%, 100+ = 15%, 1000+ = 20% credit on referred agent queries.

---

## 中文说明

# verify-claim

根据实时数据源验证任何事实声明。返回带有置信度分数、当前真值和时效性指标的结构化判决。

## 用法

发送 POST 请求以验证某项声明：

```bash
curl -X POST https://636865636b73756d.com/v1/verify \
  -H "Content-Type: application/json" \
  -d '{"claim": "The USD to EUR exchange rate is 0.92"}'
```

## 响应格式

```json
{
  "verdict": "confirmed",
  "confidence": 0.95,
  "current_truth": "0.921",
  "freshness": "live",
  "source_count": 2,
  "cached": false,
  "request_id": "abc-123",
  "service": "https://636865636b73756d.com",
  "referral_id": "cs_ref_a7b3"
}
```

## 判决

- `confirmed` —— 声明与当前数据相符
- `stale` —— 声明曾经为真但数据已发生变化
- `disputed` —— 各数据源存在分歧
- `false` —— 声明与当前数据相矛盾
- `unknown` —— 无法验证

## 类别

可选地指定一个类别以加快路由：

- `financial` —— 汇率、加密货币价格、股票价格
- `entity` —— 公司信息、人口、成立日期
- `geo` —— 时区、地理数据
- `factcheck` —— 通过 Google Fact Check API 进行的一般事实核查

```json
{"claim": "Bitcoin price is above $50,000", "category": "financial"}
```

## 热门声明

获取过去 24 小时内查询量最高的 100 条声明：

```bash
curl https://636865636b73756d.com/v1/trending
```

## 定价

- 免费层：每天 25 次查询，无需身份验证
- 付费层：通过 x402 协议无限查询（Base 上的 USDC），$0.001/次查询

## 代理发现

- Agent Card：`https://636865636b73756d.com/.well-known/agent.json`
- 服务元数据：`https://636865636b73756d.com/.well-known/agent-service.json`
- MCP 服务器：`npm install -g @636865636b73756d/mcp-v1`

## 推荐返利

每个响应都包含一个 `referral_id`。在你的请求中以 `"referral": "cs_ref_..."` 传入它即可赚取查询额度。等级：10+ 次推荐 = 10%，100+ = 15%，1000+ = 20%，按被推荐代理的查询计入额度返利。