获取钱包支持的链
返回 Wallet 服务能够查询余额的区块链列表。支持链由服务端动态配置,可能随时变更。 传入 binanceChainId 仅返回该链信息;不传则返回全量列表。
获取钱包支持的链 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
获取钱包支持的链 › 响应
成功返回支持的链列表。
code业务状态码,0 表示成功。
msg支持的区块链网络列表。
binanceChainId链唯一标识。
name链全称。
shortName链简称。
logoUrl链 Logo 图片 URL。
timestampsuccess查询地址全部代币余额
返回地址在指定链上的全部代币余额,支持分页。 将 excludeRiskToken=true 可过滤空投风险币与蜜罐币(蜜罐检测当前仅支持 ETH / BSC / SOL / BASE)。
查询地址全部代币余额 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
查询参数
address待查询的钱包地址。
chains当前仅支持单个链。传入多个逗号分隔的链 ID 将返回错误,多链支持后续视情况提供。
excludeRiskToken是否排除风险代币。
page页码,默认 1。
pageSize每页条数,范围 1–100,默认 20。
查询地址全部代币余额 › 响应
成功返回代币余额。
codemsg每个查询链对应一条记录,包含该链上分页后的代币余额列表。
page当前页码。
pageSize每页条数。
该链上的代币余额列表。
timestampsuccess查询地址特定代币余额
查询指定 (链, 合约) 列表的代币余额,单次请求最多 20 条。 excludeRiskToken="0" 过滤风险代币(默认),"1" 不过滤。
查询地址特定代币余额 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
查询地址特定代币余额 › 请求体
address钱包地址。
要查询的代币列表,最多 20 条。
binanceChainId链唯一标识。
tokenContractAddress代币合约地址。原生币传空字符串 ""。
excludeRiskToken风险代币筛选。"0"=过滤(默认),"1"=不过滤。蜜罐检测当前仅支持 ETH / BSC / SOL / BASE。
查询地址特定代币余额 › 响应
成功返回代币余额。
codemsg每条对应请求中出现过的一个链,包含匹配到的代币余额。
该链上匹配到的代币余额列表。
binanceChainId链唯一标识。
tokenContractAddress代币合约地址。原生币为空字符串。
address钱包地址,回显请求值。
symbol代币简称(ticker)。
balance已按精度换算的代币数量。
rawBalance未换算精度的原始数量。部分链不支持时返回空字符串。
tokenPrice代币美元单价。
isRiskToken是否为风险代币。
timestampsuccess查询地址链上交易历史
返回钱包地址在指定链上的交易历史。仅返回最近 6 个月的记录,按时间倒序排列。 支持游标分页、时间范围筛选和代币合约筛选。
查询地址链上交易历史 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
查询参数
address待查询的钱包地址。
chains链 ID 列表,英文逗号分隔。
tokenContractAddress可选的代币合约地址筛选。
begin起始时间戳(Unix 毫秒,包含)。
end截止时间戳(Unix 毫秒,包含)。
cursor上次响应返回的分页游标。
limit每页返回数量,范围 1–100,默认 20。
查询地址链上交易历史 › 响应
成功返回交易历史。
codemsg每条对应一个链。每条包含该链的交易列表与独立分页游标。
cursor该链下一页游标。无更多数据时为空字符串。
交易历史列表,按时间倒序排列。
binanceChainId链唯一标识。
txHash交易 Hash。
itype交易层级类型。"0"=外层原生币转账,"1"=内部合约原生币转账,"2"=Token 转账。
methodId合约调用函数方法 ID。原生币转账时为 null。
nonce发送方地址的 nonce。
txTime交易时间(Unix 毫秒,字符串形式)。
交易输入(发送方地址与金额)。
address发送方地址;多签交易以英文逗号分隔。
amount输入金额(最小单位,十进制字符串)。
交易输出(接收方地址与金额)。
address接收方地址;多签交易以英文逗号分隔。
amount输出金额。
tokenContractAddressToken 合约地址。原生币转账时为 null。
amount交易金额(最小单位)。
symbol交易金额对应的币种符号。
txFee交易手续费(原生代币数量,十进制字符串)。
txStatus交易状态。
hitBlacklist是否命中黑名单。
timestampsuccess根据 Hash 查询交易详情
根据 binanceChainId 与 txHash 查询链上交易详情,返回交易的输入、输出、内部调用与代币转账明细。
根据 Hash 查询交易详情 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间,ISO 8601 格式,精确到毫秒,例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名(Base64 编码)。
X-OC-RECV-WINDOW允许的时间偏差(毫秒),默认值 5000,最大值 60000。
X-OC-NONCE唯一请求标识符,用于防重放攻击;省略时使用 X-OC-SIGN 代替。
查询参数
binanceChainId链唯一标识。
txHash链上交易 Hash。
itype交易类型筛选(部分 UTXO 链)。保留参数,当前暂不生效。取值:"0"=外层原生币,"1"=内部合约原生币,"2"=Token 转账。
根据 Hash 查询交易详情 › 响应
成功返回交易详情。
codemsg交易详情列表。未找到时为空列表。
chainIndex链唯一标识。
height交易所在的区块高度。
txTime交易时间(Unix 毫秒,字符串形式)。
txhash交易 Hash。
txStatus交易状态,取值为 "success"、"fail"、"pending" 之一。
gasLimitGas 上限(十进制字符串)。
gasUsed已消耗 Gas。
gasPriceGas 价格(wei,十进制字符串)。
txFee交易手续费。
nonceNonce。
amount交易金额。
symbol交易金额对应的币种符号。
methodId合约调用函数方法 ID。原生币转账时为 null。
l1OriginHashL1 执行交易哈希(Rollup / L2 场景)。其他情况下为 null。
交易输入详情。
address发送方 / 输入地址。
vinIndex当前交易输入索引(UTXO 链)。
preVoutIndex关联的前一笔输出索引(UTXO 链)。
txHash前一笔交易哈希(UTXO 链与 preVoutIndex 共同定位输入 UTXO)。
isContract发送方地址是否为合约地址。
amount交易金额。
交易输出详情。
address接收方 / 输出地址。
voutIndex输出索引(UTXO 链)。
isContract接收方地址是否为合约地址。
amount交易金额。
内部交易详情。
from发送方地址。
to接收方地址。
isFromContract发送方是否为合约地址。
isToContract接收方是否为合约地址。
amount交易金额。
txStatus内部调用状态。
Token 转账详情。
from发送方地址。
to接收方地址。
isFromContract发送方是否为合约地址。
isToContract接收方是否为合约地址。
tokenContractAddressToken 合约地址。
symbolToken 符号。
amount转账金额(最小单位,十进制字符串)。
timestampsuccess