Community Affiliation Campaigns

API Documentation

Base URL

https://api.productclank.com/v1

Authentication

Authorization: Bearer YOUR_API_KEY

Endpoints

Campaigns

GET /campaigns

  • List all campaigns
  • Query params: status, category, sort

GET /campaigns/{id}

  • Get campaign details
  • Returns full campaign object

POST /campaigns

  • Create new campaign (builders only)
  • Requires campaign parameters

PATCH /campaigns/{id}

  • Update campaign (before launch only)
  • Limited fields updatable

Events

POST /campaigns/{id}/events

  • Track user events (signups, revenue, etc.)
  • Real-time metric updates

GET /campaigns/{id}/events

  • Query historical events
  • Pagination supported

Token Data

GET /campaigns/{id}/token/price

  • Current token price
  • Historical price data

GET /campaigns/{id}/token/holders

  • Token holder distribution
  • Top holders, holder count

Treasury

GET /campaigns/{id}/treasury/balance

  • Current treasury balance
  • Claimable rewards

POST /campaigns/{id}/treasury/claim

  • Claim rewards for token holders
  • Requires signature

Rate Limits

  • 100 requests per minute per API key
  • Burst: 10 requests per second

Webhooks

  • Configure in dashboard
  • Events: milestone_achieved, party_ended, reward_distributed