DRep AI

DRep AI

curl --request POST \
  --url https://api.syncgovhub.com/api/drep/ai \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "query": "<string>",
  "page": 123,
  "limit": 123,
  "sort": "<string>",
  "sortDirection": "<string>"
}
'

import requests

url = "https://api.syncgovhub.com/api/drep/ai"

payload = {
    "query": "<string>",
    "page": 123,
    "limit": 123,
    "sort": "<string>",
    "sortDirection": "<string>"
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: '<string>',
    page: 123,
    limit: 123,
    sort: '<string>',
    sortDirection: '<string>'
  })
};

fetch('https://api.syncgovhub.com/api/drep/ai', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.syncgovhub.com/api/drep/ai",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'page' => 123,
    'limit' => 123,
    'sort' => '<string>',
    'sortDirection' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.syncgovhub.com/api/drep/ai"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123,\n  \"sort\": \"<string>\",\n  \"sortDirection\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.syncgovhub.com/api/drep/ai")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123,\n  \"sort\": \"<string>\",\n  \"sortDirection\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.syncgovhub.com/api/drep/ai")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123,\n  \"sort\": \"<string>\",\n  \"sortDirection\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "drepId": "drep1y24xr6m4mkgl7e7886sk3wee7h73mcreysyvhrwzksy5ajqrv0rrv",
      "id": "dc3cfd1e-3308-4223-adf6-da1662a1b4b0",
      "links": [
        "x.com/Crown_Tech1021",
        "crown-tech.co.jp/ctecstakepool",
        "https://www.crown-tech.co.jp/DRep/CTEC-Stake-Pool.jsonld"
      ],
      "metrics": {
        "participationRate": 100,
        "votingPower": 19829102.491109,
        "communityAlignment": 0,
        "proposalsVoted": 12,
        "globalAlignment": 54.19,
        "totalDelegators": 33,
        "totalAllowedProposals": 12,
        "totalProposals": 18
      },
      "motivations": "●目標：Target\n\n・安全で安心できるカルダノネットワークを運営する\n\n　Operate a safe and secure Cardano network.\n\n・カルダノネットワークをより高度な次元へ発展させるために貢献する\n\n　Contribute to the development of the Cardano network to a higher dimension.\n",
      "name": "CTEC-Stake-Pool",
      "objectives": "●ミッション：mission\n\nカルダノネットワークの発展のためにDRepとして活動していきます\n\nI will work as a DRep for the development of the Cardano network.",
      "profilePic": null,
      "qualifications": "●資格：Qualifications\n\n　CTEC Stake Pool Operator（SPO）",
      "registration_date": "2024-11-14T09:54:59+00:00",
      "status": "active",
      "username": "drep1y24xr6m4mkgl7e7886sk3wee7h73mcreysyvhrwzksy5ajqrv0rrv",
      "voting_history": [
        {
          "communityAlignment": "Coming Soon",
          "alignmentStatus": "aligned",
          "date": "2025-03-25",
          "globalAlignment": 54.19,
          "id": "1b75c28f-e77b-4304-b050-9ee894d863f5",
          "isAligned": true,
          "proposalId": "gov_action1nd3t833j7v5sz65k3tp9yyvztw60sjcjgcgjr37682s3m7frwrusqmd2k80",
          "isIncluded": true,
          "proposalTitle": "2025 Net Change Limit",
          "majorityVote": "Yes",
          "proposalUrl": "ipfs://bafkreiaqno22swabd3kcqt2awtgwaucdzaagacoemxwadm3exrchhnfite",
          "rationale": "As agreed with the Cardano Budget Committee, the 2025 Net Change Limit shall begin at the start of Epoch 532 and progress for 72 epochs, concluding in December 2025 at the end of Epoch 604.\n\nThe 2025 Net Change Limit shall be set at 350,000,000,000,000 lovelace (350M ada).\n\nThis figure is derived from our modeling, which projected in October 2024 that the treasury would increase by approximately 351M ada across 2024 (epoch 459-531), including all approved withdrawals (e.g., Catalyst). Based on this analysis, the 2025 Net Change Limit was proposed at 350m ada. From January 5th, 2024, Epoch 459, through December 30th, Epoch 531, the actual total income into the Cardano Treasury was 335,957,093 ada. Since this is within 5% of our proposed number, the 2025 Net Change Limit should stay at 350 million ada.",
          "type": "InfoAction",
          "subtype": null,
          "vote": "Yes",
          "drepVotingAllowed": true
        }
      ],
      "active_since": "2024-11-14T09:54:59",
      "metadata": {
        "drep_id": "drep1y24xr6m4mkgl7e7886sk3wee7h73mcreysyvhrwzksy5ajqrv0rrv",
        "hex": "22aa61eb75dd91ff67c73ea168bb39f5fd1de0792408cb8dc2b4094ec8",
        "url": "https://www.crown-tech.co.jp/DRep/CTEC-Stake-Pool.jsonld",
        "hash": "d679b05cc0de219e47c11333bc1faf0caa6b75d480dbf406b69a60016ef8b551",
        "json_metadata": { /* ... detailed metadata ... */ },
        "bytes": "\\x7b0a20202240636f...",
        "location": null,
        "other_links": [
          "x.com/Crown_Tech1021",
          "crown-tech.co.jp/ctecstakepool"
        ],
        "created_at": "2025-04-09T10:27:41.477642+00:00",
        "updated_at": "2025-05-21T03:14:13.159637+00:00"
      }
    }
  ],
  "meta": {
    "explanation": "Found 112 DReps who voted yes on the Cardano net change proposal and no on the Cardano Treasury DeFi Liquidity Budget, while DRep voting was not allowed for the Plutus V3 Cost Model Parameter Changes. These DReps demonstrate active governance participation with an average participation rate of 84.49% and significant voting power representation.",
    "query": "Find DReps who voted yes on the cardano net change and no on Cardano Treasury DeFi Liquidity Budget",
    "parsedQuery": {
      "queryType": "proposal_first",
      "proposalFilters": {
        "title": {
          "all": [
            "Set a 300 million ADA Net Change Limit for Epochs 563–635",
            "Cardano Treasury DeFi Liquidity Budget"
          ]
        }
      },
      "voteFilters": {
        "vote": {
          "all": [
            {
              "proposalTitle": "Set a 300 million ADA Net Change Limit for Epochs 563–635",
              "value": "yes"
            },
            {
              "proposalTitle": "Cardano Treasury DeFi Liquidity Budget", 
              "value": "no"
            }
          ]
        },
        "voterRole": "DRep"
      },
      "drepFilters": {},
      "orderBy": [
        {
          "column": "participation_data->rate",
          "direction": "desc",
          "nullsPosition": "last",
          "excludeZeros": false
        },
        {
          "column": "basic_info->ada_delegated",
          "direction": "desc", 
          "nullsPosition": "last",
          "excludeZeros": false
        }
      ],
      "explanation": "Query focuses on DReps with specific voting patterns across multiple proposals using AND logic.",
      "pagination": {
        "page": 1,
        "limit": 5,
        "total": 112,
        "pages": 23
      }
    },
    "queryIntent": "proposal_first",
    "matchedProposals": [
      {
        "id": "gov_action1vdlrcftd48qn2zz8egepr6xyfcmxpfz8r69k769gc5mhg662adesq9yy8pl",
        "title": "Set a 300 million ADA Net Change Limit for Epochs 563–635",
        "type": "InfoAction",
        "subtype": null,
        "drepVotingAllowed": true
      },
      {
        "id": "gov_action1fpqwxp2kxvnntr8hpkh9q9djm78ccdww7qlhg5safugh4stmcwzqql5lauu",
        "title": "Cardano Treasury DeFi Liquidity Budget",
        "type": "InfoAction", 
        "subtype": null,
        "drepVotingAllowed": true
      }
    ],
    "resultCount": 1,
    "usedCache": true,
    "redisAvailable": true,
    "sortInfo": {
      "field": "participation",
      "direction": "desc"
    },
    "optimized": true
  },
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 194,
    "pages": 20
  },
  "timings": {
    "intent_determination": 1631,
    "query_parsing": 5060,
    "database_queries": 609,
    "data_transformation": 0,
    "explanation_generation": 2917,
    "proposal_validation": 6649,
    "redis_get": 332,
    "redis_set": 0,
    "sort_application": 1,
    "total": 1120
  }
}

