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>"
}

Authorizations

​
BIZ-API-KEY
string
header
required

API key. Must be included in the request header.

​
Biz-Api-Nonce
string
header
required

Timestamp. Must be included in the request header.

​
Biz-Api-Signature
string
header
required

Signature string. Must be included in the request header.

Body

application/json
  1. At least one of request_id, transaction_id, or hash must be provided by default. request_id is not applicable when the transaction type is Deposit.
  2. At least one of the remaining parameters must be provided for verification.
  3. amount_delta: amount tolerance. Default: 0.001.
  4. time: transaction time, optional, in seconds.
  5. time_type: time match type. =Created matches the transaction creation time; =Confirmed matches the confirmation time; =Completed matches the completion time. Default: Created.
  6. time_delta: time tolerance, in seconds. Default: 10.
​
txs
object[]
required

List of transactions to verify.

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

Response

Request succeeded. Returns the batch verification result.

​
status
integer

Status code. 0 indicates success.

Example:

0

​
data
object[]

Batch verification result list.

​
msg
string

Error message. Present when status is non-zero.