Community Program API

Retrieve community program status including perks, founding badge, and governance eligibility

Community Program API

Returns the full community program state for the authenticated user, including reward status, unlocked perks, founding badge, and governance eligibility.

Get community program

GET /api/community/program

Requires session authentication. Returns the community program data for the current user. If the user has claimed token rewards, the response includes their founding badge, unlocked perks, and governance voting power.

Response

{
  "rewards": {
    "connected": true,
    "walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "claimed": true,
    "currentTier": {
      "id": "builder",
      "label": "Builder",
      "credits": 100,
      "minBalance": 10000
    },
    "balanceUi": 15000,
    "creditsClaimed": 100,
    "claimedAt": "2026-04-10T12:00:00.000Z",
    "availability": "live",
    "detail": null
  },
  "perks": [
    {
      "key": "credits",
      "title": "Free Agent Credits",
      "detail": "100 Agentbot credits are active on your account.",
      "unlocked": true
    },
    {
      "key": "basefm-pass",
      "title": "baseFM Guest Pass",
      "detail": "Builder and Whale holders can create a baseFM DJ stream without holding the full BASEFM threshold.",
      "unlocked": true
    },
    {
      "key": "governance",
      "title": "Governance Rights",
      "detail": "Your community vote is active with 3x voting power.",
      "unlocked": true
    },
    {
      "key": "airdrop",
      "title": "Airdrop Ready",
      "detail": "Your claimed wallet is included in export-ready holder snapshots for future reward operations.",
      "unlocked": true
    }
  ],
  "foundingBadge": {
    "key": "founding-community",
    "title": "Founding Community",
    "detail": "Builder claim verified on Agentbot.",
    "walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "createdAt": "2026-04-10T12:00:00.000Z"
  },
  "governance": {
    "eligible": true,
    "votingPower": 3,
    "proposals": [
      {
        "id": "cgp_a1b2c3d4-...",
        "slug": "first-community-vote-abc123",
        "title": "First community vote",
        "summary": "Should Agentbot expand baseFM access to Holder tier?",
        "details": null,
        "status": "active",
        "startsAt": "2026-04-10T10:00:00.000Z",
        "endsAt": null,
        "totals": {
          "yes": 16,
          "no": 3,
          "abstain": 1
        },
        "userVote": {
          "choice": "yes",
          "votingPower": 3
        }
      }
    ]
  },
  "admin": false
}

Response fields

Field	Type	Description
rewards	object	Current community reward status for the user
rewards.connected	boolean	Whether a wallet is connected
rewards.walletAddress	string | null	Connected Solana wallet address
rewards.claimed	boolean	Whether the user has claimed community rewards
rewards.currentTier	object | null	Tier details based on token balance
rewards.currentTier.id	string	Tier identifier (whale, builder, or holder)
rewards.currentTier.label	string	Display name for the tier
rewards.currentTier.credits	number	Credits granted at this tier
rewards.currentTier.minBalance	number	Minimum token balance for this tier
rewards.balanceUi	number	Human-readable token balance
rewards.creditsClaimed	number	Number of credits claimed
rewards.claimedAt	string | null	ISO 8601 timestamp of the claim
rewards.availability	string	Service availability: live or degraded
rewards.detail	string | null	Additional status information when degraded
perks	array	List of community perks and their unlock status
perks[].key	string	Perk identifier (credits, basefm-pass, governance, airdrop)
perks[].title	string	Display title
perks[].detail	string	Description of the perk and its current status
perks[].unlocked	boolean	Whether the perk is active for the user
foundingBadge	object | null	Founding Community badge, or null if not earned
foundingBadge.key	string	Badge identifier (founding-community)
foundingBadge.title	string	Badge display title
foundingBadge.detail	string | null	Badge description
foundingBadge.walletAddress	string | null	Wallet address associated with the badge
foundingBadge.createdAt	string	ISO 8601 timestamp of badge creation
governance	object	Governance participation details
governance.eligible	boolean	Whether the user can vote (requires a claim)
governance.votingPower	number	Voting weight: 10 for Whale, 3 for Builder, 1 for Holder, 0 if unclaimed
governance.proposals	array	Recent governance proposals (up to 12)
governance.proposals[].id	string	Proposal identifier
governance.proposals[].slug	string	URL-safe slug
governance.proposals[].title	string	Proposal title
governance.proposals[].summary	string	Short summary
governance.proposals[].details	string | null	Extended description
governance.proposals[].status	string	active or closed
governance.proposals[].startsAt	string	ISO 8601 start timestamp
governance.proposals[].endsAt	string | null	ISO 8601 end timestamp, or null for open-ended
governance.proposals[].totals	object	Aggregated vote totals
governance.proposals[].totals.yes	number	Total weighted yes votes
governance.proposals[].totals.no	number	Total weighted no votes
governance.proposals[].totals.abstain	number	Total weighted abstain votes
governance.proposals[].userVote	object | null	The current user’s vote on this proposal, or null
governance.proposals[].userVote.choice	string	yes, no, or abstain
governance.proposals[].userVote.votingPower	number	Voting weight used
admin	boolean	Whether the current user has admin privileges

Perk unlock rules

Perk	Unlock condition
credits	Any tier claim
basefm-pass	Builder or Whale tier claim
governance	Any tier claim
airdrop	Any tier claim

Voting power by tier

Tier	Voting power
Whale	10
Builder	3
Holder	1
Unclaimed	0

Errors

Code	Description
401	Unauthorized — no valid session