{
  "error": "Missing or invalid query",
  "details": "Please provide a valid query string"
}

{
  "error": "Unauthorized",
  "message": "API key is required"
}

{
  "error": "No DReps found matching your criteria",
  "details": "Could not find proposals with the following title(s): Invalid Proposal Name",
  "suggestions": [
    {
      "id": "gov_action1abc123",
      "title": "Similar Proposal Name",
      "type": "InfoAction"
    }
  ]
}

{
  "error": "DReps cannot vote on the specified proposals",
  "details": "DReps are not allowed to vote on the following proposals: Protocol Parameter Change XYZ",
  "disallowedProposals": [
    {
      "id": "gov_action1xyz789",
      "title": "Protocol Parameter Change XYZ", 
      "type": "ParameterChange",
      "subtype": "Technical"
    }
  ]
}

{
  "error": "Failed to process query",
  "details": "Internal server error occurred while processing the request"
}

POST

api

drep

DRep AI

curl --request POST \
  --url https://api.syncgovhub.com/api/drep/ai \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "query": "<string>",
  "page": 123,
  "limit": 123,
  "sort": "<string>",
  "sortDirection": "<string>"
}
'

import requests

url = "https://api.syncgovhub.com/api/drep/ai"

payload = {
    "query": "<string>",
    "page": 123,
    "limit": 123,
    "sort": "<string>",
    "sortDirection": "<string>"
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: '<string>',
    page: 123,
    limit: 123,
    sort: '<string>',
    sortDirection: '<string>'
  })
};

