Address Analysis

Analyze a Blockchain Address

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

Body

blockchain_addressstring · hexOptionalExample: 0x8904E3E9eaB00F64458845d32Ea22b2279fda1f7

chain_idstring · hexOptionalExample: 0x1

Responses

200

Successful operation

application/json

403

Forbidden

500

Internal Server Error

post

HTTPcURLJavaScriptPython

POST /api/v2/analyze_address HTTP/1.1
Host: api.blockfence.io
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "blockchain_address": "0x8904E3E9eaB00F64458845d32Ea22b2279fda1f7",
  "chain_id": "0x1"
}

{
  "severity": "Medium",
  "is_contract": false,
  "bf_blockchain_analysis": [
    {
      "name": "Address Familiarity Score",
      "findings": [
        {
          "description": "This address is not listed in any known repository",
          "label": "Malicious"
        }
      ],
      "severity": "Medium"
    }
  ],
  "partners_analysis": [
    {
      "name": "Address Familiarity Score",
      "findings": [
        {
          "description": "This address is not listed in any known repository",
          "label": "Malicious"
        }
      ],
      "severity": "Medium"
    }
  ]
}

Request Body Parameters

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

Usage Example

Request

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

Response

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

Response Fields

Field	Type	Contents
severity	string	Indicates the severity level of the analysis result. Possible values: "High", "Medium", "Low".
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_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", "Medium". Low 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.