● 开放数据

免费的美股代币溢价数据：接口与嵌入卡片

Name: 美股代币（股票代币）实时溢价数据
Creator: stockcex
License: https://stockcex.com/developers#terms

本站的实时溢价、各交易所每股价、跨所价差、资金费率和历史走势都可以免费取用，不需要注册，也不需要密钥。写文章、做研究、开发应用时直接调用；只想在博客里展示行情，复制一段嵌入代码就行。唯一的要求是注明数据来自 stockcex.com 并附上链接。

一、把溢价卡片嵌入网页

选好标的、配色和尺寸，复制下面的代码粘贴到网页的 HTML 里。卡片每 60 秒自动刷新，不加载任何第三方脚本，也不收集访客信息。

标的

配色

跟随系统浅色深色

尺寸

小 300×232中 360×262大 420×322

涨跌颜色

红涨绿跌绿涨红跌

<iframe src="https://stockcex.com/embed/TSLA?rows=3" width="360" height="262" style="border:0;max-width:100%" loading="lazy" title="TSLA 代币溢价 · stockcex"></iframe>
<p style="margin:6px 0 0;font-size:12px">数据来自 <a href="https://stockcex.com/t/TSLA">stockcex.com · TSLA 代币实时溢价</a></p>

卡片地址是 https://stockcex.com/embed/{正股代码}，溢价指数是 https://stockcex.com/embed/index，可选参数：

参数	取值	说明
`theme`	`light`、`dark`	不填时跟随访客系统的深浅色
`rows`	1–6，默认 3	显示几行：单只股票是成交额最大的几个交易所，指数是成交额最大的几只股票
`updown`	`green`	改为绿涨红跌，默认红涨绿跌

繁体中文卡片把地址里的 /embed/ 换成 /zh-hant/embed/。请保留卡片下方带链接的来源说明。

二、接口一览

所有接口都是 GET 请求，返回 JSON，地址前缀为 https://stockcex.com/api/v1。

接口	内容	缓存
`/api/v1/index`	当前溢价指数和走势（默认 7 天）	15 秒
`/api/v1/stocks`	全部标的：每股价、正股参考价、加权溢价、跨所价差、成交额	15 秒
`/api/v1/stocks/{ticker}`	单只股票：各交易所的交易对、溢价、盘口价差、永续合约溢价和资金费率	15 秒
`/api/v1/history/{ticker}`	单只股票各交易所的溢价历史，`range=1d\|7d\|30d`	60 秒

三、通用约定

来源字段：每个响应都带 source（固定为 stockcex.com）、source_url（对应的网页，引用时请链接它）、attribution 和 updated_at（这份数据的计算时间）。
百分比：以 _pct 结尾的字段都是百分数，1.25 表示 1.25%，负数是折价。资金费率是每个结算周期的费率，周期见 funding_interval_h（小时）。
价格：以 _usd 结尾的价格都已换算成对应 1 股正股的美元价格，不同交易所、不同发行方可以直接比较，换算方法见方法说明。
时间：updated_at 等时间字段是 UTC 的 ISO 8601 字符串；走势里的 ts 是 Unix 秒，表示所在区间的起点。
空值：缺少参考价、成交太少或数据异常时，相应字段为 null，不会省略。
代码：{ticker} 用正股代码，不区分大小写，例如 TSLA、BRK.B。名称为简体中文。
跨域：响应带 Access-Control-Allow-Origin: *，网页里可以直接用 fetch 调用。
版本：v1 的字段只增不改。如果需要不兼容的改动，会发布 v2，v1 继续保留一段时间并在本页提前说明。

四、溢价指数 /api/v1/index

溢价指数是全部现货代币按 24 小时成交额加权的平均溢价，只纳入成交额不低于 1 万美元的标的。美股休市时，它近似反映代币市场对下次开盘的预期。可选参数 range=1d|7d|30d，走势分别按 3 分钟、20 分钟、1 小时聚合。

字段	说明
`market.session`	美股时段：`pre` 盘前、`regular` 盘中、`post` 盘后、`closed` 休市
`market.next_open`	下一次常规开盘时间
`index.premium_pct`	当前溢价指数
`index.constituents`	纳入指数的标的数
`index.ext_premium_pct`	盘前、盘后时段相对正股最新成交价的加权溢价，只在覆盖足够时给出
`series.points[]`	走势：`ts`、`premium_pct`

响应示例

{
  "source": "stockcex.com",
  "source_url": "https://stockcex.com/",
  "attribution": "数据来自 stockcex.com，引用请注明来源并链接 https://stockcex.com",
  "updated_at": "2026-10-17T21:30:00Z",
  "market": {
    "session": "closed",
    "label": "休市中",
    "next_open": "2026-10-19T13:30:00Z"
  },
  "index": {
    "name": "周末溢价指数",
    "premium_pct": 0.375,
    "constituents": 58,
    "ext_premium_pct": null
  },
  "series": {
    "range": "7d",
    "interval_sec": 1200,
    "points": [
      {
        "ts": 1792270200,
        "premium_pct": 0.312
      },
      {
        "ts": 1792271400,
        "premium_pct": 0.359
      },
      {
        "ts": 1792272600,
        "premium_pct": 0.375
      }
    ]
  }
}

