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
| Nombre | Tipo | Descripción |
|---|---|---|
chain | string | Identificador de blockchain. Los valores admitidos se enumeran a continuación. |
address | string | Direcció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
| Campo | Tipo | Descripción |
|---|---|---|
query.chain | string | Identificador de cadena normalizado. |
query.readableChain | string | Nombre de cadena legible por humanos. |
query.address | string | Dirección solicitada original. |
address.value | string | Valor de dirección resuelto. |
address.type | string | Valor de enumeración del tipo de dirección. |
address.readableType | string | Tipo de dirección legible por humanos. |
address.model | string | Valor de enumeración del modelo de dirección. |
address.readableModel | string | Modelo de dirección legible por humanos. |
address.explorerUrl | string | Enlace del explorador para la dirección. |
entity.name | string | Nombre de la entidad de presentación. |
entity.category | string | Valor de enumeración de la categoría de entidad. |
entity.readableCategory | string | Categoría de entidad legible por humanos. |
labels | array<object> | Etiquetas resueltas para la dirección. Puede estar vacío. |
labels[].type | string | Valor de enumeración del tipo de etiqueta. |
labels[].readableType | string | Tipo de etiqueta legible por humanos. |
labels[].category | string | Valor de enumeración de la categoría de etiqueta. |
labels[].readableCategory | string | Categoría de etiqueta legible por humanos. |
labels[].sourceType | string | Valor de enumeración de la fuente de etiqueta. |
labels[].readableSourceType | string | Fuente de etiqueta legible por humanos. |
labels[].method | string | Valor de enumeración del método de etiqueta. |
labels[].readableMethod | string | Método de etiqueta legible por humanos. |
labels[].status | string | Valor de enumeración del estado de etiqueta. |
labels[].readableStatus | string | Estado 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
| Campo | Tipo | Descripción |
|---|---|---|
code | string | Código de error estable legible por máquina. |
message | string | Mensaje de error público seguro. |
path | string | Ruta de la solicitud. |
timestamp | string<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— Bitcoinethereum— Ethereumtron— Tron
Tipo de dirección
contract— Cuenta de contratoeoa— Cuenta de propiedad externaunknown— Desconocido
Categoría de entidad
bridge— Puentecustodian— Custodiodao— DAOdefi_protocol— Protocolo DeFidex_aggregator— Agregador DEXexchange— Exchangegambling_service— Servicio de apuestasgovernment— Gobiernoindividual_address— Dirección individualillicit_activity— Actividad ilícitamarketplace— Marketplacemining_pool— Pool de mineríamixer— Mezcladorpayment_service— Servicio de pagopublic_figure— Figura públicaservice_provider— Proveedor de serviciostoken_issuer— Emisor de tokenswallet_provider— Proveedor de billeterasunknown— Desconocido
Modelo de dirección
account_based— Modelo basado en cuentasutxo— Modelo UTXO
Fuente de etiqueta
internal— Internamanual_review— Revisión manualpartner— Sociopublic— Pública
Método de etiqueta
aggregation— Agregaciónheuristic— Heurísticoimport— Importaciónmanual— Manualonchain_analysis— Análisis en cadena
Estado de etiqueta
active— Activohistorical— Históricoinactive— Inactivo
Tipo de etiqueta
bridge_address— Dirección de puenteburn_address— Dirección de quemacompliance_related— Relacionado con cumplimientocross_chain_activity— Actividad entre cadenascustodial_wallet— Billetera de custodiadefi_pool— Pool DeFidefi_treasury— Tesorería DeFideployer— Desplegadordex_contract— Contrato DEXdarknet_market— Mercado de la darknetexchange_cold_wallet— Billetera fría de exchangeexchange_deposit_wallet— Billetera de depósito de exchangeexchange_hot_wallet— Billetera caliente de exchangeexchange_withdrawal_wallet— Billetera de retiro de exchangeforwarder_contract— Contrato de reenvíofraud_related— Relacionado con fraudegambling_address— Dirección de apuestashigh_frequency— Alta frecuenciahigh_volume— Alto volumeninstitutional_flow— Flujo institucionalmarket_maker_related— Relacionado con market makermarketplace_address— Dirección de marketplacemoney_laundering— Lavado de dineromining_pool_payout— Pago de pool de mineríamixer_address— Dirección de mezcladorblackmail— Chantajepayment_processor— Procesador de pagosphishing— Phishingproxy_contract— Contrato proxypublic_figure_related— Relacionado con figura públicarisky_service— Servicio de riesgosanctioned— Sancionadoscam— Estafaservice_wallet— Billetera de serviciostaking_wallet— Billetera de stakingstolen_funds— Fondos robadosterrorism_related— Relacionado con terrorismotreasury_wallet— Billetera de tesoreríaunknown— Desconocidovalidator— Validadorwrapper_contract— Contrato envoltorio
Categoría de etiqueta
behavior— Comportamientobridge— Puentecex— Exchange centralizadocompliance— Cumplimientocrime— Delitocustody— Custodiadefi— DeFiflow— Flujofraud— Fraudegambling— Apuestasidentity— Identidadinfrastructure— Infraestructuramarketplace— Marketplacemining— Mineríamixer— Mezcladorpayment— Pagorisk— Riesgosanctions— Sancionesservice— Serviciotrading— Tradingtreasury— Tesoreríaunknown— Desconocidowallet— Billetera