株価テクニカル指標API入門:MACD・RSIをJSONで
生のOHLCV APIか、計算済みシグナルのAPIか。両者を比較し、PickSkillのREST APIで米国株・香港株・中国A株のMACD、RSI、KDJを取得する方法を解説します。

株価テクニカル指標APIとは、MACD・RSI・KDJ などの指標値を、できれば日付付きの「強気・弱気・中立」の判定とともに返すWebサービスで、生の価格データから自分で計算する手間を省くものです。 実際の選択肢は、価格をダウンロードして自分で計算する「生のOHLCV API」と、判定が計算済みで届く「シグナルAPI」の2つです。PickSkill の API では GET /api/v1/signals を1回呼ぶだけで、最大10銘柄の8つの指標ディメンションが1クレジットで返ってきます。2026年11月19日の結果では、テンセント(0700.HK)の RSI(14) は 27.86、弱気が5ディメンション、強気が1ディメンションでした。
本記事では、開発者がテクニカル指標を手に入れる3つの方法を比較したうえで、実際のリクエスト、実際のフィールド名、15行の Python アラートを使って PickSkill の REST API を解説します。
要点
- 生のOHLCV APIは価格を、シグナルAPIは結論を返す。 生データを使う場合、計算式もデータクレンジングも、値を「強気」と判定するルールもすべて自前です。
- 中国A株には特別な処理が必要。 メインボードの値幅制限は1日10%、STAR マーケット(科創板)は20%です(上海証券取引所)。高値と安値が等しいストップ高の足は、偽のトレンドシグナルを生みかねません。
- PickSkill の REST API のエンドポイントは5つ:
/signals、/screen、/earnings、/portfolios、/credits。認証はAuthorization: Bearer <key>です。 - 月額ではなく従量課金。 シグナルは1クレジット、スクリーニングは3クレジット。パックは 1,000 クレジット 10 ドルから、全アカウントに無料の 100 クレジットが付き、失敗した呼び出しは返金されます。
- MCP と同じデータ。 MCP サーバーと REST API は、ツール・結果・クレジット残高を共有しています。
生のOHLCV APIとテクニカルシグナルAPIの違いは?
生のOHLCV APIが返すのは始値・高値・安値・終値・出来高の足だけで、それ以外はすべて利用者の仕事です。MACD を得るには十分な履歴(遅いEMAに最低26本、さらにシグナル線のウォームアップ分)を取得し、EMAを計算し、何をクロスとみなし何をシグナルとするかを決める必要があります。テクニカルシグナルAPIはその処理をサーバー側で行い、指標値を解釈と日付付きで返します。トレードオフは「自由度」対「時間」です。生データならあらゆるパラメータを調整でき、独自指標も作れます。一方シグナルAPIなら、複数市場にわたって一貫した、クレンジング済みの判定が1回の呼び出しで手に入ります。多くのチームは両方を使い分けています。バックテストには生データ、アラートや AI エージェントにはシグナルAPIという形です。
3つ目の選択肢は、指標計算にAPIを使わず、TA-Lib のようなライブラリでローカル計算する方法です。TA-Lib は BSD ライセンスで 200 以上の指標と Python ラッパーを提供するとしています。ただし、それを動かすための信頼できる価格データは別途必要です。
3つの方法を比較すると?
サードパーティのデータベンダーの料金はプランによって異なるため、各ベンダーの公式料金ページを確認してください。
| 自前で計算(pandas / TA-Lib) | 生のOHLCVデータAPI | 計算済みシグナルAPI(PickSkill) | |
|---|---|---|---|
| 得られるもの | 自分でコードを書いた任意の指標 | 価格と出来高の足 | 8ディメンション:値+強気/弱気/中立+5日間の推移 |
| 最初のシグナルまでの手間 | 最大:データ取得・計算式・ルール | 中:計算式とルール | 最小:HTTP 呼び出し1回 |
| パラメータの自由度 | 完全 | 完全 | 標準設定で固定(例:RSI 14、KDJ 9,3,3、ボリンジャー 20,2) |
| 対象市場 | データソース次第 | ベンダー次第 | 米国株・香港株・中国A株。日本株・韓国株のティッカーにも対応 |
| A株のストップ高・ストップ安の足 | 自分で検出・処理が必要 | 自分で検出・処理が必要 | 高値=安値の足は中立に固定 |
| 銘柄群のスクリーニング | 全銘柄をダウンロードして計算 | 全銘柄をダウンロードして計算 | POST /screen で約950の指数構成銘柄が対象 |
| コスト | ライブラリは無料、価格データは別料金 | ベンダーのサブスクまたは従量課金 | シグナル呼び出し1回につき1クレジット(0.008〜0.01ドル) |
| 向いている用途 | バックテスト、独自リサーチ | 大規模な独自指標 | アラート、ダッシュボード、AI エージェント |
少数の銘柄で標準的な指標をいくつか使うだけならシグナルAPIの方が早く実装できます。特殊なパラメータでバックテストするなら自前で計算しましょう。
なぜ中国A株では素朴な指標コードが壊れるのか?
中国A株には1日の値幅制限があるため、取引日によっては制限値に張り付いたまま、実質的な価格発見がないまま引けることがあります。上海証券取引所はメインボードに1日10%、STAR マーケットには上場後5営業日を過ぎてから20%の値幅制限を設けています(上海証券取引所 Q&A)。一本値のストップ高の日は足の高値と安値が等しくなり、KDJ・ボリンジャーバンド・ADX のようなレンジに基づく指標が退化します。ストップ高が続くと、それを考慮しないコードには教科書どおりの強いトレンドに見えてしまいます。売買停止の銘柄も同じような平坦な足を生みます。PickSkill の指標エンジンは高値と安値が等しい足を検出し、その日の判定を全ディメンションで中立に固定します。5日間の推移の中でも同様なので、ストップ高の連続が偽シグナルを生むことはありません。自前で計算する場合も、クロスを信用する前に同じチェックを入れてください。A株のトレーダーが実際に重視するオシレーターについては、A株に最適な指標をご覧ください。
PickSkill のテクニカル指標APIはどう呼び出す?
PickSkill の REST API のベースURLは https://pickskill.ai/api/v1 で、APIキーを Authorization: Bearer <key> として送る必要があります(x-api-key ヘッダーも使えます)。キーはアカウントの API ダッシュボードで作成します。全アカウントに無料の 100 クレジットが付与され、API と MCP サーバーは同じ残高を使います。成功時のレスポンスは { data, credits: { charged, remaining } } の形で、同じ数値が X-Credits-Charged と X-Credits-Remaining ヘッダーにも入ります。エラー時は { error: { code, message, docs } } がステータス 400、401、402(クレジット不足)、403、404、405、502 のいずれかで返り、失敗した呼び出しのクレジットは返金されます。パラメータの詳細は API ドキュメントにあります。
| エンドポイント | メソッド | 返す内容 | クレジット |
|---|---|---|---|
/signals?tickers= | GET | 最大10銘柄:終値、1日・5日の騰落率、8ディメンション | 1 |
/screen | POST | 最大8つの AND 条件に合致する銘柄と根拠(有料プランが必要) | 3 |
/earnings?ticker= | GET | 直近の EPS 実績と予想、主要財務指標 | 2 |
/portfolios | GET | 保存済みの PickSkill ポートフォリオと保有銘柄ごとのシグナル | 1 |
/credits | GET | 残高、1回あたりのコスト、クレジットパック | 無料 |
香港株・上海A株・米国株を対象にした実際のリクエストです。ティッカーは Yahoo Finance 形式(0700.HK、600519.SS、300750.SZ、NVDA)です。
curl "https://pickskill.ai/api/v1/signals?tickers=0700.HK,600519.SS,NVDA" \
-H "Authorization: Bearer $PICKSKILL_API_KEY"
レスポンスは、1銘柄・8ディメンション中4つに絞って掲載しています。値は2026年11月19日の実際の呼び出し結果(同日の香港市場終値ベース)です。
{
"data": {
"disclaimer": "For research and education only; not investment advice. …",
"legend": "signals[dim].now = latest reading; last5 = last 5 trading days oldest→newest (B bullish, S bearish, N neutral); values = latest indicator values.",
"stocks": [
{
"ticker": "0700.HK",
"asOf": "2026-11-19",
"close": 348.4,
"changePct": -6.55,
"fiveDayChangePct": -12.64,
"signals": {
"macd": { "now": "bearish", "last5": "NNSSS", "values": { "dif": -10.77, "dea": -6.61, "hist": -8.32 } },
"rsi": { "now": "bullish", "last5": "NNNNB", "values": { "rsi": 27.86 } },
"kdj": { "now": "neutral", "last5": "NNNNN", "values": { "k": 11.46, "d": 24.39, "j": -14.42 } },
"boll": { "now": "bearish", "last5": "NNNNS", "values": { "mid": 393.32, "upper": 430.79, "lower": 355.85, "bandwidth": 19.05 } },
"…": "ma, adx, volume, flow"
},
"bullishCount": 1,
"bearishCount": 5,
"page": "https://pickskill.ai/stocks/0700.HK"
}
]
},
"credits": { "charged": 1, "remaining": "…" }
}

