Analysis

Get contract dependencies

get

Analyze and return the dependency network for a given contract address.

Path parameters

addressstringRequired

Query parameters

from_blockstringOptional

Start block

to_blockstringOptional

End block

Responses

200

Successful Response

application/json

422

Input validation error

application/json

500

Internal server error

application/json

get

/v1/analysis/{address}/dependencies

HTTPcURLJavaScriptPython

GET /v1/analysis/{address}/dependencies HTTP/1.1
Host: 
Accept: */*

{
  "address": "text",
  "from_block": 1,
  "to_block": 1,
  "n_nodes": 1,
  "nodes": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "edges": [
    {
      "source": "text",
      "target": "text",
      "types": {
        "ANY_ADDITIONAL_PROPERTY": 1
      }
    }
  ],
  "dependency_depths": {
    "ANY_ADDITIONAL_PROPERTY": 1
  },
  "n_matching_transactions": 1
}

Get contract risk assessment

get

Calculate and return the risk assessment for a given contract address.

Path parameters

addressstringRequired

Query parameters

from_blockstringOptional

Start block

to_blockstringOptional

End block

Responses

200

Successful Response

application/json

422

Input validation error

application/json

500

Internal server error

application/json

get

/v1/analysis/{address}/risk

HTTPcURLJavaScriptPython

GET /v1/analysis/{address}/risk HTTP/1.1
Host: 
Accept: */*

{
  "root_address": "text",
  "from_block": 1,
  "to_block": 1,
  "dependencies": [
    {
      "verified": true,
      "risk_factors": {
        "upgradeability": true,
        "permissioned": true,
        "repository": true,
        "audits": true,
        "scorecard": 1
      },
      "details": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "address": "text",
      "dependency_depth": 1
    }
  ],
  "aggregated_risks": {
    "verified": true,
    "risk_factors": {
      "upgradeability": true,
      "permissioned": true,
      "repository": true,
      "audits": true,
      "scorecard": 1
    },
    "details": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  }
}

Transaction risk: simulate and check

post

Simulate a transaction via Erigon trace_call, list all touched contracts (including DELEGATECALL), and report whether it's the first interaction by the sender and the verification status.

Body

application/json

Request model for pre-sign transaction simulation.

from_addrstringRequired

EOA sender address

to_addrstringRequired

Target contract address

datastringOptional

Calldata hex

Default: 0x

valueany ofOptional

Wei value (hex)

Default: 0x0

stringOptional

or

nullOptional

gasany ofOptional

Gas limit (hex)

stringOptional

or

nullOptional

gasPriceany ofOptional

Gas price (hex)

stringOptional

or

nullOptional

maxFeePerGasany ofOptional

maxFeePerGas (hex)

stringOptional

or

nullOptional

maxPriorityFeePerGasany ofOptional

maxPriorityFeePerGas (hex)

stringOptional

or

nullOptional

tx_typeany ofOptional

Tx type, e.g., 0x2

stringOptional

or

nullOptional

block_tagany ofOptional

Block tag or number

Default: latest

stringOptional

or

nullOptional

latest_offsetany ofOptional

Limit first-time checks to N latest blocks (performance control)

Default: 100

integerOptional

or

nullOptional

from_blockany ofOptional

Lower bound block for first-time checks

stringOptional

or

nullOptional

to_blockany ofOptional

Upper bound block for first-time checks

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Input validation error

application/json

500

Internal server error

application/json

post

/v1/analysis/tx-risk

HTTPcURLJavaScriptPython

POST /v1/analysis/tx-risk HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 242

{
  "from_addr": "text",
  "to_addr": "text",
  "data": "0x",
  "value": "0x0",
  "gas": "text",
  "gasPrice": "text",
  "maxFeePerGas": "text",
  "maxPriorityFeePerGas": "text",
  "tx_type": "text",
  "block_tag": "latest",
  "latest_offset": 100,
  "from_block": "text",
  "to_block": "text"
}

{
  "status": "OK",
  "details": [
    {
      "address": "text",
      "first_time": true,
      "verification": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "depth": 1,
      "types": {
        "ANY_ADDITIONAL_PROPERTY": 1
      }
    }
  ]
}

Transaction risk by tx hash

get

Analyze a confirmed transaction by hash, list all touched contracts (including DELEGATECALL), and report whether it's the first interaction by the sender and the verification status.

Path parameters

tx_hashstringRequired

Query parameters

from_blockany ofOptional

Lower bound block for first-time checks

stringOptional

or

nullOptional

to_blockany ofOptional

Upper bound block for first-time checks

stringOptional

or

nullOptional

latest_offsetany ofOptional

Limit first-time checks to N latest blocks

Default: 100

integerOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Input validation error

application/json

500

Internal server error

application/json

get

/v1/analysis/tx-risk/{tx_hash}

HTTPcURLJavaScriptPython

GET /v1/analysis/tx-risk/{tx_hash} HTTP/1.1
Host: 
Accept: */*

{
  "status": "OK",
  "details": [
    {
      "address": "text",
      "first_time": true,
      "verification": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "depth": 1,
      "types": {
        "ANY_ADDITIONAL_PROPERTY": 1
      }
    }
  ]
}