API-Referenz

PickSkill API-Dokumentation

Alles, was Sie für die PickSkill-REST-API brauchen: Basis-URL, Authentifizierung, Credits, Fehler und jeder Endpunkt mit Beispielen.

API-Schlüssel erstellenhttps://pickskill.ai/api/v1

Überblick

Die API besteht aus wenigen schreibgeschützten JSON-Endpunkten über HTTPS. Ticker verwenden das Yahoo-Format: NVDA, BRK-B, 0700.HK, 600519.SS, 300750.SZ.

Basis-URL
https://pickskill.ai/api/v1
Antwortformat
Ein erfolgreicher Aufruf liefert HTTP 200 mit data und credits. Jedes Datenobjekt enthält einen Hinweis: PickSkill-Daten dienen der Recherche und Bildung und sind keine Anlageberatung.

Authentifizierung

Erstellen Sie in Ihrem API-Dashboard einen Schlüssel und senden Sie ihn im Authorization-Header als Bearer-Token (oder im Header x-api-key). Schlüssel beginnen mit psk_. Halten Sie sie geheim; Sie können jeden Schlüssel jederzeit widerrufen.

Authorization: Bearer psk_…
# or
x-api-key: psk_…
API-Schlüssel erstellen

Credits

Jeder erfolgreiche Aufruf verbraucht Credits aus Ihrem Prepaid-Guthaben; fehlgeschlagene Aufrufe werden erstattet. Jedes Konto startet mit 100 kostenlosen Credits, und API und MCP-Server teilen sich ein Guthaben.

GET/signals1
POST/screen3
GET/earnings2
GET/portfolios1
GET/creditskostenlos

Jede Antwort nennt die verbrauchten und verbleibenden Credits im Body sowie in den Headern X-Credits-Charged und X-Credits-Remaining.

Fehler

Fehler liefern einen JSON-Body mit Fehlercode, Meldung und einem Link zu dieser Dokumentation.

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough API credits: this call needs 3, your balance is 2. …",
    "docs": "https://pickskill.ai/data-api/docs"
  },
  "credits": { "remaining": 2 }
}
StatusCodeBedeutung
400invalid_inputUngültige Eingabe – etwa ein fehlender Ticker oder eine fehlerhafte Screening-Bedingung. Wird erstattet.
401unauthorizedDer API-Schlüssel fehlt, ist ungültig oder wurde widerrufen.
402insufficient_creditsNicht genug Credits für diesen Aufruf. Der Body enthält Ihr Guthaben.
404not_found / unknown_toolUnbekannter Endpunkt.
405method_not_allowedFalsche HTTP-Methode für diesen Endpunkt.
500internal_errorAuf unserer Seite ist ein Fehler aufgetreten.
502upstream_errorEin Datenanbieter ist ausgefallen. Wird erstattet; versuchen Sie es in Kürze erneut.

Endpunkte

GET/api/v1/signalsKosten: 1

Aktiensignale abrufen

Letzter Schlusskurs, Veränderung über 1 und 5 Tage sowie acht technische Signale – jeweils bullish, bearish oder neutral, mit 5-Tage-Verlauf und den aktuellen Indikatorwerten.

Parameter

tickersquery · erforderlichKommagetrennte Ticker, bis zu 10. USA, Hongkong (.HK) oder China A-Aktien (.SS, .SZ).

Beispielanfrage

curl "https://pickskill.ai/api/v1/signals?tickers=NVDA,0700.HK" \
  -H "Authorization: Bearer $PICKSKILL_API_KEY"

Beispielantwort

{
  "data": {
    "disclaimer": "For research and education only. Not investment advice.",
    "legend": "signals[dim].now = latest reading; last5 = …",
    "stocks": [
      {
        "ticker": "NVDA",
        "asOf": "2026-11-17",
        "close": 156.14,
        "changePct": -1.2,
        "fiveDayChangePct": 3.4,
        "signals": {
          "macd": { "now": "bullish", "last5": "NBBBB", "values": { "dif": 2.1, "dea": 1.7 } },
          "rsi":  { "now": "neutral", "last5": "NNNNN", "values": { "rsi": 58.4 } },
          "…": "kdj, ma, boll, adx, volume, flow"
        },
        "bullishCount": 6,
        "bearishCount": 1,
        "page": "https://pickskill.ai/stocks/NVDA"
      }
    ]
  },
  "credits": { "charged": 1, "remaining": 99 }
}
POST/api/v1/screenKosten: 3

Aktien screenen

Findet Aktien aus S&P 500, Nasdaq-100, Hang Seng und CSI 300 (plus PickSkill-Aktienseiten), die alle Bedingungen erfüllen – mit Beleg für jede einzelne. Erwartet einen JSON-Body.

Parameter

conditionsbody · erforderlichEine bis acht Bedingungen, die alle erfüllt sein müssen. Siehe Screening-Bedingungen.
indicesbody · optionalAuf Indexwerte beschränken: sp500, ndx, hsi, csi300.
marketsbody · optionalAuf Märkte beschränken: us, hk, cn.
sort_bybody · optionalbullish_count (Standard), change_pct, five_day_change_pct oder rsi.
limitbody · optionalAnzahl der Treffer, 1–30. Standard: 15.

Beispielanfrage

curl -X POST "https://pickskill.ai/api/v1/screen" \
  -H "Authorization: Bearer $PICKSKILL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "indices": ["sp500"],
    "conditions": [
      { "type": "event", "event": "macd_golden_cross", "within_days": 3 },
      { "type": "value", "field": "rsi.rsi", "op": "<", "value": 50 }
    ],
    "limit": 10
  }'

Beispielantwort

