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

/api/v2/transaction/validate

Authorizations

Header parameters

X-Tenant-Idstringrequired

X-Api-Keystringrequired

X-Validation-Productstringrequired

X-Initiatorstring

Body

transactionobjectrequired

trackNoncebooleanrequired

Indicates whether to track the nonce of the transaction

clientDataobject

signTransactionboolean

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","chainId":"text"},"trackNonce":true,"clientData":{}}'

200

200

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

OK

put

/api/v2/transaction/{cube3-transaction-id}

Authorizations

Path parameters

cube3-transaction-idstringrequired

Header parameters

X-Tenant-Idstringrequired

X-Initiatorstring

Body

transactionIdstring

Real transaction id on chain.

blockNumberstring

Transaction on chain block number.

blockTimestring · date-time

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'

200

200

No body

OK

Deprecated:

post

/api/v1/transaction/validate

Authorizations

Body

transactionobjectrequired

trackNoncebooleanrequired

Indicates whether to track the nonce of the transaction

clientDataobject

signTransactionboolean

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","chainId":"text"},"trackNonce":true,"clientData":{}}'

200

200

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

OK

Deprecated:

put

/api/v1/transaction/{cube3-transaction-id}

Authorizations

Path parameters

cube3-transaction-idstringrequired

Body

transactionIdstringrequired

blockNumberstring

blockTimestring · date-time

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"}'

200

200

No body

OK