alphapipeline

AlphaPipeline

オンチェーン取引エージェント向けの事前安全チェックゲートです。購入前にラグプルやハニーポットをチェックできるほか、市場・デリバティブのデータも取得できます。従量課金（1 回あたり $0.005～$0.03 USDC）で、登録、API キー、OAuth は不要です。 スワップ前にトークンのハニーポット、税率、流動性のリスクをチェックしたり、資金調達率、DEX のスリッページ、韓国の価格プレミアム、Polymarket のアービトラージシグナル、Hyperliquid HIP-4 の予測市場オッズを取得したりできます。Base 上の x402 protocol（HTTP 402）を使えば、1 回のリクエストで認証と支払いが完了します。また、Claude Desktop、Cursor、その他の MCP クライアントからリモート MCP サーバーとして呼び出すこともできます。

---

AlphaPipeline を選ぶ理由

AlphaPipeline はマシン向けのデータ APIです。すべてのエンドポイントは x402 を使った呼び出しごとの従量課金です。支払いヘッダーを含まないリクエストには、支払い方法（アセット、金額、ネットワーク、受取先）を明示した標準の HTTP 402 レスポンスが返されます。アカウントの作成、ダッシュボード、API キーの発行は不要です。署名し、支払い情報を添えてリクエストを再送信すれば、同じリクエスト／レスポンスのサイクル内でデータが返されます。

また、リモート MCP サーバー（POST /mcp）としても公開されているため、エージェントフレームワーク（Claude Desktop、Cursor、LangChain、CrewAI など、MCP に対応したもの）は、カスタム連携コードなしでツールを検出して呼び出せます。

セキュリティクラスターは、この API で最も実運用での検証が進んでいる部分です。 security.token_risk、security.contract_health_audit、security.token_diagnostic は、Base 上で実際のオンチェーンスワップを行う前の安全チェックゲートとして稼働してきました。単なる参考情報ではなく、資金をリスクにさらす前に取引パイプラインへ組み込まれた、実際の実行可否判断の入力として使われています。この 3 つはいずれも定性的な判定フィールド（safe_to_execute: true/false など）を返しません。GoPlus／Honeypot.is の生の数値を返すため、購入するかどうかの判断は利用者側のコードで行ってください。

• ツールの検出は常に無料です。 initialize と tools/list は支払いを要求しないため、支払う前にツールのカタログ全体を確認できます。
• オンボーディング用のエンドポイント 2 つは恒久的に無料です（unlocks.dump_risk と market.kimchi_alert。詳細は下記参照）。そのためエージェントは、セキュリティクラスターやその他のツールへの支払いを始める前に、接続、レイテンシ、レスポンススキーマを確認できます。
• 決済は Base のメインネット（eip155:8453）上で、Coinbase CDP（Developer Platform）Facilitator を介して処理されます。 使用アセットは USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）です。

エンドポイントは Coinbase による審査を受けていません。資金を送る前に、信頼できることをご確認ください。

---

クイックスタート — リモート MCP

MCP クライアントの設定（Claude Desktop の claude_desktop_config.json、Cursor の .cursor/mcp.json など）に以下を追加してください。

{
  "mcpServers": {
    "alphapipeline": {
      "url": "https://alphapipeline-eu.onrender.com/mcp"
    }
  }
}

tools/list は支払いなしですぐに利用できます。料金が設定されたツールに対する tools/call には、支払いに署名してリクエストを再試行できる x402 対応クライアントが必要です（ウォレットを保持するボット／エージェントのクライアントが必要です。一般的なチャット UI の多くは自動で支払いできません）。公式の x402 SDK を使った動作する Python クライアントについては、examples/ をご覧ください。

クイックスタート — プレーン REST / x402

curl -s "https://alphapipeline-eu.onrender.com/v1/security/token-risk?chain_id=8453&contract_address=0x..."
# -> HTTP 402, payment terms in the `payment-required` response header (base64 JSON)
# sign a payment, retry with the PAYMENT-SIGNATURE header attached -> 200 + data

クライアント作成者向けの注意： このサーバーは x402 v2 を使用します。402 レスポンスの本文は空の {} です。実際の支払い条件（accepts 配列、価格、アセット、送金先アドレス）は本文ではなく、payment-required レスポンスヘッダーに Base64 でエンコードされた JSON として含まれています。以前の本文形式の仕様に基づいて作成されたクライアントは、エラーなく空のオブジェクトを受け取るため、明確な失敗にはなりません。代わりにヘッダーをデコードしてください。

unlocks.dump_risk と market.kimchi_alert に関する注意： どちらもオンボーディング用ツールとして意図的に無料（x402 の支払い不要）にしています。これらは情報提供を目的とした市場コンテキストのシグナルであり、有料の検証済み取引前セキュリティクラスター（security.token_risk、security.contract_health_audit、security.token_diagnostic）には含まれません。サードパーティの検出カタログ（x402 Bazaar など）に、この変更前の古いゼロ以外の価格がどちらかに表示されている場合は、このサーバー自身の / レスポンスと MCP の tools/list 出力を正として扱ってください。これらには常に現在の価格が反映されています。

