Get wallet saving history

GET

/v2/treasury/wallet/{walletId}/savings/history

• Staging
• Development

Get the saving history for a specific wallet with filters and pagination

Authorizations

• X-API-Key
• X-API-Secret

Parameters

Path Parameters

walletId

required

string format: uuid

The wallet ID

Example

77a0049c-7683-45ff-956f-656f257048f7

Query Parameters

status

required

string

Allowed values: PENDING COMPLETED FAILED

The status of the transaction

Example

PENDING

actionType

required

string

Allowed values: DEPOSIT WITHDRAW

The action type of the transaction

Example

DEPOSIT

fromDate

required

string

The start date of the transaction

Example

2025-01-01T00:00:00.000Z

toDate

required

string

The end date of the transaction

Example

2025-01-01T00:00:00.000Z

sortOrder

required

string

default: desc

Allowed values: asc desc

The sort order by Date

Example

desc

Header Parameters

X-API-Key

string

API Key

X-API-Secret

string

API Secret

Responses

200

List of saving history entries

object

items

required

List of saving history items

Array<object>

object

savingHistoryId

required

The history entry ID

string format: uuid

77a0049c-7683-45ff-956f-656f257048f7

walletId

required

The wallet ID

string format: uuid

77a0049c-7683-45ff-956f-656f257048f7

savingId

required

The saving ID

string format: uuid

77a0049c-7683-45ff-956f-656f257048f7

actionType

required

The action type, either “deposit” or “withdraw”

string

Allowed values: DEPOSIT WITHDRAW

status

required

The current status, e.g., “pending”, “completed”, “failed”

string

Allowed values: PENDING COMPLETED FAILED

feeStatus

required

The status of the fee processing, similar to transaction status

string

Allowed values: PENDING COMPLETED FAILED

txQueryId

The transaction query ID

string format: uuid

77a0049c-7683-45ff-956f-656f257048f7

currencyId

required

The currency ID

string format: uuid

77a0049c-7683-45ff-956f-656f257048f7

totalValue

required

Total value involved in the transaction

string

100.123456

customerInputValue

required

Customer’s original input value before any deductions

string

100.123456

customerValue

required

Final customer value after applying fees or deductions

string

98.123456

customerFeeValue

required

Customer-specific fee amount

string

1.000000

adminFeeValue

required

Admin fee calculated from the transaction

string

1.000000

paidAdminFeeValue

required

Amount of admin fee that has already been paid

string

1.000000

preBalance

required

Customer’s balance before the transaction

string

1000.123456

postBalance

required

Customer’s balance after the transaction

string

1100.123456

createdAt

required

The transaction timestamp

string format: date-time

2024-03-20T10:30:00.000Z

updatedAt

required

Last update timestamp

string format: date-time

2024-03-20T10:30:00.000Z

page

required

Pagination information

object

number

required

Page number (starts at 1)

number

1

size

required

Items per page

number

10

totalPages

required

Total number of items

number

100

totalCount

required

Total number of pages

number

10

hasNext

required

Whether there is a next page

boolean

true

hasPrev

required

Whether there is a previous page

boolean

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error