Référence de l'API

Documentation de l'API PickSkill

Tout ce qu'il faut pour appeler l'API REST PickSkill : URL de base, authentification, crédits, erreurs et chaque endpoint avec exemples.

Créer une clé APIhttps://pickskill.ai/api/v1

Vue d'ensemble

L'API est un petit ensemble d'endpoints JSON en lecture seule, via HTTPS. Les tickers suivent le format Yahoo : NVDA, BRK-B, 0700.HK, 600519.SS, 300750.SZ.

URL de base
https://pickskill.ai/api/v1
Format de réponse
Un appel réussi renvoie HTTP 200 avec data et credits. Chaque objet de données inclut un avertissement : les données PickSkill servent à la recherche et à la formation, et ne constituent pas un conseil en investissement.

Authentification

Créez une clé depuis votre tableau de bord de l'API et envoyez-la dans l'en-tête Authorization comme jeton Bearer (ou dans un en-tête x-api-key). Les clés commencent par psk_. Gardez-les secrètes ; vous pouvez révoquer une clé à tout moment.

Authorization: Bearer psk_…
# or
x-api-key: psk_…
Créer une clé API

Crédits

Chaque appel réussi débite des crédits de votre solde prépayé ; les appels échoués sont remboursés. Chaque compte démarre avec 100 crédits offerts, et l'API et le serveur MCP partagent un même solde.

GET/signals1
POST/screen3
GET/earnings2
GET/portfolios1
GET/creditsgratuit

Chaque réponse indique les crédits débités et restants dans le corps et dans les en-têtes X-Credits-Charged et X-Credits-Remaining.

Erreurs

Les erreurs renvoient un corps JSON avec un code d'erreur, un message et un lien vers cette documentation.

{
  "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 }
}
StatutCodeSignification
400invalid_inputL'entrée est invalide — par exemple un ticker manquant ou une condition de filtre mal formée. Remboursé.
401unauthorizedLa clé API est absente, invalide ou révoquée.
402insufficient_creditsCrédits insuffisants pour cet appel. Le corps indique votre solde.
404not_found / unknown_toolEndpoint inconnu.
405method_not_allowedMéthode HTTP incorrecte pour cet endpoint.
500internal_errorUne erreur est survenue de notre côté.
502upstream_errorUn fournisseur de données a échoué. Remboursé ; réessayez dans quelques instants.

Endpoints

GET/api/v1/signalsCoût: 1

Obtenir les signaux boursiers

Dernière clôture, variation sur 1 et 5 jours, et huit signaux techniques — chacun haussier, baissier ou neutre, avec son historique sur 5 jours et les dernières valeurs des indicateurs.

Paramètres

tickersquery · obligatoireTickers séparés par des virgules, jusqu'à 10. États-Unis, Hong Kong (.HK) ou actions A chinoises (.SS, .SZ).

Exemple de requête

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

Exemple de réponse

{
  "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/screenCoût: 3

Filtrer des actions

Trouvez les actions du S&P 500, du Nasdaq-100, du Hang Seng et du CSI 300 (plus les pages actions PickSkill) qui remplissent toutes les conditions, avec la justification de chacune. Envoyez un corps JSON.

Paramètres

conditionsbody · obligatoireUne à huit conditions, qui doivent toutes être remplies. Voir Conditions de filtre.
indicesbody · facultatifRestreindre aux composantes d'indices : sp500, ndx, hsi, csi300.
marketsbody · facultatifRestreindre aux marchés : us, hk, cn.
sort_bybody · facultatifbullish_count (par défaut), change_pct, five_day_change_pct ou rsi.
limitbody · facultatifNombre de résultats renvoyés, de 1 à 30. Par défaut : 15.

Exemple de requête

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
  }'

Exemple de réponse

{
  "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/earningsCoût: 2

Obtenir les résultats clés

La dernière publication de résultats d'une entreprise — date, EPS réel vs. estimé et surprise — ainsi que les principaux ratios de valorisation, marges, rentabilité, endettement et croissance. Plus complet pour les sociétés cotées aux États-Unis.

Paramètres

tickerquery · obligatoireUn seul ticker.

Exemple de requête

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

Exemple de réponse

{
  "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/portfoliosCoût: 1

Lire vos portefeuilles

Vos portefeuilles PickSkill enregistrés avec leurs lignes, pondérations et, pour chaque ligne, la dernière variation et le nombre de signaux.

Paramètres

portfolioquery · facultatifNom ou id d'un portefeuille. Omettez-le pour lire tous les portefeuilles.
include_signalsquery · facultatifMettez false pour omettre les signaux par ligne. Par défaut : true.

Exemple de requête

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

Exemple de réponse

{
  "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/creditsCoût: gratuit

Consulter vos crédits

Votre solde de crédits, le coût de chaque endpoint et les packs de crédits disponibles. Appel gratuit.

Exemple de requête

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

Exemple de réponse

{
  "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"
  }
}

Conditions de filtre

Les conditions sont des objets dotés d'un type. Combinez-en jusqu'à huit ; une action n'est retenue que si toutes sont remplies.

type: "signal"

Une dimension est haussière, baissière ou neutre, éventuellement sur les N derniers jours (1–5). Pour le RSI et le KDJ, « haussier » signifie survendu.

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

type: "value"

Une valeur d'indicateur comparée à un nombre : <, <=, > ou >=.

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

type: "event"

Un croisement doré ou de la mort du MACD ou des MA5/MA20, ou une dimension qui devient haussière ou baissière, sur les N derniers jours (1–5).

{ "type": "event", "event": "macd_golden_cross", "within_days": 3 }
Dimensions
macdmarsikdjbolladxvolumeflow
Champs courants
rsi.rsikdj.kkdj.dkdj.jmacd.difmacd.histadx.adxboll.bandwidthvolume.volRatioprice.changePctprice.fiveDayChangePct
Événements
macd_golden_crossmacd_death_crossma5_ma20_golden_crossma5_ma20_death_crossturned_bullishturned_bearish

Utiliser MCP à la place

Vous préférez qu'un agent IA appelle les outils ? Le serveur MCP met les quatre mêmes outils à disposition de Claude, Cursor, VS Code et d'autres clients MCP, avec la même clé et les mêmes crédits.

Configurer le serveur MCP

Les données PickSkill décrivent des cours passés et sont fournies à des fins de recherche et de formation uniquement. Elles ne constituent pas un conseil en investissement.