快速开始

StockKit API 已上线，地址为 https://api.stockkit.dev。测试期间完全开放：无需 API 密钥。

获取价格

curl https://api.stockkit.dev/v1/prices/NVDA

{
  "symbol": "NVDA",
  "currency": "USD",
  "underlying": { "bid": "228.5", "ask": "229.52", "mid": "229.010000" },
  "token": { "bid": "228.500000", "ask": "229.520000", "mid": "229.010000", "multiplier": "1.000000000000000000" },
  "halted": false,
  "asOf": "2026-09-05T14:50:45Z"
}

获取可执行报价

报价来自 Robinhood Chain（链 ID 4663）上的 Uniswap v3 实时流动池，以 USDG 计价：

curl "https://api.stockkit.dev/v1/quote?symbol=NVDA&side=buy&amount=100&denom=usd"

{
  "symbol": "NVDA",
  "side": "buy",
  "feeTier": 500,
  "usdAmount": "100.000000",
  "tokenAmount": "0.432324841419642912",
  "effectivePricePerToken": "231.307550",
  "venue": "uniswap-v3"
}

构建交易

StockKit 是非托管的：/v1/trade/build 返回未签名的交易，由你自行审阅并用自己的钱包签名。StockKit 从不持有私钥，也从不代为执行交易。

curl -X POST https://api.stockkit.dev/v1/trade/build \
  -H "content-type: application/json" \
  -d '{
    "symbol": "NVDA",
    "side": "buy",
    "amount": "100",
    "denom": "usd",
    "recipient": "0xYourWalletAddress",
    "slippageBps": 50
  }'

响应包含一个可选的 ERC-20 授权步骤和 Uniswap SwapRouter02 的兑换调用，滑点上限已经写入其中。从你的钱包或应用按顺序提交这些步骤即可。

TypeScript / JavaScript SDK

npm install @stockkit/sdk

import { StockKit } from "@stockkit/sdk"

const stockkit = new StockKit()

const price = await stockkit.prices.get("NVDA")

const quote = await stockkit.trade.quote({ ticker: "NVDA", amount: 100 })

const tx = await stockkit.trade.build({
  ticker: "NVDA",
  amount: 100,
  recipient: "0xYourWalletAddress",
})

// Hourly candles from the onchain pool price
const { candles } = await stockkit.history.get("NVDA", { interval: "1h" })

// Supply, pool TVL, and the DEX premium vs the equity quote
const stats = await stockkit.stats.get("NVDA")

所有响应都有完整的类型定义，错误会抛出带有 status 和 code 的 StockKitError。源码：github.com/stockkit-labs/sdk。

API 本身就是基于 HTTPS 的纯 JSON，并开放了 CORS，因此不使用 SDK 也可以在任何运行时或浏览器中直接用 fetch 调用。

使用 Python

import requests

BASE = "https://api.stockkit.dev/v1"

price = requests.get(f"{BASE}/prices/NVDA").json()

quote = requests.get(f"{BASE}/quote", params={
    "symbol": "NVDA", "amount": 100
}).json()

tx = requests.post(f"{BASE}/trade/build", json={
    "symbol": "NVDA", "amount": "100",
    "recipient": "0xYourWalletAddress"
}).json()

可以基于什么来构建

API	作用
Asset API	所有代币化股票的注册表，含链上地址
Execution API	DEX 报价和未签名的交易
Portfolio API	以美元计价的链上余额
Research API	来自 SEC EDGAR 的代币背后股权的事实数据
Market API	价格历史、单代币市场统计，以及 Webhook 价格提醒
Agent API	面向 AI 智能体的机器可读访问
x402 API	按次付费访问，以 USDG 或 USDC 结算