API-Dokumentation

Schnellstart

Von null zur ersten Antwort in fünf Minuten. Sie brauchen einen für Ihren Arbeitsbereich freigeschalteten API-Zugang (siehe Schlüssel und Zugangsverwaltung) und Administratorrechte im Dashboard.

Der schnellste Weg überhaupt ist MCP: Tragen Sie https://mcp.stonewake.ai/ und Ihren Schlüssel in den Connector oder die MCP-Einstellungen Ihres KI-Assistenten ein und stellen Sie Ihre Fragen. Der Rest dieser Seite ist der Weg über curl.

1. Einen Schlüssel anlegen

Im Dashboard unter den Einstellungen des Arbeitsbereichs oder über die API legt eine Administratorin oder ein Administrator einen API-Schlüssel an und kopiert den vollständigen Schlüssel bei der Erstellung. Er wird genau einmal angezeigt und lässt sich später nicht mehr abrufen. Hinterlegen Sie ihn in einer Umgebungsvariablen:

bash

export STONEWAKE_API_KEY="swk_live_EXAMPLExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Der Wert oben ist ein Platzhalter; verwenden Sie Ihren eigenen Schlüssel.

2. Die API aufrufen

Senden Sie den Schlüssel als Bearer-Token im Header Authorization:

bash

curl https://api.stonewake.ai/v1/portfolio \
  -H "Authorization: Bearer $STONEWAKE_API_KEY"

3. Das JSON auswerten

Jeder Endpunkt antwortet mit reinem JSON, also funktioniert jedes JSON-Werkzeug:

bash

curl -s https://api.stonewake.ai/v1/portfolio \
  -H "Authorization: Bearer $STONEWAKE_API_KEY" | jq .

Ein 401 an dieser Stelle bedeutet, dass der Schlüssel nicht akzeptiert wurde; die Antwort nennt keinen Grund, siehe Authentifizierung. Ein 403 oder 429 ist unter Fehler und Anfragebegrenzungen erklärt. Die aktiven Endpunkte stehen in der API-Referenz.

Für KI-Agenten

Spricht der Agent MCP, verbinden Sie ihn stattdessen mit https://mcp.stonewake.ai/, siehe MCP. Für einen Agenten, der schlicht HTTP spricht, fügen Sie dies in seinen Kontext ein:

text

Stonewake API
Base URL: https://api.stonewake.ai
Auth: send an API key on every request as "Authorization: Bearer <key>".
Keys start with swk_live_ and are read-only.
Endpoints: read-only GETs under /v1 (portfolio, entity risk, rubrics,
registry, search, company nodes, financing, ownership, screenings,
deals, monitoring, countries, geography, watches, runs) plus
POST /v1/citations/resolve, all listed at
https://docs.stonewake.ai/v1.md
List endpoints page with limit/offset and answer
{items, limit, offset, total}.
MCP endpoint (same Bearer key): https://mcp.stonewake.ai/
Docs: https://docs.stonewake.ai
Docs index for machines: https://docs.stonewake.ai/llms.txt
Full docs as one file: https://docs.stonewake.ai/llms-full.txt
Every docs page is also plain markdown: request its path plus ".md",
or send "Accept: text/markdown".
Company site: every public page on https://stonewake.ai answers as
markdown the same two ways, and https://stonewake.ai/llms.txt says
when to use Stonewake and how to call it.
Shortcuts: https://stonewake.ai/docs, /developers, /api-docs, /mcp,
and /openapi.json redirect to these docs, the API reference, the MCP
page, and the OpenAPI schema.
Errors: 4xx bodies are JSON with a stable error.code; 401 means the
credential was refused (no reason is given). Traffic refusals:
rate_limited, daily_quota_exceeded, quota_unavailable.
Rate limits: every /v1 response carries RateLimit-Policy (the
ceilings: q requests per w seconds); keyed responses add RateLimit
(r requests left, t seconds to the reset).
Respect Retry-After on 429 responses.