patternfetch — Market-State Briefs for AI Trading Agents

patternfetch

patternfetch は、米国株式、ETF、暗号資産の現物市場を対象とする AI エージェント向けマーケットデータ API です。 ティッカーと時間足を指定して 1 回呼び出すだけで、トークン効率の高い市場状態レポートを取得できます。レポートには、コンパクトなローソク足、検出されたチャートパターンとローソク足パターン、サポートラインとレジスタンスライン、市場レジーム、解釈済みの指標（RSI、EMA）が含まれます。検出された各パターンには、バックテストで算出した過去の的中率と、同じ市場のパターンなしのベースラインに対するリフトが付与されるため、エージェントは情報価値のあるパターンとそうでないパターンを見分けられます。6 つのツール（brief、multi、delta、analogs、scan、capabilities）を REST と MCP から利用でき、ワンクリック OAuth、Stripe または Base 上の x402 USDC によるクレジット決済、キー不要のデモエンドポイント、登録時の $3 のスタータークレジットを備えています。個人を特定しないマーケットデータであり、投資助言ではありません。

データが少なくて済む理由： BTC/USDT の 4h（120 本のローソク足）の場合、生の OHLCV データは数値だけで約 3,260 トークンあり、モデルがさらに分析する必要があります。一方、patternfetch の解釈済み分析は約 1,323 トークンで、すでに結論が出ています。再現方法（アカウント不要）。

