> ## 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.

# Dapatkan Identitas Dompet

> Temukan informasi identitas on-chain untuk dompet Solana, termasuk nama domain dan profil sosial.

Setiap permintaan dikenai biaya **100 kredit**.

Memerlukan paket berbayar. Permintaan dari paket gratis akan mengembalikan `403 Forbidden`.

## Parameter Permintaan

<ParamField body="wallet" type="string" required default="GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz">
  Alamat dompet Solana (dikodekan dengan base58) atau nama domain SNS/ANS (misalnya `toly.sol`,
  `miester.bonk`). Resolusi domain hanya tersedia di mainnet. Setiap domain non-`.sol` dianggap
  sebagai TLD kustom ANS — tidak ada daftar TLD yang diizinkan secara tetap.
</ParamField>


## OpenAPI

````yaml id/openapi/wallet-api/openapi.yaml GET /v1/wallet/{wallet}/identity
openapi: 3.0.3
info:
  title: Wallet API
  description: >
    REST API berkinerja tinggi untuk mengkueri data dompet Solana, termasuk
    saldo, riwayat transaksi, transfer, dan informasi identitas.


    ## Autentikasi


    Semua permintaan memerlukan kunci API yang diteruskan sebagai:

    - Parameter kueri: `?api-key=YOUR_API_KEY`

    - Header: `X-Api-Key: YOUR_API_KEY`
  version: 1.0.0
  contact:
    name: Dukungan API
    url: https://helius.dev
servers:
  - url: https://api.helius.xyz
    description: Server produksi
security:
  - ApiKeyQuery: []
  - ApiKeyHeader: []
tags:
  - name: Identitas
    description: Cari identitas dompet dan alamat yang dikenal
  - name: Saldo
    description: Kueri saldo token dan NFT
  - name: Riwayat
    description: Riwayat transaksi dan perubahan saldo
  - name: Transfer
    description: Aktivitas transfer token
  - name: Pendanaan
    description: Informasi pendanaan dompet
paths:
  /v1/wallet/{wallet}/identity:
    get:
      tags:
        - Identitas
      summary: Dapatkan identitas dompet
      description: >
        Ambil informasi identitas untuk dompet yang dikenal (bursa, protokol,
        dan sebagainya). Menerima

        alamat dompet Solana atau nama domain TLD khusus SNS (`.sol`) / ANS

        (misalnya `toly.sol`, `miester.bonk`). Resolusi domain hanya tersedia di
        mainnet.


        Respons adalah objek identitas standar untuk **alamat yang telah
        diresolusi**. Tidak ada penanda

        domain (`inputDomain`) yang disertakan pada endpoint ini — gunakan `POST
        /v1/wallet/batch-identity`

        jika Anda perlu menghubungkan input dengan output.


        Mengembalikan `404` jika dompet tidak memiliki entri identitas atau jika
        input domain tidak dapat diresolusi.

        Mengembalikan `400` jika input bukan alamat yang valid maupun nama
        domain yang valid, atau jika

        input domain dikirim pada deployment non-mainnet.
      operationId: getWalletIdentity
      parameters:
        - $ref: '#/components/parameters/WalletOrDomain'
      responses:
        '200':
          description: Informasi identitas ditemukan
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Identity'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: >-
            Tidak tersedia informasi identitas atau domain tidak dapat
            diresolusi
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  parameters:
    WalletOrDomain:
      name: wallet
      in: path
      required: true
      description: >
        Alamat dompet Solana (dikodekan dengan base58) atau nama domain SNS/ANS
        (misalnya `toly.sol`,

        `miester.bonk`). Resolusi domain hanya tersedia di mainnet. Semua domain
        selain `.sol` diperlakukan

        sebagai TLD khusus ANS — tidak ada daftar putih TLD tetap.
      schema:
        type: string
        default: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
      examples:
        address:
          summary: Alamat Solana
          value: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
        snsDomain:
          summary: Domain SNS (.sol)
          value: toly.sol
        ansDomain:
          summary: TLD khusus ANS
          value: miester.bonk
  schemas:
    Identity:
      type: object
      properties:
        address:
          type: string
          description: Alamat dompet Solana
          example: HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664
        type:
          type: string
          description: Jenis entitas
          example: exchange
        name:
          type: string
          description: Nama tampilan
          example: Binance 1
        category:
          type: string
          description: Klasifikasi kategori
          example: Bursa Terpusat
        tags:
          type: array
          items:
            type: string
          description: Tag klasifikasi tambahan
          example:
            - Bursa Terpusat
        domainNames:
          type: array
          items:
            type: string
          description: >-
            Semua nama domain on-chain yang dimiliki alamat ini, termasuk SNS
            (.sol) dan TLD khusus ANS (.bonk, .wen, dan sebagainya). Domain .sol
            favorit ditempatkan paling awal jika ditetapkan; domain lainnya
            diurutkan menurut abjad. Dihilangkan jika dompet tidak memiliki
            domain.
          example:
            - toly.sol
            - kash.superteam
      required:
        - address
        - type
        - name
        - category
        - tags
    Error:
      type: object
      properties:
        error:
          type: string
          description: Pesan kesalahan
          example: Alamat dompet tidak valid
        code:
          type: integer
          description: Kode status HTTP
          example: 400
        details:
          type: string
          description: Detail kesalahan tambahan
          example: '''invalid-address'' bukan alamat Solana yang valid'
      required:
        - error
        - code
  responses:
    BadRequest:
      description: Parameter permintaan tidak valid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Alamat dompet tidak valid
            code: 400
            details: '''invalid-address'' bukan alamat Solana yang valid'
    Unauthorized:
      description: Kunci API tidak ada atau tidak valid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: >-
              Kunci API diperlukan. Teruskan melalui ?api-key=xxx atau header
              X-Api-Key
            code: 401
    RateLimited:
      description: Batas laju terlampaui.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: RATE_LIMIT_EXCEEDED
            code: 429
            details: Terlalu banyak permintaan. Coba lagi setelah 2 detik.
    InternalError:
      description: >-
        Kesalahan server sementara. Dapat dicoba ulang dengan backoff
        eksponensial.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: INTERNAL_ERROR
            code: 500
            details: Terjadi kesalahan yang tidak terduga. Silakan coba lagi.
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Kunci API yang diteruskan sebagai parameter kueri
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-Api-Key
      description: Kunci API yang diteruskan dalam header permintaan

````