Skip to main content
POST
https://api.syncgovhub.com
/
api
/
proposal
/
ai
Proposal AI
curl --request POST \
  --url https://api.syncgovhub.com/api/proposal/ai \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "query": "<string>",
  "govaction_id": "<string>"
}
'
{
  "data": {
    "analysis": "## Parameter Change Analysis\n\nThis proposal suggests modifying the protocol parameter `minPoolCost` from 340 ADA to 170 ADA. This parameter sets the minimum fixed cost that stake pool operators (SPOs) can charge for operating a pool.\n\n### Main Objectives\n\nThe primary goal of this proposal is to lower the entry barrier for new stake pool operators by reducing the minimum fixed cost requirement by 50%. This change aims to enhance decentralization by making it more economically viable to operate smaller stake pools.\n\n### Technical Implications\n\nThe `minPoolCost` parameter directly affects stake pool economics in the following ways:\n\n1. **Pool Profitability**: Reducing this parameter allows pool operators to set lower fixed costs, potentially making smaller pools more competitive\n2. **Delegator Rewards**: Lower fixed costs could translate to higher returns for delegators of smaller pools\n3. **Network Topology**: The change may encourage the creation of more pools, potentially increasing network decentralization\n\n### Community Sentiment\n\nThe proposal received strong support from the DRep community, with 87.2% voting in favor. SPOs were more divided with 62.4% in favor, suggesting some existing operators have concerns about increased competition or potential impacts on the sustainability of smaller pools.\n\nThe total voting participation was high at 78.3%, indicating significant community interest in this parameter change.",
    "proposal_id": "gov1x8jkz74",
    "proposal_title": "Reduce minPoolCost Parameter from 340 to 170 ADA",
    "proposal_type": "ParameterChange",
    "proposal_subtype": "Economic"
  },
  "meta": {
    "query": "What are the main objectives and implications of this parameter change?",
    "content_sources": [
      {
        "url": "https://governance.cardano.org/en/proposals/gov1x8jkz74",
        "is_meta_url": true,
        "content_type": "proposal"
      },
      {
        "url": "https://github.com/cardano-foundation/cips/blob/master/CIP-0094/README.md",
        "is_meta_url": false,
        "content_type": "technical-reference"
      },
      {
        "url": "https://forum.cardano.org/t/discussion-reduce-minpoolcost-parameter-from-340-to-170-ada/128975",
        "is_meta_url": false,
        "content_type": "discussion"
      }
    ],
    "timings": {
      "fetch_proposal_data": 125,
      "search_content": 452,
      "openai_analysis": 2351,
      "total": 2928
    }
  }
}
Intelligent Analysis: This endpoint provides detailed, context-aware answers to questions about specific governance proposals or general proposal patterns using advanced AI.
The Proposal API enables you to ask natural language questions about Cardano governance proposals and receive detailed analysis based on the proposal content, metadata, and related documents. It can analyze specific proposals or provide insights on patterns across multiple proposals.

Request Headers

x-api-key
string
required
Your API key for authentication

Request Body

query
string
required
Natural language question about a proposal
govaction_id
string
ID of the specific proposal to analyze. If omitted, the API will analyze across all proposals.

Response

data
object
meta
object
{
  "data": {
    "analysis": "## Parameter Change Analysis\n\nThis proposal suggests modifying the protocol parameter `minPoolCost` from 340 ADA to 170 ADA. This parameter sets the minimum fixed cost that stake pool operators (SPOs) can charge for operating a pool.\n\n### Main Objectives\n\nThe primary goal of this proposal is to lower the entry barrier for new stake pool operators by reducing the minimum fixed cost requirement by 50%. This change aims to enhance decentralization by making it more economically viable to operate smaller stake pools.\n\n### Technical Implications\n\nThe `minPoolCost` parameter directly affects stake pool economics in the following ways:\n\n1. **Pool Profitability**: Reducing this parameter allows pool operators to set lower fixed costs, potentially making smaller pools more competitive\n2. **Delegator Rewards**: Lower fixed costs could translate to higher returns for delegators of smaller pools\n3. **Network Topology**: The change may encourage the creation of more pools, potentially increasing network decentralization\n\n### Community Sentiment\n\nThe proposal received strong support from the DRep community, with 87.2% voting in favor. SPOs were more divided with 62.4% in favor, suggesting some existing operators have concerns about increased competition or potential impacts on the sustainability of smaller pools.\n\nThe total voting participation was high at 78.3%, indicating significant community interest in this parameter change.",
    "proposal_id": "gov1x8jkz74",
    "proposal_title": "Reduce minPoolCost Parameter from 340 to 170 ADA",
    "proposal_type": "ParameterChange",
    "proposal_subtype": "Economic"
  },
  "meta": {
    "query": "What are the main objectives and implications of this parameter change?",
    "content_sources": [
      {
        "url": "https://governance.cardano.org/en/proposals/gov1x8jkz74",
        "is_meta_url": true,
        "content_type": "proposal"
      },
      {
        "url": "https://github.com/cardano-foundation/cips/blob/master/CIP-0094/README.md",
        "is_meta_url": false,
        "content_type": "technical-reference"
      },
      {
        "url": "https://forum.cardano.org/t/discussion-reduce-minpoolcost-parameter-from-340-to-170-ada/128975",
        "is_meta_url": false,
        "content_type": "discussion"
      }
    ],
    "timings": {
      "fetch_proposal_data": 125,
      "search_content": 452,
      "openai_analysis": 2351,
      "total": 2928
    }
  }
}

Status Codes

Status CodeDescription
200Success - Analysis generated successfully
400Bad Request - Invalid query parameters
401Unauthorized - Missing or invalid API key
404Not Found - Specified proposal not found
429Too Many Requests - Rate limit exceeded
500Internal Server Error

Notes

Content Sources: The API searches through various sources of content related to the proposal, including the proposal itself, technical references, and community discussions. These sources are used to generate a comprehensive analysis.
Response Time: Generating AI analysis for complex queries may take several seconds, especially for cross-proposal analysis that requires synthesizing information from multiple sources.

Proposal Types

The API supports analysis of all governance proposal types in the Cardano ecosystem:
TypeDescription
InfoActionInformational or action proposals
ParameterChangeProtocol parameter modifications
NewConstitutionConstitutional updates
TreasuryWithdrawalTreasury fund allocations
HardForkInitiationHardfork trigger proposals
NoConfidenceNo-confidence votes
UpdateCommitteeConstitutional committee changes