Overview

The Address Risk API provides a comprehensive analysis of risk associated with Ethereum addresses. It is designed to identify various risk factors, including connections to known hackers, mixers, or other flagged entities.

Base URL

https://risk.infra.fuzz.land/

Endpoint: /risk/{chain}/{address}

This endpoint retrieves risk information for a specified address.

• Method: GET
• URL Params:
  • Required: address=[address]
  • Required: chain=[eth|bsc|polygon|optimism|base]

Response Format

The response is a JSON object containing several fields that describe the risk associated with the Ethereum address. Key components include:

• fund_flow: Detailed information about the flow of funds:
  • accounts: An object containing information about related accounts:
    • address The address
    • type Either eoa or contract
    • label Descriptive label of the address.
    • risk_score Score in float of the risk of the specific address
    • additional_labels Additional labels of the address
  • flows: An array of objects detailing individual fund transfers:
    • amount Amount of the token
    • from Receiver
    • to Sender
    • token Token involved in the flow. If it is native token, the field is @native otherwise (erc20 / erc721), it is the address of the token.
    • txhash Transaction hash of the flow
    • type transfer , contract_creation , or cross_chain
  • label: Descriptive label of the address.
• fund_flow_risk: Overall risk assessment of the fund flow.
  • drainer whether involved in scams
  • hacker whether involved in malicious tx
  • mixers whether received or sent funds to mixers
  • tornado whether appears to be tornado cash relayer / contracts
  • ofac whether appears in OFAC ban list
  • fbi_ic3 whether appears in FBI IC3 ban list
• risk: Overall risk assessment of the address.

Sample Response

/risk/eth/0x6ce8c5ad1339fb9d7e40f0f4e234e7ca847163de

{
  "fund_flow": {
    "accounts": {
      "0x0a5984f86200415894821bfefc1c1de036dbf9e7": {
        "additional_labels": { ... },
        "address": "0x0a5984f86200415894821bfefc1c1de036dbf9e7",
        "label": "Poloniex Exchange Exploiter",
        "risk_score": 100,
        "type": "eoa"
      },
      ...
    },
    "flows": [ ... ],
    "label": "Poloniex Hacker 4",
  },
  "fund_flow_risk": { ... },
  "risk": { ... }
}

Endpoint: /tokensecurity/{address}

This endpoint provides Solana token risk.

• Method: GET