API 參考

PickSkill API 文件

呼叫 PickSkill REST API 所需的一切:API 位址、身分驗證、點數、錯誤碼,以及每個端點的說明與範例。

建立 API 金鑰https://pickskill.ai/api/v1

概覽

這套 API 由少數幾個唯讀的 JSON 端點組成,透過 HTTPS 存取。股票代號採用 Yahoo 格式:NVDA、BRK-B、0700.HK、600519.SS、300750.SZ。

API 位址
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 Agent 直接呼叫這些工具?MCP 伺服器為 Claude、Cursor、VS Code 等 MCP 用戶端提供同樣的四個工具,使用同一把金鑰,消耗同一份點數。

設定 MCP 伺服器

PickSkill 資料描述的是過去的價格走勢,僅供研究與教育用途,不構成投資建議。