五、全部标的 /api/v1/stocks

看板上的全部标的，按现货 24 小时成交额从大到小排列，另附当前溢价指数。

字段	说明
`ticker`、`name`	正股代码和中文名
`url`	这只股票在本站的页面
`price_usd`	成交额最大的现货代币的每股价
`ref_price_usd`、`ref_at`	正股参考价及其时间：盘中是延迟行情，休市时是上一次收盘价
`premium_pct`	各交易所现货代币按成交额加权的溢价
`cross_spread_pct`	跨所价差：成交额足够的交易所之间每股价的最大差距
`turnover_24h_usd`	现货代币 24 小时成交额合计（美元）
`exchanges`	有现货代币的交易所
`perp`	成交额最大的永续合约：`exchange`、`premium_pct`、`funding_rate_pct`；没有时为 `null`
`extended`	盘前盘后：正股最新成交价 `price_usd` 和代币相对它的 `premium_pct`；其余时段为 `null`

响应示例

{
  "source": "stockcex.com",
  "source_url": "https://stockcex.com/",
  "attribution": "数据来自 stockcex.com，引用请注明来源并链接 https://stockcex.com",
  "updated_at": "2026-10-17T21:30:00Z",
  "market": {
    "session": "closed",
    "label": "休市中",
    "next_open": "2026-10-19T13:30:00Z"
  },
  "index": {
    "name": "周末溢价指数",
    "premium_pct": 0.375,
    "constituents": 58,
    "ext_premium_pct": null
  },
  "count": 1,
  "stocks": [
    {
      "ticker": "TSLA",
      "name": "特斯拉",
      "url": "https://stockcex.com/t/TSLA",
      "price_usd": 441.62,
      "ref_price_usd": 439.31,
      "ref_at": "2026-10-17T20:00:00Z",
      "premium_pct": 0.486,
      "cross_spread_pct": 0.214,
      "turnover_24h_usd": 18406233,
      "exchanges": [
        "binance",
        "bybit"
      ],
      "perp": {
        "exchange": "binance",
        "premium_pct": 0.612,
        "funding_rate_pct": 0.01
      },
      "extended": null
    }
  ]
}

六、单只股票 /api/v1/stocks/{ticker}

在全部标的的字段之外，stock.listings 列出这只股票在各交易所的每个交易对，现货在前、永续在后，各自按成交额排序。没有收录的代码返回 404。

字段	说明
`exchange`、`exchange_name`	交易所代号和名称
`symbol`、`token`	交易所的交易对代码和代币名
`issuer`	发行方：`xstocks`、`ondo`、`bstocks`、`reality`，永续合约为交易所
`kind`	`spot` 现货代币、`perp` 永续合约
`quote`、`multiplier`	计价币，以及 1 枚代币对应的股数（含分红再投资）
`bid_usd`、`ask_usd`、`mid_usd`	买一、卖一和中间价，已换算成每股美元
`book_spread_pct`	买一卖一之间的价差
`premium_pct`	相对正股参考价的溢价
`funding_rate_pct`、`funding_interval_h`	永续合约的资金费率和结算周期，现货为 `null`
`quoted_at`、`stale`	最近一次报价的时间；超过 2 分钟没有新报价时 `stale` 为 `true`，这时不计算溢价

响应示例

{
  "source": "stockcex.com",
  "source_url": "https://stockcex.com/t/TSLA",
  "attribution": "数据来自 stockcex.com，引用请注明来源并链接 https://stockcex.com",
  "updated_at": "2026-10-17T21:30:00Z",
  "market": {
    "session": "closed",
    "label": "休市中",
    "next_open": "2026-10-19T13:30:00Z"
  },
  "stock": {
    "ticker": "TSLA",
    "name": "特斯拉",
    "url": "https://stockcex.com/t/TSLA",
    "price_usd": 441.62,
    "ref_price_usd": 439.31,
    "ref_at": "2026-10-17T20:00:00Z",
    "premium_pct": 0.486,
    "cross_spread_pct": 0.214,
    "turnover_24h_usd": 18406233,
    "exchanges": [
      "binance",
      "bybit"
    ],
    "perp": {
      "exchange": "binance",
      "premium_pct": 0.612,
      "funding_rate_pct": 0.01
    },
    "extended": null,
    "listings": [
      {
        "exchange": "binance",
        "exchange_name": "Binance",
        "symbol": "TSLABUSDT",
        "token": "TSLAB",
        "issuer": "bstocks",
        "kind": "spot",
        "quote": "USDT",
        "multiplier": 1,
        "bid_usd": 441.58,
        "ask_usd": 441.66,
        "mid_usd": 441.62,
        "book_spread_pct": 0.018,
        "premium_pct": 0.526,
        "turnover_24h_usd": 12903118,
        "funding_rate_pct": null,
        "funding_interval_h": null,
        "quoted_at": "2026-10-17T21:30:00Z",
        "stale": false
      },
      {
        "exchange": "bybit",
        "exchange_name": "Bybit",
        "symbol": "TSLAXUSDT",
        "token": "TSLAx",
        "issuer": "xstocks",
        "kind": "spot",
        "quote": "USDT",
        "multiplier": 1.00042,
        "bid_usd": 440.61,
        "ask_usd": 440.93,
        "mid_usd": 440.77,
        "book_spread_pct": 0.073,
        "premium_pct": 0.332,
        "turnover_24h_usd": 5503115,
        "funding_rate_pct": null,
        "funding_interval_h": null,
        "quoted_at": "2026-10-17T21:30:00Z",
        "stale": false
      },
      {
        "exchange": "binance",
        "exchange_name": "Binance",
        "symbol": "TSLAUSDT",
        "token": "",
        "issuer": "binance",
        "kind": "perp",
        "quote": "USDT",
        "multiplier": 1,
        "bid_usd": 442,
        "ask_usd": 442.04,
        "mid_usd": 442.02,
        "book_spread_pct": 0.009,
        "premium_pct": 0.612,
        "turnover_24h_usd": 96220400,
        "funding_rate_pct": 0.01,
        "funding_interval_h": 8,
        "quoted_at": "2026-10-17T21:30:00Z",
        "stale": false
      }
    ]
  }
}