ツール名に関する注意： MCP ツール名には domain.tool_name というドット区切りの表記（例：market.kimchi_alert）を使用しているため、ツールリストはドメインごとにナビゲートできるツリーになります。/v1/<domain>/... 以下の REST パスには影響せず、引き続き安定しています。

プロトコルの全リファレンス：/llms.txt · x402 ドキュメント

今すぐ試す — ウォレット、登録、支払いは不要

支払いを行うクライアントを接続する前に、check-my-slippage を実行して、このサービスが本番環境のエンドポイントに対して実際のライブデータを返すことを確認してください。

npx check-my-slippage

実際の出力（2026-09-18 に本番環境から直接取得。モックのサンプルではありません）：

Checking live Polymarket exit-liquidity via AlphaPipeline...

Market:            will-the-fed-decrease-interest-rates-by-25-bps-after-the-october-2026-meeting-... (sell)
Position size:     500 shares
Executable:        true
Best quote:        $0.0060
Avg exit price:    $0.0060
Price impact:      0%
Data source:       polymarket-clob
Latency:           88ms

Want this for any market/size, in your own bot?
-> https://github.com/parkyucheol-del/alphapipeline

これは無料で、レート制限（IP ごとに 10 回/分）付きの GET /v1/prediction/preview-slippage を呼び出します。支払いヘッダーもクエリパラメーターも不要で、常に固定のベンチマーク市場に対して実行されるため、任意の市場やサイズを指定できる有料の prediction.exit_capacity_audit に支払う前に、データ品質を判断できます。お使いの環境で npx check-my-slippage が解決されない場合は、代わりにエンドポイントを直接呼び出してください：curl https://alphapipeline-eu.onrender.com/v1/prediction/preview-slippage。または、このリポジトリをクローンして、ソースから node check-my-slippage/bin/index.js を実行してください。

コピーして使えるクライアント — DEX 購入前の安全ゲート

Base 上の新しいトークンを購入するスナイピング／検出ボットを構築している場合、これは私たちのドッグフーディング用ボット（alphapipeline-dogfood-bot）が、すべてのオンチェーン購入前に回避不能なハードゲートとして使用しているパターンです：security.token-diagnostic に $0.03 を支払い、返された生のフィールドに独自のしきい値を適用します（このサーバーは safe_to_buy: true/false の判定を返しません。AlphaPipeline を選ぶ理由を参照）。examples/client_example.py を元にしています：

# pip install "x402[https]" eth_account httpx
import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

API = "https://alphapipeline-eu.onrender.com"

async def is_safe_to_buy(contract_address: str, chain_id: int = 8453) -> bool:
    account = Account.from_key(os.environ["EVM_PRIVATE_KEY"])  # dedicated small wallet only
    client = x402Client()
    register_exact_evm_client(client, EthAccountSigner(account))
    async with x402HttpxClient(client) as http:
        r = await http.get(f"{API}/v1/security/token-diagnostic",
                            params={"contract_address": contract_address, "chain_id": chain_id})
        await r.aread()
        diag = r.json()  # $0.03 USDC charged on Base mainnet — no free tier for this one

    return (
        diag.get("is_honeypot") is not True
        and (diag.get("buy_tax_pct") or 0) <= 10
        and (diag.get("sell_tax_pct") or 0) <= 10
        and diag.get("liquidity_health") in ("LOCKED", "PARTIALLY_LOCKED")
    )

if __name__ == "__main__":
    print(asyncio.run(is_safe_to_buy("0xYourTargetTokenContract")))

しきい値（購入／売却税率、許容する liquidity_health の値、risk_flags_count など）は、ご自身のリスク許容度に合わせて調整してください。フィールドの全一覧は、以下の security.token-diagnostic スキーマに記載されています。これは、実際の USDC を使う前に、候補ごとに私たちのドッグフーディング用ボットが実行するロジックそのものです。

---

ツール／エンドポイント

