Les données de portefeuille Solana en toute simplicité
Une seule API REST pour obtenir les soldes, l’historique, l’identité et les sources de financement des portefeuilles Solana. Aucune méthode JSON-RPC de Solana à mémoriser ni aucun calcul en lamports.
Identifiez le propriétaire d’un portefeuille
Associez une adresse ou un nom de domaine Solana à une identité. Plus de 32 500 libellés et 21,5 millions de tags sont pris en charge.
- Recherche unique ou par lot de 100 adresses maximum
- Résolution des TLD personnalisés SNS et ANS sur le mainnet
- Prise en charge des libellés pour les adresses de plateformes d’échange, les portefeuilles de protocoles, les institutions et les adresses signalées
{
"address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
"type": "exchange",
"name": "Binance 1",
"category": "Centralized Exchange",
"tags": ["Centralized Exchange"]
}
- Recherche unique ou par lot de 100 adresses maximum
- Résolution des TLD personnalisés SNS et ANS sur le mainnet
- Prise en charge des libellés pour les adresses de plateformes d’échange, les portefeuilles de protocoles, les institutions et les adresses signalées
{
"address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
"type": "exchange",
"name": "Binance 1",
"category": "Centralized Exchange",
"tags": ["Centralized Exchange"]
}
Identifiez qui a financé un portefeuille
Découvrez la source de financement initiale d’un portefeuille : qui a envoyé les premiers SOL, quel montant et à quelle date. Le nom et le type du financeur proviennent du même système d’identité.
- Adresse du financeur direct, montant, slot et signature
- Plateforme d’échange, protocole ou source inconnue, avec un libellé lorsque nous l’identifions
- Mise en cache permanente. Le premier financeur d’un portefeuille ne change jamais
{
"funder": "26MAyPNpK4At8LgRECMMbgiKQuJyg3oACtw1Q9FRyuba",
"funderName": null,
"funderType": null,
"mint": "So11111111111111111111111111111111111111111",
"symbol": "SOL",
"amount": 0.09811972,
"amountRaw": "98119720",
"decimals": 9,
"date": "2022-01-19T20:46:34.000Z",
"signature": "5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG",
"timestamp": 1642625194,
"slot": 116984883,
"explorerUrl": "https://orbmarkets.io/tx/5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG?tab=summary"
}
- Adresse du financeur direct, montant, slot et signature
- Plateforme d’échange, protocole ou source inconnue, avec un libellé lorsque nous l’identifions
- Mise en cache permanente. Le premier financeur d’un portefeuille ne change jamais
{
"funder": "26MAyPNpK4At8LgRECMMbgiKQuJyg3oACtw1Q9FRyuba",
"funderName": null,
"funderType": null,
"mint": "So11111111111111111111111111111111111111111",
"symbol": "SOL",
"amount": 0.09811972,
"amountRaw": "98119720",
"decimals": 9,
"date": "2022-01-19T20:46:34.000Z",
"signature": "5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG",
"timestamp": 1642625194,
"slot": 116984883,
"explorerUrl": "https://orbmarkets.io/tx/5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG?tab=summary"
}
L’activité du portefeuille, entièrement analysée
Historique des transactions avec les variations de solde de chaque transaction dans un format lisible.
- Des plus récentes aux plus anciennes, jusqu’à 100 transactions par page
tokenAccounts=balanceChangedpour ne récupérer que les mises à jouramountest déjà ajusté selon les décimales ; aucun calcul en lamports
{
"data": [
{
"signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
"timestamp": 1704067200,
"slot": 250000000,
"fee": 0.000005,
"feePayer": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"error": null,
"balanceChanges": [
{
"mint": "So11111111111111111111111111111111111111111",
"amount": -0.05,
"decimals": 9
}
]
}
],
"pagination": {
"hasMore": true,
"nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
}
}
- Des plus récentes aux plus anciennes, jusqu’à 100 transactions par page
tokenAccounts=balanceChangedpour ne récupérer que les mises à jouramountest déjà ajusté selon les décimales ; aucun calcul en lamports
{
"data": [
{
"signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
"timestamp": 1704067200,
"slot": 250000000,
"fee": 0.000005,
"feePayer": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"error": null,
"balanceChanges": [
{
"mint": "So11111111111111111111111111111111111111111",
"amount": -0.05,
"decimals": 9
}
]
}
],
"pagination": {
"hasMore": true,
"nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
}
}
Déployez ensemble le portefeuille et la couche de données
Ajoutez des portefeuilles intégrés non dépositaires à votre application, avec des options de connexion par clés d’accès, par e-mail et par portefeuilles existants via helius-wallet-kit
Cas d’usage de Wallet API
Tableaux de bord de portefeuilles
Soldes, valeurs en USD et métadonnées en un seul appel REST. Aucun assemblage DAS ni calcul en lamports
Outils de suivi de portefeuille
Utilisez l’historique et balance-at pour reconstituer les actifs détenus et calculer les PnL au fil du temps
Processeurs de paiement
Enregistrez les transactions et les transferts avec la contrepartie, le montant, le mint et la direction
Fiscalité et comptabilité
Obtenez un historique lisible avec les soldes détenus et leurs variations pour chaque transaction
Conformité et lutte contre le blanchiment d’argent
Identifiez les plateformes d’échange et les portefeuilles de trésorerie connus, et découvrez comment les portefeuilles ont été financés
Explorateurs et analyses
Obtenez les tags de plus de 21 millions de portefeuilles pour ajouter des libellés de compte à votre application
Une seule API REST pour toutes les données de portefeuille Solana
1. Obtenez une clé API
Inscrivez-vous, obtenez votre clé API Helius et transmettez api-key dans la chaîne de requête ou dans un en-tête X-Api-Key
2. Appelez un seul chemin REST
GET /v1/wallet/{wallet}/balances, identity, history ou tout autre endpoint de Wallet API
3. Intégrez-le à votre application
Les montants sont ajustés selon les décimales, les identités sont libellées et les données sont correctement formatées ; aucune étape supplémentaire n’est nécessaire
const getWalletBalances = async (address) => {
const url = `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`;
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
const solBalance = data.balances[0]; // SOL is always first when showNative=true
console.log(`SOL Balance: ${solBalance.balance} SOL ($${solBalance.usdValue})`);
console.log(`Page ${data.pagination.page} Total Value: $${data.totalUsdValue}`);
console.log(`Token Count (this page): ${data.balances.length}`);
// Display top holdings
data.balances.slice(0, 5).forEach(token => {
console.log(`${token.symbol}: ${token.balance} ($${token.usdValue || 'N/A'})`);
});
return data;
};
getWalletBalances("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY");1. Obtenez une clé API
Inscrivez-vous, obtenez votre clé API Helius et transmettez api-key dans la chaîne de requête ou dans un en-tête X-Api-Key
2. Appelez un seul chemin REST
GET /v1/wallet/{wallet}/balances, identity, history ou tout autre endpoint de Wallet API
3. Intégrez-le à votre application
Les montants sont ajustés selon les décimales, les identités sont libellées et les données sont correctement formatées ; aucune étape supplémentaire n’est nécessaire
const getWalletBalances = async (address) => {
const url = `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`;
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
const solBalance = data.balances[0]; // SOL is always first when showNative=true
console.log(`SOL Balance: ${solBalance.balance} SOL ($${solBalance.usdValue})`);
console.log(`Page ${data.pagination.page} Total Value: $${data.totalUsdValue}`);
console.log(`Token Count (this page): ${data.balances.length}`);
// Display top holdings
data.balances.slice(0, 5).forEach(token => {
console.log(`${token.symbol}: ${token.balance} ($${token.usdValue || 'N/A'})`);
});
return data;
};
getWalletBalances("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY");FAQ
Trouvez les réponses aux questions fréquentes. Besoin d’aide ou d’une offre personnalisée ? Contactez notre équipe.
Les soldes, le solde historique (balance-at), l’historique et les transferts sont disponibles avec chaque offre, y compris Free. Les endpoints d’identité (individuel et par lot) et funded-by nécessitent une offre payante (Developer ou supérieure) et renvoient 403 avec Free.
Chaque requête Wallet API coûte 100 crédits, y compris l’identification par lot (jusqu’à 100 adresses en un seul appel). Consultez le tableau complet des crédits.
Utilisez balances pour le portefeuille actuel, balance-at pour les actifs détenus à un slot ou à un horodatage passé, history pour un flux d’activité complet avec les variations de solde de chaque transaction, et transfers si vous avez uniquement besoin des paiements envoyés ou reçus avec une contrepartie. Utilisez identity pour attribuer un libellé à une plateforme d’échange, un protocole ou une institution connue, et funded-by pour trouver le portefeuille qui a envoyé les premiers SOL.
Wallet API est le chemin de lecture : obtenez via REST les soldes, l’historique, l’identité et les informations sur le portefeuille financeur. WaaS fournit des portefeuilles intégrés : créez et signez des transactions avec helius-wallet-kit.
WaaS est en bêta et disponible avec toutes les offres payantes (Developer, Business, Professional et Enterprise). Il n’est pas disponible avec Free.
Il n’y a ni abonnement distinct ni frais par utilisateur. Chaque signature coûte 200 crédits (0,001 $ au tarif standard des crédits). La création de portefeuilles est gratuite. signMessage, signTransaction et signAndSendTransaction comptent chacun comme une signature. Une signature est facturée même si la transaction échoue ensuite onchain. Une demande annulée est gratuite. Suivez l’utilisation dans le tableau de bord sous WaaS → Analytics. Consultez les crédits WaaS.
Passez à une offre payante, créez une clé API et installez helius-wallet-kit. Encapsulez votre application dans HeliusWalletProvider et suivez le guide de démarrage rapide WaaS.
Pour commencer, explorez ces ressources :
Les données de portefeuille sans la complexité
Évitez les méthodes JSON-RPC brutes de Solana et commencez à interroger les données de portefeuille onchain en quelques minutes