{"openapi":"3.1.0","info":{"title":"Burn dem Trees \u2014 Leaderboard API","version":"3.0","description":"Public, opt-in leaderboard ranking Claude Code users by CO\u2082 burned. Self-reported.","license":{"name":"MIT"},"contact":{"name":"privacy","email":"privacy@deutschekiagenten.com"}},"servers":[{"url":"https://api.deutschekiagenten.com/leaderboard/push"}],"paths":{"/":{"post":{"summary":"Submit aggregated GPU/CO\u2082 usage","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}}},"responses":{"200":{"description":"Accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitResponse"}}}},"422":{"description":"Validation error"},"429":{"description":"Rate limited (1/24h per IP-hash)"}}},"get":{"summary":"Leaderboard rows","parameters":[{"name":"period","in":"query","schema":{"type":"string","enum":["hour","today","week","month","year","all","cumulative"]}},{"name":"sort","in":"query","schema":{"type":"string","enum":["co2","cost","streak","peak","trees","days"]}}],"responses":{"200":{"description":"Array of rows"}}},"delete":{"summary":"Erase entry (right to erasure)","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"token","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted"},"403":{"description":"Bad token"}}}},"/?endpoint=badge":{"get":{"summary":"shields.io-style SVG badge by pseudonym"}},"/?endpoint=feed":{"get":{"summary":"RSS 2.0 of top weekly burners"}},"/?endpoint=sparkline":{"get":{"summary":"Last 30 days time-series (token-protected)"}}},"components":{"schemas":{"Submission":{"type":"object","required":["version","consent","gpu"],"properties":{"version":{"type":"string","enum":["3.0"]},"pseudonym":{"type":["string","null"],"pattern":"^[A-Za-z0-9][A-Za-z0-9_-]{2,19}$","maxLength":20},"consent":{"type":"object","required":["publicLeaderboard"],"properties":{"publicLeaderboard":{"type":"boolean"},"bucketsHourly":{"type":"boolean"},"pseudonymBinding":{"type":"boolean"}}},"gpu":{"type":"object","required":["totalCostUSD","totalHoursH100","daysActive"],"properties":{"totalCostUSD":{"type":"number","minimum":0,"maximum":3000000},"totalHoursH100":{"type":"number","minimum":0,"maximum":900000},"daysActive":{"type":"integer","minimum":0,"maximum":3650},"byHour":{"type":"object"},"byDay":{"type":"object"},"byWeek":{"type":"object"},"byMonth":{"type":"object"},"byYear":{"type":"object"}}}}},"SubmitResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"id":{"type":"integer"},"deleteToken":{"type":"string"},"achievements":{"type":"array","items":{"type":"string"}},"derived":{"type":"object"}}}}}}