fetch('https://api.syncgovhub.com/api/drep/ai', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.syncgovhub.com/api/drep/ai",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'page' => 123,
    'limit' => 123,
    'sort' => '<string>',
    'sortDirection' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.syncgovhub.com/api/drep/ai"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123,\n  \"sort\": \"<string>\",\n  \"sortDirection\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.syncgovhub.com/api/drep/ai")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123,\n  \"sort\": \"<string>\",\n  \"sortDirection\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.syncgovhub.com/api/drep/ai")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123,\n  \"sort\": \"<string>\",\n  \"sortDirection\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "drepId": "drep1y24xr6m4mkgl7e7886sk3wee7h73mcreysyvhrwzksy5ajqrv0rrv",
      "id": "dc3cfd1e-3308-4223-adf6-da1662a1b4b0",
      "links": [
        "x.com/Crown_Tech1021",
        "crown-tech.co.jp/ctecstakepool",
        "https://www.crown-tech.co.jp/DRep/CTEC-Stake-Pool.jsonld"
      ],
      "metrics": {
        "participationRate": 100,
        "votingPower": 19829102.491109,
        "communityAlignment": 0,
        "proposalsVoted": 12,
        "globalAlignment": 54.19,
        "totalDelegators": 33,
        "totalAllowedProposals": 12,
        "totalProposals": 18
      },
      "motivations": "●目標：Target\n\n・安全で安心できるカルダノネットワークを運営する\n\n　Operate a safe and secure Cardano network.\n\n・カルダノネットワークをより高度な次元へ発展させるために貢献する\n\n　Contribute to the development of the Cardano network to a higher dimension.\n",
      "name": "CTEC-Stake-Pool",
      "objectives": "●ミッション：mission\n\nカルダノネットワークの発展のためにDRepとして活動していきます\n\nI will work as a DRep for the development of the Cardano network.",
      "profilePic": null,
      "qualifications": "●資格：Qualifications\n\n　CTEC Stake Pool Operator（SPO）",
      "registration_date": "2024-11-14T09:54:59+00:00",
      "status": "active",
      "username": "drep1y24xr6m4mkgl7e7886sk3wee7h73mcreysyvhrwzksy5ajqrv0rrv",
      "voting_history": [
        {
          "communityAlignment": "Coming Soon",
          "alignmentStatus": "aligned",
          "date": "2025-03-25",
          "globalAlignment": 54.19,
          "id": "1b75c28f-e77b-4304-b050-9ee894d863f5",
          "isAligned": true,
          "proposalId": "gov_action1nd3t833j7v5sz65k3tp9yyvztw60sjcjgcgjr37682s3m7frwrusqmd2k80",
          "isIncluded": true,
          "proposalTitle": "2025 Net Change Limit",
          "majorityVote": "Yes",
          "proposalUrl": "ipfs://bafkreiaqno22swabd3kcqt2awtgwaucdzaagacoemxwadm3exrchhnfite",
          "rationale": "As agreed with the Cardano Budget Committee, the 2025 Net Change Limit shall begin at the start of Epoch 532 and progress for 72 epochs, concluding in December 2025 at the end of Epoch 604.\n\nThe 2025 Net Change Limit shall be set at 350,000,000,000,000 lovelace (350M ada).\n\nThis figure is derived from our modeling, which projected in October 2024 that the treasury would increase by approximately 351M ada across 2024 (epoch 459-531), including all approved withdrawals (e.g., Catalyst). Based on this analysis, the 2025 Net Change Limit was proposed at 350m ada. From January 5th, 2024, Epoch 459, through December 30th, Epoch 531, the actual total income into the Cardano Treasury was 335,957,093 ada. Since this is within 5% of our proposed number, the 2025 Net Change Limit should stay at 350 million ada.",
          "type": "InfoAction",
          "subtype": null,
          "vote": "Yes",
          "drepVotingAllowed": true
        }
      ],
      "active_since": "2024-11-14T09:54:59",
      "metadata": {
        "drep_id": "drep1y24xr6m4mkgl7e7886sk3wee7h73mcreysyvhrwzksy5ajqrv0rrv",
        "hex": "22aa61eb75dd91ff67c73ea168bb39f5fd1de0792408cb8dc2b4094ec8",
        "url": "https://www.crown-tech.co.jp/DRep/CTEC-Stake-Pool.jsonld",
        "hash": "d679b05cc0de219e47c11333bc1faf0caa6b75d480dbf406b69a60016ef8b551",
        "json_metadata": { /* ... detailed metadata ... */ },
        "bytes": "\\x7b0a20202240636f...",
        "location": null,
        "other_links": [
          "x.com/Crown_Tech1021",
          "crown-tech.co.jp/ctecstakepool"
        ],
        "created_at": "2025-04-09T10:27:41.477642+00:00",
        "updated_at": "2025-05-21T03:14:13.159637+00:00"
      }
    }
  ],
  "meta": {
    "explanation": "Found 112 DReps who voted yes on the Cardano net change proposal and no on the Cardano Treasury DeFi Liquidity Budget, while DRep voting was not allowed for the Plutus V3 Cost Model Parameter Changes. These DReps demonstrate active governance participation with an average participation rate of 84.49% and significant voting power representation.",
    "query": "Find DReps who voted yes on the cardano net change and no on Cardano Treasury DeFi Liquidity Budget",
    "parsedQuery": {
      "queryType": "proposal_first",
      "proposalFilters": {
        "title": {
          "all": [
            "Set a 300 million ADA Net Change Limit for Epochs 563–635",
            "Cardano Treasury DeFi Liquidity Budget"
          ]
        }
      },
      "voteFilters": {
        "vote": {
          "all": [
            {
              "proposalTitle": "Set a 300 million ADA Net Change Limit for Epochs 563–635",
              "value": "yes"
            },
            {
              "proposalTitle": "Cardano Treasury DeFi Liquidity Budget", 
              "value": "no"
            }
          ]
        },
        "voterRole": "DRep"
      },
      "drepFilters": {},
      "orderBy": [
        {
          "column": "participation_data->rate",
          "direction": "desc",
          "nullsPosition": "last",
          "excludeZeros": false
        },
        {
          "column": "basic_info->ada_delegated",
          "direction": "desc", 
          "nullsPosition": "last",
          "excludeZeros": false
        }
      ],
      "explanation": "Query focuses on DReps with specific voting patterns across multiple proposals using AND logic.",
      "pagination": {
        "page": 1,
        "limit": 5,
        "total": 112,
        "pages": 23
      }
    },
    "queryIntent": "proposal_first",
    "matchedProposals": [
      {
        "id": "gov_action1vdlrcftd48qn2zz8egepr6xyfcmxpfz8r69k769gc5mhg662adesq9yy8pl",
        "title": "Set a 300 million ADA Net Change Limit for Epochs 563–635",
        "type": "InfoAction",
        "subtype": null,
        "drepVotingAllowed": true
      },
      {
        "id": "gov_action1fpqwxp2kxvnntr8hpkh9q9djm78ccdww7qlhg5safugh4stmcwzqql5lauu",
        "title": "Cardano Treasury DeFi Liquidity Budget",
        "type": "InfoAction", 
        "subtype": null,
        "drepVotingAllowed": true
      }
    ],
    "resultCount": 1,
    "usedCache": true,
    "redisAvailable": true,
    "sortInfo": {
      "field": "participation",
      "direction": "desc"
    },
    "optimized": true
  },
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 194,
    "pages": 20
  },
  "timings": {
    "intent_determination": 1631,
    "query_parsing": 5060,
    "database_queries": 609,
    "data_transformation": 0,
    "explanation_generation": 2917,
    "proposal_validation": 6649,
    "redis_get": 332,
    "redis_set": 0,
    "sort_application": 1,
    "total": 1120
  }
}

