For the complete documentation index, see llms.txt. This page is also available as Markdown.

Votes

Get votes for an activity

get
Query parameters
typestring · enumRequiredPossible values:
activityIdnumberRequired
isUpvotestring · enumOptionalPossible values:
orderBystring · enumOptionalDefault: updatedAtPossible values:
orderDirectionstring · enumOptionalDefault: descPossible values:
limitinteger · max: 500OptionalDefault: 50
offsetinteger · max: 2147483647OptionalDefault: 0
Responses
200

Successful response

application/json
totalnumberRequired
limitnumberRequired
offsetnumberRequired
get/votes
GET /api/v2/votes?type=attestation&activityId=1 HTTP/1.1
Host: api.ethos.network
Accept: */*
{
  "values": [
    {
      "isUpvote": true,
      "isArchived": true,
      "voter": 1,
      "targetContract": "text",
      "targetId": 1,
      "createdAt": 1,
      "weight": 1,
      "user": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 1,
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "holdingsWei": 1,
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          },
          "vouchTotals": [
            {
              "balance": {
                "given": 1,
                "received": 1
              },
              "count": {
                "given": 1,
                "received": 1
              },
              "token": {
                "address": "text",
                "decimals": 1,
                "id": "eth"
              }
            }
          ]
        }
      }
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

Get aggregated vote stats for a single activity

get
Query parameters
typestring · enumRequiredPossible values:
activityIdnumberRequired
includeArchivedbooleanOptional
Responses
200

Successful response

application/json
get/votes/stats
GET /api/v2/votes/stats?type=attestation&activityId=1 HTTP/1.1
Host: api.ethos.network
Accept: */*
{
  "userVote": {
    "isUpvote": true,
    "isArchived": true,
    "voter": 1,
    "targetContract": "text",
    "targetId": 1,
    "createdAt": 1,
    "weight": 1,
    "user": {
      "id": 1,
      "profileId": 1,
      "displayName": "text",
      "username": "text",
      "avatarUrl": "https://example.com",
      "description": "text",
      "score": 1,
      "status": "ACTIVE",
      "userkeys": [
        "text"
      ],
      "xpTotal": 1,
      "xpStreakDays": 1,
      "xpRemovedDueToAbuse": true,
      "influenceFactor": 1,
      "influenceFactorPercentile": 1,
      "humanVerificationStatus": "REQUESTED",
      "validatorNftCount": 1,
      "links": {
        "profile": "https://example.com",
        "scoreBreakdown": "https://example.com"
      },
      "stats": {
        "holdingsWei": 1,
        "review": {
          "received": {
            "negative": 1,
            "neutral": 1,
            "positive": 1
          }
        },
        "vouch": {
          "given": {
            "amountWeiTotal": 1,
            "count": 1
          },
          "received": {
            "amountWeiTotal": 1,
            "count": 1
          }
        },
        "vouchTotals": [
          {
            "balance": {
              "given": 1,
              "received": 1
            },
            "count": {
              "given": 1,
              "received": 1
            },
            "token": {
              "address": "text",
              "decimals": 1,
              "id": "eth"
            }
          }
        ]
      }
    }
  },
  "counts": {
    "upvotes": 1,
    "downvotes": 1
  },
  "weights": {
    "weightedUpvotes": 1,
    "weightedDownvotes": 1,
    "upvotePercentage": 1,
    "downvotePercentage": 1
  }
}

Get aggregated vote stats for multiple activities

post
Body
attestationnumber[]Optional
bondnumber[]Optional
discussionnumber[]Optional
reviewnumber[]Optional
slashnumber[]Optional
vouchnumber[]Optional
vouchV2number[]Optional
projectnumber[]Optional
reputationMarketnumber[]Optional
brokernumber[]Optional
includeArchivedbooleanOptional
Responses
200

Successful response