七、溢价历史 /api/v1/history/{ticker}

每个交易所、每种产品一条溢价曲线。range 可选 1d、7d（默认）、30d，聚合粒度见 interval_sec。market_closed 是这段时间里美股常规交易时段之外的区间（Unix 秒，左闭右开），画图时可以用来标出休市。

响应示例

{
  "source": "stockcex.com",
  "source_url": "https://stockcex.com/t/TSLA",
  "attribution": "数据来自 stockcex.com，引用请注明来源并链接 https://stockcex.com",
  "updated_at": "2026-10-17T21:30:00Z",
  "ticker": "TSLA",
  "range": "7d",
  "interval_sec": 1200,
  "series": [
    {
      "exchange": "binance",
      "kind": "spot",
      "points": [
        {
          "ts": 1792271400,
          "premium_pct": 0.491
        },
        {
          "ts": 1792272600,
          "premium_pct": 0.526
        }
      ]
    },
    {
      "exchange": "binance",
      "kind": "perp",
      "points": [
        {
          "ts": 1792271400,
          "premium_pct": 0.58
        },
        {
          "ts": 1792272600,
          "premium_pct": 0.612
        }
      ]
    },
    {
      "exchange": "bybit",
      "kind": "spot",
      "points": [
        {
          "ts": 1792271400,
          "premium_pct": 0.304
        },
        {
          "ts": 1792272600,
          "premium_pct": 0.332
        }
      ]
    }
  ],
  "market_closed": [
    [
      1792267200,
      1792272600
    ]
  ]
}

八、调用示例

命令行：

curl -s https://stockcex.com/api/v1/stocks/TSLA

网页或 Node.js：

const res = await fetch("https://stockcex.com/api/v1/stocks/TSLA");
const d = await res.json();
console.log(d.stock.name, d.stock.premium_pct + "%");

// 展示时请注明来源并链接回本站
const credit = `数据来自 <a href="${d.source_url}">stockcex.com</a>`;

取全部标的里溢价最高的五只：

const { stocks } = await (await fetch("https://stockcex.com/api/v1/stocks")).json();
const top = stocks
  .filter(s => s.premium_pct !== null)
  .sort((a, b) => b.premium_pct - a.premium_pct)
  .slice(0, 5);

九、频率限制与错误

每个 IP 每分钟最多 60 次请求，允许短时间集中请求。行情每 15 秒更新一次，轮询间隔短于 15 秒拿不到新数据，建议 30 秒或更长。响应头 X-RateLimit-Limit、X-RateLimit-Remaining 显示额度和剩余次数；超出时返回 429，Retry-After 头给出需要等待的秒数。

出错时返回对应的状态码和 JSON：

{"error": "没有收录这只股票的代币，代码请用正股代码，例如 TSLA", "status": 404, …}

十、使用条款

免费使用，注明来源：接口和嵌入卡片可以免费用于网站、应用、文章和研究。使用时请在数据旁边注明「数据来自 stockcex.com」，并链接到 stockcex.com 或对应的 source_url。
不作任何保证：数据按现状提供，可能延迟、缺失或出错，接口也可能因维护暂时不可用。我们不对数据的准确性、完整性和及时性作保证，也不承担因使用这些数据造成的损失。
不构成投资建议：数据仅供研究和信息展示，不构成任何投资建议。股票代币不等于股票本身，部分地区禁止或限制此类产品。
数据可能延迟：代币和合约行情约每 15 秒更新，正股参考价为延迟行情，休市时是上一次收盘价。
合理使用：请遵守频率限制，不要用多个地址绕过限制。滥用的来源可能会被限制访问。