Assets & Transactions
Read your balances per token and your ledger history. All endpoints require authentication.
List Assets
GET /api/v1/assets
Query Parameters
| Param | Type | Default |
|---|---|---|
page | int | 1 |
limit | int | 20 |
Response 200
{
"data": {
"items": [
{
"tokenCode": "USDT",
"network": "ethereum",
"networkType": "evm",
"chainId": 1,
"tokenAddress": "0x...",
"symbol": "USDT",
"decimals": 6,
"pendingBalance": 0,
"activeBalance": 100.5,
"withholdBalance": 0
}
],
"total": 5,
"page": 1,
"limit": 20
}
}Get Asset by Token Code
GET /api/v1/assets/:tokenCode → { "data": { /* single asset */ } }
| Code | Meaning |
|---|---|
| 404 | Asset/token not found |
List Transaction History
GET /api/v1/transaction-histories
Query Parameters
| Param | Type | Description |
|---|---|---|
page | int | Default 1 |
limit | int | Default 20 |
startDate | string | RFC3339 or YYYY-MM-DD |
endDate | string | RFC3339 or YYYY-MM-DD |
transactionType | string | deposit, withdraw, withdraw_fee |
method | string | credit or debit |
tokenCode | string | Filter by token |
Response 200
{
"data": {
"items": [
{
"id": "txn_abc123",
"tokenCode": "USDT",
"network": "ethereum",
"symbol": "USDT",
"method": "credit",
"transactionType": "deposit",
"amount": 100,
"latestBalance": 100.5,
"referenceType": "invoice",
"referenceId": "inv_abc123",
"createdAt": "2026-01-01T00:00:00Z"
}
],
"total": 20,
"page": 1,
"limit": 20
}
}| Code | Meaning |
|---|---|
| 400 | Invalid date range, transactionType, or method |
| 404 | Token not found |