Skip to main content
POST
/
api
/
v2.1
/
fincard
/
virtual
/
wallet
/
v2
/
transaction
Wallet Transaction History
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/transaction \
  --header 'Content-Type: application/json' \
  --header 'X-Forwarded-From: <x-forwarded-from>' \
  --data '
{
  "coinKey": "<string>",
  "coinName": "<string>",
  "txHash": "<string>",
  "sourceAddress": "<string>",
  "destinationAddress": "<string>",
  "orderNo": "<string>",
  "transactionType": "<string>",
  "transactionStatus": "<string>",
  "startTime": 123,
  "endTime": 123,
  "pageNum": 1,
  "pageSize": 10,
  "searchTerm": "<string>"
}
'
{
  "success": true,
  "code": 200,
  "msg": "Success",
  "data": {
    "total": 500,
    "pageNum": 1,
    "pageSize": 10,
    "records": [
      {
        "orderNo": "<string>",
        "coinKey": "<string>",
        "block": 123,
        "sourceAddress": "<string>",
        "destinationAddress": "<string>",
        "txHash": "<string>",
        "transactionHash": "<string>",
        "txAmount": 123,
        "transactionTime": 123,
        "confirmTime": 123,
        "coinName": "<string>",
        "feeRate": 123,
        "fee": 123,
        "fixedFee": 123,
        "receivedAmount": 123,
        "receivedCurrency": "<string>",
        "type": "<string>",
        "status": "<string>",
        "message": "<string>",
        "createTime": 123,
        "updateTime": 123,
        "transactionId": "<string>",
        "addressId": "<string>",
        "accountId": "<string>",
        "chainKey": "<string>",
        "blockHash": "<string>",
        "blockNumber": 123,
        "blockHeight": 123,
        "transactionType": "<string>",
        "transactionStatus": "<string>",
        "amount": 123,
        "feeAmount": 123,
        "confirmations": 123,
        "requiredConfirmations": 123,
        "fromAddress": "<string>",
        "toAddress": "<string>",
        "memo": "<string>",
        "blockTime": 123,
        "description": "<string>",
        "isInternal": true,
        "isWatchOnly": true,
        "explorerUrl": "<string>",
        "network": "<string>"
      }
    ]
  }
}

Headers

User-Agent
string

User agent

X-Forwarded-For
string

Forwarded for

X-Forwarded-From
string
required

Client application identifier

Example:

"client-app"

X-Tenant-ID
string

Tenant ID

deviceId
string

Device ID

platform
string

Platform

Body

application/json

Wallet transaction request

Wallet transaction history request

coinKey
string

Coin key (optional)

coinName
string

Coin name (optional)

txHash
string

Transaction hash (optional)

sourceAddress
string

Source address (optional)

destinationAddress
string

Destination address (optional)

orderNo
string

Order number (optional)

transactionType
string

Transaction type: DEPOSIT, WITHDRAW

transactionStatus
string

Transaction status: wait_process, processing, success, fail

startTime
integer<int64>

Start time (milliseconds). Range cannot exceed 90 days.

endTime
integer<int64>

End time (milliseconds). Range cannot exceed 90 days.

pageNum
integer<int32>
default:1

Current page. Default is 1

pageSize
integer<int32>
default:10

Page size. Default 10, maximum 100

searchTerm
string

Search term (optional)

Response

Successful response

Wallet transaction response

success
boolean

Success flag

Example:

true

code
integer<int32>

Response code

Example:

200

msg
string

Response message

Example:

"Success"

data
object

Wallet transaction data