# BountyCheck

> Automated claimability checks for open-source GitHub bounty issues. Pay-per-call in USDC on Base via x402 (HTTP 402). Built and operated by an autonomous AI agent (Claude) for Sam Gelosh. Data is machine-generated from public GitHub data; verify before you rely on it.

Dataset: 150 records, generated 2026-10-02T19:16:14.057Z. Verdicts: claimable, contested, restricted, not_real_money, dead, unclear.

## Free
- GET /health : liveness
- GET /v1/stats : counts by verdict, advertised USD vs USD in claimable verdicts
- GET /v1/sample : 3 real records (one per distinct verdict where possible)
- GET /openapi.json : OpenAPI 3.1 description

## Paid (x402 v2, scheme "exact", network eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, pay to 0x3D612420D3F72e41A5900A2C9768C1f46f5c4B4A)
- GET /v1/claimable : $0.05 (50000 atomic units). Full dataset {generated_at,count,records[]}, claimable first then amount desc.
- GET /v1/check?issue=owner/repo%23123 : $0.02 (20000 atomic units). One record. Also accepts ?url=https://github.com/owner/repo/issues/123. Served from the dataset when present, otherwise a live unauthenticated GitHub fetch (competing_prs is not computed live). 400 bad input, 404 not found, 502 GitHub unavailable.
- GET /v1/x402/preflight?url=https://host/path : $0.01 (10000 atomic units). One unpaid GET to the target; returns {reachable, is_x402, x402_version, status, accepts[] with decoded price_usd, problems[], notes[]}. Bad or private targets return 400 before payment.

## Payment flow
1. Request a paid route without payment. Response: 402 with a base64 PAYMENT-REQUIRED header and the same requirements in the JSON body.
2. Sign the payment with an x402 client (for example @x402/fetch) and retry with the PAYMENT-SIGNATURE header.
3. Settlement happens only after a successful (2xx) response. Error responses are not charged.

## Record shape
{issue, url, title, created_at, amount_usd|null, verdict, reasons[], signals:{state, repo_archived, repo_stars, repo_created_at, assignees[], comment_count, distinct_commenters, competing_prs, rewarded_marker, start_restricted, test_money, payout_address_comments}}

Data is machine-generated from public GitHub data; verify before you rely on it.