CryptoLabel

Etiquetas gratuitas de direcciones cripto. Identifica direcciones conocidas en redes principales con una API gratuita.

Documentación

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

Content type application/json

Auth None

Conecta CryptoLabel a un agente a través de MCP para buscar documentación de API y verificar direcciones con el endpoint en vivo cuando sea necesario.

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

La referencia interactiva de OpenAPI está disponible en https://cryptolabel.io/api/v1/openapi.
El esquema OpenAPI 3.1 sin procesar está disponible en https://cryptolabel.io/api/v1/openapi.json.

Resuelve una dirección, detecta su tipo y modelo, la asigna a una entidad de presentación y devuelve todas las etiquetas conocidas.

Parámetros de ruta

NombreTipoDescripción
chainstringIdentificador de blockchain. Los valores admitidos se enumeran a continuación.
addressstringDirección validada según la cadena seleccionada.

Ejemplo de solicitud

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

Si es posible, incluye un encabezado User-Agent significativo con el nombre de tu aplicación y un correo electrónico de contacto. Esto nos ayuda a contactarte sobre actualizaciones de la API, mantenimiento técnico o problemas específicos de solicitudes cuando sea necesario.

Respuesta exitosa

En caso de éxito, la API devuelve un objeto JSON con metadatos de consulta, detalles de dirección normalizados, información de entidad y cero o más etiquetas.

Esquema

CampoTipoDescripción
query.chainstringIdentificador de cadena normalizado.
query.readableChainstringNombre de cadena legible por humanos.
query.addressstringDirección solicitada original.
address.valuestringValor de dirección resuelto.
address.typestringValor de enumeración del tipo de dirección.
address.readableTypestringTipo de dirección legible por humanos.
address.modelstringValor de enumeración del modelo de dirección.
address.readableModelstringModelo de dirección legible por humanos.
address.explorerUrlstringEnlace del explorador para la dirección.
entity.namestringNombre de la entidad de presentación.
entity.categorystringValor de enumeración de la categoría de entidad.
entity.readableCategorystringCategoría de entidad legible por humanos.
labelsarray<object>Etiquetas resueltas para la dirección. Puede estar vacío.
labels[].typestringValor de enumeración del tipo de etiqueta.
labels[].readableTypestringTipo de etiqueta legible por humanos.
labels[].categorystringValor de enumeración de la categoría de etiqueta.
labels[].readableCategorystringCategoría de etiqueta legible por humanos.
labels[].sourceTypestringValor de enumeración de la fuente de etiqueta.
labels[].readableSourceTypestringFuente de etiqueta legible por humanos.
labels[].methodstringValor de enumeración del método de etiqueta.
labels[].readableMethodstringMétodo de etiqueta legible por humanos.
labels[].statusstringValor de enumeración del estado de etiqueta.
labels[].readableStatusstringEstado de etiqueta legible por humanos.

Ejemplo

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

Respuesta de error

Los errores de API orientados al cliente utilizan un formato público estable. Los tipos de excepción internos no se exponen.

Esquema

CampoTipoDescripción
codestringCódigo de error estable legible por máquina.
messagestringMensaje de error público seguro.
pathstringRuta de la solicitud.
timestampstring<ISO-8601>Marca de tiempo del error del lado del servidor.

Ejemplo

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

Enumeraciones

Cadena

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

Tipo de dirección

  • contract — Cuenta de contrato
  • eoa — Cuenta de propiedad externa
  • unknown — Desconocido

Categoría de entidad

  • bridge — Puente
  • custodian — Custodio
  • dao — DAO
  • defi_protocol — Protocolo DeFi
  • dex_aggregator — Agregador DEX
  • exchange — Exchange
  • gambling_service — Servicio de apuestas
  • government — Gobierno
  • individual_address — Dirección individual
  • illicit_activity — Actividad ilícita
  • marketplace — Marketplace
  • mining_pool — Pool de minería
  • mixer — Mezclador
  • payment_service — Servicio de pago
  • public_figure — Figura pública
  • service_provider — Proveedor de servicios
  • token_issuer — Emisor de tokens
  • wallet_provider — Proveedor de billeteras
  • unknown — Desconocido

Modelo de dirección

  • account_based — Modelo basado en cuentas
  • utxo — Modelo UTXO

Fuente de etiqueta

  • internal — Interna
  • manual_review — Revisión manual
  • partner — Socio
  • public — Pública

Método de etiqueta

  • aggregation — Agregación
  • heuristic — Heurístico
  • import — Importación
  • manual — Manual
  • onchain_analysis — Análisis en cadena

Estado de etiqueta

  • active — Activo
  • historical — Histórico
  • inactive — Inactivo

Tipo de etiqueta

  • bridge_address — Dirección de puente
  • burn_address — Dirección de quema
  • compliance_related — Relacionado con cumplimiento
  • cross_chain_activity — Actividad entre cadenas
  • custodial_wallet — Billetera de custodia
  • defi_pool — Pool DeFi
  • defi_treasury — Tesorería DeFi
  • deployer — Desplegador
  • dex_contract — Contrato DEX
  • darknet_market — Mercado de la darknet
  • exchange_cold_wallet — Billetera fría de exchange
  • exchange_deposit_wallet — Billetera de depósito de exchange
  • exchange_hot_wallet — Billetera caliente de exchange
  • exchange_withdrawal_wallet — Billetera de retiro de exchange
  • forwarder_contract — Contrato de reenvío
  • fraud_related — Relacionado con fraude
  • gambling_address — Dirección de apuestas
  • high_frequency — Alta frecuencia
  • high_volume — Alto volumen
  • institutional_flow — Flujo institucional
  • market_maker_related — Relacionado con market maker
  • marketplace_address — Dirección de marketplace
  • money_laundering — Lavado de dinero
  • mining_pool_payout — Pago de pool de minería
  • mixer_address — Dirección de mezclador
  • blackmail — Chantaje
  • payment_processor — Procesador de pagos
  • phishing — Phishing
  • proxy_contract — Contrato proxy
  • public_figure_related — Relacionado con figura pública
  • risky_service — Servicio de riesgo
  • sanctioned — Sancionado
  • scam — Estafa
  • service_wallet — Billetera de servicio
  • staking_wallet — Billetera de staking
  • stolen_funds — Fondos robados
  • terrorism_related — Relacionado con terrorismo
  • treasury_wallet — Billetera de tesorería
  • unknown — Desconocido
  • validator — Validador
  • wrapper_contract — Contrato envoltorio

Categoría de etiqueta

  • behavior — Comportamiento
  • bridge — Puente
  • cex — Exchange centralizado
  • compliance — Cumplimiento
  • crime — Delito
  • custody — Custodia
  • defi — DeFi
  • flow — Flujo
  • fraud — Fraude
  • gambling — Apuestas
  • identity — Identidad
  • infrastructure — Infraestructura
  • marketplace — Marketplace
  • mining — Minería
  • mixer — Mezclador
  • payment — Pago
  • risk — Riesgo
  • sanctions — Sanciones
  • service — Servicio
  • trading — Trading
  • treasury — Tesorería
  • unknown — Desconocido
  • wallet — Billetera