{
  "error": "Missing or invalid query",
  "details": "Please provide a valid query string"
}

{
  "error": "Unauthorized",
  "message": "API key is required"
}

{
  "error": "No DReps found matching your criteria",
  "details": "Could not find proposals with the following title(s): Invalid Proposal Name",
  "suggestions": [
    {
      "id": "gov_action1abc123",
      "title": "Similar Proposal Name",
      "type": "InfoAction"
    }
  ]
}

{
  "error": "DReps cannot vote on the specified proposals",
  "details": "DReps are not allowed to vote on the following proposals: Protocol Parameter Change XYZ",
  "disallowedProposals": [
    {
      "id": "gov_action1xyz789",
      "title": "Protocol Parameter Change XYZ", 
      "type": "ParameterChange",
      "subtype": "Technical"
    }
  ]
}

{
  "error": "Failed to process query",
  "details": "Internal server error occurred while processing the request"
}

Enhanced AI-Powered Search: The DRep AI API uses advanced natural language processing to understand complex queries about Cardano’s Delegated Representatives, including their voting patterns, attributes, and governance participation.

The DRep AI API enables you to find DReps based on comprehensive criteria, including their attributes (voting power, delegators, participation rate, alignment scores) and their detailed voting behavior on specific proposals using natural language queries.

