Inspector

Inspector enables users to do quick, one-off, manual investigations on blockchain transactions by inputting smart contracts and/or wallet addresses and receiving a risk score.

Getting started

  1. After logging into the CUBE3 platform, navigate to the Inspector link on the navigation bar.

  1. Next, input your desired address (wallet, smart contract, or transaction hash) into the Inspector bar and hit "submit" to request details from our CUBE3 Engine. You will see a preview for all supported chains and can select the risk score to show the details of that score.

  1. Inspector will display the latest Risk Score from our CUBE3 Engine for all chains associated with the address you inspected. You can select each chain to get any details for that chain for that address.

Our Risk Score ranges from a 1 to 100:

  • 1 - 30 Safe

  • 31 - 69 Warning

  • 70 - 100 Unsafe

We also have three categories which each have their own risk score and the highest score of these informs the final Risk Score.

  • Cyber: This category refers to the behavior of Externally Owned Addresses (EOAs) and smart contracts that are suspected of being exploited, have attempted to exploit, or have interacted with an exploit/hack that targets the technology layer (vulnerabilities in code, configurations, etc.). The system additionally evaluates probabilities of imminent attacks originating from an EOA or smart contract.

  • Fraud: This category score is designed to detect deceptive activities and misrepresentations that exploit human errors of trust, oversight, and misaligned expectations that can lead to token scams, Ponzi schemes, and other forms of financial fraud, such as fake NFTs or rug pulls.

  • Compliance: This category is designed to detect Externally Owned Addresses (EOAs) and smart contracts that may have been suspected as potentially noncompliant with laws in various jurisdictions (can be related to money laundering, terrorist financing, sanctioned addresses, etc.).

Using the Inspector API

While using the frontend for Inspector allows a user to easily look up addresses, there are some use cases where you need to look up a large amount of addresses or integrate Inspector into your own platform.

Here is an example syntax for executing an Inspector API call:

$ curl --location 'https://validation-api.cube3.ai/api/v2/inspector/addresses/<Address>?chainId=<ChainID>' \
--header 'X-Api-Key: <Key>-inspection'

You will want to replace the following with your own information:

  • <Addresses> = The address you are looking up (wallet or smart contract address)

  • ?chainId=<ChainID> = (Optional) The chainId number for the chain you are looking up

  • <Key> = API key number which can be found in Risk API page found in Panorama

Here is an example Inspector address response example:

$ curl --location 'https://validation-api.cube3.ai/api/v2/inspector/addresses/0x3c9a5d65e49d9b09a2cf498ec3c8d9fbb2fbf464' \
--header 'X-Api-Key: <Key>-inspection'
{
    "address": "0x3c9a5d65e49d9b09a2cf498ec3c8d9fbb2fbf464",
    "chainResultList": [
        {
            "chainId": "56",
            "score": {
                "fraud": 30,
                "compliance": 30,
                "cyber": 30,
                "combinedScore": 30
            },
            "scoreDetails": {
                "cyber": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "fraud": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "compliance": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "combined": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                }
            },
            "deployedAtByChainId": null,
            "firstAnalysedAtByChainId": null,
            "lastAnalysedAtByChainId": null,
            "type": "EOA",
            "deployer": null
        },
        {
            "chainId": "1",
            "score": {
                "fraud": 84,
                "compliance": 30,
                "cyber": 30,
                "combinedScore": 84
            },
            "scoreDetails": {
                "cyber": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "compliance": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "fraud": {
                    "value": 84,
                    "subCategory": "financialScam",
                    "subCategoryDescription": "This contract was identified as a financial scam as it has characteristics resembling rug pulls, honeypots, Ponzi schemes, pump and dump scams, and phishing scams."
                },
                "combined": {
                    "value": 84,
                    "subCategory": "financialScam",
                    "subCategoryDescription": "This contract was identified as a financial scam as it has characteristics resembling rug pulls, honeypots, Ponzi schemes, pump and dump scams, and phishing scams."
                }
            },
            "deployedAtByChainId": "2024-06-12T08:08:11Z",
            "firstAnalysedAtByChainId": "2024-06-12T08:08:31.388Z",
            "lastAnalysedAtByChainId": "2024-06-12T12:33:04.895Z",
            "type": "CONTRACT",
            "deployer": null
        },
        {
            "chainId": "43114",
            "score": {
                "fraud": 30,
                "compliance": 30,
                "cyber": 30,
                "combinedScore": 30
            },
            "scoreDetails": {
                "cyber": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "fraud": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "compliance": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "combined": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                }
            },
            "deployedAtByChainId": null,
            "firstAnalysedAtByChainId": null,
            "lastAnalysedAtByChainId": null,
            "type": "EOA",
            "deployer": null
        },
        {
            "chainId": "137",
            "score": {
                "fraud": 30,
                "compliance": 30,
                "cyber": 30,
                "combinedScore": 30
            },
            "scoreDetails": {
                "cyber": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "fraud": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "compliance": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "combined": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                }
            },
            "deployedAtByChainId": null,
            "firstAnalysedAtByChainId": null,
            "lastAnalysedAtByChainId": null,
            "type": "EOA",
            "deployer": null
        },
        {
            "chainId": "42161",
            "score": {
                "fraud": 30,
                "compliance": 30,
                "cyber": 30,
                "combinedScore": 30
            },
            "scoreDetails": {
                "cyber": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "fraud": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "compliance": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                },
                "combined": {
                    "value": 30,
                    "subCategory": null,
                    "subCategoryDescription": null
                }
            },
            "deployedAtByChainId": null,
            "firstAnalysedAtByChainId": null,
            "lastAnalysedAtByChainId": null,
            "type": "EOA",
            "deployer": null
        }
    ]
}

You can also inspect transaction hashes with Inspector. Here is an example Inspector transaction hash response example:

$ curl --location 'https://validation-api.cube3.ai//api/v2/inspector/transactions/0xa8fce29220fb0d4c9fab5e2caf4aea66872bedc63f131349c101a454d03e0c7d' \
--header 'X-Api-Key: <Key>-inspection'
{
    "txHash": "0xa8fce29220fb0d4c9fab5e2caf4aea66872bedc63f131349c101a454d03e0c7d",
    "attackerContractAddress": "0x3c9a5d65e49d9b09a2cf498ec3c8d9fbb2fbf464",
    "attackerContractDeployerAddress": "0x84e5b8d5ac2c74f3cc053034dcfc8613b19e14f2",
    "chainId": "1",
    "blockNumber": "20075771",
    "blockTime": "2024-06-12T12:32:47Z[UTC]",
    "transactionScore": {
        "highestScore": 77.45,
        "finalScore": {
            "compliance": {
                "value": 30.0,
                "subCategory": null,
                "subCategoryDescription": null
            },
            "fraud": {
                "value": 77.45,
                "subCategory": "financialScamInteraction",
                "subCategoryDescription": "This transaction was identified as a financial scam involving disguised assets as legitimate investments for fund theft, honeypot traps, price manipulation via pump and dump schemes, and fund embezzlement through rug pulls."
            },
            "cyber": {
                "value": 30.0,
                "subCategory": null,
                "subCategoryDescription": null
            }
        },
        "scoreDetails": [
            {
                "reason": "pluginDetection-FinancialScamInteraction",
                "value": 20.0
            },
            {
                "reason": "fraudVictimContractAge",
                "value": 9.93
            },
            {
                "reason": "toOriginATScoreFraud",
                "value": 7.91
            },
            {
                "reason": "toOriginAge",
                "value": 8.35
            },
            {
                "reason": "attackerGain",
                "value": 1.26
            }
        ]
    },
    "totalLoss": 18548.23132486283,
    "victimsBalanceChanges": {
        "0xad8cc5460ee4ab14bbeea8b1c5528a30e56a6a18": [
            {
                "token": "米老鼠",
                "value": 10000000000000000000000.000000000,
                "usd": 0.0,
                "score": 30
            },
            {
                "token": "WETH",
                "value": -5.244428168477509914,
                "usd": -18548.23132486283,
                "score": 30
            }
        ]
    },
    "attackersBalanceChanges": {
        "0x84e5b8d5ac2c74f3cc053034dcfc8613b19e14f2": [
            {
                "token": "ETH",
                "value": 5.244428168477509914,
                "usd": 18548.23132486283,
                "score": 99
            }
        ]
    },
    "balanceChanges": {
        "0xad8cc5460ee4ab14bbeea8b1c5528a30e56a6a18": [
            {
                "token": "米老鼠",
                "value": 10000000000000000000000.000000000,
                "usd": 0.0,
                "score": 30
            },
            {
                "token": "WETH",
                "value": -5.244428168477509914,
                "usd": -18548.23132486283,
                "score": 30
            }
        ],
        "0x3c9a5d65e49d9b09a2cf498ec3c8d9fbb2fbf464": [
            {
                "token": "米老鼠",
                "value": -10000000000000000000000.000000000,
                "usd": 0.0,
                "score": 84
            }
        ],
        "0x84e5b8d5ac2c74f3cc053034dcfc8613b19e14f2": [
            {
                "token": "ETH",
                "value": 5.244428168477509914,
                "usd": 18548.23132486283,
                "score": 99
            }
        ],
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": [
            {
                "token": "ETH",
                "value": -5.244428168477509914,
                "usd": -18548.23132486283,
                "score": 15
            },
            {
                "token": "WETH",
                "value": 5.244428168477509914,
                "usd": 18548.23132486283,
                "score": 15
            }
        ],
        "0x7a250d5630b4cf539739df2c5dacb4c659f2488d": [
            {
                "token": "ETH",
                "value": 0E-18,
                "usd": 0.0,
                "score": 15
            },
            {
                "token": "WETH",
                "value": 0E-18,
                "usd": 0.0,
                "score": 15
            }
        ]
    },
    "createdAt": null,
    "scoredAddresses": [
        {
            "address": "0x3c9a5d65e49d9b09a2cf498ec3c8d9fbb2fbf464",
            "score": 84
        },
        {
            "address": "0x84e5b8d5ac2c74f3cc053034dcfc8613b19e14f2",
            "score": 99
        },
        {
            "address": "0xad8cc5460ee4ab14bbeea8b1c5528a30e56a6a18",
            "score": 30
        },
        {
            "address": "0xed239dc2bcedb5c45c24d8697c6c669d07a4891f",
            "score": 30
        },
        {
            "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "score": 15
        },
        {
            "address": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
            "score": 15
        }
    ],
    "transactionRiskProfile": {
        "transactionRisk": 77,
        "participantRisk": 69
    }
}

Each lookup using Inspector (either through Panorama or via API) uses 1 API request of the 1000 in the Free tier per month.

Using Batch Address Inspector API

Inspector also allows batching up to 10 inspect address requests in one go. Duplicate requests will be processed once. If chainId is not provided for EVM address, it will scan through all chains supported by us. Example of batch request:

curl --location 'https://validation-api.cube3.ai/api/v2/inspector/addresses/batches' \
--header 'X-Api-Key: <Api-Key>-inspection' \
--header 'Content-Type: application/json' \
--data '{
    "addresses": [
        {
            "address": "ltc1qzvcgmntglcuv4smv3lzj6k8szcvsrmvk0phrr9wfq8w493r096ssm2fgsw"
        },
        {
            "address": "bc1qj4hglg9vceql2qj3kad67vh8sgq83535mwvhhk"
        },
        {
            "address": "TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR",
            "chainId": "BITCOIN"
        },
        {
            "address": "MJKqp326RZCHnAAbew9MDdui3iCKWco7fsK9sVuZTX2"
        },
        {
            "address": "MJKqp326RZCHnAAbew9MDdui3iCKWco7fsK9sVuZTX2"
        },
        {
            "address": "0xda617f33766789096a072e353a73416cc6aa41ad",
            "chainId": "1"
        },
        {
            "address": "0xE3280d855d37006DAEF0Ac38f062deAf4847463d"
        },
        {
            "address": "0x69Fc8dc3C50Afe0794938E836aB8bC0657D56C5a",
            "chainId": "BITCOIN"
        },
        {
            "address": "0x69Fc8dc3C50Afe0794938E836aB8bC0657D56C5a",
            "chainId": "BITCOIN"
        },
        {
            "address": "0xBEdf98c5BCd54565aEC8132202c5d692b75A730B",
            "chainId": "777"
        }
    ]
}'

