Inspector API

How to Authenticate the APIs

For more information about the product please refer to Inspector. Inspector API key found under Settings > API keys

GEThttps://validation-api.cube3.ai/api/v2/inspector/transactions/{txHash}

Authorization

InspectorApiKeyAuth

Path parameters

txHash*string

Response

200

OK

Body

*/*

txHashstring

attackerContractAddressstring

attackerContractDeployerAddressstring

chainIdstring

blockNumberstring

blockTimestring

transactionScoreTransactionScore (object)

totalLossnumber

victimsBalanceChangesobject

attackersBalanceChangesobject

balanceChangesobject

createdAtstring (date-time)

scoredAddressesarray of ScoredAddresses (object)

transactionRiskProfileTransactionRiskProfile (object)

Request

JavaScriptCurlPython

const response = await fetch('https://validation-api.cube3.ai/api/v2/inspector/transactions/{txHash}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "txHash": "text",
  "attackerContractAddress": "text",
  "attackerContractDeployerAddress": "text",
  "chainId": "text",
  "blockNumber": "text",
  "blockTime": "text",
  "transactionScore": {
    "highestScore": 0,
    "finalScore": {
      "compliance": {
        "value": 0,
        "transactionRisk": 0,
        "participantRisk": 0,
        "type": "ADDRESS",
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text"
      },
      "fraud": {
        "value": 0,
        "transactionRisk": 0,
        "participantRisk": 0,
        "type": "ADDRESS",
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text"
      },
      "cyber": {
        "value": 0,
        "transactionRisk": 0,
        "participantRisk": 0,
        "type": "ADDRESS",
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text"
      },
      "combined": {
        "value": 0,
        "transactionRisk": 0,
        "participantRisk": 0,
        "type": "ADDRESS",
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text"
      }
    },
    "scoreDetails": [
      {
        "reason": "text",
        "value": 0
      }
    ]
  },
  "totalLoss": 0,
  "createdAt": "2024-11-07T01:38:37.307Z",
  "scoredAddresses": [
    {
      "address": "text",
      "category": "text",
      "subCategory": "text",
      "subCategoryDescription": "text",
      "tagName": "text",
      "tagDescription": "text",
      "subCategoriesAndTags": [
        {
          "type": "ADDRESS",
          "category": "text",
          "subCategory": "text",
          "subCategoryDescription": "text",
          "tagName": "text",
          "tagDescription": "text"
        }
      ]
    }
  ],
  "transactionRiskProfile": {}
}

GEThttps://validation-api.cube3.ai/api/v2/inspector/addresses/{address}

Authorization

InspectorApiKeyAuth

Path parameters

address*string

Query parameters

Response

200

OK

Body

*/*

addressstring

chainResultListarray of AddressChainResult (object)

Request

JavaScriptCurlPython

const response = await fetch('https://validation-api.cube3.ai/api/v2/inspector/addresses/{address}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "address": "text",
  "chainResultList": [
    {
      "chainId": "text",
      "score": {},
      "scImplementations": [
        {
          "address": "text",
          "score": {}
        }
      ],
      "isProxy": false,
      "deployedAtByChainId": "2024-11-07T01:38:37.307Z",
      "firstAnalysedAtByChainId": "2024-11-07T01:38:37.307Z",
      "lastAnalysedAtByChainId": "2024-11-07T01:38:37.307Z",
      "type": "EOA",
      "deployer": "text"
    }
  ]
}

Inspector Batch API

Inspector also supports batch requests. Submit batch via POST and retrieve the responses using the batchId GET endpoints.

Address format	Accepted chainId	Null accepted ?
EVM	Any of the following: "1", "10", "56", "137", "8453", "42161", "43114"	yes
Tron	"TRON"	yes
Bitcoin	"BITCOIN"	yes
Solana	"SOLANA"	yes
Litecoin	"LITECOIN"	yes

Batch status	Description
COMPLETED	The batch was completed without any issues.
IN_PROGRESS	Batch is still in progress and should complete soon.
FAILED	All addresses in batch are either invalid or combinations with chainId are invalid. Error messages provided for each address.
PARTIALLY_FAILED	Some addresses in the batch are valid and processed, while others have error message with description why they have failed.
EXPIRED	Batch has not completed within a reasonable timeframe.

POSThttps://validation-api.cube3.ai/api/v2/inspector/addresses/batches

Authorization

InspectorApiKeyAuth

Header parameters

Body

application/json

addresses*array of Address (object)

Response

200

OK

Body

*/*

urlstring

Request

JavaScriptCurlPython

const response = await fetch('https://validation-api.cube3.ai/api/v2/inspector/addresses/batches', {
    method: 'POST',
    headers: {
      "X-Tenant-Id": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "addresses": [
        {
          "address": "text"
        }
      ]
    }),
});
const data = await response.json();

Response

200

{
  "url": "text"
}

GEThttps://validation-api.cube3.ai/api/v2/inspector/addresses/batches/{batchId}

Authorization

InspectorApiKeyAuth

Path parameters

batchId*string

Response

200

OK

Body

*/*

inspectedAddressesarray of InspectedAddress (object)

statusenum

COMPLETEDIN_PROGRESSFAILEDPARTIALLY_FAILEDEXPIRED

errorMessagestring

createdAtstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://validation-api.cube3.ai/api/v2/inspector/addresses/batches/{batchId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "inspectedAddresses": [
    {
      "score": {},
      "address": "text",
      "errorMessage": "text"
    }
  ],
  "status": "COMPLETED",
  "errorMessage": "text",
  "createdAt": "2024-11-07T01:38:37.307Z"
}