Referencia de la API

Documentación de la API de PickSkill

Todo lo que necesitas para llamar a la API REST de PickSkill: URL base, autenticación, créditos, errores y cada endpoint con ejemplos.

Crear una clave APIhttps://pickskill.ai/api/v1

Descripción general

La API es un pequeño conjunto de endpoints JSON de solo lectura sobre HTTPS. Los tickers usan el formato de Yahoo: NVDA, BRK-B, 0700.HK, 600519.SS, 300750.SZ.

URL base
https://pickskill.ai/api/v1
Formato de respuesta
Una llamada correcta devuelve HTTP 200 con data y credits. Cada objeto de datos incluye un aviso: los datos de PickSkill son para investigación y formación, no asesoramiento de inversión.

Autenticación

Crea una clave en tu panel de la API y envíala en la cabecera Authorization como token Bearer (o en la cabecera x-api-key). Las claves empiezan por psk_. Mantenlas en secreto; puedes revocar una clave en cualquier momento.

Authorization: Bearer psk_…
# or
x-api-key: psk_…
Crear una clave API

Créditos

Cada llamada correcta descuenta créditos de tu saldo prepagado; las fallidas se reembolsan. Todas las cuentas empiezan con 100 créditos gratis, y la API y el servidor MCP comparten un único saldo.

GET/signals1
POST/screen3
GET/earnings2
GET/portfolios1
GET/creditsgratis

Cada respuesta indica los créditos cobrados y restantes en el cuerpo y en las cabeceras X-Credits-Charged y X-Credits-Remaining.

Errores

Los errores devuelven un cuerpo JSON con un código de error, un mensaje y un enlace a esta documentación.

{
  "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 }
}
EstadoCódigoSignificado
400invalid_inputLa entrada no es válida; por ejemplo, falta el ticker o una condición de filtro está mal formada. Se reembolsa.
401unauthorizedLa clave API falta, no es válida o ha sido revocada.
402insufficient_creditsNo hay créditos suficientes para esta llamada. El cuerpo incluye tu saldo.
404not_found / unknown_toolEndpoint desconocido.
405method_not_allowedMétodo HTTP incorrecto para este endpoint.
500internal_errorAlgo ha fallado por nuestra parte.
502upstream_errorHa fallado un proveedor de datos. Se reembolsa; vuelve a intentarlo en un momento.

Endpoints

GET/api/v1/signalsCoste: 1

Obtener señales de acciones

Último cierre, variación a 1 y 5 días y ocho señales técnicas, cada una alcista, bajista o neutral, con su evolución de 5 días y los últimos valores de los indicadores.

Parámetros

tickersquery · obligatorioTickers separados por comas, hasta 10. EE. UU., Hong Kong (.HK) o acciones A de China (.SS, .SZ).

Ejemplo de petición

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

Ejemplo de respuesta

{
  "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/screenCoste: 3

Filtrar acciones

Encuentra acciones del S&P 500, el Nasdaq-100, el Hang Seng y el CSI 300 (más las páginas de acciones de PickSkill) que cumplan todas las condiciones, con la justificación de cada una. Envía un cuerpo JSON.

Parámetros

conditionsbody · obligatorioDe una a ocho condiciones, que deben cumplirse todas. Consulta Condiciones de filtro.
indicesbody · opcionalLimita a componentes de índices: sp500, ndx, hsi, csi300.
marketsbody · opcionalLimita a mercados: us, hk, cn.
sort_bybody · opcionalbullish_count (por defecto), change_pct, five_day_change_pct o rsi.
limitbody · opcionalCoincidencias que se devuelven, de 1 a 30. Por defecto, 15.

Ejemplo de petición

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

Ejemplo de respuesta

{
  "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/earningsCoste: 2

Obtener resultados destacados

La última publicación de resultados de una empresa (fecha del informe, EPS real frente al estimado y sorpresa), más ratios clave de valoración, márgenes, rentabilidad, apalancamiento y crecimiento. Más completo para empresas cotizadas en EE. UU.

Parámetros

tickerquery · obligatorioUn solo ticker.

Ejemplo de petición

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

Ejemplo de respuesta

{
  "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/portfoliosCoste: 1

Leer tus carteras

Tus carteras guardadas en PickSkill con sus posiciones, ponderaciones y, para cada posición, la última variación y el recuento de señales.

Parámetros

portfolioquery · opcionalNombre o id de una cartera. Omítelo para leer todas las carteras.
include_signalsquery · opcionalPonlo en false para omitir las señales por posición. Por defecto, true.

Ejemplo de petición

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

Ejemplo de respuesta

{
  "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/creditsCoste: gratis

Consultar tus créditos

Tu saldo de créditos, el coste de cada endpoint y los paquetes de créditos disponibles. Llamada gratuita.

Ejemplo de petición

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

Ejemplo de respuesta

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

Condiciones de filtro

Las condiciones son objetos con un type. Combina hasta ocho; una acción solo coincide si se cumplen todas.

type: "signal"

Una dimensión es alcista, bajista o neutral, opcionalmente durante los últimos N días (1–5). En RSI y KDJ, «alcista» significa sobreventa.

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

type: "value"

El valor de un indicador comparado con un número: <, <=, > o >=.

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

type: "event"

Un cruce dorado o de la muerte del MACD o de MA5/MA20, o una dimensión que pasa a alcista o bajista, en los últimos N días (1–5).

{ "type": "event", "event": "macd_golden_cross", "within_days": 3 }
Dimensiones
macdmarsikdjbolladxvolumeflow
Campos habituales
rsi.rsikdj.kkdj.dkdj.jmacd.difmacd.histadx.adxboll.bandwidthvolume.volRatioprice.changePctprice.fiveDayChangePct
Eventos
macd_golden_crossmacd_death_crossma5_ma20_golden_crossma5_ma20_death_crossturned_bullishturned_bearish

Usar MCP en su lugar

¿Prefieres que un agente de IA llame a las herramientas? El servidor MCP ofrece las mismas cuatro herramientas a Claude, Cursor, VS Code y otros clientes MCP, con la misma clave y los mismos créditos.

Configurar el servidor MCP

Los datos de PickSkill describen precios pasados y son solo para investigación y formación. No constituyen asesoramiento de inversión.