safe-shield

Analyze transaction threat

Changed on

Performs real-time threat analysis for a Safe transaction.

post/v1/chains/{chainId}/security/{safeAddress}/threat-analysis

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

chainIdstring required

Chain ID where the Safe is deployed

safeAddressstring required

Safe contract address

Request body

walletAddressstring required

Address of the transaction signer/wallet

originstring

Optional origin identifier for the request

Response

Threat analysis results including threat findings and balance changes.

request_idstring

Blockaid request ID from x-request-id header. Used for reporting false positives/negatives via the report endpoint.

Example response

{
  "THREAT": [
    {
      "severity": "OK",
      "type": "NO_THREAT",
      "title": "No threats detected",
      "description": "Transaction analysis found no security threats"
    }
  ],
  "BALANCE_CHANGE": [
    {
      "asset": {
        "type": "ERC20",
        "symbol": "USDC",
        "address": "0x0000000000000000000000000000000000000000",
        "logo_url": "https://example.com/usdc-logo.png"
      },
      "in": [
        {
          "value": "1000000"
        }
      ],
      "out": [
        {
          "value": "500000"
        }
      ]
    }
  ],
  "request_id": "11111111-1111-1111-1111-111111111111"
}

Changes

  • d87ba47e4b0dRevision changes
    • warning

      added the new NONERC enum value to the /////// response property for the response status

  • bf7a88dbb9cfRevision changes
    • breaking

      added to the / response property oneOf list for the response status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      removed the FAILED enum value from the ////// response property for the response status