Contract Intelligence

Get Contract On-Chain Profile

Public API: Returns a full on-chain profile for any contract or wallet address.

Powered by Alchemy's enhanced APIs, this endpoint provides:

  • Token Balances: All ERC-20 tokens held by the address via alchemy_getTokenBalances
  • Contract Metadata: Bytecode size, ETH balance, account nonce
  • Auto-Classification: Heuristic-based classification (treasury, MEV bot, router, factory, etc.)

Note on nonce: it is an activity count only for an EOA. A contract's nonce starts at 1 and increments only on CREATE, so for a contract it reports contracts deployed (nonce - 1), not transactions sent. That derived count is served directly as contracts_deployed (null for an EOA, where it cannot be read off the nonce). The legacy transaction_count field carries the same value as nonce and is deprecated.

This is useful for identifying unknown proxy contracts in DEX attribution data.

get/api/v1/contract/{address}/profile

Request

  • Base URL: https://cleartracedata.com (the document declares no server; this is the origin it was published from)
  • URL: https://cleartracedata.com/api/v1/contract/{address}/profile
  • Auth: none declared

Path parameters

addressstring required

Query parameters

chain'ethereum' | 'base' | 'arbitrum' | 'optimism'

Blockchain network to query.

Response

A comprehensive on-chain profile including token balances, code size, ETH balance, and automated classification.

Example response

{
  "profile": {
    "chain": "ethereum",
    "is_contract": true,
    "code_size_bytes": 4096,
    "eth_balance": 1.25,
    "nonce": 42,
    "contracts_deployed": 1612,
    "transaction_count": 42,
    "token_balances": [
      {
        "contract": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "symbol": "USDC",
        "name": "USD Coin",
        "balance": 1542.5
      }
    ],
    "classification_hint": "treasury"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.