application/json
post/votes/stats
POST /api/v2/votes/stats HTTP/1.1
Host: api.ethos.network
Content-Type: application/json
Accept: */*
Content-Length: 171

{
  "attestation": [
    1
  ],
  "bond": [
    1
  ],
  "discussion": [
    1
  ],
  "review": [
    1
  ],
  "slash": [
    1
  ],
  "vouch": [
    1
  ],
  "vouchV2": [
    1
  ],
  "project": [
    1
  ],
  "reputationMarket": [
    1
  ],
  "broker": [
    1
  ],
  "includeArchived": true
}
{
  "attestation": {
    "ANY_ADDITIONAL_PROPERTY": {
      "userVote": {
        "isUpvote": true,
        "isArchived": true,
        "voter": 1,
        "targetContract": "text",
        "targetId": 1,
        "createdAt": 1,
        "weight": 1,
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "holdingsWei": 1,
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "eth"
                }
              }
            ]
          }
        }
      },
      "counts": {
        "upvotes": 1,
        "downvotes": 1
      },
      "weights": {
        "weightedUpvotes": 1,
        "weightedDownvotes": 1,
        "upvotePercentage": 1,
        "downvotePercentage": 1
      }
    }
  },
  "bond": {
    "ANY_ADDITIONAL_PROPERTY": {
      "userVote": {
        "isUpvote": true,
        "isArchived": true,
        "voter": 1,
        "targetContract": "text",
        "targetId": 1,
        "createdAt": 1,
        "weight": 1,
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "holdingsWei": 1,
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "eth"
                }
              }
            ]
          }
        }
      },
      "counts": {
        "upvotes": 1,
        "downvotes": 1
      },
      "weights": {
        "weightedUpvotes": 1,
        "weightedDownvotes": 1,
        "upvotePercentage": 1,
        "downvotePercentage": 1
      }
    }
  },
  "discussion": {
    "ANY_ADDITIONAL_PROPERTY": {
      "userVote": {
        "isUpvote": true,
        "isArchived": true,
        "voter": 1,
        "targetContract": "text",
        "targetId": 1,
        "createdAt": 1,
        "weight": 1,
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "holdingsWei": 1,
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "eth"
                }
              }
            ]
          }
        }
      },
      "counts": {
        "upvotes": 1,
        "downvotes": 1
      },
      "weights": {
        "weightedUpvotes": 1,
        "weightedDownvotes": 1,
        "upvotePercentage": 1,
        "downvotePercentage": 1
      }
    }
  },
  "review": {
    "ANY_ADDITIONAL_PROPERTY": {
      "userVote": {
        "isUpvote": true,
        "isArchived": true,
        "voter": 1,
        "targetContract": "text",
        "targetId": 1,
        "createdAt": 1,
        "weight": 1,
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "holdingsWei": 1,
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "eth"
                }
              }
            ]
          }
        }
      },
      "counts": {
        "upvotes": 1,
        "downvotes": 1
      },
      "weights": {
        "weightedUpvotes": 1,
        "weightedDownvotes": 1,
        "upvotePercentage": 1,
        "downvotePercentage": 1
      }
    }
  },
  "slash": {
    "ANY_ADDITIONAL_PROPERTY": {
      "userVote": {
        "isUpvote": true,
        "isArchived": true,
        "voter": 1,
        "targetContract": "text",
        "targetId": 1,
        "createdAt": 1,
        "weight": 1,
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "holdingsWei": 1,
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "eth"
                }
              }
            ]
          }
        }
      },
      "counts": {
        "upvotes": 1,
        "downvotes": 1
      },
      "weights": {
        "weightedUpvotes": 1,
        "weightedDownvotes": 1,
        "upvotePercentage": 1,
        "downvotePercentage": 1
      }
    }
  },
  "vouch": {
    "ANY_ADDITIONAL_PROPERTY": {
      "userVote": {
        "isUpvote": true,
        "isArchived": true,
        "voter": 1,
        "targetContract": "text",
        "targetId": 1,
        "createdAt": 1,
        "weight": 1,
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "holdingsWei": 1,
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "eth"
                }
              }
            ]
          }
        }
      },
      "counts": {
        "upvotes": 1,
        "downvotes": 1
      },
      "weights": {
        "weightedUpvotes": 1,
        "weightedDownvotes": 1,
        "upvotePercentage": 1,
        "downvotePercentage": 1
      }
    }
  },
  "vouchV2": {
    "ANY_ADDITIONAL_PROPERTY": {
      "userVote": {
        "isUpvote": true,
        "isArchived": true,
        "voter": 1,
        "targetContract": "text",
        "targetId": 1,
        "createdAt": 1,
        "weight": 1,
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "holdingsWei": 1,
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "eth"
                }
              }
            ]
          }
        }
      },
      "counts": {
        "upvotes": 1,
        "downvotes": 1
      },
      "weights": {
        "weightedUpvotes": 1,
        "weightedDownvotes": 1,
        "upvotePercentage": 1,
        "downvotePercentage": 1
      }
    }
  },
  "project": {
    "ANY_ADDITIONAL_PROPERTY": {
      "userVote": {
        "isUpvote": true,
        "isArchived": true,
        "voter": 1,
        "targetContract": "text",
        "targetId": 1,
        "createdAt": 1,
        "weight": 1,
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "holdingsWei": 1,
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "eth"
                }
              }
            ]
          }
        }
      },
      "counts": {
        "upvotes": 1,
        "downvotes": 1
      },
      "weights": {
        "weightedUpvotes": 1,
        "weightedDownvotes": 1,
        "upvotePercentage": 1,
        "downvotePercentage": 1
      }
    }
  },
  "reputationMarket": {
    "ANY_ADDITIONAL_PROPERTY": {
      "userVote": {
        "isUpvote": true,
        "isArchived": true,
        "voter": 1,
        "targetContract": "text",
        "targetId": 1,
        "createdAt": 1,
        "weight": 1,
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "holdingsWei": 1,
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "eth"
                }
              }
            ]
          }
        }
      },
      "counts": {
        "upvotes": 1,
        "downvotes": 1
      },
      "weights": {
        "weightedUpvotes": 1,
        "weightedDownvotes": 1,
        "upvotePercentage": 1,
        "downvotePercentage": 1
      }
    }
  },
  "broker": {
    "ANY_ADDITIONAL_PROPERTY": {
      "userVote": {
        "isUpvote": true,
        "isArchived": true,
        "voter": 1,
        "targetContract": "text",
        "targetId": 1,
        "createdAt": 1,
        "weight": 1,
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "holdingsWei": 1,
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "eth"
                }
              }
            ]
          }
        }
      },
      "counts": {
        "upvotes": 1,
        "downvotes": 1
      },
      "weights": {
        "weightedUpvotes": 1,
        "weightedDownvotes": 1,
        "upvotePercentage": 1,
        "downvotePercentage": 1
      }
    }
  }
}

Last updated