List Asset (Shop)

Get the list of your assets

This endpoint allows you to retrieve the total assets of all your wallets in a specified fiat currency (e.g., USD). You will also get detailed information about each individual wallet, including the cryptocurrency balance and its equivalent in fiat currency.

GET https://api.payhubix.com/v1/wallet/shops/019242e7-d18f-788f-813e-a2c72177e172/assets/USD/

Note: you must insert Fiat symbol in end of URL (e.g USD) And you must insert shop_id in path param request

Request Header:

Name	Type	Description
X-Api-Key*	string	Your API key for authentication and authorization.

Response:

Name	Type	Description
total_fiat_balance	float	The total balance of all wallets converted into fiat (e.g., 1439.828 USD).
fiat_symbol	string	The symbol of the fiat currency used to represent the total balance (e.g., "USD").
symbol	string	The symbol of the cryptocurrency (e.g., "USDT" for Tether, "TRX" for Tron).
name	string	The name of the cryptocurrency (e.g., "Tether", "Tron").
icon	string	URL of the cryptocurrency's icon (e.g., "https://payhubixstorage.darkube.app/.../USDT_logo.jpg").
balance	float	The balance of the cryptocurrency in its own unit (e.g., 9665 TRX).
fiat_balance	float	The equivalent balance of the cryptocurrency in fiat currency (e.g., 1439.828 USD).
fiat_symbol	string	The symbol of the fiat currency (e.g., "USD").

An example of response:

200: OK

{
    "error": false,
    "number": 0,
    "message": {
        "total_fiat_balance": 1439.828,
        "fiat_symbol": "USD",
        "assets": [
            {
                "symbol": "USDT",
                "name": "Tether",
                "icon": "https://payhubixstorage.darkube.app/payhubix/coins_icons/USDT_logo.jpg",
                "balance": 0,
                "fiat_balance": 0,
                "fiat_symbol": "USD"
            },
            {
                "symbol": "TRX",
                "name": "Tron",
                "icon": "https://payhubixstorage.darkube.app/payhubix/coins_icons/TRX_logo.jpg",
                "balance": 9665,
                "fiat_balance": 1439.828,
                "fiat_symbol": "USD"
            }
        ]
    }
}

401: Unauthorized

{
    "error": true,
    "number": 401,
    "message": "Unauthorized access to api"
}

403: Forbidden

{
    "error": true,
    "number": 403,
    "message": "You don't have permission to access this resource."
}

500: Something went wrong

{
    "error": true,
    "number": 500,
    "message": "Oops! Something went wrong on our end."
}

Example codes:

cURL

curl --location 'https://api.payhubix.com/v1/wallet/shops/019242e7-d18f-788f-813e-a2c72177e172/assets/USD/' \
--header 'X-Api-Key: YOUR_API_KEY'

Python

import requests

headers = {
    'X-Api-Key': 'YOUR_API_KEY',
}

response = requests.get('https://api.payhubix.com/v1/wallet/shops/019242e7-d18f-788f-813e-a2c72177e172/assets/USD/', headers=headers)

Node.js

import axios from 'axios';

const response = await axios.get('https://api.payhubix.com/v1/wallet/shops/019242e7-d18f-788f-813e-a2c72177e172/assets/USD/', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY'
  }
});

PHP

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client();

$response = $client->get('https://api.payhubix.com/v1/wallet/shops/019242e7-d18f-788f-813e-a2c72177e172/assets/USD/', [
    'headers' => [
        'X-Api-Key' => 'YOUR_API_KEY'
    ]
]);

Golang

package main

import (
	"fmt"
	"io"
	"log"
	"net/http"
)

func main() {
	client := &http.Client{}
	req, err := http.NewRequest("GET", "https://api.payhubix.com/v1/wallet/shops/019242e7-d18f-788f-813e-a2c72177e172/assets/USD/", nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")
	resp, err := client.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer resp.Body.Close()
	bodyText, err := io.ReadAll(resp.Body)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%s\n", bodyText)
}

Note: Please make sure to replace YOUR_API_KEY in the code snippets with your actual merchant API key