Back to Homepage

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
post
/analyze
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]:

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"
}
'

Usage Example 2 - [High Risk]:

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"
}
'

Last updated

Was this helpful?