Crypto reconciliation download
About 1 min
Overview
Download the merchant crypto reconciliation file for a bill date and currency. Each currency has its own daily file. See Crypto overview for headers and signing.
IP allowlist is mandatory
This API always checks the request IP allowlist. The pay-in / pay-out / order inquiry / balance checkboxes do not apply.
Add the caller's public egress IP to Request IP allowlist in the merchant console. An empty list, or an IP that is not on the list, returns 1001.
Path
POST. There is no sandbox URL.
| Environment | URL |
|---|---|
| Production | https://openapi.toppayment.com/crypto/reconciliation/v1/download |
global-digit-openapi.toppayment.com still works. The path is the same.
Headers
| Field | Required | Type | Description |
|---|---|---|---|
| Content-Type | M | String | Fixed value: application/json |
| Nonce | M | String(16-64) | Anti-replay value. Unique for 10 minutes. Not part of the signature |
Body
| Field | Required | Type | Description |
|---|---|---|---|
| mchNo | M | String(32) | Merchant number |
| date | M | String(10) | Bill date, yyyy-MM-ddYesterday or earlier only. Today or a future date returns 1005 |
| currency | O | String(16) | Currency, such as USDT, USDC, ETH, BTCDefaults to USDT. Values are matched in uppercase |
| timestamp | M | String(13) | 13-digit millisecond timestamp, within ±5 minutes |
| sign | M | String | See Signature |
| tenantCode | O | String(32) | Sub-tenant code. Omit it to use the default tenant |
If that currency had no balance movement on the bill date, there is no file and the API returns 1005.
Example
Content-Type: application/json
Nonce: a91e60c3b7d248f5c0a2
{
"mchNo": "{{mchNo}}",
"date": "2026-11-10",
"currency": "USDT",
"timestamp": "1749102949784",
"sign": "replace with the generated signature"
}
Response
| Field | Required | Type | Description |
|---|---|---|---|
| success | M | Boolean | Whether the call succeeded |
| code | M | String | 9999 on success. See Error codes |
| msg | O | String | Failure message. null on success |
| timeStamp | M | Number | Server time in milliseconds |
| data | M | Object | Present on success |
| date | M | String | Bill date |
| currency | M | String | Currency actually queried. USDT when omitted |
| downloadUrl | M | String | Download URL, valid for 1 hour |
{
"success": true,
"code": "9999",
"msg": null,
"timeStamp": 1767873172906,
"data": {
"date": "2026-11-10",
"currency": "USDT",
"downloadUrl": "https://storage.googleapis.com/example/assetRecord/bill.csv?X-Goog-Expires=3600"
}
}
Common errors
| Code | Meaning |
|---|---|
| 0001 | Invalid parameter, timestamp, or Nonce |
| 0002 | Signature failed |
| 1001 | IP allowlist rejected |
| 1005 | No reconciliation file for that date and currency |
