List Assets

Get the list of your assets

Note: your API key must have the "Assets" permission.

This endpoint allows you to retrieve the total asset 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/assets/USD/

Note: you must insert Fiat symbol in end of URL (e.g USD).

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").
price*	float	The price of the coin.

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",
                "price": 0.9997853
            },
            {
                "symbol": "TRX",
                "name": "Tron",
                "icon": "https://payhubixstorage.darkube.app/payhubix/coins_icons/TRX_logo.jpg",
                "balance": 9665,
                "fiat_balance": 1439.828,
                "fiat_symbol": "USD",
                "price": 0.2621171
            }
        ]
    }
}

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/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/assets/USD/', headers=headers)

Node.js

import axios from 'axios';

const response = await axios.get('https://api.payhubix.com/v1/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/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/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