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 '
{
  "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
    }
  ]
}
'
{
  "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,
      "data": {
        "wallet_id": "b2c13dba-7787-4db5-98e3-cff374dc04cd",
        "type": "Deposit",
        "status": "Completed",
        "amount": "2000",
        "to": "TWaQTxMj9AFZHuf5XKjuaXCXAhym4Eiqu",
        "fee_ratio": "0.01",
        "fee_fixed": "0.00",
        "fee": "20",
        "er": "1",
        "amount_actual": "1980",
        "hash": "c4caed59a0dec787fca9c8f24555ece92dd6cb235f54595f11e9a409b318f31",
        "chain_id": "TRON",
        "token_id": "TRON_USDT",
        "created_at": "2025-10-26T22:46:55.268Z",
        "confirmed_at": "2025-10-26T22:47:50.847Z",
        "completed_at": "2025-10-26T22:47:50.847Z"
      }
    }
  ],
  "msg": "<string>"
}

授权

​
BIZ-API-KEY
string
header
必填

API Key，请求需在请求头中携带。

​
Biz-Api-Nonce
string
header
必填

时间戳，请求需在请求头中携带。

​
Biz-Api-Signature
string
header
必填

签名串，请求需在请求头中携带。

请求体

application/json
  1. request_id、transaction_id、hash 默认至少使用一个参数，其中交易类型为 Deposit 时，request_id 不适用
  2. 剩余参数需至少提供一个进行校验
  3. amount_delta：数量容差，默认：0.001
  4. time：交易时间可选，单位：秒
  5. time_type：时间匹配类型：=Created，按交易的创建时间；=Confirmed，按交易的确认时间；=Completed，按交易的完成时间，默认：Created
  6. time_delta：时间容差，单位：秒，默认：10
​
txs
object[]
必填

需要校验的交易列表

示例:
[
  {
    "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
  }
]

响应

请求成功，返回批量校验结果

​
status
integer

状态码，0 表示成功。

示例:

0

​
data
object[]

批量校验结果列表

​
msg
string

错误消息，status 非 0 时存在