ツール（MCP）	REST エンドポイント	価格	機能
security.token_prescreen	GET /v1/security/token-prescreen	$0.01	取引前チェック、最安ティア — バッチスクリーニング用フィルターです。LP のロック／バーン状態（contract_health_audit と同じ GoPlus 呼び出しで、上流コストの追加なし）と、GeckoTerminal のトッププールの USD 流動性（dex.liquidity_slippage と同じソース）を、1 つの最小限のレスポンスで確認します。まず多くの候補に対して実行し、実際の流動性がないものや LP がロックされていないものを低コストで除外してから、残った候補にのみ token_risk／contract_health_audit／token_diagnostic を利用します。ハニーポット／税金／ミントのチェックと LP 保有者の内訳はありません。これらについては各ツールを参照してください。chain_id が GeckoTerminal にマッピングされていない場合、liquidity_usd は null になります（現在は Base、Ethereum、BSC、Polygon、Arbitrum、Optimism、Avalanche に対応）。LP ロックデータには影響しません。
security.token_authenticity	GET /v1/security/token-authenticity	$0.01	取引前チェック、最安ティア — GoPlus の fake_token／trust_list／honeypot_with_same_creator フィールド（token-risk／contract-health-audit／token-prescreen と同じ GoPlus 呼び出しで、上流コストの追加なし）を使って、既知の主要資産（例：偽の「USDC」）になりすましたコントラクトにフラグを立てます。flagged_as_counterfeit: false は真正性の証明ではありません。照会時に GoPlus が該当するフラグを検出しなかったことだけを意味します。true_token_address は flagged_as_counterfeit が true の場合にのみ設定されます。ハニーポット／税金／LP のチェックはありません。これらについては token_risk／contract_health_audit を参照してください。これらのフィールドに対する Honeypot.is のフォールバックはありません。
security.token_risk	GET /v1/security/token-risk	$0.02	取引前チェック — 購入またはスワップの前に呼び出してください。GoPlus／Honeypot.is によるコントラクトセキュリティ監査です（ハニーポットフラグ、購入／売却税、ミント可能性、所有権の放棄、および個別の GoPlus シグナル — cannot_sell_all、hidden_owner、transfer_pausable、selfdestruct、is_blacklisted、slippage_modifiable、所有者の集中度 — は risk_flags にまとめられます）。多数の候補をスクリーニングしますか？このツールの料金を支払う前に、より安価な一次フィルターとして security.token_prescreen（$0.01）を利用できます。
security.contract_health_audit	GET /v1/security/contract-health-audit	$0.02	取引前チェック — token-risk と同じ GoPlus データを再利用する LP（流動性プール）のロック／バーン監査です。信頼する前に、流動性がロック済みか、バーン済みか、単一ウォレットによって自由に保有されているかを確認します。多数の候補をスクリーニングしますか？security.token_prescreen（$0.01）は同じ LP ロックチェックと流動性の数値をより低価格で再利用します。
security.token_diagnostic	GET /v1/security/token-diagnostic	$0.03	取引前チェック — token_risk と contract_health_audit を 1 回の呼び出しにまとめます（同じ GoPlus データを使用し、新たな上流呼び出しはありません）。スワップ前に、単一の実行可否判断に必要な情報を得られます。合成スコアやレターグレードはなく、両ツールのフィールドと重複を除いた risk_flags の統合のみを返します。個別に両方を呼び出すより安価です。多数の候補をスクリーニングしますか？このツールの料金を支払う前に、より安価な一次フィルターとして security.token_prescreen（$0.01）を利用できます。
dex.liquidity_slippage	GET /v1/dex/liquidity-slippage	$0.02	GeckoTerminal による DEX プールの流動性と推定取引スリッページに加え、固定の $1k／$5k／$10k の slippage_tiers、pool_fee_pct、assumed_gas_cost_usd の推定値、および quote_token_is_stablecoin（選択したプールが USD 建てではなく、追加のホップが必要な場合にフラグを設定）を返し、深さをひと目で確認できます。token_address を指定して呼び出した場合は、direct_stablecoin_pool_exists も返します。選択したプールが USD 建てではない場合は alternate_direct_pool（同じトークンの別の USD 建てプール）も返すため、スワップ前にマルチホップのルートが本当に必要かどうかを確認できます。
derivatives.whale_position_audit	GET /v1/derivatives/whale-position-audit	$0.02	指定した Hyperliquid ウォレットアドレスを監査します。オープンポジション、レバレッジ、max_leverage、清算価格、損益、および return_on_equity_pct（後者 2 つは Hyperliquid が報告するフィールド）を確認します。ウォレットの発見やランキングは行いません。Hyperliquid の公開 API にはリーダーボードのエンドポイントがありません。
derivatives.funding_rate	GET /v1/derivatives/funding-rate	$0.01	Bybit（優先）／Binance（フォールバック）の無期限先物ファンディングレートに加え、mark_price／index_price（どちらの経路でも取得）と open_interest_usd（Bybit 経路のみ。Binance へのフォールバック時は null）を返します。
derivatives.funding_rate_value	GET /v1/derivatives/funding-rate-value	$0.001	低価格ティア — funding_rate の薄いラッパーです。同じキャッシュ済みの呼び出しを使い、funding_rate／funding_rate_percentage のみを返します（マーク／インデックス価格と未決済建玉は返しません）。新たな上流呼び出しはありません。
derivatives.funding_apr_matrix	GET /v1/derivatives/funding-apr-matrix	$0.01	現在のファンディングレートを年率換算して APR を算出し、想定される往復取引コストに対するキャリートレードの損益分岐日数を計算します。
arb.spread_matrix	GET /v1/arb/spread-matrix	$0.02	CEX（Coinbase の現物）と DEX（GeckoTerminal）のスプレッド計算ツールです。ガス代を考慮した収益性フラグに加え、pool_fee_pct（参考情報であり、スプレッドから差し引かれません）を返します。
prediction.neg_risk_arbitrage	GET /v1/prediction/neg-risk-arbitrage	$0.03	Polymarket の neg-risk（相互排他的な複数結果）イベントにおけるバスケット裁定機会を検出します。YES の全結果を含むバスケットは必ず $1 で決済されるため、コスト控除後のバスケット価格が $1 から乖離していれば、ほぼリスクフリーの優位性があります。現在実際に約定可能な流動性のボトルネック規模（最良気配値だけでなく VWAP 価格に基づく）と、oldest_book_snapshot_time（各レッグの古さによるボトルネック）も返します。Polymarket 専用です。
prediction.exit_capacity_audit	GET /v1/prediction/exit-capacity-audit	$0.02	Polymarket の結果のリアルタイム注文板を確認し、指定したポジションサイズが今すぐ実際に約定可能か、平均価格と価格インパクトがどの程度かを調べます。book_snapshot_time／tick_size／min_order_size も返します。token_id または完全一致する market_slug で解決します。
prediction.order_split_guide	GET /v1/prediction/order-split-guide	$0.02	Polymarket の結果のリアルタイム注文板を確認し、大きなポジションをいくつの分割注文に分ければ、各注文の価格インパクトを max_price_impact_pct_per_slice（デフォルト 1.0％）以下に抑えられるかを推奨します。比較用に、一括注文した場合の基準値として full_size_price_impact_pct も返します。単一スナップショットに基づく計算のため、実際の取引で注文間に板が補充されるかどうかは考慮しません。レスポンス内の notice フィールドを参照してください。exit_capacity_audit の注文板ヘルパーを再利用し、新たな上流呼び出しはありません。token_id または完全一致する market_slug で解決します。
prediction.bid_ask_spread_pct	GET /v1/prediction/bid-ask-spread-pct	$0.001	低価格ティア — Polymarket の 1 つの結果について、リアルタイムの最良買い気配値／売り気配値のスプレッドを mid_price に対する割合で返します。流動性や約定可能性を示す指標ではありません（その確認には exit_capacity_audit／order_split_guide を使用してください）。同じ注文板の取得処理を再利用し、新たな上流呼び出しはありません。token_id または完全一致する market_slug で解決します。
prediction.orderbook_imbalance_ratio	GET /v1/prediction/orderbook-imbalance-ratio	$0.01	Polymarket の 1 つの結果について、各サイドの最良気配値から depth_band_pct（デフォルト 5.0％）以内の注文板の深さを合計し、買い側と売り側の比率を返します。0.5 は均衡、1.0 に近いほど買い側が優勢、0.0 に近いほど売り側が優勢です。説明的な指標にすぎず、価格方向の予測ではありません。確信度や判定フィールドもありません。同じ注文板の取得処理を再利用し、新たな上流呼び出しはありません。token_id または完全一致する market_slug で解決します。
prediction.liquidity_depth_after_haircut	GET /v1/prediction/liquidity-depth-after-haircut	$0.02	Polymarket の 1 つの結果について、最良気配値から max_price_impact_pct（デフォルト 5.0％）以内で約定可能な深さを、トップ・オブ・ブックの価格帯のサイズを haircut_pct（デフォルト 10.0％）で割り引く前と後の両方で返します。最良気配値の取り消しリスクをモデル化しますが、実際のスプーフィングを検出または警告するものではありません（対象外です。architecture-roadmap.md のフェーズ 3 を参照してください）。同じ注文板の取得処理を再利用し、新たな上流呼び出しはありません。token_id または完全一致する market_slug で解決します。
prediction.polymarket_fee_estimate	GET /v1/prediction/polymarket-fee-estimate	$0.01	仮定した約定に対する Polymarket 独自のテイカー手数料（shares * fee_rate * price * (1 - price)、公式のベルカーブ式）を返します。ガス代、スリッページ、AlphaPipeline 独自の料金ではありません。fee_rate は完全一致する token_id について、Polymarket 独自の GET /fee-rate からリアルタイムに取得され、固定のカテゴリ別テーブルは使用しません（カテゴリごとのレートは過去に変更されています。architecture-roadmap.md の Engineering Precision Backlog 項目 3 を参照してください）。どの市場でもメイカー手数料は 0 で、テイカー手数料のみです。price を省略すると、現在の最良注文板気配値が使われます。token_id または完全一致する market_slug で解決します。
prediction.polymarket_mispricing	GET /v1/prediction/polymarket-mispricing	$0.03	決済条件が同じだと利用者自身が主張する Polymarket 市場間で単調性をチェックします（行使価格が高い市場の価格が、低い市場より高くなってはなりません）。このエンドポイントは、その同一性を検証したり推定したりしません（Polymarket の API には、それを示す信頼できるフィールドがありません。architecture-roadmap.md の Engineering Precision Backlog 項目 4 と、レスポンス内の notice を参照してください）。token_ids または market_slugs（任意の outcomes を追加可能）を受け付けます。投資助言ではありません。
prediction.hip4_snapshot	GET /v1/prediction/hip4-snapshot	$0.01	Hyperliquid の HIP-4 結果市場のリアルタイム確率スナップショットです。暗号資産価格の二値市場、スポーツ試合の勝者、トーナメント優勝者、FRB の金利決定、および Hyperliquid が追加する新しい市場タイプを、1 回の呼び出しで取得します。厳選された市場リストはありません。すべての fields 値は Hyperliquid 独自の説明文字列からそのまま解析されます。任意の template／underlying フィルターで結果を絞り込めます。Hyperliquid 専用です。
prediction.hip4_price_ladder	GET /v1/prediction/hip4-price-ladder	$0.01	1 つの原資産について、HIP-4 の「$X 超」価格二値市場を行使価格ラダーに並べ、各段のリアルタイムの Yes 確率を表示します。hip4_snapshot の生リストを調べなくても、市場が示唆する価格分布をひと目で確認できます。hip4_snapshot のキャッシュ済みデータを再利用し、新たな上流呼び出しはありません。出来高フィールドはありません。Hyperliquid は HIP-4 の結果ごとの出来高を公開していません。underlying は必須です。Hyperliquid 専用です。
prediction.hip4_price	GET /v1/prediction/hip4-price	$0.002	低価格ティア — 1 段のみを検索します。hip4_price_ladder のキャッシュ済みデータを再利用し、要求された strike に最も近い行使価格の段だけを、matched_strike とともに返します。これにより、近い段が存在しない場合も判別できます。新たな上流呼び出しはありません。underlying と strike は必須です。Hyperliquid 専用です。
prediction.hip4_mispricing	GET /v1/prediction/hip4-mispricing	$0.02	1 つの原資産の HIP-4「$X 超」価格二値市場における単調性違反を検出します。同じ満期／期間内では、行使価格が高い市場の Yes 価格が、低い市場を上回ることはありません。逆転があれば、violation_bp と、教科書的な max_riskless_profit_per_usd を付けてフラグを立てます（違反の規模そのものを示し、手数料／スリッページ／執行リスク控除前の値です。投資助言ではありません）。hip4_price_ladder のキャッシュ済みデータを再利用し、新たな上流呼び出しはありません。完全に同じ (expiry, period) を共有する段同士のみを比較します（settlement_condition_note を参照）。underlying は必須です。Hyperliquid 専用です。
market.cycle_compare	GET /v1/market/cycle-compare	$0.01	現在の半減期（2024-04-20）以降の BTC／ETH 価格リターンを、2016 年と 2020 年の半減期後サイクルにおける同じ経過日数の値と比較します。今日の実際の BTC ドミナンスと DXY／米国 10 年債利回りのマクロ状況も含みます。毎日更新されるキャッシュを参照します（リクエスト時のリアルタイム上流呼び出しはありません）。生の価格比較であり、時系列の真の時価総額ドミナンスではありません。レスポンス内の notice フィールドを参照してください。ETH は 2016 年にはまだ存在していなかったため、2016 年サイクルの ETH 数値はありません。
market.oracle_gap	GET /v1/market/oracle-gap	$0.01	1 つの無期限先物について、Hyperliquid のミッド価格とマーク価格／オラクル価格の差を単一スナップショットで返します。これは、HyperEVM での 2026-10-10 の Papertrade インシデントの原因となった障害モードを確認するものです（プロトコルがマーク価格／オラクル価格ではなく生のミッド価格を参照し、攻撃者が Hyperliquid 上で約 $2.31B の想定元本を動かしてミッド価格を約 12bp 変動させ、約 $1.28M の利益を得ました）。ベーシスポイント単位の mid_oracle_gap_bp／mark_oracle_gap_bp と、固定しきい値に基づく elevated フラグ（abs(mid_oracle_gap_bp) >= alert_threshold_bp）を返します。価格操作の判定ではありません。時点ごとの単一スナップショットであり、Hyperliquid が市場ごとの取引量を公開していないため、取引フロー／出来高データはありません。
market.oracle_gap_bp	GET /v1/market/oracle-gap-bp	$0.001	低価格ティア — oracle_gap の薄いラッパーです。同じキャッシュ済みの呼び出しを使い、bp 単位のギャップ数値と elevated フラグのみを返します（ミッド／マーク／オラクルの絶対価格は返しません）。新たな上流呼び出しはありません。
calendar.macro_dday	GET /v1/calendar/macro-dday	$0.01	静的に事前読み込みされたカレンダーに基づき、最も近い主要な米国マクロイベント（FOMC、CPI、NFP）までのカウントダウンを返します。外部 API 呼び出しはなく、上流の障害によって失敗することもありません。
tools.ai_markdown	GET /v1/tools/ai-markdown	$0.005	任意の Web ページ URL を、LLM のコンテキストウィンドウに最適化された広告なしのクリーンな Markdown に変換します。
market.kimchi_alert	GET /v1/market/kimchi-alert	無料	韓国（Upbit）と世界の参照価格（Coinbase の現物、CoinGecko はフォールバック。リアルタイムの Binance 注文板ではありません）のプレミアム、つまり「キムチプレミアム」をリアルタイムで取得し、逆プレミアムと 1 時間急騰のアラートを返します。オンボーディングツールとしてデフォルトで無料です。情報提供を目的とした市場コンテキストであり、有料の取引前セキュリティツール群には含まれません。
unlocks.dump_risk	GET /v1/unlocks/dump-risk	無料	トークンのロック解除／ベスティングに伴う売り圧力リスクのオンチェーン（Sablier）プロキシです。ベスティングがどこまで進んでいるかを示す vesting_progress_pct（引き出し済み／デポジット）も含みます。オンボーディングツールとしてデフォルトで無料にし、残りのサービスに料金を支払う前にエージェントがサービスを確認できるようにしています。
[実験的] events.hip4_alerts	GET /v1/prediction/hip4-alerts/event-types (無料) · GET /v1/prediction/hip4-alerts/subscribe ($0.02) · POST /v1/prediction/hip4-alerts/unsubscribe (無料)	以下を参照	自分で hip4_snapshot をポーリングする代わりに、HIP-4 の確率急変／新市場について Webhook プッシュアラートを受け取れます。デフォルトでは無効です（HIP4_EVENTS_ENABLED=false）。以下の「イベントサブスクリプション」を参照してください。
すべてのレスポンスには UTC と KST の両方でタイムスタンプが付与され、価格が設定されたエンドポイントの支払いプロンプトには「Paid in USDC on Base.」と表示されるため、ブラウザーで 402 画面を見た人が、どのチェーンの USDC を送ればよいのか迷うことはありません。

