Bitcoin co-spend clustering API

Apply the common-input-ownership heuristic over a BTC address's recent transactions (mempool.space, keyless) to surface other addresses likely controlled by the same entity — the clustering signal, not single-address stats. Answers 'what other addresses belong to this wallet', 'co-spend cluster for this BTC address', 'common-input-ownership for this address', 'find sibling addresses'.

Price$0.01per request

MethodPOST

Route/v1/osint/bitcoin-cluster

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

osintbitcoinclusterco-spendblockchainwalletheuristicbtc

API URLhttps://x402.hexl.dev/v1/osint/bitcoin-cluster

Integration docs

Example request

{
  "address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq"
}

Example response

{
  "address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
  "analyzedTxCount": 25,
  "cospendTxCount": 6,
  "clusterSize": 3,
  "clusteredAddresses": [
    {
      "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "cospendTxCount": 4
    },
    {
      "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
      "cospendTxCount": 2
    }
  ],
  "heuristic": "common-input-ownership",
  "confidence": "heuristic",
  "note": "Co-spend heuristic only; CoinJoin/PayJoin transactions can produce false positives."
}

Input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "minLength": 1,
      "examples": [
        "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}