• 対象範囲： 米国株式と ETF（株式分割・配当調整済み、遅延/EOD、Yahoo 経由）、暗号資産の現物（リアルタイム、Binance 経由）。
• 時間足： 1m、5m、15m、30m、1h、4h、1d、1w。
• アクセス方法： REST は patternfetch.com/v1/*、MCP は patternfetch.com/mcp（Streamable HTTP）、およびローカルの stdio ブリッジ（patternfetch-mcp）。

ベースレートとリフトを使う理由

double_top, confidence 0.92 のように報告するだけの検出器では、そのパターンがこれまで何らかの意味を持ったことがあるのか、エージェントにはわかりません。patternfetch は、検出された各パターンに evidence ブロックを付与します。

{
  "name": "double_top",
  "confidence": 0.92,
  "evidence": {
    "scope": "US stocks & ETFs",
    "tf": "1d",
    "band": "0.75-1.00",
    "horizon": 10,
    "n": 7508,
    "hitRate": 0.431,
    "ci95": 0.011,
    "lift": {
      "baseline": 0.419979,
      "baselineN": 46038,
      "lift": 0.011021,
      "ci95": 0.012075,
      "informative": false,
      "reading": "indistinguishable-from-baseline"
    }
  }
}

hitRate は実現可能な総方向ベースレートです。つまり、対象のパターン、時間足、信頼度帯に該当する、重複のない過去の出現のうち、次の horizon 本のローソク足における終値から終値までのリターンが、予想された方向に動いた割合です。先読みが発生しないよう、将来の測定期間は検出時点から開始します。ストップ、手数料、スリッページはモデル化されていません。

lift は、その的中率を同じ市場でパターンが存在しない場合のベースラインと比較します。多くのパターンは「ベースラインと区別できない」という結果になります。これが誠実な結果であり、報告する意義でもあります。エージェントは、幾何学的な信頼度スコアをそのまま信じるのではなく、informative でフィルタリングできます。

較正。 監査済みの 105 カテゴリーのうち、信頼区間の範囲外となったのは 3 つです。105 回の比較で偶然だけから予想される約 5.3 件を下回ります。米国株式では 60 件中 0 件です。手法と全表は以下をご覧ください。 patternfetch.com/pattern-base-rates-study。この測定は、オープンソースの honest-signals ツールを使って再現できます。

クイックスタート

キーは不要です。デモエンドポイントは公開されています。

curl -X POST https://patternfetch.com/v1/demo \
  -H 'content-type: application/json' \
  -d '{"ticker":"AAPL","timeframe":"1d"}'

キーを使用する場合（セルフサービス、スタータークレジット $3）：

curl -X POST https://patternfetch.com/v1/keys -d '{"email":"[email protected]"}'

curl -X POST https://patternfetch.com/v1/brief \
  -H 'authorization: Bearer pf_...' \
  -H 'content-type: application/json' \
  -d '{"ticker":"BTC/USDT","timeframe":"4h"}'

JavaScript クライアント：

npm install patternfetch

import { Patternfetch } from 'patternfetch';

const { key } = await new Patternfetch().createKey('[email protected]');
const pf = new Patternfetch({ apiKey: key });

const brief = await pf.brief({ ticker: 'AAPL', timeframe: '1d' });

console.log(brief.analysis.nl);
// "AAPL: uptrend (strong), +0.14% last 1d, RSI 71.66 (overbought),
//  bearish_engulfing (conf 1, hist 41% over 10b, lift -0.7pp vs 42% base (within noise))."

for (const p of brief.analysis.patterns) {
  if (p.evidence?.lift.informative) console.log(p.name, p.evidence.hitRate, p.evidence.lift.lift);
}

ツール

MCP（patternfetch_*）と REST（POST /v1/*）で共通の6つのツールを利用できます。

ツール	返される内容	エージェントが呼び出すタイミング
brief	1つのティッカーと時間足を対象とした市場状況レポートです。簡潔なローソク足、ベースレートとリフトを含むパターン、サポート／レジスタンス、レジーム、RSI／EMA、1行の要約を返します。	デフォルトの選択肢です。生の OHLCV データをコンテキストに大量に含めずに、1つの市場の現在のテクニカルな状況を把握したい場合に使います。
multi	時間足ごとのレポート（デフォルトは 1h、4h、1d）に加え、時間足をまたいだ一致または乖離を示す分析結果を返します。例：1h up / 4h up / 1d down。	brief を3回個別に呼び出さずに、セットアップが複数の時間軸で確認されているか、相反するシグナルが出ているかを把握したい場合に使います。
delta	同じティッカーと時間足の前回のレポート以降に変化した内容のみを返します。トレンドの反転、新しいパターン、RSI 状態の変化などが対象です。重要な変化がない場合は changed: false を返します。	同じ市場を繰り返しポーリングする場合に使います。最初に brief を1回呼び出し、その後のポーリングでは毎回 delta を呼び出すことで、トークンコストをほぼゼロに抑えられます。
analogs	現在の値動きに形状が似た過去の期間と、その後に続いた値動きの全分布を返します。固定の将来期間における勝率、中央値、平均値、最小値、最大値、サンプル数を含みます。	点推定ではなく、セットアップ後に過去にどのような結果が出たかの分布を知りたい場合に使います。予測でも、戦略のバックテストでもありません。
scan	流動性の高い米国大型株、主要 ETF、セクター ETF、および主要な暗号資産ペアからなる厳選されたユニバースを対象とするスクリーナーです。資産クラス、レジーム、パターン、最低ベースレートで絞り込めます。結果はベースレート順に並び、95% 信頼区間を含みます。毎日事前計算されます。	すでに特定したティッカーを分析するのではなく、市場全体から候補を見つけたい場合に使います。絞り込んだ候補を brief に渡してください。
capabilities	対応する資産、時間足、エンドポイント、制限事項、料金を返します。入力は不要です。	カバレッジに関する前提に基づいて処理する前に、まず呼び出してください。

クライアントメソッド

メソッド	エンドポイント
brief({ticker, timeframe, limit?, fields?, market?})	POST /v1/brief
multi({ticker, timeframes?, limit?, market?})	POST /v1/multi
delta({ticker, timeframe, limit?})	POST /v1/delta
analogs({ticker, timeframe, window?, horizon?})	POST /v1/analogs
scan({assetClass?, regime?, pattern?, tf?, minBaseRate?, limit?})	POST /v1/scan
candles({ticker, timeframe})	POST /v1/candles
platforms()	GET /v1/platforms
createKey(email)	POST /v1/keys

MCP

patternfetch は https://patternfetch.com/mcp で利用できるリモート MCP サーバー（Streamable HTTP）です。 ツール：patternfetch_brief、patternfetch_multi、patternfetch_delta、patternfetch_analogs、 patternfetch_scan、patternfetch_capabilities。 検出（initialize、tools/list）は無料で、キーは不要です。認証が必要なのは tools/call のみです。

ワンクリック OAuth（貼り付け不要） — Claude Code、Claude Desktop、Cursor、または Smithery で URL を追加し、一度認証してください。無料プランのキーが発行されます。

claude mcp add --transport http patternfetch https://patternfetch.com/mcp

claude.ai の場合：Customize → Connectors → Add custom connector → https://patternfetch.com/mcp → Authorize。

または Bearer キーを使用 — MCP 設定に追加してください。

{
  "mcpServers": {
    "patternfetch": {
      "url": "https://patternfetch.com/mcp",
      "headers": { "Authorization": "Bearer pf_..." }
    }
  }
}

無料キー（少額のスタータークレジット付き）は https://patternfetch.com/v1/keys で取得できます。

ローカル stdio ブリッジ

ローカルの stdio サーバー（Claude Desktop、サンドボックス、インバウンド HTTP 不要）を使いたい場合、このパッケージに含まれる patternfetch-mcp は、依存関係のない stdio↔HTTP ブリッジです。同じツールを公開し、呼び出しを patternfetch.com に転送します。

{
  "mcpServers": {
    "patternfetch": {
      "command": "npx",
      "args": ["-y", "patternfetch-mcp"],
      "env": { "PATTERNFETCH_API_KEY": "pf_..." }
    }
  }
}

tools/list はキーなしで動作し、リモートに接続できない場合は組み込みスナップショット （mcp-tools.json）にフォールバックするため、イントロスペクションは常に成功します。ツール呼び出しには PATTERNFETCH_API_KEY、OAuth、または x402 を使用します。PATTERNFETCH_MCP_URL でエンドポイントを上書きできます。

稼働中のサーバーからスナップショットを更新します。

curl -s -X POST https://patternfetch.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

料金

登録時にスタータークレジットとして 3 ドルが付与され、そのうち少なくとも 0.50 ドルはカードなしですぐに利用できます。その後はクレジットから呼び出しごとに料金が差し引かれ、Stripe または Base 上の x402 USDC でチャージできます。Studio プランは月額 19 ドルで、25 ドル分の利用料が含まれます。

呼び出し	料金
/v1/brief	$0.010
/v1/multi	$0.025
/v1/delta	$0.008（変化がない場合は $0.001）
/v1/candles	$0.005
/v1/analogs	$0.050
/v1/scan	$0.020

リアルタイムの数値：GET /v1/platforms。

法的事項

patternfetch は、情報提供のみを目的とする非個人的な市場データおよびアルゴリズムによるシグナルを提供します。投資、金融、法律、税務に関する助言ではなく、証券または暗号資産の購入、売却、保有を推奨するものでもありません。出力はお客様に合わせて個別化されていません。基準レートは、損切り、手数料、スリッページを考慮しない総合的な方向別頻度です。過去の実績や過去の類似事例は、将来の結果を保証するものではありません。市場は変動し、資本をすべて失う可能性があります。ご自身で調査してください。patternfetch.com/disclaimer、/methodology、/termsをご覧ください。