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é.
Vous vous connectez à Sonar pendant la configuration. Pas encore de compte ? Créez-en un gratuitement.
URL du serveurhttps://sonarfolio.com/api/mcpOuvrez Customize, puis Connectors.
Ouvrir les connecteurs Claude(s’ouvre dans un nouvel onglet)Choisissez + Add, puis Add custom connector. Nommez-le Sonar et collez l’URL du serveur.
Si on vous le demande, choisissez Sign in now et Use Claude's published identity, sans ID ni secret client, puis Add.
Choisissez Connect, connectez-vous et choisissez Autoriser. Dans une conversation, activez-le sous +, puis Connectors.
Quelles sont mes cinq plus grosses positions ?Utilisez ChatGPT sur le web. Les serveurs MCP personnalisés dépendent de votre offre ChatGPT ; sur Business et Enterprise, un administrateur devra peut-être les autoriser.
Vous vous connectez à Sonar pendant la configuration. Pas encore de compte ? Créez-en un gratuitement.
URL du serveurhttps://sonarfolio.com/api/mcpOuvrez Plugins.
Ouvrir les plugins ChatGPT(s’ouvre dans un nouvel onglet)Choisissez +, puis Add custom MCP server. Nommez-le Sonar et collez l’URL du serveur.
Réglez Authentication sur OAuth et laissez vides l’ID et le secret client. Acceptez l’avertissement, puis choisissez Create as a plugin.
Quand on vous le demande, connectez-vous et choisissez Autoriser. Installez-le ensuite depuis vos plugins et tapez @ dans une conversation.
Quelles sont mes cinq plus grosses positions ?ChatGPT demande confirmation avant d’ajouter une position.
Pour les clients à en-tête comme Claude Code et Cursor, avec une clé API.
Créez un compte gratuit, puis une clé. Elle ne s’affiche qu’une fois.
Obtenir votre clé APIAjoutez Sonar à votre client.
Claude Codeclaude mcp add --transport http sonar https://sonarfolio.com/api/mcp \ --header "Authorization: Bearer YOUR_KEY"
Cursor : ~/.cursor/mcp.json{ "mcpServers": { "sonar": { "url": "https://sonarfolio.com/api/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }Autres clients MCP : Streamable HTTP, en-tête Authorization: Bearer YOUR_KEYhttps://sonarfolio.com/api/mcpLancez
/mcpdans Claude Code pour vérifier la connexion.
Ou sans clé : ajoutez l’URL sans l’en-tête, lancez /mcp, choisissez Sonar puis Authenticate.
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.
| Offre | Requêtes incluses | Couvre |
|---|---|---|
| Free | Crédits API uniquement | Prix et portefeuille |
| Starter | 500 par jour | Prix, données sociales et ajout de positions |
| Standard | 1 000 par jour | Ajoute positions, plus/moins-values, répartition et données onchain |
| Premium | 2 000 par jour | Ajoute 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.