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

transactionobjectrequired

trackNoncebooleanrequired

Indicates whether to track the nonce of the transaction

clientDataobjectoptional

signTransactionbooleanoptional

Indicates whether the transaction should be signed

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://validation-api-dev.cube3.ai/api/v2/transaction/validate' \
  --header 'X-Api-Key: text' \
  --header 'X-Tenant-Id: text' \
  --header 'X-Validation-Product: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "transaction": {
      "to": "text",
      "from": "text",
      "nonce": "text",
      "data": "text",
      "value": "text",
      "chainId": "text"
    },
    "trackNonce": true,
    "clientData": {
      "userAgent": "text",
      "ip": "text"
    },
    "signTransaction": true
  }'

200

200

{
  "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-04-01T20:00:39.192Z",
      "lastUpdatedAt": "2025-04-01T20:00:39.192Z"
    }
  ],
  "internalAddressesWithMaxScore": [
    {
      "address": "text",
      "name": "text",
      "maxScore": 1,
      "category": "text",
      "subCategory": "text",
      "subCategoryDescription": "text",
      "subCategoriesAndTags": [
        {
          "category": "text",
          "subCategory": "text",
          "subCategoryDescription": "text"
        }
      ]
    }
  ],
  "error": "text",
  "cube3TxId": "text"
}

OK

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

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://validation-api-dev.cube3.ai/api/v2/transaction/{cube3-transaction-id}' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'X-Tenant-Id: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "transactionId": "text",
    "blockNumber": "text",
    "blockTime": "2025-04-01T20:00:39.192Z"
  }'

200

200

No body

OK

Deprecated:

post

Authorizations

Body

transactionobjectrequired

trackNoncebooleanrequired

Indicates whether to track the nonce of the transaction

clientDataobjectoptional

signTransactionbooleanoptional

Indicates whether the transaction should be signed

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://validation-api.cube3.ai/api/v1/transaction/validate' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "transaction": {
      "to": "text",
      "from": "text",
      "nonce": "text",
      "data": "text",
      "value": "text",
      "chainId": "text"
    },
    "trackNonce": true,
    "clientData": {
      "userAgent": "text",
      "ip": "text"
    },
    "signTransaction": true
  }'

200

200

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

OK

Deprecated:

put

Authorizations

Path parameters

cube3-transaction-idstringrequired

Body

transactionIdstringrequired

blockNumberstringoptional

blockTimestring · date-timeoptional

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://validation-api.cube3.ai/api/v1/transaction/{cube3-transaction-id}' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "transactionId": "text",
    "blockNumber": "text",
    "blockTime": "2025-04-01T20:00:39.192Z"
  }'

200

200

No body

OK