Similar Smart Contracts

Query a smart contract and get a list of similar smart contracts

beta

Supported Networks:

• Ethereum: chain_id: "0x1"

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

Query similar smart contracts

Body

blockchain_addressstring · hexOptionalExample: 0x8904E3E9eaB00F64458845d32Ea22b2279fda1f7

chain_idstring · hexOptionalExample: 0x1

pageintegerOptionalExample: 1

Responses

200

Successful operation

application/json

403

Forbidden

500

Internal Server Error

post

HTTPcURLJavaScriptPython

POST /api/v1/similar-addresses HTTP/1.1
Host: api.blockfence.io
Content-Type: application/json
Accept: */*
Content-Length: 93

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

{
  "addresses": [
    {
      "blockchain_address": "0x8904E3E9eaB00F64458845d32Ea22b2279fda1f7",
      "chain_id": "0x1",
      "similarity": 0.8
    }
  ],
  "page": 1,
  "page_count": 1
}

This API returns at max 50 results per call. Check the response for page and page_count to query the rest of the results.

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
page	int (optional)	Page number (for pagination purposes)

Usage Example

Request

curl https://api.blockfence.io/api/v1/similar-addresses -X POST -H "Content-Type: application/json" -H "x-api-key: <YOUR API KEY>" -d '
{
    "chain_id": "0x1",
    "blockchain_address": "0x40d2025ed2e89632d3a41d8541df9ed2ac0e2b1c"
    "page": 1
}
'

Response

{
   "addresses":[
      {
         "blockchain_address":"0x0Def8d8addE14c9eF7c2a986dF3eA4Bd65826767",
         "chain_id":"0x1",
         "similarity":0.16279069767441862
      },
      {
         "blockchain_address":"0x55296f69f40Ea6d20E478533C15A6B08B654E758",
         "chain_id":"0x1",
         "similarity":0.15942028985507245
      },
      {
         "blockchain_address":"0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
         "chain_id":"0x1",
         "similarity":1
      }
   ],
   "page":1,
   "page_count":1
}