Back to API Reference

Governance API

Shape the future of marine conservation. Vote on projects, earn governance rewards, and unlock exclusive benefits.

1,247
Active Voters
89%
Participation Rate
$50K
Governance Rewards Pool
POST

Submit Conservation Proposal

POST /api/v1/governance/proposals

👑 Proposal Rewards

  • Proposal Bonus: 500 SeaCoin tokens for approved proposals
  • Implementation Reward: 2% of project funding if proposal passes
  • Community Recognition: NFT badge for successful proposals
  • Voting Power Boost: +25% voting weight for future proposals
  • Expert Access: Direct line to marine conservation scientists

Request Body

{
  "title": "Maldives Coral Nursery Expansion",
  "description": "Expand existing coral nursery to 500 new fragments",
  "funding_requested": "75000",      // USD
  "project_duration": "12",          // months
  "conservation_partner": "Maldives Marine Research Institute",
  "expected_impact": {
    "coral_fragments": 500,
    "reef_area": "25.5",             // square meters
    "species_protected": 15,
    "carbon_sequestered": "3.2"      // tons CO2
  },
  "proposer_stake": "50.0",          // SOL staked (min 25 SOL to propose)
  "supporting_documents": [
    "ipfs://QmX7Y8Z9...",            // Scientific study
    "ipfs://QmA1B2C3..."             // Budget breakdown
  ]
}

Response

{
  "proposal_id": "PROP_2024_047",
  "status": "pending_review",
  "voting_starts": "2024-12-15T00:00:00Z",
  "voting_ends": "2024-12-22T00:00:00Z",
  "minimum_quorum": "1000",          // SOL voting power needed
  "potential_rewards": {
    "approval_bonus": "500 SeaCoin",
    "implementation_fee": "1500 USD",
    "nft_badge": "Conservation Pioneer #47"
  },
  "review_timeline": "7 days",
  "expert_feedback_available": true
}
POST

Vote on Proposals

POST /api/v1/governance/vote

🗳️ Voting Incentives

  • Voting Rewards: 10 SeaCoin tokens per vote cast
  • Streak Bonus: +5 tokens for voting on 5+ consecutive proposals
  • Early Voter Bonus: 2x rewards for voting in first 24 hours
  • Accuracy Rewards: Bonus tokens for voting with majority
  • Delegation Income: Earn 5% of delegated voting rewards

Request Body

{
  "proposal_id": "PROP_2024_047",
  "vote": "yes",                     // "yes", "no", "abstain"
  "voting_power": "25.5",            // SOL staked = voting power
  "comment": "Strong scientific backing and clear impact metrics",
  "delegate_to": null,               // Optional: delegate future votes
  "conviction": "high"               // "low", "medium", "high" - affects rewards
}

Response

{
  "vote_recorded": true,
  "transaction_id": "VOTE_5KJp9X2mN8qR7vL3wE1fG4hS6tY9uI0oP",
  "voting_power_used": "25.5",
  "rewards_earned": {
    "base_reward": "10 SeaCoin",
    "early_voter_bonus": "10 SeaCoin",
    "conviction_bonus": "5 SeaCoin",
    "total": "25 SeaCoin"
  },
  "current_vote_tally": {
    "yes": "1247.8 SOL",
    "no": "234.2 SOL",
    "abstain": "89.1 SOL"
  },
  "your_voting_streak": 7,
  "next_streak_bonus": "15 SeaCoin at 10 votes"
}
GET

Check Governance Status

GET /api/v1/governance/status/:wallet_address

🏆 Governance Rankings

  • Voting Power Rank: Top 1% voters get exclusive proposal previews
  • Participation Score: High participation = higher APY on staking
  • Influence Rating: Track how your votes affect outcomes
  • Reputation System: Build credibility for future proposals
  • Leadership Rewards: Top voters eligible for governance council

Response

{
  "wallet_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "governance_stats": {
    "voting_power": "125.7 SOL",
    "total_votes_cast": 23,
    "voting_streak": 7,
    "participation_rate": "92%",
    "accuracy_score": "87%"          // Voting with majority
  },
  "rewards_earned": {
    "total_seacoin": "347",
    "pending_rewards": "25",
    "monthly_income": "89 SeaCoin"
  },
  "governance_rank": {
    "title": "Ocean Advocate",
    "rank": 47,                      // Out of 1,247 voters
    "next_tier": "Marine Guardian",
    "progress": "73%"
  },
  "special_privileges": [
    "Early proposal access",
    "Direct scientist contact",
    "VIP conservation updates",
    "Governance council eligibility"
  ],
  "delegation": {
    "delegated_to_you": "89.3 SOL",  // Others delegating to you
    "delegation_income": "12.4 SeaCoin/month",
    "your_delegates": 8
  }
}

🌟 Governance Council Benefits

Council Member Rewards

  • Monthly Stipend: 1,000 SeaCoin tokens
  • Proposal Priority: Fast-track your conservation ideas
  • Expert Network: Direct access to marine scientists
  • Conference Invites: Free tickets to conservation summits

Exclusive Privileges

  • Project Veto Power: Block harmful proposals
  • Emergency Funding: Approve urgent conservation needs
  • Partnership Deals: Negotiate with conservation organizations
  • Protocol Upgrades: Vote on technical improvements

How to Join the Council

Top 12 voters by participation rate and voting power are elected quarterly. Minimum requirements: 100+ SOL staked, 90%+ participation rate, 5+ successful proposals.