CryptoLabel

Etiquetas gratuitas de endereços de criptomoedas. Identifique endereços conhecidos nas principais redes com uma API gratuita.

Ver em cryptolabel.ioExperimente este MCPPatrocinado

Documentação

URL base https://cryptolabel.io/api/v1

Tipo de conteúdo application/json

Autenticação None

Conecte o CryptoLabel a um agente por meio do MCP para pesquisar a documentação da API e verificar endereços com o endpoint ativo quando necessário.

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

A referência interativa do OpenAPI está disponível em https://cryptolabel.io/api/v1/openapi.
O esquema OpenAPI 3.1 bruto está disponível em https://cryptolabel.io/api/v1/openapi.json.

Resolve um endereço, detecta seu tipo e modelo, mapeia-o para uma entidade de apresentação e retorna todos os rótulos conhecidos.

Parâmetros de Caminho

Nome	Tipo	Descrição
`chain`	string	Identificador da blockchain. Os valores suportados estão listados abaixo.
`address`	string	Endereço validado em relação à cadeia selecionada.

Exemplo de Requisição

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

Se possível, inclua um cabeçalho User-Agent significativo com o nome do seu aplicativo e um e-mail de contato. Isso nos ajuda a entrar em contato com você sobre atualizações da API, manutenção técnica ou problemas específicos de requisições quando necessário.

Resposta de Sucesso

Em caso de sucesso, a API retorna um objeto JSON com metadados da consulta, detalhes normalizados do endereço, informações da entidade e zero ou mais rótulos.

Esquema

Campo	Tipo	Descrição
`query.chain`	string	Identificador normalizado da cadeia.
`query.readableChain`	string	Nome legível da cadeia.
`query.address`	string	Endereço originalmente solicitado.
`address.value`	string	Valor do endereço resolvido.
`address.type`	string	Valor do enum de tipo de endereço.
`address.readableType`	string	Tipo de endereço legível.
`address.model`	string	Valor do enum de modelo de endereço.
`address.readableModel`	string	Modelo de endereço legível.
`address.explorerUrl`	string	Link do explorador para o endereço.
`entity.name`	string	Nome da entidade de apresentação.
`entity.category`	string	Valor do enum de categoria da entidade.
`entity.readableCategory`	string	Categoria da entidade legível.
`labels`	array<object>	Rótulos resolvidos para o endereço. Pode estar vazio.
`labels[].type`	string	Valor do enum de tipo de rótulo.
`labels[].readableType`	string	Tipo de rótulo legível.
`labels[].category`	string	Valor do enum de categoria de rótulo.
`labels[].readableCategory`	string	Categoria de rótulo legível.
`labels[].sourceType`	string	Valor do enum de origem do rótulo.
`labels[].readableSourceType`	string	Origem do rótulo legível.
`labels[].method`	string	Valor do enum de método do rótulo.
`labels[].readableMethod`	string	Método do rótulo legível.
`labels[].status`	string	Valor do enum de status do rótulo.
`labels[].readableStatus`	string	Status do rótulo legível.

Exemplo

{
  "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"
    }
  ]
}

Resposta de Erro

Erros de API voltados ao cliente usam um formato público estável. Tipos de exceção internos não são expostos.

Esquema

Campo	Tipo	Descrição
`code`	string	Código de erro estável legível por máquina.
`message`	string	Mensagem de erro pública segura.
`path`	string	Caminho da requisição.
`timestamp`	string<ISO-8601>	Carimbo de data/hora do erro no servidor.

Exemplo

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

Enums

Cadeia

bitcoin — Bitcoin
ethereum — Ethereum
tron — Tron

Tipo de Endereço

contract — Conta de Contrato
eoa — Conta de Propriedade Externa
unknown — Desconhecido

Categoria de Entidade

bridge — Ponte
custodian — Custodiante
dao — DAO
defi_protocol — Protocolo DeFi
dex_aggregator — Agregador DEX
exchange — Exchange
gambling_service — Serviço de Apostas
government — Governo
individual_address — Endereço Individual
illicit_activity — Atividade Ilícita
marketplace — Marketplace
mining_pool — Pool de Mineração
mixer — Mixer
payment_service — Serviço de Pagamento
public_figure — Figura Pública
service_provider — Provedor de Serviços
token_issuer — Emissor de Token
wallet_provider — Provedor de Carteira
unknown — Desconhecido

Modelo de Endereço

account_based — Modelo baseado em contas
utxo — Modelo UTXO

Origem do Rótulo

internal — Interna
manual_review — Revisão Manual
partner — Parceiro
public — Pública

Método do Rótulo

aggregation — Agregação
heuristic — Heurística
import — Importação
manual — Manual
onchain_analysis — Análise On-chain

Status do Rótulo

active — Ativo
historical — Histórico
inactive — Inativo

Tipo de Rótulo

bridge_address — Endereço de Ponte
burn_address — Endereço de Queima
compliance_related — Relacionado a Conformidade
cross_chain_activity — Atividade Cross-chain
custodial_wallet — Carteira de Custódia
defi_pool — Pool DeFi
defi_treasury — Tesouraria DeFi
deployer — Implantador
dex_contract — Contrato DEX
darknet_market — Mercado Darknet
exchange_cold_wallet — Carteira Fria de Exchange
exchange_deposit_wallet — Carteira de Depósito de Exchange
exchange_hot_wallet — Carteira Quente de Exchange
exchange_withdrawal_wallet — Carteira de Saque de Exchange
forwarder_contract — Contrato de Encaminhamento
fraud_related — Relacionado a Fraude
gambling_address — Endereço de Apostas
high_frequency — Alta Frequência
high_volume — Alto Volume
institutional_flow — Fluxo Institucional
market_maker_related — Relacionado a Market Maker
marketplace_address — Endereço de Marketplace
money_laundering — Lavagem de Dinheiro
mining_pool_payout — Pagamento de Pool de Mineração
mixer_address — Endereço de Mixer
blackmail — Chantagem
payment_processor — Processador de Pagamento
phishing — Phishing
proxy_contract — Contrato Proxy
public_figure_related — Relacionado a Figura Pública
risky_service — Serviço de Risco
sanctioned — Sancionado
scam — Golpe
service_wallet — Carteira de Serviço
staking_wallet — Carteira de Staking
stolen_funds — Fundos Roubados
terrorism_related — Relacionado a Terrorismo
treasury_wallet — Carteira de Tesouraria
unknown — Desconhecido
validator — Validador
wrapper_contract — Contrato Wrapper

Categoria de Rótulo

behavior — Comportamento
bridge — Ponte
cex — Exchange Centralizada
compliance — Conformidade
crime — Crime
custody — Custódia
defi — DeFi
flow — Fluxo
fraud — Fraude
gambling — Apostas
identity — Identidade
infrastructure — Infraestrutura
marketplace — Marketplace
mining — Mineração
mixer — Mixer
payment — Pagamento
risk — Risco
sanctions — Sanções
service — Serviço
trading — Negociação
treasury — Tesouraria
unknown — Desconhecido
wallet — Carteira