Request Headers

string

required

Your API key for authentication

Request Body

string

required

Natural language query describing the DReps you want to find. Supports complex queries with AND/OR logic, proposal-specific searches, and attribute-based filtering.Example queries:

"Find DReps with more than 100M ADA voting power"
"Show active DReps who voted yes on the Cardano NCL proposal"
"Find DReps who voted yes on treasury proposals and no on parameter changes"
"Show DReps registered in 2024 with high participation rates"

number

default:"1"

Page number for pagination (minimum: 1)

number

default:"10"

Number of results per page (minimum: 1, maximum: 100)

string

default:"default"

Sort field for ordering results. Available options:

"default" - Default sorting (by voting power)
"name" - Sort by DRep name (alphabetical)
"participation" - Sort by participation rate
"votingPower" - Sort by voting power (ADA delegated)
"delegators" - Sort by number of delegators
"alignment" - Sort by alignment score

string

default:"desc"

Sort direction for ordering results:

"desc" - Descending order (highest to lowest)
"asc" - Ascending order (lowest to highest)

Note: For name sorting, "asc" = A-Z, "desc" = Z-A

Response

array

Array of DReps matching the query

Show DRep Object

string

Unique Bech32 identifier for the DRep (starts with “drep1”)

string

Internal database UUID

string

Display name of the DRep (falls back to drepId if no name set)

string

Current DRep status. Possible values:

"active" - Currently participating in governance
"inactive" - Not currently participating
"retired" - No longer participating
"registered" - Registered but not yet active

object

Show Performance Metrics

number

Total amount of ADA delegated to this DRep (in ADA)

number

Number of wallets delegating to this DRep

number

Percentage of allowed proposals this DRep has voted on (0-100)

number

Average alignment percentage with community consensus across all votes (0-100)

number

Alignment with community-specific voting patterns (currently always 0)

number

Total number of proposals this DRep has voted on

number

Number of proposals this DRep was eligible to vote on

number

Total number of proposals in the governance system

array

Array of URLs and social media links associated with the DRep

string

DRep’s stated motivations for participation