読むときのポイントは2つです。RSI と KDJ の「bullish(強気)」は「上昇中」ではなく「売られすぎ」を意味します。RSI(14) が30以下なら強気、70以上なら弱気と判定されます。また last5 は古い順に並ぶため、NNNNB は売られすぎの判定が最新日にだけ現れたことを示します。各オシレーターの意味は MACD とはと KDJ とはで解説しています。
API で香港株と中国A株をスクリーニングするには?
POST /screen は約950銘柄(S&P 500、Nasdaq-100、ハンセン指数、CSI 300 の構成銘柄と、PickSkill に個別ページがある銘柄)に条件を適用し、合致した銘柄を根拠付きで返します。条件は3種類で、すべて AND、1回のスクリーニングで最大8つです。signal(あるディメンションが N 日間強気・弱気・中立を維持)、value(例:rsi.rsi < 30 や kdj.j)、event(macd_golden_cross、ma5_ma20_golden_cross、turned_bullish とその逆を N 日以内に検出、つまりゴールデンクロスなど)です。markets(us、hk、cn)や indices(sp500、ndx、hsi、csi300)で絞り込み、並べ替えて最大30件を返せます。1回3クレジットで、PickSkill の有料プランが必要です。Free アカウントには 403 が返り、課金はされません。シグナルスクリーナーと同じエンジンです。
curl -X POST "https://pickskill.ai/api/v1/screen" \
-H "Authorization: Bearer $PICKSKILL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"indices":["hsi","csi300"],
"conditions":[{"type":"value","field":"rsi.rsi","op":"<","value":30}],
"sort_by":"rsi","limit":8}'
2026年11月19日の終値で実行すると、このスクリーニングはハンセン指数と CSI 300 の385銘柄を対象に、RSI(14) が30未満の33銘柄を抽出しました。一致例を絞り込むと次のとおりです。
{
"ticker": "0881.HK",
"name": "Zhongsheng",
"market": "hk",
"indices": ["hsi"],
"asOf": "2026-11-19",
"close": 1.73,
"evidence": ["rsi.rsi = 17.4 (< 30)"]
}
15行でシグナルアラートを作るには?
最初のプロジェクトとしておすすめなのが、ウォッチリストの判定が強気に転じたら知らせるアラートです。各ディメンションには5日間の推移が付いているので、前日の状態を保存する必要はありません。推移が NB または SB で終わっていれば、最新日に強気へ転じたことを意味します。
- PickSkill アカウントで APIキーを作成し、
PICKSKILL_API_KEYとして export します。 - 1回の呼び出しで最大10銘柄を指定します。市場が混在していても構いません。
- 見たいディメンション(例:MACD、RSI、KDJ)を選びます。
- 各
last5の末尾2文字をチェックします。 - 引け後に1日1回スクリプトを実行するようスケジュールします(cron、GitHub Actions、クラウド関数など)。1回の実行は1クレジットです。
import os, requests
URL = "https://pickskill.ai/api/v1/signals"
KEY = os.environ["PICKSKILL_API_KEY"]
WATCH = "NVDA,0700.HK,600519.SS"
r = requests.get(URL, params={"tickers": WATCH},
headers={"Authorization": f"Bearer {KEY}"}, timeout=30)
r.raise_for_status()
body = r.json()
for s in body["data"]["stocks"]:
for dim in ("macd", "rsi", "kdj"):
trail = s.get("signals", {}).get(dim, {}).get("last5", "")
if trail[-2:] in ("NB", "SB"):
print(f"{s['ticker']} {dim} turned bullish ({trail}) as of {s['asOf']}")
print("credits left:", body["credits"]["remaining"])
2026年11月19日のデータでは、スクリプトは 0700.HK rsi turned bullish (NNNNB) as of 2026-11-19 の1行を出力します。テンセントの RSI がこの日に売られすぎ水準に入ったということです。NVDA の RSI は5日間ずっと強気(BBBBB)だったため新たな転換ではなく、貴州茅台(600519.SS)には新たな強気判定はありませんでした。
API の料金は?
API の利用はプリペイドのクレジットで課金され、料金ページのチャットプランとは別です。全アカウントに一度だけ無料の 100 クレジットが付与され、その後のパックは 1,000 クレジット 10 ドル、5,000 クレジット 45 ドル、20,000 クレジット 160 ドルで、クレジットに有効期限はありません。この価格なら10銘柄のシグナル呼び出しは1回 0.008〜0.01 ドルで、上のデイリーアラートは1日1セントを大きく下回ります。固定のレート制限はなく、呼び出しは残高によってのみ制限されます。詳細と最新のパック一覧は Data API ページにあります。
AI エージェントにこれらの呼び出しを任せたい場合は、同じツールが MCP でも使えます。選択肢の比較は株式市場データ向け MCP サーバーまとめをご覧ください。
本記事は調査・教育目的であり、投資助言ではありません。テクニカルシグナルは過去の値動きを表すもので、将来のリターンを予測するものではありません。
FAQ
無料で使える株価テクニカル指標APIはありますか? PickSkill は全アカウントに一度だけ無料の 100 API クレジットを付与しており、最大10銘柄のシグナル呼び出しを100回行えます。その後はプリペイドパック(1,000 クレジット 10 ドルから)を購入します。TA-Lib などのオープンソースライブラリで自前計算するのは無料ですが、入力となる価格データは別途必要です。
香港株や中国A株の MACD・RSI を返す API は?
PickSkill の /api/v1/signals エンドポイントは、米国株に加え、0700.HK などの香港株や 600519.SS、300750.SZ などの中国A株について、MACD、RSI、KDJ、移動平均、ボリンジャーバンド、ADX、出来高、資金フローを返します。各ディメンションには最新値、強気・弱気・中立の判定、5日間の推移が含まれます。
API は中国A株のストップ高の日をどう扱いますか? 高値と安値が等しい日足、つまり一本値のストップ高・ストップ安や売買停止で生じる足は「情報なし」として扱われます。その日の判定は全指標ディメンションで中立に固定され、5日間の推移の中でも同様です。そのため、ストップ高が続いても偽の強いトレンドシグナルは生まれません。
REST API と MCP サーバーの違いは? 同じツールを実行し、同じデータを返し、クレジット残高も共有しています。REST API は自作のスクリプト、ダッシュボード、バックエンド向けです。MCP サーバーは Claude Code、Cursor、Claude Desktop などの AI エージェント向けで、エージェントがツールを自ら発見して呼び出します。
RSI の期間などのパラメータは変更できますか? できません。API は RSI(14)、KDJ(9,3,3)、ボリンジャー(20,2)、ADX/DMI(14)、5日・20日・60日移動平均などの標準設定で値を返します。独自の期間に依存する戦略なら、生の価格データを取得して自分で計算し、シグナルAPIは簡易チェックやアラートに使うのがよいでしょう。