Transaction Analysis

Analyze a Blockchain Address or a URL or a combination of both

Supported Networks

• Ethereum: chain_id: "0x1"

• BSC: chain_id: "0x38"

• Avalanche: chain_id: "0xa86a"

• Polygon: chain_id: "0x89"

• Optimism: chain_id: "0xa"

• Arbitrum: chain_id: "0xa4b1"

All requests require an API key. Add "x-api-key" to your request header as shown in the example below.

Don't have an API key? Contact us to get one.

post

Analyze a blockhain address or a URL

Body

chain_idstring · hexOptionalExample: 0x1

blockchain_addressstring · hexOptionalExample: 0x8904E3E9eaB00F64458845d32Ea22b2279fda1f7

urlstring · hexOptionalExample: https://blockfence.io/

Responses

200

Successful operation

application/json

403

Forbidden

500

Internal Server Error

post

HTTPcURLJavaScriptPython

POST /api/v1/analyze HTTP/1.1
Host: api.blockfence.io
Content-Type: application/json
Accept: */*
Content-Length: 115

{
  "chain_id": "0x1",
  "blockchain_address": "0x8904E3E9eaB00F64458845d32Ea22b2279fda1f7",
  "url": "https://blockfence.io/"
}

{
  "severity": "NONE",
  "is_contract": true,
  "bf_blockchain_analysis": [
    {
      "name": "Blockfence Smart Contract Analysis",
      "severity": "NONE",
      "findings": [
        {
          "description": "No threats detected",
          "label": "text"
        }
      ]
    }
  ],
  "bf_web_analysis": [
    {
      "name": "URL Similarity Verification",
      "severity": "HIGH",
      "findings": [
        {
          "description": "  • looks like swap.hiveswap.io",
          "label": "CONTAINED_STRING"
        }
      ]
    }
  ],
  "partners_analysis": [
    {
      "name": "DappRadar",
      "severity": "LOW",
      "findings": [
        {
          "description": "This address is not listed by DappRadar\nProceed with caution!",
          "label": "DAPPRADAR_NOT_VERIFIED"
        }
      ]
    }
  ]
}

Request Body Parameters

Parameter Name	Parameter Type	Comments
chain_id	hex string (optional)	Chain ID (e.g. "0x1" for mainnet)
blockchain_address	hex string (optional)	Blockchain address
url	string (optional)	URL

When querying a blockchain address, chain ID and blockchain address are mandatory. When querying a URL, chain ID and blockchain address are not mandatory.

Response Fields

Field	Type	Contents
severity	string	Indicates the severity level of the analysis result. Possible values: "HIGH", "LOW", "NONE".
analysis_score	number	A floating-point score quantifying the analysis outcome. Score is from 1 to 10.
is_contract	boolean	Specifies whether the analyzed address is a contract.
bf_web_analysis	array	An array of APIAnalyzerResult objects containing web analysis results, if any.
bf_blockchain_analysis	array	An array of APIAnalyzerResult objects containing blockchain analysis results, if any.
partners_analysis	array	An array of APIAnalyzerResult objects containing analysis results from partners.

APIAnalyzerResult

Field	Type	Contents
name	string	The name of the analyzer that produced the findings.
findings	array	An array of Risk objects detailing specific analysis findings.
severity	string	The severity level of the findings from this analyzer. Possible values: "HIGH", "LOW". NONE severity risks will not be returned.

Risk

Field	Type	Contents
description	string	A description of the risk identified.
label	string	An optional label categorizing the risk.

Usage Example 1 - [Low Risk]:

Request

curl https://api.blockfence.io/api/v1/analyze -X POST -H "Content-Type: application/json" -H "x-api-key: <YOUR API KEY>" -d '
{
    "chain_id": "0x1",
    "blockchain_address": "0x541a2378589e280fdfdde6e53fb5ecf98a853fc2",
    "url": "https://bunni.pro/stake"
}
'

Response

{
    "severity": "LOW",
    "analysis_score": 6.7,
    "is_contract": true,
    "bf_blockchain_analysis": [
        {
            "name": "Address Familiarity Score",
            "findings": [
                {
                    "description": "This address is not listed in any known repository"
                }
            ],
            "severity": "LOW"
        },
        {
            "name": "Blockfence Smart Contract Analysis",
            "findings": [
                {
                    "description": "Blockfence analysis identified this address as a possible Malicious scam!",
                    "label": "Malicious"
                }
            ],
            "severity": "LOW"
        }
    ]
}

Usage Example 2 - [High Risk]:

Request

curl https://api.blockfence.io/api/v1/analyze -X POST -H "Content-Type: application/json" -H "x-api-key: <YOUR API KEY>" -d '
{
    "chain_id": "0x1",
    "blockchain_address": "0x50f5474724e0Ee42D9a4e711ccFB275809Fd6d4a",
    "url": "https://nft-studio.com"
}
'

Response

{
    "severity": "HIGH",
    "analysis_score": 10,
    "is_contract": true,
    "bf_web_analysis": [
        {
            "name": "Graph Web Analysis",
            "findings": [
                {
                    "description": "Malicious address detected! proceed with caution",
                    "label": "Malicous_association"
                }
            ],
            "severity": "HIGH"
        }
    ],
    "bf_blockchain_analysis": [
        {
            "name": "Address Familiarity Score",
            "findings": [
                {
                    "description": "This Address appears to be Blocklisted! 0X50F54...6D4A",
                    "label": "BLOCKLIST"
                }
            ],
            "severity": "HIGH"
        },
        {
            "name": "Source Code Verification",
            "findings": [
                {
                    "description": "Source Code analysis identified this contract as containing a call to setApprovalForAll!\nProceed with caution!"
                }
            ],
            "severity": "LOW"
        }
    ],
    "partners_analysis": [
        {
            "name": "Forta Network",
            "findings": [
                {
                    "description": "  • Scam detector identified this address as a possible Rake Token scam!",
                    "label": "SCAM-DETECTOR-RAKE-TOKEN"
                }
            ],
            "severity": "HIGH"
        },
        {
            "name": "GoPlus Contract Analysis",
            "findings": [
                {
                    "description": "We found the following risks on GoPlus Labs:"
                },
                {
                    "description": "  • This address is related to honeypot tokens or has created scam tokens.",
                    "label": "honeypot_related_address"
                }
            ],
            "severity": "HIGH"
        }
    ]
}