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é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/signals | 1 |
| POST/screen | 3 |
| GET/earnings | 2 |
| GET/portfolios | 1 |
| GET/credits | gratuit |
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 }
}| Statut | Code | Signification |
|---|---|---|
| 400 | invalid_input | L'entrée est invalide — par exemple un ticker manquant ou une condition de filtre mal formée. Remboursé. |
| 401 | unauthorized | La clé API est absente, invalide ou révoquée. |
| 402 | insufficient_credits | Crédits insuffisants pour cet appel. Le corps indique votre solde. |
| 404 | not_found / unknown_tool | Endpoint inconnu. |
| 405 | method_not_allowed | Méthode HTTP incorrecte pour cet endpoint. |
| 500 | internal_error | Une erreur est survenue de notre côté. |
| 502 | upstream_error | Un fournisseur de données a échoué. Remboursé ; réessayez dans quelques instants. |
Endpoints
GET/api/v1/signalsCoût: 1Obtenir 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 · obligatoire | Tickers 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: 3Filtrer 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 · obligatoire | Une à huit conditions, qui doivent toutes être remplies. Voir Conditions de filtre. |
indicesbody · facultatif | Restreindre aux composantes d'indices : sp500, ndx, hsi, csi300. |
marketsbody · facultatif | Restreindre aux marchés : us, hk, cn. |
sort_bybody · facultatif | bullish_count (par défaut), change_pct, five_day_change_pct ou rsi. |
limitbody · facultatif | Nombre 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: 2Obtenir 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 · obligatoire | Un 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: 1Lire 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 · facultatif | Nom ou id d'un portefeuille. Omettez-le pour lire tous les portefeuilles. |
include_signalsquery · facultatif | Mettez 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: gratuitConsulter 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 MCPLes 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.