Tokens - Response

The endpoint responds with a JSON object detailing information about the token.

Response Parameters

  1. tokenInformation

  2. tokenScore

  3. marketChecks

  4. codeChecks

  5. honeypotDetails

tokenInformation

FieldDescription Data Type

tokenAddress

Contract address of the token

String

tokenName

Token name as per it's contract

String

tokenSymbol

Token's Ticker

String

tokenCreationDate

Token's creation date in ISO format

String

totalSupply

Total Supply of Token

String

ownerAddress

Token's owner address

String

ownerBalance

Token balance of owner

String

creatorAddress

Token creator address

String

creatorBalance

Token balance of creator

String

tokenCategories

Returns relevant categories of the token [ "Stablecoins", "DeFi Ecosystem"]

Array

marketData

Returns

  1. Current Price in USD

  2. Market Cap in USD

  3. Last One Day High Price in USD

  4. Last One Day Low Price in USD of the token.

Object

socialInformation

Returns

  1. Associated Github Repo

  2. Twitter Handle & Number of Followers

  3. Facebook Page & Number of Page Likes

  4. Telegram Group & Number of Members

  5. subReddit & Number of Subscribers

Object

externalLinks

Returns

  1. CoinGecko Link of the token

  2. Appropriate BlockExplorer Link of the token

  3. GeckoTerminal Link of the Token

Object

tokenScore

FieldDescriptionData Type

totalScore

Returns

  1. percent - The percentage of the code score achieved.

  2. Achieved Score - The code score the token has achieved based on our scoring algorithm.

  3. Max Score - Based on the available data points about the token's code, the maximum achievable score.

  4. Min Score - Based on the available data points about the token's code, the least achievable score

Object

codeScore

Returns

  1. percent - The percentage of the code score achieved.

  2. Achieved Score - The code score the token has achieved based on our scoring algorithm.

  3. Max Score - Based on the available data points about the token's code, the maximum achievable score.

  4. Min Score - Based on the available data points about the token's code, the least achievable score. Note: Each potentially malicious permissions present is given a negative score and the absence of the item is given a positive score. Sum of positives and negatives gives Achieved Score.

Object

marketScore

Returns

  1. percent - The percentage of the market score achieved.

  2. Achieved Score - The Market Score the token has achieved based on our scoring algorithm.

  3. Max Score - Based on the available data points about the token's market standings, the maximum achievable score.

  4. Min Score - Based on the available data points about the token's market standings, the least achievable score. Note: Positive scores are given when risk is lower(for eg, when Owner Balance < 10%) and negative scores are given when risk is higher (for eg, Number of Trading Pairs = 1). Sum of positive and negative scores gives the achievedScore.

Object

marketChecks

holdersChecks

FieldDescriptionData Type

holdersCount

Returns

  1. Total number of addresses holding this token.

  2. Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk. Lesser holders means more risk.

Object

keyHolders

Returns information about Top3 holders of the token. It shows

  1. Address holding the token

  2. Percentage of Total Supply that this Address holds

  3. If the Address holding is a contract. false denotes it's an EOA and true denotes it's a contract address

  4. Token Balance of this Holder.

Note: "isContract", "isLocked" will return "" if status is unknown

Array

percentDistributed

Returns information about Token Distribution amongst holders of the token

  1. Top Three

    • Percentage of total supply that the top 3 addresses have

    • Sum total of token balances of top three addresses

    • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  2. Top Ten

    • Percentage of total supply that the top 10 addresses have

    • Sum total of token balances of top 10 addresses

    • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  3. Owner

    • Percentage of total supply that the owner address has

    • Token balance of owner address

    • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  4. Creator

    • percentage of total supply that the creator address has

    • Token balance of creator address

    • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  5. Burnt

    • percentage of total supply that the burnt addresses has

    • Token balance of all burnt addresses

    • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  6. Other

    • percentage of total supply with other addresses except for above categories

    • Token balance of all otheraddresses

    • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

Object

liquidityChecks

FieldDescriptionData Type

aggregatedInformation

Explains Aggregated Liquidity Information of token

  1. totalLpSupplyInUsd

    • Gives Total Lp Supply across all pairs in tracked DEX in Us Dollar Value

    • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk

  2. lpHolderCount

    • Number of aggregated lp holders

    • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk

  3. tradingPairCount

    • Number of total trading pairs

    • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk

  4. keyLpHolders

    • All major lp holders as per their share in Us Dollars

  5. liquidityLockDetails

    • upcomingUnlockDetails along with unlock time,value and risk assesment

  6. percentDistributed

    • Aggregated distribution of liquidity in Us Dollar among categories like owner, creator, burnt, topThree, topTen, other.

    • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk

Object

pairByPairInformation

Returns details about all tracked trading pairs of the token including the Dex, taxes, key LP holders, and token distribution, etc

Array

codeChecks

ownershipChecks

FieldDescriptionData Type

ownerChangeBalance

Returns information about if the token's owner address has the ability to alter the balances of token holders.

  1. Description - Whether balances can be adjusted or not.

  2. Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  3. Status "1" - true, "0" - false, "" - unknown

  4. Comment (if any) on why this is present in the token, if known.

Object

isMintable

Returns Information on whether the token's total supply is not fixed and the owner is permitted to mint more tokens.

  • Description - Whether token can be minted or not.

  • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  • Status "1" - true, "0" - false, "" - unknown

  • Comment (if any) on why this is present in the token, if known.

Object

selfDestruct

Returns Information on whether the token has a self-destruct functionality which the owner can call.

  • Description - Whether token can be delf destructed or not.

  • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  • Status "1" - true, "0" - false, "" - unknown

  • Comment (if any) on why this is present in the token, if known.

Object

transferPausable

Returns Information on whether the token's transfer can be paused by the owner.

  • Description - Whether token can be self destructed or not.

  • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  • Status "1" - true, "0" - false, "" - unknown

  • Comment (if any) on why this is present in the token, if known.

eg:

Object

slippageModifiable

Returns information on whether the token has modifiable tax or not. This refers to the owner having the ability to change the buy or sell tax of the token.

  • Description - Whether token has a modifiable tax or not

  • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  • Status "1" - true, "0" - false, "" - unknown

  • Comment (if any) on why this is present in the token, if known.

eg:

Object

personalSlippageModifiable

Returns information on whether the owner has the ability to modify buy and sell tax for select wallet addresses.

  • Description - Whether token has modifiable tax for select addresses or not

  • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  • Status "1" - true, "0" - false, "" - unknown

  • Comment (if any) on why this is present in the token, if known.

eg:

Object

otherChecks

FieldDescriptionData Type

externalCall

Returns information on if the token's contract is making calls to external contracts. This could lead to risks if we don't have information about the contracts this token is calling.

  • Description - Whether token calls any external contract.

  • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  • Status "1" - true, "0" - false, "" - unknown

  • Comment (if any) on why this is present in the token, if known.

Object

isProxy

Returns information on if the token's contract is a proxy contract. Implementation of proxy contracts allows for upgradability but also could be misused.

  • Description - Whether token calls is a proxy contract.

  • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  • Status "1" - true, "0" - false, "" - unknown

  • Comment (if any) on why this is present in the token, if known.

Object

tradingCooldown

Returns information on if the token's contract can affect how often users can trade the token.

  • Description - Whether trade frequency is restricted.

  • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  • Status "1" - true, "0" - false, "" - unknown

  • Comment (if any) on why this is present in the token, if known.

Object

cannotBuy

Returns information on if the token is available in a DEX to buy

  • Description - Whether token is listed on tracked DEXs

  • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  • Status "1" - true, "0" - false, "" - unknown

  • Comment (if any) on why this is present in the token, if known.

Object

cannotSellAll

Returns information on if the token has any limit of number of tokens that can be sold in one trade.

  • Description - Whether entire token balance can be sold in a trade

  • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  • Status "1" - true, "0" - false, "" - unknown

  • Comment (if any) on why this is present in the token, if known.

eg:

Object

isAntiWhale

Returns information on if the token has any anti-whale measures in it.

  • Description - Whether token has anti-whale measures put in it.

  • Risk associated with this item. 0 denotes the least risk. 6 denotes the highest risk.

  • Status "1" - true, "0" - false, "" - unknown

  • Comment (if any) on why this is present in the token, if known.

Object

honeypotDetails

FieldDescriptionData Type

honeypotPairs

Returns information about potential honeypot traps identified in specific Dex pairs.

  1. Pair Address - The address of the token pair on the Dex.

  1. Dex Name - The name of the decentralized exchange.

  1. Honeypot Reason - The reason or evidence which suggests that the token pair might be a honeypot.

Array

honeypotFound

Returns information about the results of honeypot simulations in specific pools.

  1. Pools Simulated: The number of pools that were subjected to honeypot simulation tests.

  1. Total Pools: The total number of pools available for the specific token or Dex.

  1. Honeypot Pools: The number of pools identified as potential honeypots during the simulation.

Object

isTokenHoneypot

It describes whether a token is honeypot or not.

Note: This can be 0 - false, 1 - true, 2 - unknown

Number

PreviousTokens - RequestNextChain Mapping

Last updated