Cabrini Market Data

cabrini

AI エージェント向けの米国株式市場データです。23 年分の分足・日足バー、SEC のファンダメンタルズ、提出書類、インサイダーデータを提供します。2003 年から現在まで、米国の全株式が対象です。

Base 上の USDC（x402）でクエリごとに支払います。API キー、サブスクリプション、登録は不要です。

インストール

pip install cabrini

クイックスタート

from cabrini import Cabrini

c = Cabrini(private_key="0x...")  # any Base wallet with USDC

# Intraday bars (pct from daily open) — $0.025
bars = c.query("AAPL", "2024-01-15")

# Daily OHLCV + VWAP (absolute prices) — $0.001/year
daily = c.daily("TSLA", "2024-01-01", "2024-03-31")

# SEC fundamentals — $0.02
fins = c.fundamentals("NVDA")

# Full research brief — $0.25
brief = c.brief("MSFT")

LangChain

from cabrini import get_langchain_tools
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

tools = get_langchain_tools(private_key="0x...")
agent = create_react_agent(ChatOpenAI(model="gpt-4o"), tools)

result = agent.invoke({"messages": [
    {"role": "user", "content": "What was NVDA's trading volume on the day of their last earnings?"}
]})

CrewAI

from cabrini import get_crewai_tools
from crewai import Agent, Task, Crew

tools = get_crewai_tools(private_key="0x...")

analyst = Agent(
    role="Financial Analyst",
    goal="Analyze stock performance using real market data",
    tools=tools,
)

task = Task(
    description="Compare AAPL and MSFT intraday volatility on 2024-06-15",
    agent=analyst,
)

Crew(agents=[analyst], tasks=[task]).kickoff()

MCP（Claude、Cursor など）

任意の MCP クライアントから https://cabrini.ai/mcp に接続します。

{
  "mcpServers": {
    "cabrini": {
      "url": "https://cabrini.ai/mcp"
    }
  }
}

すべてのエンドポイント

メソッド	料金	説明
query(ticker, date)	$0.025	1 取引日分の分足バー
daily(ticker, start, end)	$0.001/year	日足 OHLCV + VWAP — 実際の価格
batch(tickers, date)	$0.02/ticker	複数のティッカー、1 日分、上限なし
range(ticker, start, end)	$0.01/trading day	複数日分の分足データ、上限なし
bars(ticker, date, interval)	$0.015/day	リサンプリングされた分足データ、3～240 分
scan(date, **criteria)	$0.10	米国株式をすべてスクリーニング。1 つ以上の条件が必要
tickers(date)	$0.005	取引されたティッカーの一覧
company(ticker)	$0.005	SEC EDGAR の企業プロフィール
fundamentals(ticker)	$0.02	SEC の四半期データ
filings(ticker)	$0.01 / $0.05	SEC 提出書類のインデックス。抽出済みのセクションテキストを含む場合は追加料金
insiders(ticker)	$0.02	インサイダー取引（Form 4）
brief(ticker)	$0.25	複数データをまとめた調査概要

料金は各 402 レスポンスにリアルタイムで表示され、クライアントはサーバーが要求する金額を支払います。この表は説明用であり、正式な料金情報ではありません。

出力形式

分足メソッド（query、range、batch、bars）は価格水準ではなく、日次始値からの変化率を返します。

{"window_start": "2024-01-02T14:30:00", "timestamp": 1704204600000000000,
 "pct_open": 0.0, "pct_high": 0.0012, "pct_low": -0.0003, "pct_close": 0.0008,
 "volume": 47000, "transactions": 312}

pct_x = (bar_x - day_open) / day_open です。たとえば、0.0012 は +0.12% を表します。

daily() は絶対価格である始値、高値、安値、終値、出来高、取引数、VWAP を返します。両方を組み合わせることで価格を再構成できます。

day = c.daily("AAPL", "2024-01-02", "2024-01-02")["data"][0]
bars = c.query("AAPL", "2024-01-02")["data"]
close_price = day["open"] * (1 + bars[-1]["pct_close"])

サードパーティの始値ではなく、daily() を使用してください。基準値はセッションの最初のバーで、プレマーケットを含むため、外部データの 09:30 の始値とは正確に一致しません。

支払いの仕組み

有料リクエストにはすべて、HTTP マイクロペイメント向けのオープンプロトコルである x402 を使用します。

1. クライアントがリクエストを送信 → サーバーが PAYMENT-REQUIRED ヘッダー付きの 402 を返します
2. クライアントが USDC 送金の認証（EIP-3009）に署名します
3. クライアントが、署名済みの認証を含む X-PAYMENT ヘッダー付きでリクエストを再送します
4. Cloudflare エッジワーカーが署名を検証し、Base に送信して、オリジンサーバーに転送します
5. オリジンサーバーがデータを返します

Cabrini クライアントがこれらすべてを自動的に処理します。Base 上に USDC を保有するウォレットがあれば利用できます。

Base 上で USDC を入手する

1. Ethereum からブリッジします：bridge.base.org
2. 直接購入します：Coinbase で購入し、Base ネットワーク上のウォレットに USDC を送金します
3. フォーセット（テストネット）：不要です。メインネットの USDC は安価です（クエリあたり $0.025）

リンク

• ホームページ：https://cabrini.ai
• API ドキュメント：https://cabrini.ai/docs
• エージェントガイド：https://cabrini.ai/agents
• MCP エンドポイント：https://cabrini.ai/mcp