商户
获取加密货币充值地址
获取商户钱包在特定代币和区块链网络上的链上充值地址，包括确认数要求。
GET
/
v2
/
assets
/
depositAddress
获取加密货币充值地址
curl --request GET \
--url https://api-test.velafi.com/v2/assets/depositAddress \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/depositAddress"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/assets/depositAddress', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/assets/depositAddress")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"allowDeposit": true,
"address": "<string>",
"addressExt": "<string>",
"minQuantity": "<string>",
"needAddressTag": true,
"requiredConfirmNum": 123,
"canWithdrawConfirmNum": 123,
"tokenType": "<string>"
}
}使用此端点获取特定加密货币和网络的链上充值地址。您必须从下方支持的组合中同时提供
tokenId 和 chainType。响应包括充值地址、所需的地址标签（例如 XRP 或 EOS）、最低充值金额以及确认数要求。
所有请求都必须在
X-BH-TOKEN 请求头中携带通过 GET /v2/token/generate 获取的业务令牌。端点
GET https://api.velafi.com/v2/assets/depositAddress
查询参数
string
必填
要充值的代币符号。支持的值：
USDT、USDC、BTC、COPM、BRL1、MXNB、MMXN。string
必填
区块链网络标识符。必须是所选
tokenId 的有效组合。请参阅下方支持的组合表。integer
必填
要获取充值地址的商户 ID。
支持的代币 / 网络组合
| tokenId | chainType | 网络 |
|---|---|---|
USDT | TRC20 | Tron |
USDT | ERC20 | Ethereum |
USDT | BEP20 | BNB Smart Chain |
USDT | POL | Polygon |
USDT | SPL20 | Solana Mainnet |
USDC | ERC20 | Ethereum |
USDC | POL | Polygon |
USDC | SPL20 | Solana Mainnet |
BTC | BTC | Bitcoin |
COPM | POL | Polygon (POS) |
BRL1 | POL | Polygon (POS) |
MXNB | Arbitrum | Arbitrum Network |
MMXN | ERC20 | Ethereum (ERC20) |
MMXN | TRC20 | TRON (TRC20) |
响应字段
number
HTTP 风格的响应码。
200 表示成功。string
可读的状态信息，例如
SUCCESS。object
示例
cURL
curl -G https://api.velafi.com/v2/assets/depositAddress \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "tokenId=USDT" \
--data-urlencode "chainType=TRC20" \
--data-urlencode "merchantId=12345"
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"allowDeposit": true,
"address": "TT5PSvrhxXjw2NZNu1S8L5ybwYVxCkQRKC",
"addressExt": "",
"minQuantity": "5",
"needAddressTag": false,
"requiredConfirmNum": 12,
"canWithdrawConfirmNum": 20,
"tokenType": "TRX_TOKEN"
}
}
在向用户展示地址之前，请务必检查
allowDeposit。如果 allowDeposit 为 false，发送到该地址的资金可能无法入账。如果该标志意外地持续为 false，请联系 VelaFi 支持团队。⌘I
获取加密货币充值地址
curl --request GET \
--url https://api-test.velafi.com/v2/assets/depositAddress \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/depositAddress"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/assets/depositAddress', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/assets/depositAddress")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"allowDeposit": true,
"address": "<string>",
"addressExt": "<string>",
"minQuantity": "<string>",
"needAddressTag": true,
"requiredConfirmNum": 123,
"canWithdrawConfirmNum": 123,
"tokenType": "<string>"
}
}