Skip to main content
POST
/
api
/
v2.1
/
fincard
/
virtual
/
wallet
/
v2
/
addressList
Wallet Address List
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList \
  --header 'Content-Type: application/json' \
  --header 'X-Forwarded-From: <x-forwarded-from>' \
  --data '
{
  "accountId": "wsb-12345678",
  "coinKey": "BTC",
  "chainKey": "BITCOIN",
  "addressType": "SEGWIT",
  "active": true,
  "pageNum": 1,
  "pageSize": 10,
  "sortField": "createTime",
  "sortOrder": "DESC",
  "searchTerm": "bc1q",
  "createDateFrom": "2023-01-01T00:00:00.000Z",
  "createDateTo": "2023-12-31T00:00:00.000Z"
}
'
{
  "success": true,
  "code": 200,
  "msg": "Success",
  "data": {
    "total": 50,
    "pageNum": 1,
    "pageSize": 10,
    "records": [
      {
        "addressId": "<string>",
        "accountId": "<string>",
        "coinKey": "<string>",
        "chain": "<string>",
        "address": "<string>",
        "walletAddress": "<string>",
        "chainKey": "<string>",
        "addressType": "<string>",
        "label": "<string>",
        "memo": "<string>",
        "qrCodeUrl": "<string>",
        "isHdWallet": true,
        "derivationPath": "<string>",
        "active": true,
        "totalReceived": 123,
        "totalSent": 123,
        "balance": 123,
        "unconfirmedBalance": 123,
        "numberOfTransactions": 123,
        "createTime": 123,
        "lastActivityTime": 123
      }
    ]
  }
}

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 address list request

Wallet address list request

accountId
string

Account ID (optional)

Example:

"wsb-12345678"

coinKey
string

Coin key (optional)

Example:

"BTC"

chainKey
string

Chain key (optional)

Example:

"BITCOIN"

addressType
string

Address type (optional)

Example:

"SEGWIT"

active
boolean

Active status (optional)

Example:

true

pageNum
integer<int32>

Page number

Example:

1

pageSize
integer<int32>

Page size

Example:

10

sortField
string

Sort field

Example:

"createTime"

sortOrder
string

Sort order

Example:

"DESC"

searchTerm
string

Search term (optional)

Example:

"bc1q"

createDateFrom
string

Create date from (YYYY-MM-DD)

Example:

"2023-01-01T00:00:00.000Z"

createDateTo
string

Create date to (YYYY-MM-DD)

Example:

"2023-12-31T00:00:00.000Z"

Response

Successful response

Wallet address list response

success
boolean

Success flag

Example:

true

code
integer<int32>

Response code

Example:

200

msg
string

Response message

Example:

"Success"

data
object

Wallet address list data