Cluster addresses into entities
Clustering groups addresses that are likely controlled together and attributes the group to an entity. The cluster endpoint returns the cluster id, the attributed entity and the heuristics behind it, so the attribution is auditable rather than a black box.
- A live API key with a positive credit balance
- An address and chain to resolve
1Call the cluster endpoint
Pass the chain and address. The cluster endpoint is C3-metered and returns the cluster the address belongs to plus its entity attribution.
curl https://api.1st-node.com/v1/intel/btc/bc1q..k7/cluster \ -H "Authorization: Bearer sk_live_..."
2Read the cluster and heuristics
The response carries a cluster id, size, the attributed entity with confidence and the heuristics (co-spend, change detection) that grouped the addresses.
> { "cluster_id": "clu_8831", "size": 4192,
> "entity": "Binance", "category": "exchange",
> "confidence": 0.9,
> "heuristics": ["co-spend", "change-detection"] }3Persist the mapping
Store the address-to-cluster-to-entity mapping with its heuristics and confidence. Keeping the heuristics makes the attribution reproducible and defensible in review.
Preguntas frecuentes
Is a cluster the same as an owner?
No. A cluster is a set of addresses likely controlled together, attributed to an entity with a confidence — a cluster-level attribution, not a named person.
Why return the heuristics?
So the attribution is auditable. Storing which heuristics grouped the cluster lets you reproduce and defend the conclusion later.
Sigue leyendo
Recarga, obtén tu clave y publica.
Autoservicio. Paga en cripto o con tarjeta. Medido por créditos: las primitivas pesadas cuestan más, las simples son baratas.
Obtener clave API