转账监听
订阅钱包地址后,服务解析多链转账并落库。用 HTTP 管名单、查历史;用 WebSocket 或 Webhook 收实时命中。
需要 X-API-Key。公网 WebSocket 路径是 /tx/ws,不是 /tx/api/v1/transaction/ws。
能做什么
| 能力 | 入口 |
|---|---|
| 增删监听地址 | POST /tx/api/v1/addresses |
| 排除推送地址 | POST /tx/api/v1/addresses/exclusions |
| 历史转账 | POST /tx/api/v1/transfers/search |
| 实时推送 | wss://gateway.gelabs.org/tx/ws |
| 出站 Webhook | PUT /tx/api/v1/app/config |
已支持网络
用 chain_type(链族)+ chain_id 标识具体网络。chain_type 为 evm / svm / tvm / utxo,大小写不敏感:
| 网络 | 链族 | chain_id |
|---|---|---|
| Ethereum | evm | 1 |
| Sepolia | evm | 11155111 |
| BSC | evm | 56 |
| Polygon | evm | 137 |
| Arbitrum | evm | 42161 |
| Optimism | evm | 10 |
| Base | evm | 8453 |
| Solana Mainnet | svm | 1 |
| Tron Mainnet | tvm | 728126428 |
| Bitcoin Mainnet | utxo | 1 |
WebSocket 帧是 {id,time,type,code,data,message}。Webhook 是 POST 裸数组,请求头 Sign。结构见 接口。
下一步:快速上手。