# Realms — Solana DAO Governance

> Realms is the leading governance platform on Solana, powering 4,000+ DAOs with on-chain voting, treasury management, and DeFi integrations.

## MCP Server

Connect AI agents to Realms governance:

```
https://v2.realms.today/api/mcp
```

### Tools Available

- **SearchRealms** — Search documentation, API reference, and code examples
- **GetDAO** — Get DAO details, config, and governance accounts
- **ListProposals** — List proposals with filtering by state
- **GetTreasury** — Get treasury token balances with USD values
- **GetProposal** — Get proposal details, vote counts, instructions
- **CreateProposal** — Build unsigned proposal creation transactions
- **CastVote** — Build unsigned vote transactions
- **CreateSowellianBet** — Create a Sowellian bet proposal with Jupiter limit order

## REST API

Base: `https://v2.realms.today/api/v1`

### Read Endpoints
- GET /daos — List all DAOs
- GET /daos/:realmPk — DAO details
- GET /daos/:realmPk/proposals — List proposals
- GET /daos/:realmPk/proposals/:proposalPk — Proposal details
- GET /daos/:realmPk/treasury — Treasury balances
- GET /daos/:realmPk/governances — Governance configs
- GET /daos/:realmPk/members — Members and voting power
- GET /daos/:realmPk/delegates — Delegation info

### Write Endpoints (return unsigned transactions)
- POST /daos/create — Create new DAO
- POST /daos/:realmPk/proposals/create — Create proposal
- POST /daos/:realmPk/proposals/create-bet — Create Sowellian bet with limit order
- POST /daos/:realmPk/proposals/:proposalPk/vote — Cast vote
- POST /daos/:realmPk/proposals/:proposalPk/execute — Execute proposal
- POST /daos/:realmPk/proposals/:proposalPk/cancel — Cancel proposal
- POST /daos/:realmPk/proposals/:proposalPk/finalize — Finalize voting
- POST /daos/:realmPk/join — Join DAO (deposit tokens)
- POST /daos/:realmPk/leave — Leave DAO (withdraw tokens)
- POST /daos/:realmPk/delegate — Delegate voting power
- POST /daos/:realmPk/undelegate — Remove delegation

## DeFi Integrations

Proposals can include instructions for:
- **Jupiter** — Swaps, limit orders, DCA/recurring orders
- **Drift** — Perpetual futures, deposits, withdrawals
- **Kamino** — Lending deposits and withdrawals
- **Save (Solend)** — Staking
- **Validator Staking** — Native SOL staking

## Sowellian Fund Management

Social trading platform built on Realms:
- Fund managers propose trades as governance proposals
- Community votes on trade execution
- Built-in stop-loss/take-profit enforcement
- KPI-based performance tracking

### ⚠️ CreateSowellianBet — Critical Rules
- Sign and send ALL returned transactions in order
- The last tx contains sign-off + register_vote (auto-votes Yes)
- If you skip the last tx, bet collateral is PERMANENTLY LOCKED
- Only Jupiter limit orders supported (swaps expire before voting completes)
- Proposer must hold community tokens (deposited as collateral)

## Links
- App: https://v2.realms.today
- Docs: https://docs.realms.today
- GitHub: https://github.com/Mythic-Project/realms-ui
- Discord: https://discord.gg/realms