订阅监控地址

POST

/api/v1/wallet/watch-address/subscribe

订阅一个外部地址，当该地址收到代币转入时推送 watch.deposit.confirmed Webhook。

与用户充值的区别:

用户充值地址由平台生成，到账后自动归集 + 计入租户余额

监控地址由租户指定，到账后仅推送通知，不归集不计余额

地址格式要求:

链	格式	示例
BNB/ETH/ARBITRUM	`0x` + 40 位 hex	`0xe835...C3b`
TRON	`T` 开头 Base58	`TK87L1q...QZA`
SOLANA	Base58, 32-44 位	`BAM8JBD...3T8`

Request

Header Params

Body Params application/jsonRequired

Examples

监控所有币种到账仅监控 USDT 到账推送到独立 URL

{
    "network": "BNB",
    "address": "0xe835233c318a422742aE675A9ebC0dCCf5887C3b",
    "label": "交易所热钱包"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

监控所有币种到账仅监控 USDT 到账推送到独立 URL

curl --location '/api/v1/wallet/watch-address/subscribe' \
--header 'tenant-id: 1' \
--header 'Content-Type: application/json' \
--data '{
    "network": "BNB",
    "address": "0xe835233c318a422742aE675A9ebC0dCCf5887C3b",
    "label": "交易所热钱包"
}'

Responses

🟢200OK

application/json

订阅成功

Bodyapplication/json

Example

{
    "code": 0,
    "msg": "success",
    "data": {
        "id": 1,
        "tenantId": 1,
        "network": "BNB",
        "address": "0xe835233c318a422742ae675a9ebc0dccf5887c3b",
        "currency": null,
        "label": "交易所热钱包",
        "webhookUrl": null,
        "status": "ENABLED",
        "createTime": "2026-04-01T12:00:00",
        "updateTime": "2026-04-01T12:00:00"
    },
    "ok": true
}

Modified at 2026-05-07 09:40:42

查询单笔提现

修改订阅