API Overview
The CredDAO REST API provides endpoints for querying governance data, member profiles, proposals, and analytics.
Base URL
Development: http://localhost:3001
Production: https://api.creddao.ioAuthentication
Most endpoints are public. Member-specific operations may require wallet signature verification.
Rate Limits
| Tier | Requests/min |
|---|---|
| Anonymous | 60 |
| Authenticated | 300 |
Response Format
All responses are JSON:
interface ApiResponse<T> {
data: T;
success: boolean;
error?: string;
}Endpoints Overview
| Endpoint | Description |
|---|---|
/health | API health check |
/api/members | Member operations |
/api/proposals | Proposal operations |
/api/delegations | Delegation operations |
/api/analytics | Governance analytics |
/api/fairscore | Score queries |
/api/admin | Admin panel (auth required) |
/api/docs | Swagger documentation |
Error Handling
interface ApiError {
error: string;
message: string;
code: string;
}HTTP Status Codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad Request |
| 401 | Unauthorized |
| 404 | Not Found |
| 429 | Rate Limited |
| 500 | Server Error |
Quick Example
# Health check
curl https://api.creddao.io/health
# Get proposals
curl https://api.creddao.io/api/proposals
# Get member profile
curl https://api.creddao.io/api/members/{walletAddress}