イベントサブスクリプション（Webhook プッシュ） — EXPERIMENTAL

2026-09-30 に追加。まだドラフト段階の MCP Events 拡張機能（ github.com/modelcontextprotocol/experimental-ext-triggers-events — まだ公式仕様ではなく、リクエスト／レスポンスの形式は変更される可能性があります）を大まかに参考にしています。自分で GET /v1/prediction/hip4-snapshot をポーリングする代わりに、Webhook を登録すると、HIP-4 の結果の確率が指定したしきい値以上変動したとき、または新しい HIP-4 市場が現れたときに、Standard Webhooks 署名（webhook-id ／ webhook-timestamp ／ webhook-signature、"{id}.{timestamp}.{body}" に対する HMAC-SHA256）付きの POST がプッシュされます。

利用する前に知っておくべき注意点：

• これはポーリングであり、リアルタイムのプッシュフィードではありません。 Hyperliquid の HIP-4 には Webhook／ストリーミング API がないため、内部ではこのサーバーが HIP4_EVENTS_POLL_INTERVAL_SECONDS ごとに（デフォルトは 300s = 5 min）get_hip4_snapshot() を再取得し、差分を検出します。変動が実際に起きてから最大でその時間が経過して、ようやく報告される可能性があります。
• デフォルトでは無効です（HIP4_EVENTS_ENABLED=false）。無効な間は、サブスクリプション用ルートが支払いミドルウェアに登録されず、ハンドラー自体も有効かどうかを再確認して 503 を返すため、配信されることのないサブスクリプションに課金されることはありません。
• 再起動後もサブスクリプションが維持されるとは限りません。 ローカルの JSON ファイル（HIP4_EVENTS_DATA_FILE、デフォルトは data/hip4_event_subscriptions.json）に保存されます。長期間稼働する単一の Render インスタンスであれば問題ありませんが、ディスクがリセットされると失われます。まだ実際のデータベースには保存されていません。
• hip4.resolving（解決／決済が間近）は実装されていません。Hyperliquid の outcomeMeta では、検証済みの解決タイムスタンプが公開されておらず、このプロジェクトでは、実データで裏付けられないフィールドを決して捏造しない方針です。現在利用できるのは hip4.prob_jump と hip4.market_created のみです。
• MCP クライアントは、/mcp 上の events/list ／ events/subscribe ／ events/unsubscribe JSON-RPC メソッドと同じ 3 つの操作を利用できます（実験的な capabilities.extensions["io.modelcontextprotocol/events"] キーの下で宣言）。events/subscribe は内部で同じ有料 REST ルートを呼び出すため、料金と支払い方法はどちらも同じです。
• 任意のノイズフィルター（HIP4_EVENTS_CLEF_FILTER_ENABLED、デフォルトは false）。 有効にすると、各 hip4.prob_jump 候補は配信前に Cloudflare Workers AI の clef-flash 判断モデルでスコア付けされます（CLOUDFLARE_ACCOUNT_ID ／ CLOUDFLARE_API_TOKEN が必要です）。HIP4_EVENTS_CLEF_SIGNAL_THRESHOLD（デフォルトは 0.3）を下回るスコアの候補は送信されません。このスコアには、取引量やオーダーブックの厚さのデータは使われません。Hyperliquid の公開 HIP-4 API では、どちらも公開されていないためです。そのため、判断材料は確率の変動のみです。Cloudflare の呼び出しに失敗した場合や、認証情報が不足している場合は、フェイルオープンとなり、イベントは配信されます。ただし、本来付与される追加の clef_signal フィールドは付与されません。

