Customers
Create a customer
- URI
POST /customers
- Body
json{ "externalRef": "user_10086", "name": "Alice Chen", "email": "alice@example.com", "metadata": { "tier": "gold" } }
- Response 200
json{ "status":"1", "data":{ "customerId":"cus_8a9b3e", "externalRef":"user_10086", "name":"Alice Chen", "email":"alice@example.com", "createdAt":"2025-11-06T02:13:00Z" } }
- Response 400
json{ "status":"-1", "message":"email already exists" }
Wallets
Create wallet
为客户开通稳定币钱包（指定资产与网络）
- URI
POST /wallets
- Body
json{ "customerId":"cus_8a9b3e", "asset":"USDT", "network":"TRON" }
- Response 200
json{ "status":"1", "data":{ "walletId":"wal_c1f0aa", "customerId":"cus_8a9b3e", "asset":"USDT", "network":"TRON", "address":"TQn2...V1", "status":"ACTIVE", "createdAt":"2025-11-06T02:15:00Z" } }
- Response 400
json{ "status":"-1", "message":"unsupported asset/network" }
List wallets by customer
- URI
GET /customers/{customerId}/wallets?limit=50&cursor={cursor}
- Response 200
json{ "status":"1", "data":{ "items":[ { "walletId":"wal_c1f0aa","asset":"USDT","network":"TRON","address":"TQn2...V1","status":"ACTIVE" } ], "nextCursor": null } }
Get wallet balance
- URI
GET /wallets/{walletId}/balances
- Response 200
json{ "status":"1", "data":{ "walletId":"wal_c1f0aa", "asset":"USDT", "network":"TRON", "available":"65.2932", "pending":"0", "updatedAt":"2025-11-06T02:20:00Z" } }
Get wallet transactions
- URI
GET /wallets/{walletId}/transactions?limit=50&cursor={cursor}
- Response 200
json{ "status":"1", "data":{ "items":[ { "txId":"tx_4c9a1e", "type":"CREDIT", // CREDIT | DEBIT "reason":"TOPUP_CREDIT", // 业务来源 "amount":"1325.44", "asset":"USDT", "network":"TRON", "txHash":"a18f...ce9", "createdAt":"2025-11-06T02:58:00Z" } ], "nextCursor": null } }
Top-up（Fiat → Stablecoin）
Create quote
The API is used to get the currency rate.
- URI
POST /global/payout/rate/query/price
- Body Params
Body Json Demo
Name
Type
Required
Description
sourceCurrency
string
Required
Currency you are sending
targetCurrency
string
Required
Target currency
- Response
Name
Type
Required
Description
data
object
Conditional Required
data →
queryNostring
Conditional Required
data →
ratenumber
Conditional Required
status
string
Required
1 : Success
-1: Error
message
string
Conditional Required
if the status is -1，the err message is responded
Response Status: 200, Body Json Demo
Response Status: 400, Body Json Demo
Create top-up order
对应“提交法币转账”，返回银行/网关付款指引
- URI
POST /topup/orders
- Body
json{ "quoteId": "q_7b0e8d", "walletId": "wal_c1f0aa", "payer": { "name": "Alice Chen", "bankAccount": { "ibanOrAccount":"062-123456","bankName":"ABC Bank" } } }
- Response 200
json{ "status":"1", "data":{ "orderId":"or_98f12a", "status":"PENDING_PAYMENT", "paymentInstructions":{ "method":"BANK_TRANSFER", "beneficiaryName":"Your Company Pty Ltd", "bankName":"XYZ Bank", "accountNumber":"12345678", "bsbOrRouting":"062-000", "reference":"RF-98F12A", "amount":"2000.00", "currency":"AUD", "expiresAt":"2025-11-06T03:00:00Z" }, "quoteSnapshot":{ "rate":"0.663271", "fees":"10.50", "estimatedCredit":"1325.44" }, "createdAt":"2025-11-06T02:22:00Z" } }
- Response 400
json{ "status":"-1", "message":"quote expired" }
Get top-up order status
- URI
GET /topup/orders/{orderId}
- Response 200
json{ "status":"1", "data":{ "orderId":"or_98f12a", "status":"CREDITED", // PENDING_PAYMENT | PAID_MATCHED | CONVERTED | CREDITED | FAILED | CANCELED "fiatReceived":"2000.00", "fiatCurrency":"AUD", "assetCredited":"1325.44", "asset":"USDT", "network":"TRON", "creditTxHash":"a18f...ce9", "updatedAt":"2025-11-06T02:58:00Z" } }
List top-up orders
- URI
GET /topup/orders?walletId=wal_c1f0aa&status=CREDITED&limit=50&cursor={cursor}
- Response 200
json{ "status":"1", "data":{ "items":[{ "orderId":"or_98f12a","status":"CREDITED","fiatReceived":"2000.00","assetCredited":"1325.44","updatedAt":"2025-11-06T02:58:00Z"}], "nextCursor": null } }
Webhooks
Top-up status webhook
- URI（你方接收）
POST https://yourapp.com/webhooks/topup.status
- Request（我们推送）
json{ "event":"topup.status", "signature":"v1=2fd58b3c...hmac", "data":{ "orderId":"or_98f12a", "status":"CREDITED", "fiatReceived":"2000.00", "fiatCurrency":"AUD", "assetCredited":"1325.44", "asset":"USDT", "network":"TRON", "walletId":"wal_c1f0aa", "occurredAt":"2025-11-06T02:58:00Z" } }
- Response 200
json{ "status":"1" }
Assets & Networks
Get supported assets & networks
- URI
GET /assets/networks
- Response 200
json{ "status":"1", "data":{ "matrix":[ { "asset":"USDT","network":"TRON","minTopupFiat":"100.00","settlementSlaMins":30 }, { "asset":"USDT","network":"ETH","minTopupFiat":"100.00","settlementSlaMins":30 }, { "asset":"USDC","network":"ETH","minTopupFiat":"100.00","settlementSlaMins":30 } ] } }