The response from the server is a url:

https://validation-api.cube3.ai/api/v2/inspector/addresses/batches/<Batch-Id>

This indicates that batch is reachable through the url provided, but it might take time to process it fully. Under normal circumstances this should be processed within few seconds.

We can fetch the batch with the url provided via rest call:

curl --location 'https://validation-api.cube3.ai/api/v2/inspector/addresses/batches/<Batch-Id>
--header 'X-Api-Key: <Api-Key>-inspection' 

Once curl is executed, we get the following response:

{
    "inspectedAddresses": [
        {
            "score": null,
            "address": "TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR",
            "perChainAssessment": null,
            "errorMessage": "Provided chain id does not match address format"
        },
        {
            "score": null,
            "address": "0x69Fc8dc3C50Afe0794938E836aB8bC0657D56C5a",
            "perChainAssessment": null,
            "errorMessage": "Provided EVM address does not match provided chain id that we support. For EVM addresses please input valid chain id from the following set: [1, 10, 56, 137, 8453, 42161, 43114]"
        },
        {
            "score": null,
            "address": "0xBEdf98c5BCd54565aEC8132202c5d692b75A730B",
            "perChainAssessment": null,
            "errorMessage": "Provided EVM address does not match provided chain id that we support. For EVM addresses please input valid chain id from the following set: [1, 10, 56, 137, 8453, 42161, 43114]"
        },
        {
            "score": {
                "fraud": 30,
                "compliance": 30,
                "cyber": 99,
                "combinedScore": 99
            },
            "address": "bc1qj4hglg9vceql2qj3kad67vh8sgq83535mwvhhk",
            "perChainAssessment": {
                "BITCOIN": {
                    "scoreDetails": {
                        "cyber": {
                            "value": 99,
                            "category": "cyber",
                            "subCategory": "malware",
                            "subCategoryDescription": "This address has been involved in malware and / or ransomware targeting cryptocurrency platforms, illicitly accessing or encrypting data and demanding crypto payments for release."
                        },
                        "fraud": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "compliance": {
                            "value": 30,
                            "category": "compliance",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "combined": {
                            "value": 99,
                            "category": "cyber",
                            "subCategory": "malware",
                            "subCategoryDescription": "This address has been involved in malware and / or ransomware targeting cryptocurrency platforms, illicitly accessing or encrypting data and demanding crypto payments for release."
                        }
                    },
                    "subCategoriesAndTags": [
                        {
                            "type": null,
                            "category": "cyber",
                            "subCategory": "malware",
                            "subCategoryDescription": "This address has been involved in malware and / or ransomware targeting cryptocurrency platforms, illicitly accessing or encrypting data and demanding crypto payments for release.",
                            "tagName": null,
                            "tagDescription": null
                        }
                    ],
                    "deployedAtByChainId": null,
                    "firstAnalysedAtByChainId": null,
                    "lastAnalysedAtByChainId": null,
                    "type": "EOA",
                    "deployer": null
                }
            },
            "errorMessage": null
        },
        {
            "score": {
                "fraud": 30,
                "compliance": 30,
                "cyber": 30,
                "combinedScore": 30
            },
            "address": "MJKqp326RZCHnAAbew9MDdui3iCKWco7fsK9sVuZTX2",
            "perChainAssessment": {
                "SOLANA": {
                    "scoreDetails": {
                        "cyber": {
                            "value": 30,
                            "category": "cyber",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "fraud": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "compliance": {
                            "value": 30,
                            "category": "compliance",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "combined": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        }
                    },
                    "subCategoriesAndTags": [],
                    "deployedAtByChainId": null,
                    "firstAnalysedAtByChainId": null,
                    "lastAnalysedAtByChainId": null,
                    "type": null,
                    "deployer": null
                }
            },
            "errorMessage": null
        },
        {
            "score": {
                "fraud": 30,
                "compliance": 30,
                "cyber": 30,
                "combinedScore": 30
            },
            "address": "ltc1qzvcgmntglcuv4smv3lzj6k8szcvsrmvk0phrr9wfq8w493r096ssm2fgsw",
            "perChainAssessment": {
                "LITECOIN": {
                    "scoreDetails": {
                        "cyber": {
                            "value": 30,
                            "category": "cyber",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "fraud": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "compliance": {
                            "value": 30,
                            "category": "compliance",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "combined": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        }
                    },
                    "subCategoriesAndTags": [],
                    "deployedAtByChainId": null,
                    "firstAnalysedAtByChainId": null,
                    "lastAnalysedAtByChainId": null,
                    "type": "EOA",
                    "deployer": null
                }
            },
            "errorMessage": null
        },
        {
            "score": {
                "fraud": 30,
                "compliance": 30,
                "cyber": 30,
                "combinedScore": 30
            },
            "address": "0xE3280d855d37006DAEF0Ac38f062deAf4847463d",
            "perChainAssessment": {
                "8453": {
                    "scoreDetails": {
                        "cyber": {
                            "value": 30,
                            "category": "cyber",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "fraud": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "compliance": {
                            "value": 30,
                            "category": "compliance",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "combined": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        }
                    },
                    "subCategoriesAndTags": [],
                    "deployedAtByChainId": null,
                    "firstAnalysedAtByChainId": null,
                    "lastAnalysedAtByChainId": null,
                    "type": "EOA",
                    "deployer": null
                },
                "1": {
                    "scoreDetails": {
                        "cyber": {
                            "value": 30,
                            "category": "cyber",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "fraud": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "compliance": {
                            "value": 30,
                            "category": "compliance",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "combined": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        }
                    },
                    "subCategoriesAndTags": [],
                    "deployedAtByChainId": null,
                    "firstAnalysedAtByChainId": null,
                    "lastAnalysedAtByChainId": null,
                    "type": "EOA",
                    "deployer": null
                },
                "56": {
                    "scoreDetails": {
                        "cyber": {
                            "value": 30,
                            "category": "cyber",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "fraud": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "compliance": {
                            "value": 30,
                            "category": "compliance",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "combined": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        }
                    },
                    "subCategoriesAndTags": [],
                    "deployedAtByChainId": null,
                    "firstAnalysedAtByChainId": null,
                    "lastAnalysedAtByChainId": null,
                    "type": "EOA",
                    "deployer": null
                },
                "43114": {
                    "scoreDetails": {
                        "cyber": {
                            "value": 30,
                            "category": "cyber",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "fraud": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "compliance": {
                            "value": 30,
                            "category": "compliance",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "combined": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        }
                    },
                    "subCategoriesAndTags": [],
                    "deployedAtByChainId": null,
                    "firstAnalysedAtByChainId": null,
                    "lastAnalysedAtByChainId": null,
                    "type": "EOA",
                    "deployer": null
                },
                "137": {
                    "scoreDetails": {
                        "cyber": {
                            "value": 30,
                            "category": "cyber",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "fraud": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "compliance": {
                            "value": 30,
                            "category": "compliance",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "combined": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        }
                    },
                    "subCategoriesAndTags": [],
                    "deployedAtByChainId": null,
                    "firstAnalysedAtByChainId": null,
                    "lastAnalysedAtByChainId": null,
                    "type": "EOA",
                    "deployer": null
                },
                "42161": {
                    "scoreDetails": {
                        "cyber": {
                            "value": 30,
                            "category": "cyber",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "fraud": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "compliance": {
                            "value": 30,
                            "category": "compliance",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "combined": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        }
                    },
                    "subCategoriesAndTags": [],
                    "deployedAtByChainId": null,
                    "firstAnalysedAtByChainId": null,
                    "lastAnalysedAtByChainId": null,
                    "type": "EOA",
                    "deployer": null
                },
                "10": {
                    "scoreDetails": {
                        "cyber": {
                            "value": 30,
                            "category": "cyber",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "fraud": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "compliance": {
                            "value": 30,
                            "category": "compliance",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "combined": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        }
                    },
                    "subCategoriesAndTags": [],
                    "deployedAtByChainId": null,
                    "firstAnalysedAtByChainId": null,
                    "lastAnalysedAtByChainId": null,
                    "type": "EOA",
                    "deployer": null
                }
            },
            "errorMessage": null
        },
        {
            "score": {
                "fraud": 30,
                "compliance": 90,
                "cyber": 30,
                "combinedScore": 90
            },
            "address": "0xda617f33766789096a072e353a73416cc6aa41ad",
            "perChainAssessment": {
                "1": {
                    "scoreDetails": {
                        "cyber": {
                            "value": 30,
                            "category": "cyber",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "fraud": {
                            "value": 30,
                            "category": "fraud",
                            "subCategory": null,
                            "subCategoryDescription": null
                        },
                        "compliance": {
                            "value": 90,
                            "category": "compliance",
                            "subCategory": "sanctionedAddressInteraction",
                            "subCategoryDescription": "This address has engaged, either directly or indirectly, with an address that has been sanctioned by governmental authorities due to its associations with illicit activities or violations of regulations.  Example: Tornado Cash"
                        },
                        "combined": {
                            "value": 90,
                            "category": "compliance",
                            "subCategory": "sanctionedAddressInteraction",
                            "subCategoryDescription": "This address has engaged, either directly or indirectly, with an address that has been sanctioned by governmental authorities due to its associations with illicit activities or violations of regulations.  Example: Tornado Cash"
                        }
                    },
                    "subCategoriesAndTags": [
                        {
                            "type": null,
                            "category": "compliance",
                            "subCategory": "sanctionedAddressInteraction",
                            "subCategoryDescription": "This address has engaged, either directly or indirectly, with an address that has been sanctioned by governmental authorities due to its associations with illicit activities or violations of regulations.  Example: Tornado Cash",
                            "tagName": null,
                            "tagDescription": null
                        }
                    ],
                    "deployedAtByChainId": null,
                    "firstAnalysedAtByChainId": null,
                    "lastAnalysedAtByChainId": null,
                    "type": "EOA",
                    "deployer": null
                }
            },
            "errorMessage": null
        }
    ],
    "status": "PARTIALLY_FAILED",
    "errorMessage": "Inspection failed for some addresses in the batch.",
    "createdAt": "2024-07-12T07:23:53.619Z"
}

The request itself had some invalid entries, and they have error message in the response. If you decided to provide chainId, it should match the address format. i.e.: for Tron addresses you can either put "TRON" in chainId, or not provide it at all. Both are valid. But if you put anything except TRON or null inside the chainID for TRON address, you will receive an errorMessage for this address:

{
    "inspectedAddresses": [
        {
            "score": null,
            "address": "TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR",
            "perChainAssessment": null,
            "errorMessage": "Provided chain id does not match address format"
        },...
    ] 
}

For EVM addresses when chainId provided is either not EVM valid chainId or is not among our supported EVM chains, the following message is provided

{
    "inspectedAddresses": [
       ....
       {
            "score": null,
            "address": "0xBEdf98c5BCd54565aEC8132202c5d692b75A730B",
            "perChainAssessment": null,
            "errorMessage": "Provided EVM address does not match provided chain id that we support. For EVM addresses please input valid chain id from the following set: [1, 10, 56, 137, 8453, 42161, 43114]"
        }, ...
     ]
}

In the response we don't see duplicates as they are checked for uniqueness, and thus "0x69Fc8dc3C50Afe0794938E836aB8bC0657D56C5a" and "MJKqp326RZCHnAAbew9MDdui3iCKWco7fsK9sVuZTX2" are only checked / inspected once. Api usage count only increased for the latter and only by 1.

Accepted chainId values for address formats:

Batch has overall status which helps tracking current batch state:

The response for each address is similar to the Inspect one address response.

Last updated