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"
}
'import requests
url = "https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList"
payload = {
"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"
}
headers = {
"X-Forwarded-From": "<x-forwarded-from>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Forwarded-From': '<x-forwarded-from>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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'
})
};
fetch('https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Forwarded-From: <x-forwarded-from>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList"
payload := strings.NewReader("{\n \"accountId\": \"wsb-12345678\",\n \"coinKey\": \"BTC\",\n \"chainKey\": \"BITCOIN\",\n \"addressType\": \"SEGWIT\",\n \"active\": true,\n \"pageNum\": 1,\n \"pageSize\": 10,\n \"sortField\": \"createTime\",\n \"sortOrder\": \"DESC\",\n \"searchTerm\": \"bc1q\",\n \"createDateFrom\": \"2023-01-01T00:00:00.000Z\",\n \"createDateTo\": \"2023-12-31T00:00:00.000Z\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Forwarded-From", "<x-forwarded-from>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList")
.header("X-Forwarded-From", "<x-forwarded-from>")
.header("Content-Type", "application/json")
.body("{\n \"accountId\": \"wsb-12345678\",\n \"coinKey\": \"BTC\",\n \"chainKey\": \"BITCOIN\",\n \"addressType\": \"SEGWIT\",\n \"active\": true,\n \"pageNum\": 1,\n \"pageSize\": 10,\n \"sortField\": \"createTime\",\n \"sortOrder\": \"DESC\",\n \"searchTerm\": \"bc1q\",\n \"createDateFrom\": \"2023-01-01T00:00:00.000Z\",\n \"createDateTo\": \"2023-12-31T00:00:00.000Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Forwarded-From"] = '<x-forwarded-from>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"accountId\": \"wsb-12345678\",\n \"coinKey\": \"BTC\",\n \"chainKey\": \"BITCOIN\",\n \"addressType\": \"SEGWIT\",\n \"active\": true,\n \"pageNum\": 1,\n \"pageSize\": 10,\n \"sortField\": \"createTime\",\n \"sortOrder\": \"DESC\",\n \"searchTerm\": \"bc1q\",\n \"createDateFrom\": \"2023-01-01T00:00:00.000Z\",\n \"createDateTo\": \"2023-12-31T00:00:00.000Z\"\n}"
response = http.request(request)
puts response.read_body{
"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
}
]
}
}Wallet
Wallet Address List
Query all wallet deposit addresses
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"
}
'import requests
url = "https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList"
payload = {
"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"
}
headers = {
"X-Forwarded-From": "<x-forwarded-from>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Forwarded-From': '<x-forwarded-from>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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'
})
};
fetch('https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Forwarded-From: <x-forwarded-from>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList"
payload := strings.NewReader("{\n \"accountId\": \"wsb-12345678\",\n \"coinKey\": \"BTC\",\n \"chainKey\": \"BITCOIN\",\n \"addressType\": \"SEGWIT\",\n \"active\": true,\n \"pageNum\": 1,\n \"pageSize\": 10,\n \"sortField\": \"createTime\",\n \"sortOrder\": \"DESC\",\n \"searchTerm\": \"bc1q\",\n \"createDateFrom\": \"2023-01-01T00:00:00.000Z\",\n \"createDateTo\": \"2023-12-31T00:00:00.000Z\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Forwarded-From", "<x-forwarded-from>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList")
.header("X-Forwarded-From", "<x-forwarded-from>")
.header("Content-Type", "application/json")
.body("{\n \"accountId\": \"wsb-12345678\",\n \"coinKey\": \"BTC\",\n \"chainKey\": \"BITCOIN\",\n \"addressType\": \"SEGWIT\",\n \"active\": true,\n \"pageNum\": 1,\n \"pageSize\": 10,\n \"sortField\": \"createTime\",\n \"sortOrder\": \"DESC\",\n \"searchTerm\": \"bc1q\",\n \"createDateFrom\": \"2023-01-01T00:00:00.000Z\",\n \"createDateTo\": \"2023-12-31T00:00:00.000Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/wallet/v2/addressList")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Forwarded-From"] = '<x-forwarded-from>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"accountId\": \"wsb-12345678\",\n \"coinKey\": \"BTC\",\n \"chainKey\": \"BITCOIN\",\n \"addressType\": \"SEGWIT\",\n \"active\": true,\n \"pageNum\": 1,\n \"pageSize\": 10,\n \"sortField\": \"createTime\",\n \"sortOrder\": \"DESC\",\n \"searchTerm\": \"bc1q\",\n \"createDateFrom\": \"2023-01-01T00:00:00.000Z\",\n \"createDateTo\": \"2023-12-31T00:00:00.000Z\"\n}"
response = http.request(request)
puts response.read_body{
"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
Forwarded for
Client application identifier
Example:
"client-app"
Tenant ID
Device ID
Platform
Body
application/json
Wallet address list request
Wallet address list request
Account ID (optional)
Example:
"wsb-12345678"
Coin key (optional)
Example:
"BTC"
Chain key (optional)
Example:
"BITCOIN"
Address type (optional)
Example:
"SEGWIT"
Active status (optional)
Example:
true
Page number
Example:
1
Page size
Example:
10
Sort field
Example:
"createTime"
Sort order
Example:
"DESC"
Search term (optional)
Example:
"bc1q"
Create date from (YYYY-MM-DD)
Example:
"2023-01-01T00:00:00.000Z"
Create date to (YYYY-MM-DD)
Example:
"2023-12-31T00:00:00.000Z"
⌘I