> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ikhtisar Wallet API (Beta)

> Kueri data dompet Solana dengan Wallet API. Dapatkan saldo, riwayat transaksi, transfer, informasi identitas, dan sumber dana dalam satu permintaan.

<Note>
  Wallet API masih dalam versi Beta. Endpoint dan format respons dapat berubah.
</Note>

## Apa itu Wallet API?

Wallet API menyediakan endpoint REST tingkat tinggi untuk mengueri data lengkap dompet Solana — saldo, riwayat transaksi, transfer token, resolusi identitas, saldo historis, dan sumber dana. Anda tidak perlu melakukan beberapa panggilan RPC dan mengurai data blockchain mentah. Anda mendapatkan informasi terstruktur yang mudah dibaca beserta harga dalam USD melalui satu permintaan.

API ini dibuat untuk dompet, pelacak portofolio, penjelajah, pemroses pembayaran, alat pajak, serta sistem kepatuhan dan AML. Semua endpoint menggunakan URL dasar `https://api.helius.xyz` dan mengembalikan jumlah dalam unit yang mudah dibaca (tidak perlu konversi lamport).

## Mengapa menggunakan Helius untuk data dompet?

<CardGroup cols={2}>
  <Card title="One REST call" icon="bolt">
    Saldo, riwayat, dan transfer terstruktur tanpa perlu menggabungkan respons
    RPC mentah.
  </Card>

  <Card title="USD pricing built in" icon="dollar-sign">
    Saldo token mencakup nilai dalam USD dan total portofolio yang bersumber dari DAS.
  </Card>

  <Card title="Identity resolution" icon="address-card">
    Lebih dari 32.500 akun dan program berlabel serta lebih dari 21,5 juta tag kategori untuk
    bursa, protokol, dan institusi.
  </Card>

  <Card title="Human-readable output" icon="book-open">
    Data jelas yang telah disesuaikan dengan jumlah desimal, bukan lamport dan instruksi mentah.
  </Card>
</CardGroup>

## Endpoint utama

<CardGroup cols={2}>
  <Card title="Wallet Identity" icon="address-card" href="/docs/id/wallet-api/identity">
    Identifikasi dompet yang dikenal berdasarkan alamat atau domain SNS/ANS — bursa, protokol,
    dan institusi.
  </Card>

  <Card title="Wallet Balances" icon="scale-balanced" href="/docs/id/wallet-api/balances">
    Semua saldo token dan NFT beserta nilai dalam USD, logo, dan metadata.
  </Card>

  <Card title="Historical Balance" icon="clock" href="/docs/id/wallet-api/balance-at">
    Saldo token atau SOL pada stempel waktu, waktu-tanggal, atau slot sebelumnya.
  </Card>

  <Card title="Wallet History" icon="clock-rotate-left" href="/docs/id/wallet-api/history">
    Riwayat transaksi lengkap beserta perubahan saldo untuk setiap transaksi.
  </Card>

  <Card title="Token Transfers" icon="arrow-right-arrow-left" href="/docs/id/wallet-api/transfers">
    Semua transfer masuk dan keluar beserta informasi pengirim/penerima.
  </Card>

  <Card title="Funding Source" icon="money-bill-transfer" href="/docs/id/wallet-api/funded-by">
    Sumber dana awal suatu dompet, yang dilacak hingga SOL pertama yang masuk.
  </Card>
</CardGroup>

## Endpoint mana yang harus saya gunakan?

| Yang Anda perlukan                        | Gunakan                                     | Hasil                                                                    |
| ----------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------ |
| Identitas dompet (bursa, protokol, label) | [Identitas](/docs/id/wallet-api/identity)        | Nama, kategori, dan tag untuk alamat yang dikenal                        |
| Portofolio dompet saat ini                | [Saldo](/docs/id/wallet-api/balances)            | Semua token dan NFT beserta nilai dalam USD                              |
| Saldo pada waktu sebelumnya               | [Saldo Historis](/docs/id/wallet-api/balance-at) | Saldo satu token atau SOL pada stempel waktu/waktu-tanggal/slot tertentu |
| Aktivitas transaksi lengkap               | [Riwayat](/docs/id/wallet-api/history)           | Transaksi terurai beserta perubahan saldo per transaksi                  |
| Hanya transfer terkirim/diterima          | [Transfer](/docs/id/wallet-api/transfers)        | Tampilan tingkat transfer beserta pihak lawan dan arah                   |
| Asal dana dompet                          | [Sumber Dana](/docs/id/wallet-api/funded-by)     | Transfer SOL pertama yang masuk dan pengirimnya                          |

Referensi singkat rute yang mendasarinya (URL dasar `https://api.helius.xyz`):

