CryptoLabel

Documentation

CryptoLabel API Docs

Reference for the current public API, including request shape, response fields, errors, and enum values.

Base URLhttps://cryptolabel.io/api/v1

Content typeapplication/json

AuthNone

Connect CryptoLabel to an agent through MCP to search API documentation and check addresses with the live endpoint when needed.

Claude Code Cursor Codex VS Code Windsurf OpenAI API

Settings -> Connectors -> Add custom connector
Name: CryptoLabel
URL: https://cryptolabel.io/api/mcp

The interactive OpenAPI reference is available athttps://cryptolabel.io/api/v1/openapi.
The raw OpenAPI 3.1 schema is available athttps://cryptolabel.io/api/v1/openapi.json.

Resolves an address, detects its type and model, maps it to a presentation entity, and returns all known labels.

Path Parameters

Name	Type	Description
chain	string	Blockchain identifier. Supported values are listed below.
address	string	Address validated against the selected chain.

Example Request

curl --request GET \
  --url https://cryptolabel.io/api/v1/address/ethereum/0x22af984f13DFB5C80145E3F9eE1050Ae5a5FB651 \
  --header 'Accept: application/json' \
  --header 'User-Agent: YourAppName/1.0 (contact@example.com)'

User-Agent

If possible, please include a meaningfulUser-Agent header with your application name and a contact email. This helps us reach you about API updates, technical maintenance, or request-specific issues when needed.

Success Response

On success the API returns a JSON object with query metadata, normalized address details, entity information, and zero or more labels.

Schema

Field	Type	Description
query.chain	string	Normalized chain identifier.
query.readableChain	string	Human-readable chain name.
query.address	string	Original requested address.
address.value	string	Resolved address value.
address.type	string	Address type enum value.
address.readableType	string	Human-readable address type.
address.model	string	Address model enum value.
address.readableModel	string	Human-readable address model.
address.explorerUrl	string	Explorer link for the address.
entity.name	string	Presentation entity name.
entity.category	string	Entity category enum value.
entity.readableCategory	string	Human-readable entity category.
labels	array	Resolved labels for the address. Can be empty.
labels[].type	string	Label type enum value.
labels[].readableType	string	Human-readable label type.
labels[].category	string	Label category enum value.
labels[].readableCategory	string	Human-readable label category.
labels[].sourceType	string	Label source enum value.
labels[].readableSourceType	string	Human-readable label source.
labels[].method	string	Label method enum value.
labels[].readableMethod	string	Human-readable label method.
labels[].status	string	Label status enum value.
labels[].readableStatus	string	Human-readable label status.

Example

{
  "query": {
    "chain": "ethereum",
    "readableChain": "Ethereum",
    "address": "0x22af984f13DFB5C80145E3F9eE1050Ae5a5FB651"
  },
  "address": {
    "value": "0x22af984f13DFB5C80145E3F9eE1050Ae5a5FB651",
    "type": "eoa",
    "readableType": "Externally Owned Account",
    "model": "account_based",
    "readableModel": "Account-based model",
    "explorerUrl": "https://www.blockchain.com/explorer/addresses/eth/0x22af984f13DFB5C80145E3F9eE1050Ae5a5FB651"
  },
  "entity": {
    "name": "Kraken",
    "category": "exchange",
    "readableCategory": "Exchange"
  },
  "labels": [
    {
      "type": "exchange_cold_wallet",
      "readableType": "Exchange Cold Wallet",
      "category": "cex",
      "readableCategory": "Centralized Exchange",
      "sourceType": "public",
      "readableSourceType": "Public",
      "method": "aggregation",
      "readableMethod": "Aggregation",
      "status": "active",
      "readableStatus": "Active"
    }
  ]
}

Error Response

Client-facing API errors use a stable public format. Internal exception types are not exposed.

Schema

Field	Type	Description
code	string	Stable machine-readable error code.
message	string	Safe public error message.
path	string	Request path.
timestamp	string	Server-side error timestamp.

Example

{
  "code": "bad_request",
  "message": "Invalid address for chain: ethereum",
  "path": "/api/v1/address/ethereum/0x123",
  "timestamp": "2026-03-23T12:34:56.789Z"
}

Enums

Chain

• bitcoin — Bitcoin
• ethereum — Ethereum
• tron — Tron

Address Type

• contract — Contract Account
• eoa — Externally Owned Account
• unknown — Unknown

Entity Category

• bridge — Bridge
• custodian — Custodian
• dao — DAO
• defi_protocol — DeFi Protocol
• dex_aggregator — DEX Aggregator
• exchange — Exchange
• gambling_service — Gambling Service
• government — Government
• individual_address — Individual Address
• illicit_activity — Illicit Activity
• marketplace — Marketplace
• mining_pool — Mining Pool
• mixer — Mixer
• payment_service — Payment Service
• public_figure — Public Figure
• service_provider — Service Provider
• token_issuer — Token Issuer
• wallet_provider — Wallet Provider
• unknown — Unknown

Address Model

• account_based — Account-based model
• utxo — UTXO model

Label Source

• internal — Internal
• manual_review — Manual Review
• partner — Partner
• public — Public

Label Method

• aggregation — Aggregation
• heuristic — Heuristic
• import — Import
• manual — Manual
• onchain_analysis — On-chain Analysis

Label Status

• active — Active
• historical — Historical
• inactive — Inactive

Label Type

• bridge_address — Bridge Address
• burn_address — Burn Address
• compliance_related — Compliance Related
• cross_chain_activity — Cross-chain Activity
• custodial_wallet — Custodial Wallet
• defi_pool — DeFi Pool
• defi_treasury — DeFi Treasury
• deployer — Deployer
• dex_contract — DEX Contract
• darknet_market — Darknet Market
• exchange_cold_wallet — Exchange Cold Wallet
• exchange_deposit_wallet — Exchange Deposit Wallet
• exchange_hot_wallet — Exchange Hot Wallet
• exchange_withdrawal_wallet — Exchange Withdrawal Wallet
• forwarder_contract — Forwarder Contract
• fraud_related — Fraud Related
• gambling_address — Gambling Address
• high_frequency — High Frequency
• high_volume — High Volume
• institutional_flow — Institutional Flow
• market_maker_related — Market Maker Related
• marketplace_address — Marketplace Address
• money_laundering — Money Laundering
• mining_pool_payout — Mining Pool Payout
• mixer_address — Mixer Address
• blackmail — Blackmail
• payment_processor — Payment Processor
• phishing — Phishing
• proxy_contract — Proxy Contract
• public_figure_related — Public Figure Related
• risky_service — Risky Service
• sanctioned — Sanctioned
• scam — Scam
• service_wallet — Service Wallet
• staking_wallet — Staking Wallet
• stolen_funds — Stolen Funds
• terrorism_related — Terrorism Related
• treasury_wallet — Treasury Wallet
• unknown — Unknown
• validator — Validator
• wrapper_contract — Wrapper Contract

Label Category

• behavior — Behavior
• bridge — Bridge
• cex — Centralized Exchange
• compliance — Compliance
• crime — Crime
• custody — Custody
• defi — DeFi
• flow — Flow
• fraud — Fraud
• gambling — Gambling
• identity — Identity
• infrastructure — Infrastructure
• marketplace — Marketplace
• mining — Mining
• mixer — Mixer
• payment — Payment
• risk — Risk
• sanctions — Sanctions
• service — Service
• trading — Trading
• treasury — Treasury
• unknown — Unknown
• wallet — Wallet