Address Enrichment

Provides metadata on a given blockchain address

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

Provides metadata on a given blockchain address

Body

blockchain_addressstring · hexOptionalExample: 0xEfF92A263d31888d860bD50809A8D171709b7b1c

chain_idstring · hexOptionalExample: 0x1

Responses

200

Successful operation

application/json

403

Forbidden

500

Internal Server Error

post

HTTPcURLJavaScriptPython

POST /api/v2/enrich_address HTTP/1.1
Host: api.blockfence.io
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "blockchain_address": "0xEfF92A263d31888d860bD50809A8D171709b7b1c",
  "chain_id": "0x1"
}

{
  "enrichments": [
    {
      "provider_name": "DappRadar",
      "name": "PancakeSwap V2",
      "type": "DAPP",
      "logo": "https://dashboard-assets.dappradar.com/geRRcWz9IdTwSrm1/document/4600/pancakeswap-dapp-defi-bsc-logo_97d09bb01774bc41263cb848bedbe994.png",
      "description": "The #1 AMM and yield farm on Binance Smart Chain",
      "long_description": "<p>PancakeSwap is an automated market maker (“AMM”) that allows two tokens to be exchanged on the Binance Smart Chain...</p>",
      "metrics": [
        {
          "name": "UAW",
          "amount": 713630,
          "tooltip": "The number of unique active wallets (UAW) interacting or performing a transaction with a dapp's smart contracts"
        }
      ]
    }
  ]
}

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

Usage Example

Request

curl https://api.blockfence.io/api/v2/enrich_address -X POST -H "Content-Type: application/json" -H "x-api-key: <YOUR API KEY>" -d '
{
    "chain_id": "0x1",
    "blockchain_address": "0xEfF92A263d31888d860bD50809A8D171709b7b1c"
}
'

Response

{
    "enrichments": [
        {
            "provider_name": "DappRadar",
            "name": "PancakeSwap V2",
            "type": "DAPP",
            "logo": "https://dashboard-assets.dappradar.com/geRRcWz9IdTwSrm1/document/4600/pancakeswap-dapp-defi-bsc-logo_97d09bb01774bc41263cb848bedbe994.png",
            "description": "The #1 AMM and yield farm on Binance Smart Chain",
            "long_description": "<p>PancakeSwap is an automated market maker (“AMM”) that allows two tokens to be exchanged on the Binance Smart Chain. It is fast, cheap, and allows anyone to participate.</p>\n<p><strong>The Dream?</strong></p>\n<p>Stacks of pancakes, syrup, whipped cream.</p>\n<p>Then after breakfast, PancakeSwap is aiming to be the #1 liquidity provider on Binance Smart Chain and the home of new, innovative gamified farming mechanics, many of which we suspect will make it to other chains and beyond.</p>",
            "metrics": [
                {
                    "name": "UAW",
                    "amount": 713630,
                    "tooltip": "The number of unique active wallets (UAW) interacting or performing a transaction with a dapp's smart contracts"
                },
                {
                    "name": "Transactions",
                    "amount": 3945556,
                    "tooltip": "The total number of transactions made between unique active wallets (UAW) and the dapp's smart contracts"
                },
                {
                    "name": "Volume",
                    "amount": 2778383605.33,
                    "tooltip": "The fiat value of incoming dapp transactions over a period of time"
                },
                {
                    "name": "Balance",
                    "amount": 47249215.13,
                    "tooltip": "The total fiat value of assets in a dapp's smart contracts"
                }
            ]
        }
    ]
}