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

application/json

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

/analyze

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

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