string

DRep’s stated objectives

string

DRep’s qualifications

string

URL to profile picture (if available)

string

ISO timestamp of registration

string

Username (usually same as drepId)

array

Show Properties

string

Whether the vote aligned with majority (“aligned”, “opposed”, “not_voted”)

string

Date of the vote (YYYY-MM-DD)

number

Global alignment percentage for this vote

string

ID of the proposal

string

Title of the proposal

string

The majority vote on this proposal

string

URL to the proposal details

string

Proposal rationale

string

Type of proposal (InfoAction, ParameterChange, etc.)

string

Subtype of proposal (if applicable)

string

DRep’s vote (Yes, No, Abstain)

boolean

Whether DRep voting was allowed on this proposal

string

Date when the DRep became active

object

Detailed metadata about the DRep

string

Geographic location (if provided)

string

Primary URL associated with the DRep

array

Additional links associated with the DRep

string

Timestamp when the record was created

string

Timestamp when the record was last updated

object

Show Query Analysis and Results

string

AI-generated explanation of the search results, including key insights and patterns

string

Original query string as submitted

object

Detailed breakdown of how the AI interpreted your query

Show Query Interpretation

string

Type of query detected. Possible values:

"proposal_first" - Query focused on proposal voting behavior
"drep_first" - Query focused on DRep attributes
"balanced" - Query combining both proposal and DRep criteria
"voting_history" - Query requesting specific DRep’s voting history

object

Filters applied to proposals, including title searches and proposal types

object

Filters applied to voting behavior (yes/no/abstain patterns)

object

Filters applied to DRep attributes (voting power, delegators, etc.)

array

Applied sorting configuration with tie-breaking rules

string

Detailed explanation of how the query was interpreted

object

Applied pagination settings

string

High-level intent classification of the query

array

Proposals that were identified and matched in your query

Show Proposal Match

string

Unique proposal identifier (gov_action format)

string

Human-readable proposal title

string

Proposal type. Possible values:

"InfoAction" - Informational governance action
"ParameterChange" - Protocol parameter modification
"TreasuryWithdrawal" - Treasury fund withdrawal
"NewConstitution" - Constitution or guardrails update
"HardForkInitiation" - Hard fork proposal
"NoConfidence" - Motion of no confidence
"UpdateCommittee" - Constitutional committee update

string

Proposal subtype (for ParameterChange proposals). Possible values:

"Network" - Network-related parameters
"Economic" - Economic parameters
"Technical" - Technical parameters
"Governance" - Governance parameters
null - No subtype (for non-ParameterChange proposals)

boolean

Whether DReps are permitted to vote on this proposal

number

Number of DReps returned in this page of results

array

Proposal titles mentioned in query that could not be found (if any)

array

Alternative proposal suggestions when exact matches aren’t found

boolean

Whether cached results were used to speed up the response

boolean

Whether caching system is available

object

Information about applied sorting

Show Sort Information

string

The primary sort field used

string

The sort direction applied (“asc” or “desc”)

boolean

Flag indicating this uses the optimized query engine (always true)

object

Show Pagination Information

number

Current page number

number

Number of results per page

number

Total number of DReps matching the query across all pages

number

Total number of pages available

object

Detailed performance metrics for the request (in milliseconds)

Show Performance Breakdown

number

Time to analyze and determine query intent

number

Time to parse natural language into database filters

number

Time to execute database queries

number

Time to transform raw data into response format

number

Time to generate AI explanation of results

number

Time to validate and match proposal references

number

Time to retrieve cached data

number

Time to store data in cache

number

Time to apply sorting and pagination

number

Total request processing time

