Cabrini Market Data

cabrini

面向 AI Agent 的美国股市数据。涵盖 23 年的日内和每日 K 线、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	全天交易时段的日内 K 线
daily(ticker, start, end)	$0.001/year	每日 OHLCV + VWAP——绝对价格
batch(tickers, date)	$0.02/ticker	多个股票代码，单个日期，无数量限制
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()，而非第三方开盘价：我们的参考值是该交易时段的第一根 K 线，包含盘前交易，因此与外部的 09:30 开盘价无法完全吻合。

付款方式

每个付费请求都使用 x402——一种开放的 HTTP 小额支付协议：

1. 客户端发送请求 → 服务端返回带有 PAYMENT-REQUIRED 标头的 402
2. 客户端签署 USDC 转账授权（EIP-3009）
3. 客户端使用 X-PAYMENT 标头重放请求，标头中包含已签署的授权
4. Cloudflare 边缘 Worker 验证签名，向 Base 提交交易，并转发至源站
5. 源站返回数据

Cabrini 客户端会自动处理所有这些步骤。你只需要一个持有 Base 上 USDC 的钱包。

获取 Base 上的 USDC

1. 从 Ethereum 跨链转移：bridge.base.org
2. 直接购买：在 Coinbase 购买 → 将 USDC 发送到 Base 网络上的钱包
3. 水龙头（测试网）：不需要，主网上的 USDC 费用很低（每次查询 $0.025）

链接

• 主页：https://cabrini.ai
• API 文档：https://cabrini.ai/docs
• Agent 指南：https://cabrini.ai/agents
• MCP 端点：https://cabrini.ai/mcp