HIP4_EVENTS_ENABLED=true を設定してデプロイした後に行う簡単なテスト：

curl -G https://alphapipeline-eu.onrender.com/v1/prediction/hip4-alerts/subscribe \
  --data-urlencode "webhook_url=https://webhook.site/your-id" \
  --data-urlencode "secret=replace-with-a-random-32-byte-secret"
# -> 402 with payment terms, same as any other endpoint here; pay, retry, get a subscription_id back

注：これはクエリパラメーターを使う GET であり、JSON ボディを使う POST ではありません。その結果として生じるトレードオフについては、エンドポイントの説明にある secret の注記をご覧ください（secret は URL のクエリ文字列内を通過します）。

データソース

返される数値はすべて、以下のアップストリームのいずれかから変更せずに引き継いだものか、それらに基づく決定論的な計算値です。第三者の推定値を、自分たちのものとして提示することはありません。

ドメイン	上流サービス	備考
market.kimchi_alert、arb.spread_matrix（CEX側）	Upbit（KRW）＋Coinbase spot、CoinGecko（フォールバック）	旧式の binance_price_usdt フィールド名は後方互換性のため維持されていますが、リアルタイムのBinance注文板ではありません。cex_reference_price_usdt／cex_price_sourceを参照してください。
security.token_risk、security.contract_health_audit、security.token_diagnostic、security.token_prescreen（LPロック部分）、security.token_authenticity	GoPlus Security API、Honeypot.is（フォールバック。token_authenticityにはフォールバックなし）	5つすべてで同じGoPlusデータを再利用しており、独立したセカンドオピニオンはありません。
derivatives.funding_rate、derivatives.funding_apr_matrix	Bybit v5（プライマリ）、Binance premiumIndex（フォールバック）	open_interest_usdはBybitのみです。Binanceへのフォールバック時は常にnullです。
derivatives.whale_position_audit	Hyperliquid公開API（clearinghouseState）	上流にランキング／発見用エンドポイントはありません。ウォレットアドレスを指定する必要があります。
dex.liquidity_slippage、arb.spread_matrix（DEX側）、security.token_prescreen（流動性部分）	GeckoTerminal	流動性の厚みは、トークンごとの実際の準備金ではなく、定積積（50:50）による概算です。この点はレスポンス自身の notice フィールドで開示されています。token_prescreenのliquidity_usdは、GeckoTerminalのネットワークスラッグに対応付けられていないチェーンではnullです（現在の対応チェーン：Base、Ethereum、BSC、Polygon、Arbitrum、Optimism、Avalanche）。
unlocks.dump_risk	オンチェーンのSablierベスティングストリーム（デフォルト、無料）	VC／チームの分類と正確なロック解除時刻には、有料のDropsTabキーが必要です（デフォルトでは無効）。それ以外の場合は常にnullです。nullを安全性の指標として扱わないでください。
calendar.macro_dday	静的な事前読み込み済みカレンダー	外部APIを呼び出さないため、上流の障害で失敗することはありません。ただし、イベントがカレンダーから過ぎていくため、手動で更新する必要があります。
prediction.neg_risk_arbitrage、prediction.exit_capacity_audit、prediction.order_split_guide、prediction.bid_ask_spread_pct、prediction.orderbook_imbalance_ratio、prediction.liquidity_depth_after_haircut、prediction.polymarket_fee_estimate、prediction.polymarket_mispricing	Polymarket Gamma API（イベント／市場のメタデータ）＋Polymarket CLOB API（注文板、GET /fee-rate）	book_snapshot_time／tick_size／min_order_size／base_fee_bpはPolymarketが報告する値で、そのまま渡されます。
prediction.hip4_snapshot	Hyperliquid公開API（outcomeMeta＋allMids）	ランキング／厳選リストはなく、Hyperliquidが現在掲載しているすべての市場が表示されます。outcome_idからallMidsの価格キーへのマッピングはHyperliquidによって文書化されておらず、ライブデータからリバースエンジニアリングされました（2026-09-28）。この点はレスポンス自身のnoticeフィールドで開示されています。
prediction.hip4_price_ladder	prediction.hip4_snapshotと同じHyperliquid公開API。両方の呼び出しはキャッシュされます	hip4_snapshot自身のデータを並べ替え／フィルタリングするだけです。別の上流呼び出しはなく、上流が提供しない出来高フィールドもありません。
market.oracle_gap	Hyperliquid公開API（metaAndAssetCtxs）	ミッド／マーク／オラクル価格はHyperliquidが報告するフィールドで、各呼び出し時に最新の値を読み取ります（キャッシュ期間は短く、ORACLE_GAP_CACHE_TTL_SECONDSのデフォルトは3秒）。ギャップの確認はリアルタイムに近い時点でのみ意味があるためです。取引フロー／出来高データはありません。Hyperliquidはこれを公開していません。
market.cycle_compare	Yahoo Finance（BTC-USD／ETH-USDの全価格履歴、DX-Y.NYB、%5ETNX）＋CoinGecko /global（今日のドミナンスのみ）	毎日のGitHub Actions cronが単一のJSONキャッシュを書き込み、エンドポイントはそのファイルを読み取るだけです。CoinMetrics Community（現在はすべて401）、CoinGeckoの過去の世界時価総額チャート（有料プランのみ）、CoinGeckoの無料Demoプラン（履歴は365日まで）、Krakenの公開OHLC（720本のローソク足まで）はすべて試したうえで候補から外し、最終的にYahooを採用しました。scripts/collect_btc_cycle_metrics.pyのモジュール docstringを参照してください。
tools.ai_markdown	指定したURL	サードパーティのデータプロバイダーは使わず、指定されたページを取得して変換します。
[EXPERIMENTAL] events.hip4_alerts	prediction.hip4_snapshotと同じHyperliquid公開API。HIP4_EVENTS_POLL_INTERVAL_SECONDSごとに再ポーリング	Hyperliquidからのプッシュ型フィードではなく、ポーリングと差分検出を行います。上記の「イベントのサブスクリプション」を参照してください。

