TRUST
Understanding users and how they're interacting with your dApp (or app) is a key factor in building reliable and consistent experiences. TRUST was created to give you insight into what drives your users, what their intentions are, and if they're trying to harm you or your users in some way.
TRUST breakdowns
Different endpoints provide different insight into what a wallet may or may not be doing on a blockchain. We'll break down what all of the properties and values available are, so that you can figure out how you want to use and implement TRUST.
Properties are broken down into several categories, based on how we suggest they're used, and how they're accessed.
Summary Scores
- Name
trust_score- Type
- number
- Description
An aggregate score that makes a determination on whether or not an account should be Trusted. This determination is based on how likely this account is to be engaged in either botting or profiteering. While a low score, can indicate that you should avoid interacting with that account, a high score just indicates, that based on our determination, that an account has not engaged in any flagged activity.
- Name
bot_score- Type
- number
- Description
The likelihood that an account is a bot or runs automated scripts.
- Name
profiteering_score- Type
- number
- Description
The degree with which an account is engaged in practices that are fraudulent or scam related. This can include anything from Wash Trading, Account Hijacking to flipping NFTs for excessive profits.
- Name
activity_score- Type
- number
- Description
A measure for how active an account is.
Bots
- Name
sniper_score- Type
- number
- Description
Sniper Bots are bots that buy NFTs suspiciously quickly, typically faster than the lag between listing and appearance on NFT marketplaces.
- Name
sniper_associate_score- Type
- number
- Description
Sniper Bots often use additional accounts to fund the sniper account or to transfer assets to. These accounts are also flagged.
- Name
minion_score- Type
- number
- Description
Bot farms are operations where accounts are creating multiple accounts, equipping them with resources and having them complete a task. They are often controlled by a single account and can have many (sometimes thousands) of associate accounts that they control. These are accounts associated with detected bot farms.
- Name
delegate_account_score- Type
- number
- Description
Account is frequently used as a primary authorized account on transactions being performed by others. This strategy makes it easier for bot farms to operate using shared resources.
- Name
delegate_transactions_score- Type
- number
- Description
Account is frequently used as a secondary authorized account on transactions. This strategy makes it easier for bot farms to operate using shared resources.
- Name
transfer_assets_to_main- Type
- number
- Description
Frequently transfers assets and tokens to an account suspected of running a bot farm.
- Name
no_sleep- Type
- number
- Description
An account that performs transactions without a one hour gap for more than 24 consecutive hours.
- Name
no_stopping- Type
- number
- Description
An account that performs transactions constantly over a 7 day period without a breaking.
- Name
consistent- Type
- number
- Description
An account that executes transactions in a suspiciously consistent way. Transactions are being run at the same time every hour/day/week, etc.
- Name
consistency_score- Type
- number
- Description
An account that executes transactions in a suspiciously consistent way. Transactions are being run at the same time every hour/day/week, etc. A second algorithm.
- Name
coordinated_automated_accounts_score- Type
- number
- Description
Accounts that are coordinating with each other by running in perfect synchronicity.
Profiteering
- Name
wash_trading_score- Type
- number
- Description
Wash trading is when multiple accounts are buying and selling the same assets between themselves, usually with the aim of inflating the value of the asset.
- Name
excessive_profits- Type
- number
- Description
Generating profits through flipping NFTs and driving up value.
- Name
account_takeovers- Type
- number
- Description
The frequent destination for account liquidations.
Activity
- Name
market_score- Type
- number
- Description
Compared with other active accounts, how active is this account when it comes to buying/selling/transferring NFTs. These activities are considered neutral and do not impact a users bot/profiteering scores.
- Name
market_buyer_score- Type
- number
- Description
Compared with other users that are purchasing NFTs, how many NFTs is this user purchasing. These activities are considered neutral and do not impact a users bot/profiteering scores.
- Name
market_seller_score- Type
- number
- Description
Compared with other users that are selling NFTs, how many NFTs is this user selling? These activities are considered neutral and do not impact a users bot/profiteering scores.
- Name
chain_score- Type
- number
- Description
Compared with other active accounts, how many transactions is this account performing. These activities are considered neutral and do not impact a users bot/profiteering scores.
- Name
associated_accounts- Type
- number
- Description
Accounts that are likely controlled by or highly coordinated with the main account. This determination is made based on factors like: frequent transfer of assets/tokens, new accounts creation, detected coordinated activities and delegated authorization for transactions.
Score Wallet
This endpoint allows you to retrieve a TRUST score for the provided wallet.
Request
curl -G https://{chainRoute}/score/{wallet} \
-H "apikey: {Project API Key}"
Response
{
"score": "0.75"
}
Bot Score
Retrieve the bot score for the provided wallet.
Request
curl -G https://{chainRoute}/bot/{wallet} \
-H "apikey: {Project API Key}"
{
"botScore": "0.5"
}
Activity Score
Retrieve the activity score for the provided wallet.
Request
curl -G https://{chainRoute}/activity/{wallet} \
-H "apikey: {Project API Key}"
{
"activityScore": "0.75"
}
Bot Analytics
Access a breakdown of why a wallet has been flagged as a bot. This can be used to block specific kinds of bots, while blocking others.
Request
curl -G https://{chainRoute}/analytics/bot/{wallet} \
-H "apikey: {Project API Key}"
Response
{
"sniper_score": "0.5",
"sniper_associate_score": "0.5",
"minion_score": "0.5",
"delegate_account_score": "0.5",
"delegate_transactions_score": "0.0",
"transfer_assets_to_main": "0.0",
"no_sleep": "0.0",
"no_stopping": "0.0",
"consistent": "1.0",
"consistency_score": "1.0",
"coordinated_automated_accounts_score": "0.5"
}
Profiteering Analytics
Access a breakdown of why a wallet has been flagged for profiteering.
Request
curl -G https://{chainRoute}/analytics/profiteering/{wallet} \
-H "apikey: {Project API Key}"
Response
{
"wash_trading_score": "1.0",
"profiteering_score": "1.0"
}
Activity Analytics
Detailed information about why an account is either active or inactive on a specific chain.
Request
curl -G https://{chainRoute}/analytics/activity/{wallet} \
-H "apikey: {Project API Key}"
Response
{
"market_score": "1.0",
"market_buyer_score": "0.9",
"market_seller_score": "0.2",
"chain_score": "0.87"
}