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
}
}
}
Proposal API
Proposal AI
Ask questions about governance proposals and receive AI-powered analysis
POST
/
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.
Request Headers
Your API key for authentication
Request Body
Natural language question about a proposal
ID of the specific proposal to analyze. If omitted, the API will analyze across all proposals.
Response
Show Properties
Show Properties
AI-generated analysis responding to the query
ID of the analyzed proposal (if govaction_id was provided)
Title of the analyzed proposal (if govaction_id was provided)
Type of the analyzed proposal (if govaction_id was provided)
Subtype of the analyzed proposal, if applicable (if govaction_id was provided)
Show Properties
Show Properties
Original query 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
}
}
}
Status Codes
| Status Code | Description |
|---|---|
| 200 | Success - Analysis generated successfully |
| 400 | Bad Request - Invalid query parameters |
| 401 | Unauthorized - Missing or invalid API key |
| 404 | Not Found - Specified proposal not found |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Internal 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:| Type | Description |
|---|---|
| InfoAction | Informational or action proposals |
| ParameterChange | Protocol parameter modifications |
| NewConstitution | Constitutional updates |
| TreasuryWithdrawal | Treasury fund allocations |
| HardForkInitiation | Hardfork trigger proposals |
| NoConfidence | No-confidence votes |
| UpdateCommittee | Constitutional committee changes |
⌘I