SolGov: live Solana governance API (OpenAPI 3.1)

SolGov is a live monitor of Solana DeFi governance. The public API is SolGov Public API 1.0.0. Host https://solgov.xyz. OpenAPI 3.1: /api/openapi.json. Try-it UI: /api-docs.html. Telegram t.me/SolGovActivity. There is no docs.solgov.xyz and no llms.txt.

Coverage is the protocols they track (50+). Absence in a response does not mean absence on chain. governanceModel names the pattern: squads-v4, squads-v3, serum-multisig, realms-dao, wormhole-guardians, single-signer. Protocols without a Squads vault return threshold: 0, totalMembers: 0. Read that field first.

Read the live slice

Reads: 60 requests per minute per IP. Writes: 10. Headers X-RateLimit-*. Over: 429 or 503 with Retry-After. Live multisig state refreshes within about 30 minutes. Each governance row includes lastChecked and stalenessHours.

curl https://solgov.xyz/api/v1/health
curl https://solgov.xyz/api/v1/protocols
curl https://solgov.xyz/api/v1/governance?protocols=Kamino
curl https://solgov.xyz/api/v1/governance/Kamino
curl "https://solgov.xyz/api/v1/search?q=<BASE58>"

GET /api/v1/protocols lists the set, with canonical and role so treasury/governance vaults roll up. GET /api/v1/governance is one row per protocol: threshold, signer count, timelock, configAuthority, pending proposals, threat alerts. GET /api/v1/governance/{protocol} adds members and program upgrade authorities. Name match is case-insensitive with substring fallback. Search looks up a base58 as a current signer or upgrade authority. It does not search removed signers.

Events, history, badges

GET /api/v1/alerts/recent is append-only, real-time as transactions land, newest first, cap 500. Filter with since, protocol, type, limit. GET /api/v1/changelog/{protocol} is the permanent log (limit up to 500). GET /api/v1/feed.xml is the last 50 as RSS. GET /api/v1/cadence is upgrade frequency (30-day count and mean interval) from confirmed ProgramUpgrade events.

GET /api/v1/historical is weekly aggregates: txs, approved/rejected/cancelled proposals, config changes, upgrades, unique fee payers. Expect up to 7 days of lag. GET /api/v1/state is the heavy dump. GET /api/v1/health reports each surface stamp and whether it is stale. GET /api/v1/stride maps fields to Asymmetric Research STRIDE G1 to G5. Vocabulary only. No score. GET /api/v1/badge/{protocol}.json is a shields.io payload, e.g. 4/7 multisig, 24h timelock. Colour is always neutral.

Track and webhooks

POST /api/v1/track body { "address": "<Squads v4 pubkey>", "label": "optional" }. On-chain check that it is Squads v4. Live in about 60 seconds. 400 if not. 409 if the cap is full. 503 if RPC is down. GET lists {address, label, addedAt}.

POST /api/webhooks body url (required), optional protocols, severities (CRITICAL / HIGH / MONITOR), types. 201 returns a secret. GET/DELETE /api/webhooks/{id}?secret=.

Corrections: the spec says DM @Trader_CSK. That is the contact in the OpenAPI description, not a verified org handle on the site.

Resources

• solgov.xyz
• OpenAPI JSON
• API reference