ログイン

Guides / Changelog

変更履歴

エンドポイント・フィールド・上限・URL に変更があった場合、ここに新しい順で記載します。

    • 変更PoC の基本期間を7日間に変更しました(以前は14日間)。期間はご相談のうえ調整できます。すでに開始した PoC の終了日は変わりません。レート制限とクォータ
    • ドキュメントMCP の案内を修正しました。Data API キー(ck_live_)でも MCP サーバーに接続でき、その場合は Data API ツールが使えます。PRO ツールは PRO API キーまたは OAuth で接続した場合のみ表示されます。MCP 接続
    • ドキュメントリファレンスを Data API 1.16.0 の仕様書に合わせました。以下の10月26〜28日の変更がサイドバーと /openapi.json・/openapi.en.json に反映されています。

    • 追加Data API 1.13.0。米国専用の GET /us-earnings(銘柄・提出日で一覧、cursor)と GET /us-earnings/{id}。8-K 項目 2.02 の決算発表から検証した数値(売上高・営業利益・純利益・GAAP と調整後 EPS・調整後 EBITDA・キャッシュフローなど)を基本単位で返し、前年の値と増減率、数値ごとの根拠(表のセル・原文の引用)、利益率、会社の KPI と見通し、時刻(SEC 受理・発表の確認・抽出)、コードで作成した1〜2行の速報文を含みます。詳細エンドポイントは発表直前の市場予想との比較(surprise)も返します。
    • 追加Data API 1.14.0。決算数値に reaction を追加しました。発表前の最後の通常取引終値から発表後の最初の通常取引終値までの変化率(change_pct)、発表のセッション、状態(measured・pending・unavailable)を返します。
    • 追加Data API 1.15.0。GET /us-earnings/{id} に guidance_comparison を追加しました。発表の見通しの文ごとに、同じ期間に対する会社の直前の見通しからの変化と、発表日前に観測した同じ期間・指標の市場予想に対する位置を返します。
    • 追加Data API 1.16.0。決算数値に事業セグメント別の売上高・セグメント利益(segments)を追加しました。セグメントの合計が売上高と一致する場合のみ含め、比較した合計は segment_check にあります。
    • 追加Webhook イベント us_earnings.figures(数値を初めて確認したとき、新しい読み取りで値が変わったときに再送)と us_filing.analysis_revoked(通知した分析を取り下げたとき)。修正した分析を再公開すると、us_filing.analysis_published が新しい版(publication.revision・replaces)でもう一度届きます。イベントを指定せずに作成した新しい購読は4つすべてを受け取り、既存の購読のイベント一覧は変わりません。
    • 追加韓国の /companies/{symbol}/financials に meta.preliminary_releases を追加しました。preliminary=true の行の根拠となる暫定業績の開示ごとに、届け出たウォン建ての値、増減率、黒字・赤字転換の表記、発表直前のコンセンサスとの比較を返します。行の項目は変わりません。

    • 追加Data API 1.11.0。米国専用の GET /us-filings。米国上場企業すべての SEC 開示(8-K・6-K・10-Q・10-K・20-F・40-F と訂正)を新しい順(提出日 → SEC 受理時刻 → id)に cursor 付きで返します。項目ごとに cik、8-K 項目コードと韓国語・英語の名称、accepted_at、detected_at、analysis(状態・見出し・公開時刻・遅延)があります。フィルターは since・until(受理時刻)、from・to(提出日)、form、items、symbol、analysis=published です。分析本文は PRO API で提供します。
    • 追加Data API 1.12.0。Webhook: POST・GET /webhooks、PATCH・DELETE /webhooks/{id}、POST /webhooks/{id}/test、GET /webhooks/{id}/deliveries。アカウントあたり最大5件で、有料等級と米国市場を契約した PoC で利用できます。us_filing.detected・us_filing.analysis_published イベントは GET /us-filings の項目と同じ形で、銘柄・書式・8-K 項目コードで絞り込めます。Standard Webhooks 方式で署名し(whsec_ のシークレットは登録時に一度だけ表示)、失敗すると1分・5分・30分・2時間・6時間後に再送します。100回連続で失敗すると Webhook は無効になります。
    • 追加Data API 1.10.0。米国専用の GET /companies/{symbol}/earnings-surprises(四半期 EPS の予想・実績・サプライズの履歴、次回発表、EPS・売上高予想の推移と修正)と GET /companies/{symbol}/analyst-ratings(投資判断・目標株価の変更、月別の判断分布、目標株価の要約)。韓国の銘柄は 400 UNSUPPORTED_MARKET です。MCP ツール get_us_earnings_surprises・get_us_analyst_ratings が対応します。

    • 変更Data API の等級 Launch・Business・Scale を追加しました。すべての等級ですべてのエンドポイントを利用でき、等級ごとの1分あたり・1日・AI 呼び出しの上限を適用します。Enterprise の上限は変わりません。等級は新しい項目 plan_tier とヘッダー X-Plan-Tier で確認できます。レート制限とクォータ
    • 変更PoC は目標等級(Launch・Business・Scale)のトライアル上限で利用します。目標等級を決めない場合は Launch です。Enterprise の上限の半分で利用する規則は廃止しました。既存の PoC の plan: poc・X-Plan: PoC の値は変わりません。
    • 追加契約により AI 呼び出しの月間上限を設定できます。超えると 429 AI_MONTHLY_QUOTA_EXCEEDED が返り、ai_quota.monthly と X-AI-Quota-Monthly-* ヘッダーで確認できます。

    • 変更Data API 1.4.0(バックエンドのデプロイ後に適用)。/companies/{symbol}/financials は元帳全体を会計年度・四半期の新しい順 → 勘定科目順で返します。企業 IR 資料で補った期間も同じ順に並びます。limit(既定 100・最大 200)と cursor で分けて受け取り、next_cursor・has_more が付きます。以前は約 100 行の上限で一部の科目が欠けることがありました。
    • 追加財務諸表の行に機械可読項目: account_code・fiscal_quarter・period_code(FY2025・2026Q3)・period_end・fs_code・unit_code・report_code。account は英語コード(revenue・operating_income …)を受け付け、fs フィルターも使えます。表はデータ規約。
    • 追加エラーコード 400 BAD_PERIOD(期間の形式誤り)・404 SYMBOL_NOT_FOUND(不明な銘柄)・404 NOT_APPLICABLE(ETF・ETN など企業データが該当しない商品)。以前は誤った期間でも 200 で無関係な行を返すことがありました。
    • 変更ガイダンスの unit・unit_scale が値の単位を表すようになりました(KRW・USD、倍率 1)。従来の意味(表示単位の 1 億ウォン・100 万ドル)は display_unit・display_scale に移しました。これらの項目を読んでいたコードは修正してください。
    • 追加コンセンサスの unit=raw|eok|million(既定 raw のまま)と値ごとの unit・unit_scale・comparison_status。米国は売上高のみで、meta.metrics もその市場で返す指標だけを示します。
    • 追加米国開示の form・exclude_forms フィルターと開示行の report_code。ニュースに米国記事(market=US、収集済み分)と lang・title_ko。market を省くと韓国・米国の記事を一緒に返します(契約中の市場の記事のみ)。銘柄フィルターはタグ検証済みの記事だけを返すため、以前より件数が減ることがあります。
    • 変更GET /quotes/{symbol} が標準の data・meta も返します。data.valuation は指標エンドポイントと同じ計算です。従来の最上位フィールドは残します(非推奨)。
    • 追加Data API 仕様書の英語版 /openapi.en.json(バックエンド openapi.json?lang=en)。英語・日本語のリファレンスで使います。
    • ドキュメントクイックスタートに企業データの例・レスポンスの形、MCP は PRO API 専用である旨、curl -G --data-urlencode の例を追加しました。ドキュメントのサイドバー・フッター・<head> に llms.txt・llms-full.txt のリンクを置きました。
    • 変更アカウントは申請制で発行するようになりました(利用申請)。発行されたアカウント ID とパスワードで開発者コンソールにログインし、キーの作成・ローテーション・失効をご自身で行えます。セルフサインアップと無料トライアルキーの新規発行は終了しました。発行済みのキーは引き続きご利用いただけます。
    • 追加PoC プラン(14日間)。Enterprise のエンドポイントを Enterprise の上限の半分で利用でき、AI 呼び出しは1日200回までです。期間が終了すると 403 POC_ENDED で停止します。
    • 追加コンソールでのキーのローテーション: 同じ名前・スコープで新しいキーを作成し、以前のキーをすぐに失効させます。
    • ドキュメント開発者ポータルを韓国語 · English · 日本語で提供します。
    • 追加新しいベース URL https://api.chickstockfi.com/openapi/v1(Data API)と https://api.chickstockfi.com/openapi/pro/v1(PRO API)。従来の www.chickstockfi.com のアドレスも引き続き利用できます。
    • 追加API リファレンスに PRO API の仕様を追加しました。仕様 JSON: /openapi-pro.json
    • 追加開発者コンソールで PRO API キー(ck_pers_)を発行できるようになりました。PRO プランが適用されたアカウントでのみ作成できます。
    • 削除GET /trending をドキュメントから削除しました。このエンドポイントの提供は終了しています。
    • ドキュメントガイドを新たに公開しました: クイックスタート、認証とAPIキー、レート制限とクォータ、エラーコード、データ規約、MCP 接続。
    • ドキュメントサンプルコードを curl · JavaScript fetch · Python requests に統一しました。その他の言語では、仕様 JSON からクライアントを生成してご利用ください。

    • 変更お客様向けのパスを /openapi/v1(Data API)と /openapi/pro/v1(PRO API)に統一しました。従来の /api/v1 のパスでも同じ API を利用できます。
    • 追加PRO プランで利用できるリモート MCP サーバー https://www.chickstockfi.com/openapi/pro/v1/mcp。PRO API キーまたは OAuth 2.1 で接続します。

    • 追加PRO API(Data · Ask · Bundle プラン)。開示・財務・株価・スクリーナー・業種・スケジュール・ブリーフ・レポートと対話型の質問を提供します。
    • 変更サービス概要(GET /)と記事の原文表示(/articles/{id}/read)を除き、Data API のすべてのエンドポイントでキーが必要になりました。

    • 変更GET /briefings/{symbol} の価格フィールドは、値がない場合 null になります。date は通常取引の取引日です。