* `GET /v1/wallet/{wallet}/identity` — dapatkan identitas dompet berdasarkan alamat atau domain SNS/ANS
* `POST /v1/wallet/batch-identity` — pencarian identitas secara batch (hingga 100 alamat dan/atau domain)
* `GET /v1/wallet/{wallet}/balances` — dapatkan semua saldo token dan NFT
* `GET /v1/wallet/{wallet}/balance-at` — dapatkan saldo token atau SOL pada stempel waktu, waktu-tanggal, atau slot sebelumnya
* `GET /v1/wallet/{wallet}/history` — dapatkan riwayat transaksi beserta perubahan saldo
* `GET /v1/wallet/{wallet}/transfers` — dapatkan semua aktivitas transfer token
* `GET /v1/wallet/{wallet}/funded-by` — temukan sumber dana awal

## Autentikasi

Semua permintaan Wallet API memerlukan kunci API. Anda dapat meneruskannya sebagai parameter kueri atau header:

<Tabs>
  <Tab title="Query Parameter">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=YOUR_API_KEY"
    ```
  </Tab>

  <Tab title="Header">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances" \
      -H "X-Api-Key: YOUR_API_KEY"
    ```
  </Tab>
</Tabs>

## Persyaratan paket

Endpoint identitas dan sumber dana memerlukan paket berbayar. Pada paket Gratis, permintaan ke endpoint ini mengembalikan `403 Forbidden`. Semua endpoint lainnya tersedia di semua paket, termasuk Gratis.

| Endpoint                             | Paket Gratis                 |
| ------------------------------------ | ---------------------------- |
| `GET /v1/wallet/{wallet}/identity`   | `403` — hanya paket berbayar |
| `POST /v1/wallet/batch-identity`     | `403` — hanya paket berbayar |
| `GET /v1/wallet/{wallet}/funded-by`  | `403` — hanya paket berbayar |
| `GET /v1/wallet/{wallet}/balances`   | Tersedia                     |
| `GET /v1/wallet/{wallet}/balance-at` | Tersedia                     |
| `GET /v1/wallet/{wallet}/history`    | Tersedia                     |
| `GET /v1/wallet/{wallet}/transfers`  | Tersedia                     |

Semua tingkat berbayar membuka akses ke endpoint terbatas — Developer, Business, dan setiap tingkat yang lebih tinggi (seperti Enterprise). Untuk mengaktifkan pencarian identitas dan sumber dana, [tingkatkan paket Anda di dasbor](https://dashboard.helius.dev).

## Jumlah dan unit

Wallet API merupakan abstraksi tingkat tinggi di atas data mentah Solana. Semua bidang `amount` dalam respons **mudah dibaca** — nilainya telah dibagi dengan `decimals` token — sehingga Anda dapat langsung menampilkannya tanpa konversi. Panggilan RPC Solana mentah mengembalikan nilai dalam lamport (unit terkecil, 10⁻⁹ SOL), sedangkan Wallet API tidak. `"amount": 1.5` berarti 1,5 SOL, bukan 1,5 lamport.

Jika aritmetika presisi diperlukan, beberapa endpoint juga menyediakan `amountRaw`: nilai yang sama sebagai bilangan bulat mentah yang diserialisasi sebagai string untuk menghindari hilangnya presisi bilangan titik mengambang. Rumus konversinya adalah:

`amount = parseInt(amountRaw) / 10**decimals`

| Endpoint                       | `amount` yang mudah dibaca            | String `amountRaw` mentah |
| ------------------------------ | ------------------------------------- | ------------------------- |
| **Saldo**                      | Bidang `balance`                      | Tidak tersedia            |
| **Saldo historis**             | Bidang `balance` (**string** desimal) | Bidang `balanceRaw`       |
| **Sumber dana**                | Bidang `amount`                       | Bidang `amountRaw`        |
| **Transfer**                   | Bidang `amount`                       | Bidang `amountRaw`        |
| **Riwayat** (`balanceChanges`) | Bidang `amount`                       | Tidak tersedia            |

Gunakan `amount` untuk tampilan. Gunakan `amountRaw` saat meneruskan nilai ke instruksi on-chain atau sistem lain yang memerlukan aritmetika bilangan bulat presisi.

## Mulai

<Steps>
  <Step title="Get your API key">
    Daftar di [dashboard.helius.dev](https://dashboard.helius.dev) untuk mendapatkan kunci API Anda.
  </Step>

  <Step title="Choose your endpoint">
    Gunakan tabel di atas untuk memilih endpoint yang sesuai dengan kasus penggunaan Anda.
  </Step>

  <Step title="Make your first request">
    Mulai dengan kueri saldo sederhana:

    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"
    ```
  </Step>

  <Step title="Handle the response">
    Urai respons JSON dan tampilkan datanya dalam aplikasi Anda.
  </Step>
</Steps>

## Langkah berikutnya

<CardGroup cols={3}>
  <Card title="Getting Data" icon="database" href="/docs/id/getting-data">
    Jelajahi semua cara untuk mengueri data Solana di Helius.
  </Card>

  <Card title="API Reference" icon="code" href="/docs/id/api-reference/wallet-api">
    Skema permintaan dan respons untuk semua endpoint Wallet API.
  </Card>

  <Card title="Contact Support" icon="headset" href="/docs/id/support/contact-support">
    Dapatkan bantuan melalui Discord, obrolan, atau email.
  </Card>
</CardGroup>