Endpoints

Builders

List builders


GET /api/v1/builders

Returns all public builder profiles.

Query parameters:

Parameter	Type	Description
`category`	string	Filter by category (e.g., `defi`, `wallet`)
`limit`	number	Results per page (default: 50, max: 100)
`offset`	number	Pagination offset

Response:


{
  "data": [
    {
      "id": "builder_123",
      "name": "Acme Protocol",
      "username": "acme",
      "description": "Decentralized lending protocol",
      "category": "defi",
      "website": "https://acme.xyz",
      "logo_url": "https://...",
      "stamp_count": 142
    }
  ],
  "total": 85,
  "limit": 50,
  "offset": 0
}

Get builder


GET /api/v1/builders/:username

Returns a single builder profile by username.

Events

List events


GET /api/v1/events

Returns all public events.

Query parameters:

Parameter	Type	Description
`status`	string	`upcoming`, `active`, or `past`
`org`	string	Filter by organization slug
`limit`	number	Results per page (default: 20)

Response:


{
  "data": [
    {
      "id": "event_456",
      "name": "Meridian 2026",
      "description": "Annual Stellar ecosystem conference",
      "start_date": "2026-10-15T09:00:00Z",
      "end_date": "2026-10-17T18:00:00Z",
      "location": "London, UK",
      "cover_image": "https://...",
      "participant_count": 1250,
      "company_count": 45
    }
  ]
}

Get event


GET /api/v1/events/:id

Returns details for a specific event, including participating companies.

Leaderboards

Event leaderboard


GET /api/v1/events/:id/leaderboard

Returns the top participants for an event.

Query parameters:

Parameter	Type	Description
`limit`	number	Number of entries (default: 25, max: 100)

Response:


{
  "data": [
    {
      "rank": 1,
      "display_name": "alice",
      "points": 340,
      "stamp_count": 28,
      "tier": "Gold"
    }
  ]
}

Stamps

Event stamp stats


GET /api/v1/events/:id/stamps

Returns aggregate stamp collection data for an event.

Response:


{
  "data": {
    "total_stamps_collected": 4520,
    "unique_participants": 890,
    "companies": [
      {
        "name": "Acme Protocol",
        "stamps_collected": 245
      }
    ]
  }
}