---

作業中 — 株価乖離フィード（4週間のデータ試験、2026-10-08開始）

現在は1時間ごとにデータを収集しており、まだ販売していません。scripts/collect_stock_discrepancy.py は .github/workflows/stock-discrepancy-collect.yml を通じて1時間ごとに実行され、data-public/stock_discrepancy_log.jsonl に追記します（data/ ではありません。このディレクトリは HIP-4 のウェブフックシークレットを保護するため gitignore に含まれており、このデータに機密情報はありません）。ここに有料エンドポイントはありません。これは、有料化するかどうかを判断するための根拠を集めているだけです。

追跡対象：直近の通常取引時間の終値、Base の B20 トークン価格（GeckoTerminal 経由の Aerodrome）、Hyperliquid HIP-3 株式パーペチュアルのマーク価格とファンディング、および銘柄ごと・時間ごとの両者の乖離率です。銘柄リスト：NVDA、AAPL、META、GOOGL — 以前の概要で挙げられていた TSLA/MSTR/COIN は含まれません。現時点で Aerodrome 上に Coinbase B20/cbStock トークンが存在することを確認できていないためです（追加し直す前に再確認してください）。

開始／保留の判断期限は約2026-11-05（開始から4週間後） — 次の3項目のうち2つを満たす必要があります：

