Complex Template · Related Wallets at Scale
用例 2: 大规模识别关联钱包
从一个地址出发，结合交易历史和风险标签，批量找出可能相关的钱包，并给出为什么相关。
Use this template when
- 手上有一个种子地址，想顺藤摸瓜找相关钱包
- 搭一套风控或调查工作流
- 尽调报告里需要补一点链上证据
适用用户: 链上研究、合规风控、调查分析
输出预览静态样例，非实时
Seed 0x1234…abcd
0xaa…11 · 0.92
0xbb…22 · 0.81
0xcc…33 · 0.74
3 candidates · shared funder + gas payer · window 30d
API / MCP 调用
同一个模板同时支持 REST、Python 与 MCP Prompt。选择你熟悉的入口。
import requests
BASE = "https://api.gatedata.ai/api/v1"
H = {"Authorization": "Bearer gd_live_…"}
addr = "0x1234abcd0000000000000000000000000000abcd"
profile = requests.get(f"{BASE}/wallets/{addr}", headers=H, timeout=15).json()
txs = requests.get(f"{BASE}/wallets/transactions",
params={"address": addr, "limit": 100}, headers=H, timeout=15).json()
risk = requests.get(f"{BASE}/risk/address",
params={"chain": "ethereum", "address": addr}, headers=H, timeout=15).json()
# Template layer: cluster by shared funder / gas payer / frequent counterparties
# candidates = cluster_related_wallets(profile, txs, risk, min_confidence=0.6)
print(profile, txs, risk)输入参数
修改下方参数，上方代码示例和请求 URL 会同步更新。Live 模板的默认值即可一键跑通。
GET/api/v1/wallets/0x1234abcd0000000000000000000000000000abcd · /api/v1/wallets/transactions · /api/v1/risk/address
输出与解读
静态样例响应静态样例，非实时
{
"seed_address": "0x1234abcd...",
"counterparties": [
{ "address": "0xaa11...", "tx_count": 42, "value_usd": 812311.5 }
],
"relationship_candidates": [
{
"address": "0xaa11...",
"confidence": 0.92,
"evidence": ["shared_funder:0xffff...", "gas_paid_by:0xffff..."]
}
],
"risk_tags": ["cex_deposit:binance", "high_activity"],
"metadata": {
"data_status": "ready",
"object_refs": [
{
"type": "asset",
"id": "asset_eth",
"asset_id": "asset_eth",
"entity_id": "entity_ethereum",
"resolved_from": "query",
"resolution_confidence": "default"
}
]
}
}字段说明
seed_addressstring输入的种子地址counterparties[]array高频交易对手方，含交互次数与金额relationship_candidates[]array候选关联地址，含 confidence 与 evidencerisk_tags[]array交易所 / DEX / mixer / 巨鲸等标签evidence[]array为什么被判为关联，例如共同资金源、gas 支付方metadata.object_refs[]object[]统一对象引用数组object_refs[].typestring对象引用类型object_refs[].idstring对象标识，标识 type 指定的具体对象object_refs[].asset_idstring资产标识，标识股票、加密资产等资产对象object_refs[].resolved_fromstring对象解析所用输入来源object_refs[].resolution_confidencestring对象解析置信度
如何解读结果
- 置信度到 0.8 以上通常比较可信，可以进入人工复核
- evidence 是空的，当作弱信号看，别直接下结论
- 标签里出现混币器或跨链桥，记得提示结果可能不完整
边界与下一步
Do NOT use for
- 不做资金归属的法律定性
- 遇到混币器或跨链桥时，原始来源不一定能追到
常见边界与状态
- 候选关联地址是模板层算出来的，不是接口直接返回
- 大范围扫描建议分批做，再用 webhook 增量更新