Chess

API

Read ChessGuard trust ratings programmatically. Create an API key below, then pass it as Authorization: Bearer cg_… or X-API-Key: cg_…. Keys can be revoked by their owner or by a ChessGuard moderator.

API keys
Sign in with Google to create keys that authorize trust factor reads.
Base URL
All authenticated requests require an API key from this page.
https://chess.sushii.dev
GET/api/v1/trust/:username
Read a player's trust rating, factors, anomalies, and overwatch review status.

Auth: API key required

curl -s "https://chess.sushii.dev/api/v1/trust/PLAYER_USERNAME" \
  -H "Authorization: Bearer cg_YOUR_KEY"
POST/api/trust
Compact trust check (username → trust percent and label).

Auth: API key required

curl -s -X POST "https://chess.sushii.dev/api/trust" \
  -H "Authorization: Bearer cg_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"PLAYER_USERNAME"}'
GET/api/status
Health and storage readiness.

Auth: None

Trust read response fields
trustPercent
0–100 composite trust score
trustLabel
Human-readable band (e.g. Trusted, Suspicious)
factors
Stat bars that contribute to the score
anomalies
Flags raised by analysis (empty when clean)
overwatchStatus
cleared | convicted | null — only set after moderator review; pending reports are hidden
gamesAnalyzed
Number of games included in the trust model