API Reference

The ARRAKIS API provides programmatic access to conviction data and community analytics.

Authentication

All API requests require an API key:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.arrakis.community/v1/members

Get your API key from the dashboard under Settings > API.

Base URL

https://api.arrakis.community/v1

Rate Limits

Endpoints

Members

List Members

GET /members

Query parameters:

• tier - Filter by tier (1-9)
• min_conviction - Minimum conviction score
• limit - Results per page (default: 50, max: 100)
• offset - Pagination offset

Get Member

GET /members/:discord_id

Returns detailed member information including conviction breakdown and tier history.

Tiers

Get Tier Distribution

GET /tiers/distribution

Returns member count per tier.

Analytics

Community Summary

GET /analytics/summary

Returns aggregate community metrics.

Conviction Trends

GET /analytics/trends?period=30d

Returns conviction trend data over specified period.

Webhooks

Configure webhooks to receive real-time updates.

Events

• member.verified - New wallet verification
• member.tier_changed - Tier promotion/demotion
• member.badge_earned - Badge awarded

Error Codes

SDKs

Official SDKs coming soon:

• TypeScript/JavaScript
• Python

Plan Availability