Ethos Developers - API Docs
  • API Documentation
    • Introduction
    • API v2
      • Activity
      • Categories
      • Chains
      • Contributions
      • Nfts
      • Projects
      • Project Votes
      • Score
      • System
      • Users
      • Xp
    • API v1 (deprecated)
      • Activities
      • Addresses
      • Attestations
      • Categories
      • Contracts
      • Contributions
      • Curated Lists
      • ENS
      • Events
      • Exchange Rates
      • Fees
      • Invitations
      • Markets
      • Notifications
      • Profiles
      • Replies
      • Reviews
      • Scores
      • Search
      • Signatures
      • Slashes
      • Twitter
      • Users
      • Vouches
      • XP
  • Whitepaper
    • Whitepaper
Powered by GitBook
On this page
  1. API Documentation
  2. API v2

Score

PreviousProject VotesNextSystem

Get score by userId

get
Query parameters
userIdintegerRequired
Responses
200
Successful response
application/json
400
Invalid input data
application/json
404
Not found
application/json
500
Internal server error
application/json
get
GET /api/v2/score/userId HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "score": 1,
  "level": "untrusted"
}

Get score by userkey

get
Query parameters
userkeystringRequired
Responses
200
Successful response
application/json
400
Invalid input data
application/json
404
Not found
application/json
500
Internal server error
application/json
get
GET /api/v2/score/userkey HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "score": 1,
  "level": "untrusted"
}

Check score calculation status

get
Query parameters
userkeystringRequired
Responses
200
Successful response
application/json
400
Invalid input data
application/json
404
Not found
application/json
500
Internal server error
application/json
get
GET /api/v2/score/status HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "status": "idle",
  "isQueued": true,
  "isCalculating": true,
  "isPending": true
}
  • GETGet score by address
  • POSTGet scores by multiple addresses
  • GETGet score by userId
  • POSTGet scores by multiple userIds
  • GETGet score by userkey
  • POSTGet scores by multiple userkeys
  • GETCheck score calculation status

Get score by address

get
Query parameters
addressstringRequired
Responses
200
Successful response
application/json
400
Invalid input data
application/json
404
Not found
application/json
500
Internal server error
application/json
get
GET /api/v2/score/address HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "score": 1,
  "level": "untrusted"
}

Get scores by multiple addresses

post
Body
addressesstring[]Required
Responses
200
Successful response
application/json
400
Invalid input data
application/json
500
Internal server error
application/json
post
POST /api/v2/score/addresses HTTP/1.1
Host: api.ethos.network
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "addresses": [
    "text"
  ]
}
{
  "ANY_ADDITIONAL_PROPERTY": {
    "score": 1,
    "level": "untrusted"
  }
}

Get scores by multiple userIds

post
Body
userIdsinteger[]Required
Responses
200
Successful response
application/json
400
Invalid input data
application/json
500
Internal server error
application/json
post
POST /api/v2/score/userIds HTTP/1.1
Host: api.ethos.network
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "userIds": [
    1
  ]
}
{
  "ANY_ADDITIONAL_PROPERTY": {
    "score": 1,
    "level": "untrusted"
  }
}

Get scores by multiple userkeys

post
Body
userkeysstring[]Required
Responses
200
Successful response
application/json
400
Invalid input data
application/json
500
Internal server error
application/json
post
POST /api/v2/score/userkeys HTTP/1.1
Host: api.ethos.network
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "userkeys": [
    "text"
  ]
}
{
  "ANY_ADDITIONAL_PROPERTY": {
    "score": 1,
    "level": "untrusted"
  }
}