Query Sybil Score

POST https://www.trustalabs.ai/service/openapi/queryRiskSummaryScore

Retrieve the Sybil score and the scores for each behavior pattern sub-item for an address on the corresponding chain.

Response Description

A successful response will return(This is only a sample data, not real data):

JSON

{
  "data": {
    "address": "0xbe778865781aa618309a2c82dc5a8b563a024d62",
    "sybilRiskScore": 99.83684450346095,
    "sybilRiskLevel": "High",
    "subScore": {
      "bulkOperationRisk": 99.71434866317104,
      "starlikeAssetsNetworkRisk": 71.2,
      "chainlikeAssetsNetworkRisk": 0,
      "similarBehaviorSequenceRisk": 99.4505181398162,
      "blacklistRisk": 0
    }
  },
  "success": true,
  "code": 0,
  "message": ""
}

Field Descriptions

data: Container for the main response information.

• address: The queried address. This should match the address provided in the API request.
• sybilRiskScore: Floating point number representing the Sybil risk score for the address. It provides an overall assessment of the Sybil attack risk associated with the address.
• sybilRiskLevel: String denoting the level of Sybil risk. Possible values include "High", "Medium", "Low", "No Risk", "Unknown". This is derived from the sybilRiskScore.
• subScore: Container for sub-scores, breaking down various risk elements.
  • bulkOperationRisk: Floating point number representing the risk score associated with bulk operations performed by the address.
  • starlikeAssetsNetworkRisk: Floating point number indicating the risk score for star-like asset network patterns.
  • chainlikeAssetsNetworkRisk: Floating point number denoting the risk score for chain-like asset network patterns.
  • similarBehaviorSequenceRisk: Floating point number representing the risk score for sequences of behaviors that appear to be similar or repetitive.
  • blacklistRisk: Integer representing the risk score if the address is found in any public blacklists. The minimum score for this is 0, which indicates no known associations with blacklisted entities.

success: Boolean value indicating the success or failure of the API request.

code: Integer indicating the status of the response. A value of 0 represents success.

message: String containing any additional information or error messages associated with the API call.

The Value of Sybil Score

The output Sybils score has the value ranged from 0 to 100, where the higher the score, the more Sybil risk of the addresses. Besides, there are two negative integers -2 and -1 of the score to indicate two corner cases. We explain the value in the

sybilRiskScore	sybilRiskLevel	Explanation	Recommendation (Non-Sybil Account Verification)
-2	Unknown	Out of scope for TrustScan's Sybil analysis due to insufficient on-chain activity.	False
-1	No Risk	High Value addresses，No apparent Sybil risk detected by TrustScan	True
0 - 60	No Risk	No signs of Sybil risk detected	True
60 -80	Low	LOW Sybil risk detected	False
80 - 90	Medium	MEDIUM Sybil risk detected	False
90 -100	High	HIGH Sybil risk detected	False