{
  "data": [
    {
      "drepId": "drep1y24xr6m4mkgl7e7886sk3wee7h73mcreysyvhrwzksy5ajqrv0rrv",
      "id": "dc3cfd1e-3308-4223-adf6-da1662a1b4b0",
      "links": [
        "x.com/Crown_Tech1021",
        "crown-tech.co.jp/ctecstakepool",
        "https://www.crown-tech.co.jp/DRep/CTEC-Stake-Pool.jsonld"
      ],
      "metrics": {
        "participationRate": 100,
        "votingPower": 19829102.491109,
        "communityAlignment": 0,
        "proposalsVoted": 12,
        "globalAlignment": 54.19,
        "totalDelegators": 33,
        "totalAllowedProposals": 12,
        "totalProposals": 18
      },
      "motivations": "●目標：Target\n\n・安全で安心できるカルダノネットワークを運営する\n\n　Operate a safe and secure Cardano network.\n\n・カルダノネットワークをより高度な次元へ発展させるために貢献する\n\n　Contribute to the development of the Cardano network to a higher dimension.\n",
      "name": "CTEC-Stake-Pool",
      "objectives": "●ミッション：mission\n\nカルダノネットワークの発展のためにDRepとして活動していきます\n\nI will work as a DRep for the development of the Cardano network.",
      "profilePic": null,
      "qualifications": "●資格：Qualifications\n\n　CTEC Stake Pool Operator（SPO）",
      "registration_date": "2024-11-14T09:54:59+00:00",
      "status": "active",
      "username": "drep1y24xr6m4mkgl7e7886sk3wee7h73mcreysyvhrwzksy5ajqrv0rrv",
      "voting_history": [
        {
          "communityAlignment": "Coming Soon",
          "alignmentStatus": "aligned",
          "date": "2025-03-25",
          "globalAlignment": 54.19,
          "id": "1b75c28f-e77b-4304-b050-9ee894d863f5",
          "isAligned": true,
          "proposalId": "gov_action1nd3t833j7v5sz65k3tp9yyvztw60sjcjgcgjr37682s3m7frwrusqmd2k80",
          "isIncluded": true,
          "proposalTitle": "2025 Net Change Limit",
          "majorityVote": "Yes",
          "proposalUrl": "ipfs://bafkreiaqno22swabd3kcqt2awtgwaucdzaagacoemxwadm3exrchhnfite",
          "rationale": "As agreed with the Cardano Budget Committee, the 2025 Net Change Limit shall begin at the start of Epoch 532 and progress for 72 epochs, concluding in December 2025 at the end of Epoch 604.\n\nThe 2025 Net Change Limit shall be set at 350,000,000,000,000 lovelace (350M ada).\n\nThis figure is derived from our modeling, which projected in October 2024 that the treasury would increase by approximately 351M ada across 2024 (epoch 459-531), including all approved withdrawals (e.g., Catalyst). Based on this analysis, the 2025 Net Change Limit was proposed at 350m ada. From January 5th, 2024, Epoch 459, through December 30th, Epoch 531, the actual total income into the Cardano Treasury was 335,957,093 ada. Since this is within 5% of our proposed number, the 2025 Net Change Limit should stay at 350 million ada.",
          "type": "InfoAction",
          "subtype": null,
          "vote": "Yes",
          "drepVotingAllowed": true
        }
      ],
      "active_since": "2024-11-14T09:54:59",
      "metadata": {
        "drep_id": "drep1y24xr6m4mkgl7e7886sk3wee7h73mcreysyvhrwzksy5ajqrv0rrv",
        "hex": "22aa61eb75dd91ff67c73ea168bb39f5fd1de0792408cb8dc2b4094ec8",
        "url": "https://www.crown-tech.co.jp/DRep/CTEC-Stake-Pool.jsonld",
        "hash": "d679b05cc0de219e47c11333bc1faf0caa6b75d480dbf406b69a60016ef8b551",
        "json_metadata": { /* ... detailed metadata ... */ },
        "bytes": "\\x7b0a20202240636f...",
        "location": null,
        "other_links": [
          "x.com/Crown_Tech1021",
          "crown-tech.co.jp/ctecstakepool"
        ],
        "created_at": "2025-04-09T10:27:41.477642+00:00",
        "updated_at": "2025-05-21T03:14:13.159637+00:00"
      }
    }
  ],
  "meta": {
    "explanation": "Found 112 DReps who voted yes on the Cardano net change proposal and no on the Cardano Treasury DeFi Liquidity Budget, while DRep voting was not allowed for the Plutus V3 Cost Model Parameter Changes. These DReps demonstrate active governance participation with an average participation rate of 84.49% and significant voting power representation.",
    "query": "Find DReps who voted yes on the cardano net change and no on Cardano Treasury DeFi Liquidity Budget",
    "parsedQuery": {
      "queryType": "proposal_first",
      "proposalFilters": {
        "title": {
          "all": [
            "Set a 300 million ADA Net Change Limit for Epochs 563–635",
            "Cardano Treasury DeFi Liquidity Budget"
          ]
        }
      },
      "voteFilters": {
        "vote": {
          "all": [
            {
              "proposalTitle": "Set a 300 million ADA Net Change Limit for Epochs 563–635",
              "value": "yes"
            },
            {
              "proposalTitle": "Cardano Treasury DeFi Liquidity Budget", 
              "value": "no"
            }
          ]
        },
        "voterRole": "DRep"
      },
      "drepFilters": {},
      "orderBy": [
        {
          "column": "participation_data->rate",
          "direction": "desc",
          "nullsPosition": "last",
          "excludeZeros": false
        },
        {
          "column": "basic_info->ada_delegated",
          "direction": "desc", 
          "nullsPosition": "last",
          "excludeZeros": false
        }
      ],
      "explanation": "Query focuses on DReps with specific voting patterns across multiple proposals using AND logic.",
      "pagination": {
        "page": 1,
        "limit": 5,
        "total": 112,
        "pages": 23
      }
    },
    "queryIntent": "proposal_first",
    "matchedProposals": [
      {
        "id": "gov_action1vdlrcftd48qn2zz8egepr6xyfcmxpfz8r69k769gc5mhg662adesq9yy8pl",
        "title": "Set a 300 million ADA Net Change Limit for Epochs 563–635",
        "type": "InfoAction",
        "subtype": null,
        "drepVotingAllowed": true
      },
      {
        "id": "gov_action1fpqwxp2kxvnntr8hpkh9q9djm78ccdww7qlhg5safugh4stmcwzqql5lauu",
        "title": "Cardano Treasury DeFi Liquidity Budget",
        "type": "InfoAction", 
        "subtype": null,
        "drepVotingAllowed": true
      }
    ],
    "resultCount": 1,
    "usedCache": true,
    "redisAvailable": true,
    "sortInfo": {
      "field": "participation",
      "direction": "desc"
    },
    "optimized": true
  },
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 194,
    "pages": 20
  },
  "timings": {
    "intent_determination": 1631,
    "query_parsing": 5060,
    "database_queries": 609,
    "data_transformation": 0,
    "explanation_generation": 2917,
    "proposal_validation": 6649,
    "redis_get": 332,
    "redis_set": 0,
    "sort_application": 1,
    "total": 1120
  }
}

