Développeurs

Utilisez votre portefeuille depuis vos assistants IA, le terminal ou votre propre code. Tout est en lecture seule et ne couvre que les actifs que vous détenez.

Connecter votre assistant IA

Interrogez Claude, ChatGPT, Claude Code ou Cursor sur vos positions, ou ajoutez-en une en discutant.

Fonctionne avec toutes les offres Claude, sur le web, sur ordinateur et sur mobile. L’offre gratuite inclut un connecteur personnalisé.

  1. Vous vous connectez à Sonar pendant la configuration. Pas encore de compte ? Créez-en un gratuitement.

    URL du serveur
    https://sonarfolio.com/api/mcp
  2. Choisissez + Add, puis Add custom connector. Nommez-le Sonar et collez l’URL du serveur.

  3. Si on vous le demande, choisissez Sign in now et Use Claude's published identity, sans ID ni secret client, puis Add.

  4. Choisissez Connect, connectez-vous et choisissez Autoriser. Dans une conversation, activez-le sous +, puis Connectors.

Testez : demandez à votre assistant
Quelles sont mes cinq plus grosses positions ?

Les connecteurs ne voient que les actifs que vous détenez. Ils peuvent ajouter les positions que vous décrivez, mais ni négocier, ni déplacer de fonds, ni rien supprimer.

Dépannage

La connexion échoue ou aucun outil n’apparaît

Vérifiez que l’URL se termine par /api/mcp et que la connexion s’est terminée par Autoriser. Sinon, retirez Sonar et ajoutez-le de nouveau.

L’assistant indique qu’une offre ou des crédits sont nécessaires

Votre offre définit ce que voit l’assistant ; chaque appel d’outil compte pour une requête. Consultez requêtes et crédits dans API et outils d’IA.

Vous avez déconnecté une app ou révoqué une clé

L’accès s’arrête aussitôt. Pour vous reconnecter, retirez Sonar, ajoutez-le de nouveau et connectez-vous.

Vous utilisez Claude avec une offre Team ou Enterprise

Un propriétaire ajoute Sonar une fois avec l’URL du serveur ; chaque membre se connecte à son propre compte.

API REST

Du JSON sur HTTPS avec une clé Bearer. Chaque point de terminaison a son outil MCP et sa commande CLI.

curl https://sonarfolio.com/api/v1/assets \
  -H "Authorization: Bearer YOUR_KEY"
  • GET/api/v1/meMCPget_usageCLIsonar statusForfait, accès et utilisation du jourStarter
  • GET/api/v1/assetsMCPlist_held_assetsCLIsonar assetsDonnées de marché et sociales de chaque actif détenuStarter
  • GET/api/v1/assets/{id}MCPget_assetCLIsonar asset <SYMBOL>Un actif détenu : cotation, social, principaux créateurs, clôtures sur 90 joursStarter
  • GET/api/v1/assets/search?q=MCPsearch_assetsCLIsonar search <QUERY>Trouver l’identifiant d’un actif (noms uniquement)Starter
  • GET/api/v1/portfolioMCPget_portfolioCLIsonar portfolioTotaux, variation sur 24 h, plus/moins-values, répartition, plus fortes variationsStandard
  • GET/api/v1/holdingsMCPlist_holdingsCLIsonar holdings [--account NAME]Chaque position par compteStandard
  • POST/api/v1/holdingsMCPadd_positionCLIsonar add <SYMBOL> <QUANTITY> [--cost --date --account]Ajouter une position : { asset_id, quantity, cost_usd?, date?, account? }Écrit des données. Les clients MCP le voient marqué comme destructif ; la CLI demande d’abord (--yes passe la question).Starter

Les réponses incluent source, horodatages et notre avertissement, ainsi que les en-têtes X-RateLimit-Limit, -Remaining, -Reset et X-Credits-Remaining. Erreurs : { error: { code, message } }.

Ligne de commande

Les mêmes données dans votre terminal et vos scripts, avec la même clé.

Installer et se connecter

npm install -g sonarfolio
sonar login

Nécessite Node 18 ou plus récent. sonar login enregistre une clé depuis API et outils d’IA ; dans les scripts et la CI, définissez plutôt SONAR_API_KEY.

Autres options d’installation

Relancez l’installation pour mettre à jour. Essayez sans installer : npx -p sonarfolio sonar status. Installez depuis ce site : npm install -g https://sonarfolio.com/cli/latest.tgz. Votre clé est enregistrée dans ~/.config/sonar/config.json, lisible par vous seul.

Commandes

Les commandes figurent avec les points de terminaison REST, plus sonar watch [portfolio|assets] pour une vue en direct dans votre limite quotidienne.

Dans les scripts

sonar holdings --json | jq '.holdings[] | {symbol, value_usd}'

Chaque commande accepte --json et affiche le JSON de l’API.

Limites et crédits

Chaque appel API, appel d’outil MCP ou commande CLI compte pour une requête. Les limites quotidiennes repartent à 00:00 UTC.

OffreRequêtes inclusesCouvre
FreeCrédits API uniquementPrix et portefeuille
Starter500 par jourPrix, données sociales et ajout de positions
Standard1 000 par jourAjoute positions, plus/moins-values, répartition et données onchain
Premium2 000 par jourAjoute positions, plus/moins-values, répartition et données onchain

Les noms d’offre dans la liste des points de terminaison indiquent où une requête est incluse ; ailleurs, les crédits API paient, avec toutes les offres. $1 pour 1 000, sans expiration, et chaque compte démarre avec 100.