API Token Fungibel Solana: Akses Lengkap ke Data Token

Gambaran umum

Awalnya, DAS API hanya mendukung kueri kepemilikan untuk NFT dan cNFT Metaplex. Helius telah memperluas DAS API agar mendukung semua token, termasuk token SPL biasa (tanpa metadata) dan Token-2022 (beserta ekstensinya). Anda dapat mengueri saldo token dari akun mana pun di seluruh jenis token (SPL, Token-2022, NFT, dan NFT terkompresi), termasuk harga token dalam USD. Token Solana ditentukan oleh akun mint-nya. Misalnya, akun mint untuk USDC adalah EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v. Saat Anda membeli USDC senilai $40, akun token yang menyimpan 40 token USDC akan dibuat. Sebuah dompet dapat menyimpan ratusan akun token untuk berbagai token. Untuk mempelajari lebih lanjut tentang Token-2022, lihat postingan blog Helius.

Kapan menggunakannya

Gunakan ekstensi token fungibel saat Anda menginginkan tampilan terpadu atas aset suatu akun — token fungibel, NFT, dan NFT terkompresi — dalam satu panggilan DAS, lengkap dengan metadata dan harga USD. Ekstensi ini merupakan pilihan yang tepat untuk pelacak portofolio, dompet, dan dasbor token. Gunakan metode token RPC standar (getTokenAccountBalance, getTokenAccountsByOwner, getTokenSupply, getTokenLargestAccounts) jika Anda hanya memerlukan nilai mentah on-chain — saldo satu akun, total pasokan, atau pemegang terbesar — tanpa metadata atau harga. Lihat panduan Mendapatkan Token SPL untuk metode tersebut.

Cara kerjanya

Ekstensi Helius untuk token fungibel berfokus pada pengindeksan kepemilikan. Metode berikut memberikan tampilan terpadu atas aset suatu akun: getAsset, getAssetsByOwner, dan searchAssets. Ekstensi ini menambahkan bidang tambahan bernama tokenType, yang memungkinkan Anda mengueri semua aset milik akun tersebut, termasuk token fungibel dan Token-2022. Opsi untuk tokenType adalah:

fungible: Mengembalikan semua token fungibel.
nonFungible: Mengembalikan semua NFT (NFT terkompresi dan reguler).
regularNft: Hanya mengembalikan NFT reguler.
compressedNft: Hanya mengembalikan NFT terkompresi.
all: Mengembalikan semua token.

Contoh permintaan:

{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze",
        "tokenType": "all"
    }
}

Respons kini mencakup token fungibel seperti JitoSOL. Setiap item berisi total saldo akun, alamat program token, alamat token terkait, total pasokan yang beredar, dan informasi harga. Item ringkas di bawah ini menampilkan bidang yang relevan:

{
    "id": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
    "content": {
        "$schema": "",
        "json_uri": "",
        "metadata": {
            "description": "MEV-Powered Liquid Staking Derivative",
            "name": "Jito Staked SOL",
            "symbol": "JitoSOL",
            "token_standard": "Fungible"
        }
        // ...
    },
    "token_info": {
        "symbol": "JitoSOL",
        "balance": 35688813508,
        "supply": 5949594702758293,
        "decimals": 9,
        "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        "associated_token_address": "H7iLu4DPFpzEx1AGN8BCN7Qg966YFndt781p6ukhgki9",
        "price_info": {
            "price_per_token": 56.47943,
            "total_price": 2015.6838854339217,
            "currency": "USDC"
        }
    }
    // ...
}

Dukungan Token-2022

Helius mendukung token Token-2022 dan mengurai ekstensinya. Respons mencakup bidang mint_extensions jika token menggunakan program Token-2022. Item ringkas di bawah ini menampilkan bidang mint_extensions untuk BERN:

{
    "mint_extensions": {
        "transfer_fee_config": {
            "withheld_amount": 0,
            "newer_transfer_fee": {
                "epoch": 457,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 690
            },
            "older_transfer_fee": {
                "epoch": 455,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 0
            },
            "withdraw_withheld_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD",
            "transfer_fee_config_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD"
        }
    }
    // ...
}

Kompatibilitas mundur

Untuk kompatibilitas mundur, perilakunya identik dengan DAS asli jika tokenType tidak disertakan: hanya NFT dan NFT terkompresi yang dikembalikan.

{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze"
    }
}

Langkah berikutnya

Get SPL Tokens

Saldo, pasokan, pemegang, dan akun token.

Search Assets

Filter berdasarkan tokenType, pemilik, dan koleksi.

searchAssets reference

Skema lengkap untuk permintaan dan respons.

Memulai

Streaming Data & Pemantauan Peristiwa

API Data & RPC

Perdagangan

Mengirim Transaksi

Dompet sebagai Layanan

Privasi

Sumber Daya

API Token Fungibel Solana: Akses Lengkap ke Data Token

Gambaran umum

Kapan menggunakannya

Cara kerjanya

Dukungan Token-2022

Kompatibilitas mundur

Langkah berikutnya

Get SPL Tokens

Search Assets

searchAssets reference

​Gambaran umum

​Kapan menggunakannya

​Cara kerjanya

​Dukungan Token-2022

​Kompatibilitas mundur

​Langkah berikutnya

Get SPL Tokens

Search Assets

searchAssets reference

Gambaran umum

Kapan menggunakannya

Cara kerjanya

Dukungan Token-2022

Kompatibilitas mundur

Langkah berikutnya