cURL
curl --request POST \
--url https://apidev.nusd.me/nps/bill/verify/txs \
--header 'BIZ-API-KEY: <api-key>' \
--header 'Biz-Api-Nonce: <api-key>' \
--header 'Biz-Api-Signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"wallet_id": "b2c13dba-7787-4db5-98e3-cff374dc04cd",
"txs": [
{
"request_id": "",
"transaction_id": "da55a74c-e666-428d-8227-38cd25e3414d",
"hash": "",
"chain_id": "TRON",
"token_id": "TRON_USDT",
"to": "TWgTvxMj9AFZhQF5xKjrua(XCAhym4E1qu",
"type": "Deposit",
"amount": 2000,
"fee": 20,
"amount_actual": 1980,
"status": "Completed",
"amount_delta": 0.01,
"time": 1761518815,
"time_type": "Created",
"time_delta": 10
},
{
"request_id": "",
"transaction_id": "164271c4-3004-4201-a2b7-21156379293c",
"hash": "",
"chain_id": "ETH",
"token_id": "ETH_USDT",
"to": "0xfdd30a21582210900bc1468b2dbc7d51b68502973",
"type": "Deposit",
"amount": 1000,
"fee": 10,
"amount_actual": 990,
"status": "Completed",
"amount_delta": 0.01,
"time": 1761649929,
"time_type": "Created",
"time_delta": 10
}
]
}
'import requests
url = "https://apidev.nusd.me/nps/bill/verify/txs"
payload = {
"wallet_id": "b2c13dba-7787-4db5-98e3-cff374dc04cd",
"txs": [
{
"request_id": "",
"transaction_id": "da55a74c-e666-428d-8227-38cd25e3414d",
"hash": "",
"chain_id": "TRON",
"token_id": "TRON_USDT",
"to": "TWgTvxMj9AFZhQF5xKjrua(XCAhym4E1qu",
"type": "Deposit",
"amount": 2000,
"fee": 20,
"amount_actual": 1980,
"status": "Completed",
"amount_delta": 0.01,
"time": 1761518815,
"time_type": "Created",
"time_delta": 10
},
{
"request_id": "",
"transaction_id": "164271c4-3004-4201-a2b7-21156379293c",
"hash": "",
"chain_id": "ETH",
"token_id": "ETH_USDT",
"to": "0xfdd30a21582210900bc1468b2dbc7d51b68502973",
"type": "Deposit",
"amount": 1000,
"fee": 10,
"amount_actual": 990,
"status": "Completed",
"amount_delta": 0.01,
"time": 1761649929,
"time_type": "Created",
"time_delta": 10
}
]
}
headers = {
"BIZ-API-KEY": "<api-key>",
"Biz-Api-Nonce": "<api-key>",
"Biz-Api-Signature": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'BIZ-API-KEY': '<api-key>',
'Biz-Api-Nonce': '<api-key>',
'Biz-Api-Signature': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
wallet_id: 'b2c13dba-7787-4db5-98e3-cff374dc04cd',
txs: [
{
request_id: '',
transaction_id: 'da55a74c-e666-428d-8227-38cd25e3414d',
hash: '',
chain_id: 'TRON',
token_id: 'TRON_USDT',
to: 'TWgTvxMj9AFZhQF5xKjrua(XCAhym4E1qu',
type: 'Deposit',
amount: 2000,
fee: 20,
amount_actual: 1980,
status: 'Completed',
amount_delta: 0.01,
time: 1761518815,
time_type: 'Created',
time_delta: 10
},
{
request_id: '',
transaction_id: '164271c4-3004-4201-a2b7-21156379293c',
hash: '',
chain_id: 'ETH',
token_id: 'ETH_USDT',
to: '0xfdd30a21582210900bc1468b2dbc7d51b68502973',
type: 'Deposit',
amount: 1000,
fee: 10,
amount_actual: 990,
status: 'Completed',
amount_delta: 0.01,
time: 1761649929,
time_type: 'Created',
time_delta: 10
}
]
})
};
fetch('https://apidev.nusd.me/nps/bill/verify/txs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://apidev.nusd.me/nps/bill/verify/txs"
payload := strings.NewReader("{\n \"wallet_id\": \"b2c13dba-7787-4db5-98e3-cff374dc04cd\",\n \"txs\": [\n {\n \"request_id\": \"\",\n \"transaction_id\": \"da55a74c-e666-428d-8227-38cd25e3414d\",\n \"hash\": \"\",\n \"chain_id\": \"TRON\",\n \"token_id\": \"TRON_USDT\",\n \"to\": \"TWgTvxMj9AFZhQF5xKjrua(XCAhym4E1qu\",\n \"type\": \"Deposit\",\n \"amount\": 2000,\n \"fee\": 20,\n \"amount_actual\": 1980,\n \"status\": \"Completed\",\n \"amount_delta\": 0.01,\n \"time\": 1761518815,\n \"time_type\": \"Created\",\n \"time_delta\": 10\n },\n {\n \"request_id\": \"\",\n \"transaction_id\": \"164271c4-3004-4201-a2b7-21156379293c\",\n \"hash\": \"\",\n \"chain_id\": \"ETH\",\n \"token_id\": \"ETH_USDT\",\n \"to\": \"0xfdd30a21582210900bc1468b2dbc7d51b68502973\",\n \"type\": \"Deposit\",\n \"amount\": 1000,\n \"fee\": 10,\n \"amount_actual\": 990,\n \"status\": \"Completed\",\n \"amount_delta\": 0.01,\n \"time\": 1761649929,\n \"time_type\": \"Created\",\n \"time_delta\": 10\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("BIZ-API-KEY", "<api-key>")
req.Header.Add("Biz-Api-Nonce", "<api-key>")
req.Header.Add("Biz-Api-Signature", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://apidev.nusd.me/nps/bill/verify/txs")
.header("BIZ-API-KEY", "<api-key>")
.header("Biz-Api-Nonce", "<api-key>")
.header("Biz-Api-Signature", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"wallet_id\": \"b2c13dba-7787-4db5-98e3-cff374dc04cd\",\n \"txs\": [\n {\n \"request_id\": \"\",\n \"transaction_id\": \"da55a74c-e666-428d-8227-38cd25e3414d\",\n \"hash\": \"\",\n \"chain_id\": \"TRON\",\n \"token_id\": \"TRON_USDT\",\n \"to\": \"TWgTvxMj9AFZhQF5xKjrua(XCAhym4E1qu\",\n \"type\": \"Deposit\",\n \"amount\": 2000,\n \"fee\": 20,\n \"amount_actual\": 1980,\n \"status\": \"Completed\",\n \"amount_delta\": 0.01,\n \"time\": 1761518815,\n \"time_type\": \"Created\",\n \"time_delta\": 10\n },\n {\n \"request_id\": \"\",\n \"transaction_id\": \"164271c4-3004-4201-a2b7-21156379293c\",\n \"hash\": \"\",\n \"chain_id\": \"ETH\",\n \"token_id\": \"ETH_USDT\",\n \"to\": \"0xfdd30a21582210900bc1468b2dbc7d51b68502973\",\n \"type\": \"Deposit\",\n \"amount\": 1000,\n \"fee\": 10,\n \"amount_actual\": 990,\n \"status\": \"Completed\",\n \"amount_delta\": 0.01,\n \"time\": 1761649929,\n \"time_type\": \"Created\",\n \"time_delta\": 10\n }\n ]\n}")
.asString();{
"status": 0,
"data": [
{
"chain_id_match": true,
"token_id_match": true,
"to_match": true,
"status_match": true,
"type_match": true,
"amount_match": true,
"fee_match": true,
"amount_actual_match": true,
"time_match": true,
"result": true,
"tx": {
"wallet_id": "b2c13dba-7787-4db5-98e3-cff374dc04cd",
"type": "Deposit",
"status": "Completed",
"amount": "2000",
"to": "TWaQTxMj9AFZHuf5XKjuaXCXAhym4Eiqu",
"fee_ratio": "0.008",
"fee_fixed": "0.00",
"fee": "16",
"er": "1",
"amount_actual": "1984",
"hash": "c4caed59a0dec787fca9c8f24555ece92dd6cb235f54595f11e9a409b318f31",
"chain_id": "TRON",
"token_id": "TRON_USDT",
"created_at": 1761518815,
"confirmed_at": 1761518870,
"completed_at": 1761518870
}
}
],
"msg": "<string>"
}{
"status": 0,
"data": [
{
"chain_id_match": true,
"token_id_match": true,
"to_match": true,
"status_match": true,
"type_match": true,
"amount_match": true,
"fee_match": true,
"amount_actual_match": true,
"time_match": true,
"result": true,
"tx": {
"wallet_id": "b2c13dba-7787-4db5-98e3-cff374dc04cd",
"type": "Deposit",
"status": "Completed",
"amount": "2000",
"to": "TWaQTxMj9AFZHuf5XKjuaXCXAhym4Eiqu",
"fee_ratio": "0.008",
"fee_fixed": "0.00",
"fee": "16",
"er": "1",
"amount_actual": "1984",
"hash": "c4caed59a0dec787fca9c8f24555ece92dd6cb235f54595f11e9a409b318f31",
"chain_id": "TRON",
"token_id": "TRON_USDT",
"created_at": 1761518815,
"confirmed_at": 1761518870,
"completed_at": 1761518870
}
}
],
"msg": "<string>"
}对账
批量交易校验
批量交易校验，支持按 request_id / transaction_id / hash 或字段组合批量匹配校验。
POST
/
nps
/
bill
/
verify
/
txs
cURL
curl --request POST \
--url https://apidev.nusd.me/nps/bill/verify/txs \
--header 'BIZ-API-KEY: <api-key>' \
--header 'Biz-Api-Nonce: <api-key>' \
--header 'Biz-Api-Signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"wallet_id": "b2c13dba-7787-4db5-98e3-cff374dc04cd",
"txs": [
{
"request_id": "",
"transaction_id": "da55a74c-e666-428d-8227-38cd25e3414d",
"hash": "",
"chain_id": "TRON",
"token_id": "TRON_USDT",
"to": "TWgTvxMj9AFZhQF5xKjrua(XCAhym4E1qu",
"type": "Deposit",
"amount": 2000,
"fee": 20,
"amount_actual": 1980,
"status": "Completed",
"amount_delta": 0.01,
"time": 1761518815,
"time_type": "Created",
"time_delta": 10
},
{
"request_id": "",
"transaction_id": "164271c4-3004-4201-a2b7-21156379293c",
"hash": "",
"chain_id": "ETH",
"token_id": "ETH_USDT",
"to": "0xfdd30a21582210900bc1468b2dbc7d51b68502973",
"type": "Deposit",
"amount": 1000,
"fee": 10,
"amount_actual": 990,
"status": "Completed",
"amount_delta": 0.01,
"time": 1761649929,
"time_type": "Created",
"time_delta": 10
}
]
}
'import requests
url = "https://apidev.nusd.me/nps/bill/verify/txs"
payload = {
"wallet_id": "b2c13dba-7787-4db5-98e3-cff374dc04cd",
"txs": [
{
"request_id": "",
"transaction_id": "da55a74c-e666-428d-8227-38cd25e3414d",
"hash": "",
"chain_id": "TRON",
"token_id": "TRON_USDT",
"to": "TWgTvxMj9AFZhQF5xKjrua(XCAhym4E1qu",
"type": "Deposit",
"amount": 2000,
"fee": 20,
"amount_actual": 1980,
"status": "Completed",
"amount_delta": 0.01,
"time": 1761518815,
"time_type": "Created",
"time_delta": 10
},
{
"request_id": "",
"transaction_id": "164271c4-3004-4201-a2b7-21156379293c",
"hash": "",
"chain_id": "ETH",
"token_id": "ETH_USDT",
"to": "0xfdd30a21582210900bc1468b2dbc7d51b68502973",
"type": "Deposit",
"amount": 1000,
"fee": 10,
"amount_actual": 990,
"status": "Completed",
"amount_delta": 0.01,
"time": 1761649929,
"time_type": "Created",
"time_delta": 10
}
]
}
headers = {
"BIZ-API-KEY": "<api-key>",
"Biz-Api-Nonce": "<api-key>",
"Biz-Api-Signature": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'BIZ-API-KEY': '<api-key>',
'Biz-Api-Nonce': '<api-key>',
'Biz-Api-Signature': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
wallet_id: 'b2c13dba-7787-4db5-98e3-cff374dc04cd',
txs: [
{
request_id: '',
transaction_id: 'da55a74c-e666-428d-8227-38cd25e3414d',
hash: '',
chain_id: 'TRON',
token_id: 'TRON_USDT',
to: 'TWgTvxMj9AFZhQF5xKjrua(XCAhym4E1qu',
type: 'Deposit',
amount: 2000,
fee: 20,
amount_actual: 1980,
status: 'Completed',
amount_delta: 0.01,
time: 1761518815,
time_type: 'Created',
time_delta: 10
},
{
request_id: '',
transaction_id: '164271c4-3004-4201-a2b7-21156379293c',
hash: '',
chain_id: 'ETH',
token_id: 'ETH_USDT',
to: '0xfdd30a21582210900bc1468b2dbc7d51b68502973',
type: 'Deposit',
amount: 1000,
fee: 10,
amount_actual: 990,
status: 'Completed',
amount_delta: 0.01,
time: 1761649929,
time_type: 'Created',
time_delta: 10
}
]
})
};
fetch('https://apidev.nusd.me/nps/bill/verify/txs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://apidev.nusd.me/nps/bill/verify/txs"
payload := strings.NewReader("{\n \"wallet_id\": \"b2c13dba-7787-4db5-98e3-cff374dc04cd\",\n \"txs\": [\n {\n \"request_id\": \"\",\n \"transaction_id\": \"da55a74c-e666-428d-8227-38cd25e3414d\",\n \"hash\": \"\",\n \"chain_id\": \"TRON\",\n \"token_id\": \"TRON_USDT\",\n \"to\": \"TWgTvxMj9AFZhQF5xKjrua(XCAhym4E1qu\",\n \"type\": \"Deposit\",\n \"amount\": 2000,\n \"fee\": 20,\n \"amount_actual\": 1980,\n \"status\": \"Completed\",\n \"amount_delta\": 0.01,\n \"time\": 1761518815,\n \"time_type\": \"Created\",\n \"time_delta\": 10\n },\n {\n \"request_id\": \"\",\n \"transaction_id\": \"164271c4-3004-4201-a2b7-21156379293c\",\n \"hash\": \"\",\n \"chain_id\": \"ETH\",\n \"token_id\": \"ETH_USDT\",\n \"to\": \"0xfdd30a21582210900bc1468b2dbc7d51b68502973\",\n \"type\": \"Deposit\",\n \"amount\": 1000,\n \"fee\": 10,\n \"amount_actual\": 990,\n \"status\": \"Completed\",\n \"amount_delta\": 0.01,\n \"time\": 1761649929,\n \"time_type\": \"Created\",\n \"time_delta\": 10\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("BIZ-API-KEY", "<api-key>")
req.Header.Add("Biz-Api-Nonce", "<api-key>")
req.Header.Add("Biz-Api-Signature", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://apidev.nusd.me/nps/bill/verify/txs")
.header("BIZ-API-KEY", "<api-key>")
.header("Biz-Api-Nonce", "<api-key>")
.header("Biz-Api-Signature", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"wallet_id\": \"b2c13dba-7787-4db5-98e3-cff374dc04cd\",\n \"txs\": [\n {\n \"request_id\": \"\",\n \"transaction_id\": \"da55a74c-e666-428d-8227-38cd25e3414d\",\n \"hash\": \"\",\n \"chain_id\": \"TRON\",\n \"token_id\": \"TRON_USDT\",\n \"to\": \"TWgTvxMj9AFZhQF5xKjrua(XCAhym4E1qu\",\n \"type\": \"Deposit\",\n \"amount\": 2000,\n \"fee\": 20,\n \"amount_actual\": 1980,\n \"status\": \"Completed\",\n \"amount_delta\": 0.01,\n \"time\": 1761518815,\n \"time_type\": \"Created\",\n \"time_delta\": 10\n },\n {\n \"request_id\": \"\",\n \"transaction_id\": \"164271c4-3004-4201-a2b7-21156379293c\",\n \"hash\": \"\",\n \"chain_id\": \"ETH\",\n \"token_id\": \"ETH_USDT\",\n \"to\": \"0xfdd30a21582210900bc1468b2dbc7d51b68502973\",\n \"type\": \"Deposit\",\n \"amount\": 1000,\n \"fee\": 10,\n \"amount_actual\": 990,\n \"status\": \"Completed\",\n \"amount_delta\": 0.01,\n \"time\": 1761649929,\n \"time_type\": \"Created\",\n \"time_delta\": 10\n }\n ]\n}")
.asString();{
"status": 0,
"data": [
{
"chain_id_match": true,
"token_id_match": true,
"to_match": true,
"status_match": true,
"type_match": true,
"amount_match": true,
"fee_match": true,
"amount_actual_match": true,
"time_match": true,
"result": true,
"tx": {
"wallet_id": "b2c13dba-7787-4db5-98e3-cff374dc04cd",
"type": "Deposit",
"status": "Completed",
"amount": "2000",
"to": "TWaQTxMj9AFZHuf5XKjuaXCXAhym4Eiqu",
"fee_ratio": "0.008",
"fee_fixed": "0.00",
"fee": "16",
"er": "1",
"amount_actual": "1984",
"hash": "c4caed59a0dec787fca9c8f24555ece92dd6cb235f54595f11e9a409b318f31",
"chain_id": "TRON",
"token_id": "TRON_USDT",
"created_at": 1761518815,
"confirmed_at": 1761518870,
"completed_at": 1761518870
}
}
],
"msg": "<string>"
}{
"status": 0,
"data": [
{
"chain_id_match": true,
"token_id_match": true,
"to_match": true,
"status_match": true,
"type_match": true,
"amount_match": true,
"fee_match": true,
"amount_actual_match": true,
"time_match": true,
"result": true,
"tx": {
"wallet_id": "b2c13dba-7787-4db5-98e3-cff374dc04cd",
"type": "Deposit",
"status": "Completed",
"amount": "2000",
"to": "TWaQTxMj9AFZHuf5XKjuaXCXAhym4Eiqu",
"fee_ratio": "0.008",
"fee_fixed": "0.00",
"fee": "16",
"er": "1",
"amount_actual": "1984",
"hash": "c4caed59a0dec787fca9c8f24555ece92dd6cb235f54595f11e9a409b318f31",
"chain_id": "TRON",
"token_id": "TRON_USDT",
"created_at": 1761518815,
"confirmed_at": 1761518870,
"completed_at": 1761518870
}
}
],
"msg": "<string>"
}授权
API Key，请求需在请求头中携带。
时间戳，请求需在请求头中携带。
签名串，请求需在请求头中携带。
请求体
application/json
- request_id、transaction_id、hash 默认至少使用一个参数，其中交易类型为 Deposit 时，request_id 不适用
- 剩余参数需至少提供一个进行校验
- amount_delta：数量容差，默认：0.001
- time：交易时间可选，单位：秒
- time_type：时间匹配类型：=Created，按交易的创建时间；=Confirmed，按交易的确认时间；=Completed，按交易的完成时间，默认：Created
- time_delta：时间容差，单位：秒，默认：10
钱包id
示例:
"b2c13dba-7787-4db5-98e3-cff374dc04cd"
需要校验的交易列表
Show child attributes
Show child attributes
示例:
[
{
"request_id": "",
"transaction_id": "da55a74c-e666-428d-8227-38cd25e3414d",
"hash": "",
"chain_id": "TRON",
"token_id": "TRON_USDT",
"to": "TWgTvxMj9AFZhQF5xKjrua(XCAhym4E1qu",
"type": "Deposit",
"amount": 2000,
"fee": 20,
"amount_actual": 1980,
"status": "Completed",
"amount_delta": 0.01,
"time": 1761518815,
"time_type": "Created",
"time_delta": 10
},
{
"request_id": "",
"transaction_id": "164271c4-3004-4201-a2b7-21156379293c",
"hash": "",
"chain_id": "ETH",
"token_id": "ETH_USDT",
"to": "0xfdd30a21582210900bc1468b2dbc7d51b68502973",
"type": "Deposit",
"amount": 1000,
"fee": 10,
"amount_actual": 990,
"status": "Completed",
"amount_delta": 0.01,
"time": 1761649929,
"time_type": "Created",
"time_delta": 10
}
]