GET

/api/v1/exchanges/:id/pie_chart_data

Izin: EXCHANGES_READKeamanan: SIGNED

Mengembalikan distribusi saldo mata uang akun tertentu menggunakan ID-nya, terstruktur dan dihitung untuk visualisasi langsung pada diagram lingkaran dan diagram donat.

Tips Tambahan (Ringkasan Portofolio)

Dengan mengganti :id menjadi summary (/api/v1/exchanges/summary/pie_chart_data), Anda dapat mengambil data distribusi saldo gabungan dari semua akun yang mengaktifkan available_include_in_summary.

Parameter Path

idUUID string / summary required

ID UUID unik entitas akun bursa ini (atau 'summary' untuk distribusi portofolio gabungan).

Contoh Permintaan

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

Parameter Respons

codestring

Simbol kode ticker mata uang kripto (misal: BTC, DOGE, USDT).

namestring

Nama tampilan lengkap mata uang kripto (misal: Bitcoin (BTC)).

coinmarketcapidstring

Pengenal unik aset di CoinMarketCap.

percentagenumber

Proporsi persentase dari total nilai portofolio yang dimiliki dalam mata uang ini.

ynumber

Nilai plot sumbu Y pada grafik yang setara dengan proporsi persentase.

amountnumber

Total jumlah koin yang dimiliki dalam akun ini.

btc_valuestring

Total nilai kepemilikan setara yang dihitung dalam BTC.

usd_valuestring

Total nilai kepemilikan setara yang dihitung dalam USD.

account_idUUID string

ID unik entitas akun bursa.

primary_display_currencyobject

Objek berisi nilai kepemilikan yang diformat dalam mata uang utama pengguna.

currencystring

Kode mata uang fiat atau referensi target (misal: USD).

amountstring

Total saldo aset yang dievaluasi dalam mata uang tampilan utama.

Contoh Respons

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"
  }
]

Sebelumnya Hapus akun bursa SelanjutnyaSaldo pengguna untuk visualisasi diagram tabel