1. 週末の乖離の方向（金曜終値 → 日曜夜）が、翌月曜の寄り付きギャップの方向と65％以上の確率で一致すること（サンプル：週末4回 × 銘柄数、およそ16～20データポイント）。
2. いずれかの銘柄で、週末ごとに少なくとも1回は乖離が1％を超えること — これがなければ、そもそもアラート製品として成立しません。
3. データ欠損（data_gap: true の行。プールの流動性不足や上流 API エラーによるもの）が全行の10％以下に収まること。

3項目のうち2つを満たさない場合：シグナルが弱い状態で有料ローンチを無理に進めないでください。代わりに無料の公開ダッシュボードとして提供し、AlphaPipeline の他の機能へ誘導するトラフィックファネルとして活用します。

副次的な無料フィード：同じ cron で、Kalshi の KXBTC15M 15分／1時間の暗号資産予測市場もスナップショットし（公開・認証不要の API）、後で prediction.hip4_snapshot 独自の BTC 確率と比較できるよう data-public/kalshi_btc15m_log.jsonl に保存します。追加のインフラコストはなく、上記の開始／保留の判断には含まれません。

新しいサブフィード、2026-10-26開始 — EQX 現物と Hyperliquid パーペチュアルの乖離：EQX Labs は2026-10-26 22:30 KST に、トークン化された米国株／ETF 11銘柄（EQSPY、EQQQQ、EQAAPL、EQAMZN、EQGOOG、EQMETA、EQMSFT、EQNVDA、EQTSLA、EQMU、EQSPCX）を Hyperliquid HIP-1 のネイティブ現物トークンとして上場しました。上記の Base と Hyperliquid の比較（異なる2つのチェーン間で、ブリッジ／決済に伴うノイズを含む）とは異なり、これは同じ HyperCore の取引環境における現物とパーペチュアルの比較です。そのため、この乖離からは時間外の裁定機会の欠如をより明確に読み取れます。同じ1時間ごとの cron で data-public/eqx_gap_log.jsonl にも書き込むようになりました（同じスクリプト内の collect_eqx_gap_rows()）。まだ有料エンドポイントではありません。有料化を判断する前に、時間外／週末の乖離が通常取引時間中より一貫して大きいかを観察しています。上場時点では EQX の公式トークン ID レジストリが公開されていなかったため、行はトークン名のみ（EQ + ティッカー）で照合しています。EQX が ID を公開したら再確認してください。

---

免責事項

AlphaPipeline は、情報提供および調査を目的として、定量的な市場データと分析を提供します。取引の実行、注文の発注、ユーザー資金の保管、またはいかなる種類の仲介／賭け／ギャンブルサービスも行いません。読み取り専用のデータレイヤーです。ユーザーは、自身のデータ利用がそれぞれの管轄区域で適用される法律および規制に準拠していることを、自らの責任で確認するものとします。

---

リンク

• ライブサービス：https://alphapipeline-eu.onrender.com
• エージェント向け仕様：https://alphapipeline-eu.onrender.com/llms.txt
• OpenAPI ドキュメント：https://alphapipeline-eu.onrender.com/docs
• x402 Bazaar の掲載ページ：https://www.x402bazaar.org/
• Glama の掲載ページ（認証済み、TDQS A / 4.4）：https://glama.ai/mcp/connectors/com.onrender.alphapipeline/alpha-pipeline-agent-mcp
• x402 プロトコル：https://docs.x402.org

ライセンス

LICENSE を参照してください。