Validate Address

This method runs a background check on any Ethereum address, returning a human-readable analysis.

validateAddress

POST https://api.harpie.io/v2/validateAddress

Get insights on the safety of an address. Addresses with no relevant data default to a recommended action of "ALLOW."

Request Body

Name	Type	Description
address*	String	The address you want to query.
apiKey*	String	Your API key. You can find this in your dashboard.

200: OK A summary on address security

{
    name: string, // The name of the address. 
    // Returns contract name if the address is associated with protocol
    isMaliciousAddress: boolean,
    isAssociatedWithProtocol: boolean,
    tags: {
      THEFT: boolean,
      CYBERCRIME: boolean,
      SANCTIONED: boolean,
      MIXER: boolean,
      BOT: boolean,
      WASH_TRADER: boolean,
      NO_DATA: boolean,
    },
    summary: string,
}

Testing

You can test this query on a visual interface at https://harpie.io/scanner.

Example query:

fetch("https://api.harpie.io/v2/validateAddress", {
    method: "POST",
    headers: {
        'Accept': 'application/json',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        apiKey: "{YOUR API KEY HERE}",
        address: "0x55456cbd1f11298b80a53c896f4b1dc9bc16c731"
    })
})

Example response:

{
  "summary": "This is a known malicious address. We recommend blocking any transactions sent there.",
  "name": "Malicious Address",
  "isMaliciousAddress": true,
  "isAssociatedWithProtocol": false,
  "tags": {
    "THEFT": true,
    "CYBERCRIME": false,
    "NO_DATA": false,
    "SANCTIONED": false,
    "MIXER": false,
    "BOT": false,
    "WASH_TRADER": false
  }
}