DocumentationapiDelegations API

Delegations API

Endpoints for managing delegation relationships.

Get Delegation

Get delegation record for a wallet.

GET /api/delegations/:delegator

Response

{
  "delegator": "7xKXtg2C...",
  "delegate": {
    "address": "9qYw2hGx...",
    "name": "CryptoGovernance",
    "tier": "platinum",
    "fairscore": 92
  },
  "delegatedPower": 50000,
  "efficiency": 95,
  "active": true,
  "createdAt": "2024-01-15T00:00:00Z"
}

Create Delegation

Delegate voting power to another member.

POST /api/delegations

Request Body

{
  "delegator": "7xKXtg2C...",
  "delegate": "9qYw2hGx...",
  "signature": "..."
}

Response

{
  "success": true,
  "data": {
    "delegator": "7xKXtg2C...",
    "delegate": "9qYw2hGx...",
    "efficiency": 95,
    "active": true
  }
}

Revoke Delegation

Revoke an active delegation.

DELETE /api/delegations/:delegator

Response

{
  "success": true,
  "data": {
    "active": false
  }
}

Get Delegates

List top delegates with filtering.

GET /api/delegates

Query Parameters

Sort by: efficiency, delegators, votingPower, fairscore.

Filter by tier.

Maximum results.

Response

{
  "delegates": [
    {
      "address": "9qYw2hGx...",
      "name": "CryptoGovernance",
      "tier": "platinum",
      "fairscore": 92,
      "votingPower": 450000,
      "delegatedPower": 320000,
      "delegators": 45,
      "efficiency": 98,
      "proposalsVoted": 156,
      "lastActive": "2024-02-28T10:00:00Z",
      "topVotingAreas": ["Treasury", "Security", "Parameters"]
    }
  ],
  "total": 128
}

Get Delegators

Get all wallets delegating to a specific delegate.

GET /api/delegates/:address/delegators

Response

{
  "delegate": "9qYw2hGx...",
  "delegators": [
    {
      "address": "7xKXtg2C...",
      "delegatedPower": 50000,
      "delegatedAt": "2024-01-15T00:00:00Z"
    }
  ],
  "total": 45,
  "totalDelegatedPower": 320000
}

Get Delegation Efficiency

Calculate delegation efficiency for a potential delegate.

GET /api/delegates/:address/efficiency

Response

{
  "delegate": "9qYw2hGx...",
  "fairscore": 92,
  "tier": "platinum",
  "participationRate": 85,
  "tierMultiplier": 150,
  "efficiency": 117
}
Analytics APIFairScore API