stockcex美股代幣
紐約10:33:06 交易中
繁
● 開放資料

免費的美股代幣溢價資料：介面與嵌入卡片

本站的實時溢價、各交易所每股價、跨所價差、資金費率和歷史走勢都可以免費取用，不需要註冊，也不需要金鑰。寫文章、做研究、開發應用時直接呼叫；只想在部落格裡展示行情，複製一段嵌入程式碼就行。唯一的要求是註明資料來自 stockcex.com 並附上鍊接。

一、把溢價卡片嵌入網頁

選好標的、配色和尺寸，複製下面的程式碼貼上到網頁的 HTML 裡。卡片每 60 秒自動重新整理，不載入任何第三方指令碼，也不收集訪客資訊。

配色
尺寸
漲跌顏色

卡片地址是 https://stockcex.com/zh-hant/embed/{正股程式碼}，溢價指數是 https://stockcex.com/zh-hant/embed/index，可選引數：

引數取值說明
themelight、dark不填時跟隨訪客系統的深淺色
rows1–6，預設 3顯示幾行：單隻股票是成交額最大的幾個交易所，指數是成交額最大的幾隻股票
updowngreen改為綠漲紅跌，預設紅漲綠跌

繁體中文卡片把地址裡的 /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|30d60 秒

三、通用約定

  • 來源欄位：每個響應都帶 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，永續合約為交易所
kindspot 現貨代幣、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 秒更新，正股參考價為延遲行情，休市時是上一次收盤價。
  • 合理使用：請遵守頻率限制，不要用多個地址繞過限制。濫用的來源可能會被限制訪問。