GET

/api/v1/exchanges/:id/pie_chart_data

Permission: EXCHANGES_READSecurity: SIGNED

Returns currency balance distribution of a specific account using its ID, structured and calculated for direct visualization in pie and donut charts.

Pro Tip (Portfolio Summary)

By replacing :id with summary (/api/v1/exchanges/summary/pie_chart_data), you can retrieve aggregated balance distribution data across all accounts where available_include_in_summary is enabled.

Path Parameters

idUUID string / summary required

Unique Quentrade UUID of this exchange account entity (or 'summary' for aggregated portfolio distribution).

Example Request

GETGET /api/v1/exchanges/7fa84b80-77a8-4e89-a292-123456789abc/pie_chart_data

Response Parameters

codestring

The cryptocurrency ticker code symbol (e.g. BTC, DOGE, USDT).

namestring

Full display name of the cryptocurrency (e.g. Bitcoin (BTC)).

coinmarketcapidstring

Unique asset identifier on CoinMarketCap.

percentagenumber

Percentage proportion of total portfolio value held in this currency.

ynumber

Y-axis chart plotting value equivalent to the percentage proportion.

amountnumber

Total coin quantity held in this account.

btc_valuestring

Total equivalent holding value calculated in BTC.

usd_valuestring

Total equivalent holding value calculated in USD.

account_idUUID string

Unique ID of the exchange account entity.

primary_display_currencyobject

Object containing the formatted holding value in the user's primary currency.

currencystring

Target fiat or reference currency code (e.g. USD).

amountstring

Total asset balance evaluated in the primary display currency.

Example Responses

pie_chart_balances_200.json

200 OK

[
  {
    "code": "BTC",
    "coinmarketcapid": "1",
    "name": "Bitcoin (BTC)",
    "y": 68.34,
    "percentage": 68.34,
    "amount": 0.00031296,
    "btc_value": "0.00031296",
    "usd_value": "24.68",
    "primary_display_currency": {
      "currency": "USD",
      "amount": "24.6764171712"
    },
    "account_id": "7fa84b80-77a8-4e89-a292-123456789abc"
  },
  {
    "code": "DOGE",
    "coinmarketcapid": "74",
    "name": "Dogecoin (DOGE)",
    "y": 13.72,
    "percentage": 13.72,
    "amount": 27.076,
    "btc_value": "0.00006282",
    "usd_value": "4.95",
    "primary_display_currency": {
      "currency": "USD",
      "amount": "4.9529707230304"
    },
    "account_id": "7fa84b80-77a8-4e89-a292-123456789abc"
  },
  {
    "code": "USDT",
    "coinmarketcapid": "825",
    "name": "Tether USDt (USDT)",
    "y": 13.01,
    "percentage": 13.01,
    "amount": 4.68331292,
    "btc_value": "0.00005958",
    "usd_value": "4.68",
    "primary_display_currency": {
      "currency": "USD",
      "amount": "4.68331292"
    },
    "account_id": "7fa84b80-77a8-4e89-a292-123456789abc"
  }
]

Previous Delete an exchange account NextUser balances for table chart visualization