Get currency transfer history

GET

/v2/treasury/wallet/{walletId}/transfer/{currencyName}/history

• Staging
• Development

Get the transfer history for a specific wallet and currency with filters and pagination

Authorizations

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

Parameters

Path Parameters

walletId

required

string

The wallet ID

Example

e271bc5c-f870-44cd-8462-54280d0411f6

currencyName

required

string

The currency name

Example

USDC

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

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

page[number]

number

Page number (starts at 1)

Example

1

page[size]

number

Items per page

Example

10

Header Parameters

X-API-Key

string

API Key

X-API-Secret

string

API Secret

Responses

200

List of transfer history entries

object

items

required

List of transfer history items

Array<object>

object

currencyTransferHistoryId

required

The history entry ID

string format: uuid

e271bc5c-f870-44cd-8462-54280d0411f6

currencyId

required

The currency ID

string format: uuid

e271bc5c-f870-44cd-8462-54280d0411f6

currencySymbol

required

The currency symbol

string

USDC

walletId

required

The wallet ID

string format: uuid

e271bc5c-f870-44cd-8462-54280d0411f6

fromAddress

required

The source address

string

0x1234...

toAddress

required

The destination address

string

0x5678...

txQueryId

required

The transaction query ID

string

e271bc5c-f870-44cd-8462-54280d0411f6

actionType

required

The action type

string

Allowed values: TRANSFER_OUT TRANSFER_IN

value

required

The transfer amount

string

100.123456

status

required

The transaction status

string

Allowed values: PENDING COMPLETED FAILED

preBalance

required

Balance before the transaction

string

1000.123456

postBalance

required

Balance after the transaction

string

900.123456

createdAt

required

The transaction timestamp

string

2024-03-20T10:30:00.000Z

updatedAt

required

Last update timestamp

string

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