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

get

/api/v2/inspector/transactions/{txHash}

Authorizations

Path parameters

txHashstringrequired

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://validation-api.cube3.ai/api/v2/inspector/transactions/{txHash}' \
  --header 'X-Api-Key: YOUR_API_KEY'

200

200

{
  "txHash": "text",
  "attackerContractAddress": "text",
  "attackerContractDeployerAddress": "text",
  "chainId": "text",
  "blockNumber": "text",
  "blockTime": "text",
  "transactionScore": {
    "highestScore": 1,
    "finalScore": {
      "compliance": {
        "value": 1,
        "transactionRisk": 1,
        "participantRisk": 1,
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text",
        "type": "ADDRESS"
      },
      "fraud": {
        "value": 1,
        "transactionRisk": 1,
        "participantRisk": 1,
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text",
        "type": "ADDRESS"
      },
      "cyber": {
        "value": 1,
        "transactionRisk": 1,
        "participantRisk": 1,
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text",
        "type": "ADDRESS"
      },
      "combined": {
        "value": 1,
        "transactionRisk": 1,
        "participantRisk": 1,
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text",
        "type": "ADDRESS"
      }
    },
    "scoreDetails": [
      {
        "reason": "text",
        "value": 1
      }
    ]
  },
  "totalLoss": 1,
  "createdAt": "2025-02-23T03:52:05.901Z",
  "transactionRiskProfile": {
    "transactionRisk": 1,
    "participantRisk": 1
  },
  "scoredAddresses": [
    {
      "address": "text",
      "score": 1,
      "category": "text",
      "subCategory": "text",
      "subCategoryDescription": "text",
      "tagName": "text",
      "tagDescription": "text",
      "subCategoriesAndTags": [
        {
          "category": "text",
          "subCategory": "text",
          "subCategoryDescription": "text",
          "tagName": "text",
          "tagDescription": "text",
          "type": "ADDRESS"
        }
      ]
    }
  ],
  "victimsBalanceChanges": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "token": "text",
        "tokenAddress": "text",
        "value": 1,
        "usd": 1,
        "score": 1
      }
    ]
  },
  "attackersBalanceChanges": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "token": "text",
        "tokenAddress": "text",
        "value": 1,
        "usd": 1,
        "score": 1
      }
    ]
  },
  "balanceChanges": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "token": "text",
        "tokenAddress": "text",
        "value": 1,
        "usd": 1,
        "score": 1
      }
    ]
  }
}

OK

get

/api/v2/inspector/addresses/{address}

Authorizations

Path parameters

addressstringrequired

Query parameters

chainIdstring

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://validation-api.cube3.ai/api/v2/inspector/addresses/{address}' \
  --header 'X-Api-Key: YOUR_API_KEY'

200

200

{
  "address": "text",
  "chainResultList": [
    {
      "chainId": "text",
      "score": {
        "fraud": 1,
        "compliance": 1,
        "cyber": 1,
        "combined": 1
      },
      "isProxy": true,
      "deployedAtByChainId": "2025-02-23T03:52:05.901Z",
      "firstAnalysedAtByChainId": "2025-02-23T03:52:05.901Z",
      "lastAnalysedAtByChainId": "2025-02-23T03:52:05.901Z",
      "deployer": "text",
      "type": "EOA",
      "scoreDetails": {
        "ANY_ADDITIONAL_PROPERTY": {
          "value": 1,
          "subCategory": "text",
          "subCategoryDescription": "text"
        }
      },
      "scImplementations": [
        {
          "address": "text",
          "score": {
            "fraud": 1,
            "compliance": 1,
            "cyber": 1,
            "combined": 1
          },
          "scoreDetails": {
            "ANY_ADDITIONAL_PROPERTY": {
              "value": 1,
              "subCategory": "text",
              "subCategoryDescription": "text"
            }
          }
        }
      ]
    }
  ]
}

OK

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
Ripple	"RIPPLE"	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.

post

/api/v2/inspector/addresses/batches

Authorizations

Header parameters

X-Tenant-Idstringrequired

Body

addressesobject[]required

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://validation-api.cube3.ai/api/v2/inspector/addresses/batches' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'X-Tenant-Id: text' \
  --header 'Content-Type: application/json' \
  --data '{"addresses":[{"address":"text"}]}'

200

200

{
  "url": "text"
}

OK

get

/api/v2/inspector/addresses/batches/{batchId}

Authorizations

Path parameters

batchIdstringrequired

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://validation-api.cube3.ai/api/v2/inspector/addresses/batches/{batchId}' \
  --header 'X-Api-Key: YOUR_API_KEY'

200

200

{
  "errorMessage": "text",
  "createdAt": "2025-02-23T03:52:05.901Z",
  "status": "COMPLETED",
  "inspectedAddresses": [
    {
      "score": {
        "fraud": 1,
        "compliance": 1,
        "cyber": 1,
        "combined": 1
      },
      "address": "text",
      "errorMessage": "text",
      "perChainAssessment": {
        "ANY_ADDITIONAL_PROPERTY": {
          "deployedAtByChainId": "2025-02-23T03:52:05.901Z",
          "firstAnalysedAtByChainId": "2025-02-23T03:52:05.901Z",
          "lastAnalysedAtByChainId": "2025-02-23T03:52:05.901Z",
          "deployer": "text",
          "type": "EOA",
          "scoreDetails": {
            "ANY_ADDITIONAL_PROPERTY": {
              "value": 1,
              "category": "text",
              "subCategory": "text",
              "subCategoryDescription": "text"
            }
          },
          "subCategoriesAndTags": [
            {
              "category": "text",
              "subCategory": "text",
              "subCategoryDescription": "text",
              "tagName": "text",
              "tagDescription": "text",
              "type": "ADDRESS"
            }
          ]
        }
      }
    }
  ]
}

OK