Entwickler

Nutze dein Portfolio in KI-Assistenten, im Terminal oder in deinem eigenen Code. Alles hat nur Lesezugriff und deckt nur Assets ab, die du hältst.

Deinen KI-Assistenten verbinden

Frag Claude, ChatGPT, Claude Code oder Cursor nach deinen Beständen, oder füge eine Position im Chat hinzu.

Funktioniert in jedem Claude-Plan, im Web, auf dem Desktop und mobil. Der kostenlose Plan enthält einen eigenen Connector.

  1. Du meldest dich bei der Einrichtung bei Sonar an. Noch kein Konto? Erstelle eins kostenlos.

    Server-URL
    https://sonarfolio.com/api/mcp
  2. Wähle + Add und dann Add custom connector. Nenne ihn Sonar und füge die Server-URL ein.

  3. Falls gefragt, wähle Sign in now und Use Claude's published identity, ohne Client-ID und Secret, dann Add.

  4. Wähle Connect, melde dich an und wähle Zulassen. Schalte ihn in einem Chat unter + und dann Connectors ein.

Teste es: Frag deinen Assistenten
Was sind meine fünf größten Positionen?

Connectors sehen nur Assets, die du hältst. Sie können Positionen hinzufügen, die du beschreibst, aber nicht handeln, keine Gelder bewegen und nichts löschen.

Hilfe bei Problemen

Keine Verbindung oder keine Tools sichtbar

Prüfe, ob die URL auf /api/mcp endet und die Anmeldung mit Zulassen abgeschlossen wurde. Sonst entferne Sonar und füge es neu hinzu.

Der Assistent sagt, ein Plan oder Credits seien nötig

Dein Plan legt fest, was der Assistent sieht; jeder Tool-Aufruf ist eine Anfrage. Anfragen und Credits siehst du unter API und KI-Tools.

Du hast eine App getrennt oder einen Schlüssel widerrufen

Der Zugriff endet sofort. Um dich neu zu verbinden, entferne Sonar, füge es neu hinzu und melde dich an.

Du nutzt Claude mit einem Team- oder Enterprise-Plan

Ein Owner fügt Sonar einmal mit der Server-URL hinzu; jedes Mitglied meldet sich bei seinem eigenen Konto an.

REST API

JSON über HTTPS mit Bearer-Schlüssel. Zu jedem Endpunkt gibt es ein passendes MCP-Tool und einen CLI-Befehl.

curl https://sonarfolio.com/api/v1/assets \
  -H "Authorization: Bearer YOUR_KEY"
  • GET/api/v1/meMCPget_usageCLIsonar statusPlan, Zugang und heutige NutzungStarter
  • GET/api/v1/assetsMCPlist_held_assetsCLIsonar assetsMarkt- und Social-Daten zu jedem gehaltenen AssetStarter
  • GET/api/v1/assets/{id}MCPget_assetCLIsonar asset <SYMBOL>Ein gehaltenes Asset: Kurs, Social, Top-Creator, Schlusskurse der letzten 90 TageStarter
  • GET/api/v1/assets/search?q=MCPsearch_assetsCLIsonar search <QUERY>Eine Asset-ID finden (nur Namen)Starter
  • GET/api/v1/portfolioMCPget_portfolioCLIsonar portfolioSummen, 24h-Änderung, G/V, Allokation, Top-BewegungenStandard
  • GET/api/v1/holdingsMCPlist_holdingsCLIsonar holdings [--account NAME]Jeder Bestand pro KontoStandard
  • POST/api/v1/holdingsMCPadd_positionCLIsonar add <SYMBOL> <QUANTITY> [--cost --date --account]Eine Position hinzufügen: { asset_id, quantity, cost_usd?, date?, account? }Schreibt Daten. MCP-Clients sehen es als destruktiv markiert; die CLI fragt vorher nach (--yes überspringt das).Starter

Antworten enthalten Quelle, Zeitstempel und unseren Haftungsausschluss, dazu die Header X-RateLimit-Limit, -Remaining, -Reset und X-Credits-Remaining. Fehler: { error: { code, message } }.

Kommandozeile

Dieselben Daten im Terminal und in Skripten, mit demselben Schlüssel.

Installieren und anmelden

npm install -g sonarfolio
sonar login

Benötigt Node 18 oder neuer. sonar login speichert einen Schlüssel aus API und KI-Tools; in Skripten und CI setze stattdessen SONAR_API_KEY.

Weitere Installationsoptionen

Zum Aktualisieren die Installation erneut ausführen. Ohne Installation testen: npx -p sonarfolio sonar status. Von dieser Seite installieren: npm install -g https://sonarfolio.com/cli/latest.tgz. Dein Schlüssel wird in ~/.config/sonar/config.json gespeichert, nur für dich lesbar.

Befehle

Die Befehle stehen bei den REST-Endpunkten, dazu sonar watch [portfolio|assets] für eine Live-Ansicht im Rahmen deines Tageslimits.

In Skripten

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

Jeder Befehl akzeptiert --json und gibt das JSON der API aus.

Limits und Credits

Jeder API-Aufruf, MCP-Tool-Aufruf oder CLI-Befehl ist eine Anfrage. Tageslimits setzen sich um 00:00 UTC zurück.

PlanEnthaltene AnfragenUmfang
FreeNur API-CreditsPreise und dein Portfolio
Starter500 pro TagPreise, Social-Daten und Positionen hinzufügen
Standard1.000 pro TagDazu Bestände, G/V, Allokation und Onchain-Daten
Premium2.000 pro TagDazu Bestände, G/V, Allokation und Onchain-Daten

Plannamen in der Endpunktliste zeigen, wo eine Anfrage enthalten ist; sonst bezahlen API-Credits, in jedem Plan. $1 kosten 1.000, Credits verfallen nie, und jedes Konto startet mit 100.