API 参考

PickSkill API 文档

调用 PickSkill REST API 所需的一切:接口地址、身份验证、点数、错误码,以及每个接口的说明和示例。

创建 API 密钥https://pickskill.ai/api/v1

概览

这套 API 由少量只读的 JSON 接口组成,通过 HTTPS 访问。股票代码使用 Yahoo 格式:NVDA、BRK-B、0700.HK、600519.SS、300750.SZ。

接口地址
https://pickskill.ai/api/v1
返回格式
调用成功时返回 HTTP 200,包含 data 和 credits。每个数据对象都附有免责声明:PickSkill 数据仅供研究与学习之用,不构成投资建议。

身份验证

在 API 控制台创建密钥,并以 Bearer token 的形式放在 Authorization 请求头中发送(也可以用 x-api-key 请求头)。密钥以 psk_ 开头,请妥善保管;你可以随时撤销密钥。

Authorization: Bearer psk_…
# or
x-api-key: psk_…
创建 API 密钥

点数

每次成功调用从预充值余额中扣除点数,调用失败自动退回。每个账户初始赠送 100 点,API 和 MCP 服务器共用同一份余额。

GET/signals1
POST/screen3
GET/earnings2
GET/portfolios1
GET/credits免费

每次响应都会在返回体以及 X-Credits-Charged 和 X-Credits-Remaining 响应头中给出本次扣除和剩余的点数。

错误

出错时返回 JSON,包含错误码、错误信息和本文档的链接。

{
  "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 }
}
状态码错误码含义
400invalid_input输入无效,例如缺少股票代码或选股条件格式有误。点数已退回。
401unauthorizedAPI 密钥缺失、无效或已被撤销。
402insufficient_credits点数不足,无法完成本次调用。返回体中包含你的余额。
404not_found / unknown_tool接口不存在。
405method_not_allowed该接口不支持此 HTTP 方法。
500internal_error服务端出现问题。
502upstream_error数据源调用失败。点数已退回,请稍后重试。

接口

GET/api/v1/signals消耗: 1

获取股票信号

最新收盘价、1 日和 5 日涨跌幅,以及 8 项技术信号——每项给出看多、看空或中性的研判,附近 5 日轨迹和最新指标数值。

参数

tickersquery · 必填股票代码,用英文逗号分隔,最多 10 个。支持美股、港股(.HK)和 A 股(.SS、.SZ)。

请求示例

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

返回示例

{
  "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/screen消耗: 3

选股

在标普 500、纳指 100、恒生指数和沪深 300(以及 PickSkill 个股页面)中,找出满足全部条件的股票,并附上每个条件的依据。请求体为 JSON。

参数

conditionsbody · 必填1 到 8 个条件,须全部满足。详见“选股条件”。
indicesbody · 可选限定指数成分股范围:sp500、ndx、hsi、csi300。
marketsbody · 可选限定市场范围:us、hk、cn。
sort_bybody · 可选bullish_count(默认)、change_pct、five_day_change_pct 或 rsi。
limitbody · 可选返回的结果数量,1–30,默认 15。

请求示例

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

返回示例

{
  "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/earnings消耗: 2

获取财报要点

公司最新一期财报——发布日期、实际 EPS 与预期 EPS 及超预期幅度——以及估值、利润率、回报率、杠杆和成长性等关键比率。美国上市公司的数据最完整。

参数

tickerquery · 必填单个股票代码。

请求示例

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

返回示例

{
  "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/portfolios消耗: 1

读取持仓组合

你在 PickSkill 保存的持仓组合,包括持仓和权重,以及每只持仓的最新涨跌幅和信号统计。

参数

portfolioquery · 可选持仓组合名称或 id。不传则读取全部组合。
include_signalsquery · 可选设为 false 可跳过每只持仓的信号。默认为 true。

请求示例

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

返回示例

{
  "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/credits消耗: 免费

查询点数

你的点数余额、各接口的价格以及可购买的点数包。调用免费。

请求示例

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

返回示例

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

选股条件

每个条件都是一个带 type 字段的对象。最多可组合 8 个条件,只有全部成立的股票才会命中。

type: "signal"

某个维度的研判为看多、看空或中性,可指定最近 N 天(1–5)。RSI 和 KDJ 的“看多”即超卖。

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

type: "value"

将某个指标数值与给定数字比较:<、<=、> 或 >=。

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

type: "event"

最近 N 天(1–5)内出现 MACD 或 MA5/MA20 金叉/死叉,或某个维度转为看多或看空。

{ "type": "event", "event": "macd_golden_cross", "within_days": 3 }
维度
macdmarsikdjbolladxvolumeflow
常用字段
rsi.rsikdj.kkdj.dkdj.jmacd.difmacd.histadx.adxboll.bandwidthvolume.volRatioprice.changePctprice.fiveDayChangePct
事件
macd_golden_crossmacd_death_crossma5_ma20_golden_crossma5_ma20_death_crossturned_bullishturned_bearish

改用 MCP

想让 AI 智能体直接调用这些工具?MCP 服务器向 Claude、Cursor、VS Code 等 MCP 客户端提供同样的四个工具,使用同一个密钥,消耗同一份点数。

配置 MCP 服务器

PickSkill 数据描述的是历史价格走势,仅供研究与学习之用,不构成投资建议。