Skip to content
FSCO Docs

Get wallet saving history

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

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

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
walletId
required
string format: uuid

The wallet ID

Example
e271bc5c-f870-44cd-8462-54280d0411f6

Query Parameters

Section titled “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
number
required
number

Page number (starts at 1)

Example
1
size
required
number

Items per page

Example
10
totalPages
required
number

Total number of items

Example
100
totalCount
required
number

Total number of pages

Example
10
hasNext
required
boolean

Whether there is a next page

Example
true
hasPrev
required
boolean

Whether there is a previous page

Header Parameters

Section titled “Header Parameters ”
X-API-Key
string

API Key

X-API-Secret
string

API Secret

Responses

Section titled “ Responses ”

200

Section titled “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 
e271bc5c-f870-44cd-8462-54280d0411f6
walletId
required

The wallet ID

string format: uuid 
e271bc5c-f870-44cd-8462-54280d0411f6
savingId
required

The saving ID

string format: uuid 
e271bc5c-f870-44cd-8462-54280d0411f6
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 
e271bc5c-f870-44cd-8462-54280d0411f6
currencyId
required

The currency ID

string format: uuid 
e271bc5c-f870-44cd-8462-54280d0411f6
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

Section titled “400 ”

Bad Request

401

Section titled “401 ”

Unauthorized

403

Section titled “403 ”

Forbidden

404

Section titled “404 ”

Not Found

500

Section titled “500 ”

Internal Server Error