Skip to main content

​
API Reference

AI-Powered Analytics: The Cardano Governance Explorer API provides AI-enhanced endpoints to query and analyze Cardano’s on-chain governance data using natural language.
The API enables developers to access and integrate the power of our AI-driven blockchain governance analytics into their own applications, providing seamless access to DRep data, proposal analysis, and vote rationale insights.

​
API Structure

The Cardano Governance Explorer API is divided into three main categories, each serving a specific purpose:

DRep API

Explore and filter Delegated Representatives (DReps) using natural language queries

Proposal API

Analyze governance proposals with AI-powered insights

Rationale API

Extract insights from voting rationales across stakeholder groups

​
Authentication

API Key Required: All API endpoints require an API key for authentication.
Include your API key in the header of all requests: 
x-api-key: YOUR_API_KEY
To obtain an API key, register at the Cardano Governance Explorer Dashboard.

​
Base URL

All API requests should be made to: 
https://api.syncgovhub.com

​
Request Format

All API endpoints accept POST requests with a JSON body. Make sure to set the appropriate headers: 
x-api-key: YOUR_API_KEY

​
Response Format

All API responses follow a consistent structure: 
{
  "data": {
    // The main response data
  },
  "meta": {
    // Metadata about the request and response
    "timings": {
      // Performance metrics
    }
  }
}

​
Error Handling

When an error occurs, the API returns an appropriate HTTP status code and a JSON object explaining the error: 
{
  "error": "Descriptive error message",
  "details": "Additional information when available"
}
Common HTTP status codes:
Status CodeDescription
200Success
400Bad Request - Invalid parameters or request format
401Unauthorized - Invalid or missing API key
404Not Found - Resource does not exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Something went wrong on our end

​
Rate Limiting

To ensure service stability, API requests are rate-limited to:
  • 60 requests per minute per API key
  • 1,000 requests per day per API key
If you exceed these limits, you’ll receive a 429 Too Many Requests status code.

​
Support

If you encounter any issues or have questions about the API, reach out to our support team at [email protected].