{
  "data": {
    "universe": "… [sp500]: 503 stocks screened.",
    "matchedCount": 10,
    "matches": [
      {
        "ticker": "CAT",
        "name": "Caterpillar",
        "market": "us",
        "indices": ["sp500"],
        "close": 512.3,
        "bullishCount": 6,
        "evidence": [
          "MACD golden cross 1 day ago (DIF 4.12, DEA 3.80)",
          "rsi.rsi = 47.6 (< 50)"
        ],
        "page": "https://pickskill.ai/stocks/cat"
      }
    ]
  },
  "credits": { "charged": 3, "remaining": 96 }
}
GET/api/v1/earningsKosten: 2

Quartalszahlen abrufen

Die jüngsten Geschäftszahlen eines Unternehmens – Berichtsdatum, tatsächliches vs. erwartetes EPS und Überraschung – plus wichtige Kennzahlen zu Bewertung, Margen, Rendite, Verschuldung und Wachstum. Am vollständigsten für in den USA gelistete Unternehmen.

Parameter

tickerquery · erforderlichEin einzelner Ticker.

Beispielanfrage

curl "https://pickskill.ai/api/v1/earnings?ticker=NVDA" \
  -H "Authorization: Bearer $PICKSKILL_API_KEY"

Beispielantwort

{
  "data": {
    "ticker": "NVDA",
    "latestEarnings": {
      "report_date": "2026-08-26",
      "report_time": "After Hours",
      "eps_actual": 2.22,
      "eps_estimate": 2.09,
      "eps_surprise_percent": 6.22
    },
    "keyRatios": {
      "pe_ratio": 20.2,
      "forward_pe": 10.1,
      "gross_margin": 0.75,
      "return_on_equity": 1.17,
      "quarterly_revenue_growth": 1.06,
      "debt_to_equity": 0.17,
      "…": "…"
    },
    "sources": ["…"]
  },
  "credits": { "charged": 2, "remaining": 94 }
}
GET/api/v1/portfoliosKosten: 1

Portfolios auslesen

Ihre gespeicherten PickSkill-Portfolios mit Positionen, Gewichtungen und für jede Position die jüngste Veränderung und die Anzahl der Signale.

Parameter

portfolioquery · optionalName oder ID eines Portfolios. Weglassen, um alle Portfolios abzurufen.
include_signalsquery · optionalAuf false setzen, um Signale je Position auszulassen. Standard: true.

Beispielanfrage

curl "https://pickskill.ai/api/v1/portfolios?include_signals=true" \
  -H "Authorization: Bearer $PICKSKILL_API_KEY"

Beispielantwort

{
  "data": {
    "portfolios": [
      {
        "id": "…",
        "name": "Core",
        "holdings": [
          {
            "ticker": "AAPL",
            "name": "Apple",
            "weightPct": 25,
            "close": 228.4,
            "changePct": 0.8,
            "signals": { "macd": { "now": "bullish", "last5": "NBBBB", "values": { … } }, "…": "…" },
            "bullishCount": 5,
            "bearishCount": 1
          }
        ]
      }
    ]
  },
  "credits": { "charged": 1, "remaining": 93 }
}
GET/api/v1/creditsKosten: kostenlos

Credits prüfen

Ihr Credit-Guthaben, die Kosten jedes Endpunkts und die verfügbaren Credit-Pakete. Der Aufruf ist kostenlos.

Beispielanfrage

curl "https://pickskill.ai/api/v1/credits" \
  -H "Authorization: Bearer $PICKSKILL_API_KEY"

Beispielantwort

{
  "data": {
    "balance": 93,
    "costPerCall": { "get_stock_signals": 1, "get_my_portfolio": 1, "get_earnings_highlights": 2, "screen_stocks": 3 },
    "packs": [ { "credits": 1000, "priceUsd": 10 }, { "credits": 5000, "priceUsd": 45 }, { "credits": 20000, "priceUsd": 160 } ],
    "buyUrl": "https://pickskill.ai/account/api"
  }
}

Screening-Bedingungen

Bedingungen sind Objekte mit einem type. Kombinieren Sie bis zu acht; eine Aktie ist nur dann ein Treffer, wenn alle zutreffen.

type: "signal"

Eine Dimension steht auf bullish, bearish oder neutral, optional über die letzten N Tage (1–5). Bei RSI und KDJ bedeutet „bullish“ überverkauft.

{ "type": "signal", "dimension": "ma", "is": "bullish", "days": 3 }

type: "value"

Ein Indikatorwert im Vergleich mit einer Zahl: <, <=, > oder >=.

{ "type": "value", "field": "rsi.rsi", "op": "<", "value": 30 }

type: "event"

Ein Golden oder Death Cross bei MACD oder MA5/MA20 oder eine Dimension, die auf bullish oder bearish dreht – innerhalb der letzten N Tage (1–5).

{ "type": "event", "event": "macd_golden_cross", "within_days": 3 }
Dimensionen
macdmarsikdjbolladxvolumeflow
Gängige Felder
rsi.rsikdj.kkdj.dkdj.jmacd.difmacd.histadx.adxboll.bandwidthvolume.volRatioprice.changePctprice.fiveDayChangePct
Ereignisse
macd_golden_crossmacd_death_crossma5_ma20_golden_crossma5_ma20_death_crossturned_bullishturned_bearish

Alternative: MCP

Sollen lieber KI-Agenten die Tools aufrufen? Der MCP-Server stellt Claude, Cursor, VS Code und anderen MCP-Clients dieselben vier Tools bereit – mit demselben Schlüssel und denselben Credits.

MCP-Server einrichten

PickSkill-Daten beschreiben vergangene Kursverläufe und dienen ausschließlich der Recherche und Bildung. Sie stellen keine Anlageberatung dar.