{
  "error": "Missing or invalid query",
  "details": "Please provide a valid query string"
}

{
  "error": "Unauthorized",
  "message": "API key is required"
}

{
  "error": "No DReps found matching your criteria",
  "details": "Could not find proposals with the following title(s): Invalid Proposal Name",
  "suggestions": [
    {
      "id": "gov_action1abc123",
      "title": "Similar Proposal Name",
      "type": "InfoAction"
    }
  ]
}

{
  "error": "DReps cannot vote on the specified proposals",
  "details": "DReps are not allowed to vote on the following proposals: Protocol Parameter Change XYZ",
  "disallowedProposals": [
    {
      "id": "gov_action1xyz789",
      "title": "Protocol Parameter Change XYZ", 
      "type": "ParameterChange",
      "subtype": "Technical"
    }
  ]
}

{
  "error": "Failed to process query",
  "details": "Internal server error occurred while processing the request"
}

Status Codes

Status Code	Description
200	Success - DReps found matching the criteria
400	Bad Request - Invalid query parameters or malformed request
401	Unauthorized - Missing or invalid API key
404	Not Found - No DReps found matching criteria OR proposal voting restrictions
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error - Unexpected server error

Advanced Features

Smart Caching: The API uses intelligent caching to speed up repeated queries. First-time complex queries may take 10-15 seconds, while cached queries return in under 2 seconds.

Query Performance: Complex queries involving multiple proposals or detailed vote pattern analysis may take 10-15 seconds on first execution. Subsequent identical queries will be much faster due to caching.

Overview

DRep API

Proposal API

Rationale API

Request Headers

Request Body

Response

Status Codes

Advanced Features

​Request Headers

​Request Body

​Response

​Status Codes

​Advanced Features

Request Headers

Request Body

Response

Status Codes

Advanced Features