Quick Start

Get your API keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

If you don't have an API Key, please contact [email protected] to get your key.

Make your first request

To make your first request, send an authenticated request to our analyze endpoint. The response will be the aggregated risk assessment.

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

Usage Example:

Request

{
    "chain_id": "0x1",
    "blockchain_address": "0x953de0fee9e7b8056dd802b2e9ba0c8e540c68b8",
    "url": "https://sudosswapq.space/"
}

Response