TAtatum
Security API

Analyze contract risk

Changed on

/v4/data/security/contract/risk

60000 credits per API call

Analyze a smart contract or token for scam and security risks. The analysis runs a set of on-chain and source-level risk checks (ERC-20 compliance, honeypot traits, owner privileges, liquidity risks, and more) and aggregates them into a single score.

Response

  • score — overall risk score, 0–100; higher means riskier.
  • results — every risk check that was evaluated, each with a machine-readable key, a boolean value (whether the risk was detected), and human-readable title/sub_title/description.
get/v4/data/security/contract/risk

Request

  • Base URL
    https://api.tatum.io
  • URL
    https://api.tatum.io/v4/data/security/contract/risk
  • Auth
    API key in header x-api-key

Query parameters

chain'ethereum-mainnet' | 'bsc-mainnet' | 'polygon-mainnet' | 'optimism-mainnet' | 'arb-one-mainnet' | 'base-mainnet' | 'avax-mainnet' | 'celo-mainnet' | 'gno-mainnet' | 'xdc-mainnet' | 'unichain-mainnet' | 'sonic-mainnet' | 'berachain-mainnet' required
Example:ethereum-mainnet

Chain the contract lives on.

addressstring required
Example:0xdAC17F958D2ee523a2206206994597C13D831ec7

The contract or token address to analyze.

Response

OK

scorenumber

Overall risk score, 0–100. Higher means riskier.

addressstring

The analyzed contract address.

chainstring

The chain the contract was analyzed on (Tatum chain name).

Example response

{
  "score": 80,
  "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
  "chain": "ethereum-mainnet",
  "results": [
    {
      "key": "risk_not_erc20_full_compliance",
      "value": true,
      "title": "Not fully ERC20 compliant",
      "sub_title": "Token is not fully compliant with the ERC20 standard"
    }
  ]
}

Changes