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.