API リファレンス

PickSkill API ドキュメント

PickSkill REST API の呼び出しに必要な情報をまとめています。ベース URL、認証、クレジット、エラー、そして各エンドポイントをサンプル付きで解説します。

API キーを作成https://pickskill.ai/api/v1

概要

API は HTTPS 経由の読み取り専用 JSON エンドポイントで構成されています。ティッカーは Yahoo 形式で指定します:NVDA、BRK-B、0700.HK、600519.SS、300750.SZ。

ベース URL
https://pickskill.ai/api/v1
レスポンス形式
成功すると HTTP 200 で data と credits を返します。すべての data オブジェクトには、PickSkill のデータはリサーチおよび教育目的のものであり、投資助言ではない旨の注意書きが含まれます。

認証

API ダッシュボードでキーを作成し、Authorization ヘッダーに Bearer トークンとして指定します(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

銘柄をスクリーニング

S&P 500、ナスダック 100、ハンセン指数、CSI 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 の実績と予想、サプライズ)に加え、バリュエーション、利益率、資本効率、レバレッジ、成長性の主要指標を返します。米国上場企業のデータが最も充実しています。

パラメーター

tickerquery · 必須ティッカーを 1 つ指定します。

リクエスト例

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 サーバーをご利用ください。同じ 4 つのツールを Claude、Cursor、VS Code などの MCP クライアントに提供し、API キーもクレジットも共通です。

MCP サーバーを設定する

PickSkill のデータは過去の価格に基づくもので、リサーチおよび教育のみを目的としています。投資助言ではありません。