# Points

Points leaderboard and user points data

## Get Points Leaderboard

> Returns points leaderboard data with wallet addresses and their corresponding points.\
> \
> Can be filtered to specific addresses or return all addresses with pagination support.<br>

```json
{"openapi":"3.0.3","info":{"title":"Kintsu Public API","version":"1.0.0"},"tags":[{"name":"Points","description":"Points leaderboard and user points data"}],"servers":[{"url":"https://kintsu.xyz","description":"Production API server"}],"paths":{"/api/public/points":{"get":{"summary":"Get Points Leaderboard","description":"Returns points leaderboard data with wallet addresses and their corresponding points.\n\nCan be filtered to specific addresses or return all addresses with pagination support.\n","operationId":"getPointsLeaderboard","tags":["Points"],"parameters":[{"name":"addresses","in":"query","description":"Comma-separated list of wallet addresses to filter. \nFor a single address, provide one value. If omitted, returns all addresses.\n","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Maximum number of results to return per page","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"name":"page","in":"query","description":"Page number for pagination","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Wallet address (lowercase)"},"points":{"type":"number","description":"Total points for this address"}}}},"meta":{"type":"object","properties":{"total":{"type":"integer","description":"Number of results in this response"},"page":{"type":"integer","description":"Current page number"},"limit":{"type":"integer","description":"Results per page limit"},"filtered":{"type":"boolean","description":"Whether address filtering was applied"}}}}}}}},"400":{"description":"Bad request - Invalid address format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Request limit per window","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"Time window for rate limit","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"message":{"type":"string","description":"Additional error details"}},"required":["error"]}}}}
```