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

Authorizations

Path parameters

txHashstringRequired

Responses

200

OK

*/*

get

HTTPcURLJavaScriptPython

GET /api/v2/inspector/transactions/{txHash} HTTP/1.1
Host: validation-api.cube3.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

200

OK

{
  "txHash": "text",
  "attackerContractAddress": "text",
  "attackerContractDeployerAddress": "text",
  "chainId": "text",
  "blockNumber": "text",
  "blockTime": "text",
  "transactionScore": {
    "highestScore": 1,
    "finalScore": {
      "compliance": {
        "value": 1,
        "transactionRisk": 1,
        "participantRisk": 1,
        "type": "ADDRESS",
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text"
      },
      "fraud": {
        "value": 1,
        "transactionRisk": 1,
        "participantRisk": 1,
        "type": "ADDRESS",
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text"
      },
      "cyber": {
        "value": 1,
        "transactionRisk": 1,
        "participantRisk": 1,
        "type": "ADDRESS",
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text"
      },
      "combined": {
        "value": 1,
        "transactionRisk": 1,
        "participantRisk": 1,
        "type": "ADDRESS",
        "category": "text",
        "subCategory": "text",
        "subCategoryDescription": "text",
        "tagName": "text",
        "tagDescription": "text"
      }
    },
    "scoreDetails": [
      {
        "reason": "text",
        "value": 1
      }
    ]
  },
  "totalLoss": 1,
  "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
      }
    ]
  },
  "createdAt": "2025-05-12T20:13:08.611Z",
  "scoredAddresses": [
    {
      "address": "text",
      "score": 1,
      "category": "text",
      "subCategory": "text",
      "subCategoryDescription": "text",
      "tagName": "text",
      "tagDescription": "text",
      "subCategoriesAndTags": [
        {
          "type": "ADDRESS",
          "category": "text",
          "subCategory": "text",
          "subCategoryDescription": "text",
          "tagName": "text",
          "tagDescription": "text"
        }
      ]
    }
  ],
  "transactionRiskProfile": {
    "transactionRisk": 1,
    "participantRisk": 1
  }
}

get

Authorizations

Path parameters

addressstringRequired

Query parameters

chainIdstringOptional

Responses

200

OK

*/*

get

HTTPcURLJavaScriptPython

GET /api/v2/inspector/addresses/{address} HTTP/1.1
Host: validation-api.cube3.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

200

OK

{
  "address": "text",
  "chainResultList": [
    {
      "chainId": "text",
      "score": {
        "fraud": 1,
        "compliance": 1,
        "cyber": 1,
        "combined": 1
      },
      "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"
            }
          }
        }
      ],
      "isProxy": true,
      "deployedAtByChainId": "2025-05-12T20:13:08.611Z",
      "firstAnalysedAtByChainId": "2025-05-12T20:13:08.611Z",
      "lastAnalysedAtByChainId": "2025-05-12T20:13:08.611Z",
      "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
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

Authorizations

Header parameters

X-Tenant-IdstringRequired

Body

Responses

200

OK

*/*

post

HTTPcURLJavaScriptPython

POST /api/v2/inspector/addresses/batches HTTP/1.1
Host: validation-api.cube3.ai
X-Api-Key: YOUR_API_KEY
X-Tenant-Id: text
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "addresses": [
    {
      "address": "text",
      "chainId": "text"
    }
  ]
}

200

OK

{
  "url": "text"
}

get

Authorizations

Path parameters

batchIdstringRequired

Responses

200

OK

*/*

get

HTTPcURLJavaScriptPython

GET /api/v2/inspector/addresses/batches/{batchId} HTTP/1.1
Host: validation-api.cube3.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

200

OK

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