Vote Data API

Migration Notice

Starting 19 May 2025, Sky Ecosystem’s governance-data API will split into two endpoints:

• Pre-upgrade Data (before 19 May 2025):

  • API Endpoint: https://vote.makerdao.com/api
  • Swagger Documentation: https://vote.makerdao.com/api-docs

• Post-upgrade Data (19 May 2025 onward):

  • API Endpoint: https://vote.sky.money/api
  • Swagger Documentation: https://vote.sky.money/api-docs

The underlying OpenAPI specifications, endpoints, and response schemas remain unchanged. The only required code change is updating the base URL for queries involving data from 19 May 2025 onward.

API Overview

The Sky Ecosystem Governance Portal exposes a public, read-only REST and ES-Module API, suitable for front-end applications. It returns JSON-formatted data and requires no authentication for GET requests.

The API documentation is available via Swagger UI, based on an OpenAPI specification.

Endpoint Details

• Base URLs:

  • Pre-upgrade: https://vote.makerdao.com/api
  • Post-upgrade: https://vote.sky.money/api

• Swagger UI:

  • Pre-upgrade: https://vote.makerdao.com/api-docs
  • Post-upgrade: https://vote.sky.money/api-docs

Resource Groups

Polling

Provides current and historical governance poll data, including proposal metadata, vote totals, outcome status, and full proposal text (via IPFS or GitHub markdown).

Executive

Exposes information on executive “spells,” such as queue status, estimated activation times (ETA), vote tallies, and defined office-hour windows.

Delegates

Returns delegate details—addresses, display names, pledged SKY or MKR, voting-power share, platform links, and self-reported mandate statements.

Voter Address

Surfaces voter-specific activity: individual voting history, delegated SKY or MKR amounts, current voting weight, and delegation relationships for a given Ethereum address.

ES Module

Offers a tree-shakable JavaScript module that exports the same governance objects used by the front-end, enabling zero-configuration integration in dApps.

Integration Notes

• MKR and SKY tokens are not 1:1 equivalent. Values returned from the pre- and post-upgrade APIs will differ accordingly; ensure appropriate handling when comparing data across endpoints.
• All endpoints remain publicly accessible without authentication.
• JavaScript applications can directly import governance data via the provided ES-Module endpoints.