Validation API

How to Authenticate the APIs

The Validation API provides endpoints for validating a transaction by sending the transaction data and other relevant information. It is secured using a Validation API key found under Settings > API keys in Panorama UI. The usage of the APIs is described in the CUBE3 SDK.

post

Authorizations

Header parameters

X-Tenant-IdstringRequired

X-Api-KeystringRequired

X-Validation-ProductstringRequired

X-InitiatorstringOptional

Body

trackNoncebooleanRequired

Indicates whether to track the nonce of the transaction

signTransactionbooleanOptional

Indicates whether the transaction should be signed

Responses

200

OK

*/*

post

HTTPcURLJavaScriptPython

POST /api/v2/transaction/validate HTTP/1.1
Host: validation-api-dev.cube3.ai
X-Api-Key: text
X-Tenant-Id: text
X-Validation-Product: text
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "transaction": {
    "to": "text",
    "from": "text",
    "nonce": "text",
    "data": "text",
    "value": "text",
    "chainId": "text"
  },
  "trackNonce": true,
  "clientData": {
    "userAgent": "text",
    "ip": "text"
  },
  "signTransaction": true
}

200

OK

{
  "valid": true,
  "payload": "text",
  "combinedScore": 1,
  "combinedScoreDetails": {
    "value": 1,
    "category": "text",
    "subCategory": "text",
    "subCategoryDescription": "text",
    "hops": 1
  },
  "scoreDetails": {
    "ANY_ADDITIONAL_PROPERTY": {
      "value": 1,
      "category": "text",
      "subCategory": "text",
      "subCategoryDescription": "text",
      "hops": 1
    }
  },
  "controlLists": [
    {
      "id": "text",
      "address": "text",
      "chainIds": [
        "text"
      ],
      "type": "ALLOW",
      "productType": "SONAR",
      "createdAt": "2025-05-16T09:09:53.116Z",
      "lastUpdatedAt": "2025-05-16T09:09:53.116Z"
    }
  ],
  "internalAddressesWithMaxScore": [
    {
      "address": "text",
      "name": "text",
      "maxScore": 1,
      "category": "text",
      "subCategory": "text",
      "subCategoryDescription": "text",
      "subCategoriesAndTags": [
        {
          "category": "text",
          "subCategory": "text",
          "subCategoryDescription": "text"
        }
      ]
    }
  ],
  "error": "text",
  "cube3TxId": "text"
}

put

Authorizations

Path parameters

cube3-transaction-idstringRequired

Header parameters

X-Tenant-IdstringRequired

X-InitiatorstringOptional

Body

transactionIdstringOptional

Real transaction id on chain.

blockNumberstringOptional

Transaction on chain block number.

blockTimestring · date-timeOptional

Transaction on chain block time.

Responses

200

OK

put

HTTPcURLJavaScriptPython

PUT /api/v2/transaction/{cube3-transaction-id} HTTP/1.1
Host: validation-api-dev.cube3.ai
X-Api-Key: YOUR_API_KEY
X-Tenant-Id: text
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "transactionId": "text",
  "blockNumber": "text",
  "blockTime": "2025-05-16T09:09:53.116Z"
}

200

OK

No content

Deprecated:

post

Authorizations

Body

trackNoncebooleanRequired

Indicates whether to track the nonce of the transaction

signTransactionbooleanOptional

Indicates whether the transaction should be signed

Responses

200

OK

*/*

post

HTTPcURLJavaScriptPython

POST /api/v1/transaction/validate HTTP/1.1
Host: validation-api.cube3.ai
X-Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "transaction": {
    "to": "text",
    "from": "text",
    "nonce": "text",
    "data": "text",
    "value": "text",
    "chainId": "text"
  },
  "trackNonce": true,
  "clientData": {
    "userAgent": "text",
    "ip": "text"
  },
  "signTransaction": true
}

200

OK

{
  "valid": true,
  "payload": "text",
  "error": "text",
  "combinedScore": 1,
  "combinedScoreDetails": {
    "value": 1,
    "category": "text",
    "subCategory": "text",
    "subCategoryDescription": "text"
  },
  "cube3TxId": "text"
}

Deprecated:

put

Authorizations

Path parameters

cube3-transaction-idstringRequired

Body

transactionIdstringRequired

blockNumberstringOptional

blockTimestring · date-timeOptional

Responses

200

OK

put

HTTPcURLJavaScriptPython

PUT /api/v1/transaction/{cube3-transaction-id} HTTP/1.1
Host: validation-api.cube3.ai
X-Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "transactionId": "text",
  "blockNumber": "text",
  "blockTime": "2025-05-16T09:09:53.116Z"
}

200

OK

No content