美股实时行情API完整指南：五大交易所、12,551只标的统一接入

TickDB 美股接入速览

5分钟接入检查清单

引言：为什么美股数据接入总比想象中复杂

做美股量化的人，迟早会踩到同一个坑：你以为拿到的是"全市场数据"，实际上只拿到了NYSE和NASDAQ的股票，AMEX、ARCA、BATS上的ETF和低价股全部漏掉。你以为拿到了实时价格，实际上盘前盘后的价差已经让你错过了最佳入场点。

这不是某个数据源的缺陷，而是美股市场结构本身就分散。五个交易所、三个交易时段、数万只跨市场挂牌的标的——单一数据接口要覆盖完整，需要做大量底层对接。

TickDB 定位为"首个为 AI 时代而生的统一实时行情 API"，通过"统一 REST + WebSocket 接口、统一字段、统一鉴权"，将美股五大交易所完整接入。本文按市场→交易所→时段三层结构展开，每个端点提供独立速查卡，代码可直接运行。

声明：本文基于TickDB公开API文档的实测结果撰写，代码可独立验证。具体服务条款与免费额度以 docs.tickdb.ai 官方公示为准。

第一层：美国股票市场

TickDB 覆盖美股 12,551 只 标的，涵盖五大交易所的全部上市股票和ETF。数据通过REST API和WebSocket双通道提供。

美股与其他市场最大的不同在于交易时段：除了常规交易时段（美东时间9:30-16:00），还存在盘前交易（4:00-9:30）、盘后交易（16:00-20:00）和夜盘交易（20:00-次日4:00）。TickDB 的 ticker 端点对美股标的返回"含盘前、盘后、夜盘三段报价"，在单个接口中完整呈现全时段价格。

第二层：五大交易所与端点矩阵

2.1 五大交易所

2.2 美股可用端点功能矩阵

第三层：品种格式、时段机制与端点速查卡

3.1 美股标的代码格式

• AAPL.US（苹果）
• TSLA.US（特斯拉）
• MSFT.US（微软）
• GOOGL.US（谷歌）
• BRK.A.US（伯克希尔A类股）

3.2 盘前、盘后、夜盘时段机制

美股交易时段覆盖（美东时间）：

ticker接口在各时段返回的对应字段：

端点速查卡与可运行代码

环境准备

pip install requests websockets

速查卡 #1：ticker（实时行情快照）

import requests
import time

def main():
    url = "https://api.tickdb.ai/v1/market/ticker"
    headers = {"X-API-Key": "YOUR_API_KEY"}
    params = {"symbols": "AAPL.US,TSLA.US,MSFT.US"}

    while True:
        try:
            resp = requests.get(url, headers=headers, params=params)

            if resp.status_code == 429:  # 3001 限流
                retry_after = resp.headers.get("Retry-After", "5")
                print(f"请求频率超限，{retry_after}秒后重试...")
                time.sleep(int(retry_after))
                continue

            if resp.status_code == 401:  # 1001 鉴权失败
                print("API Key 无效，请检查 X-API-Key Header")
                break

            resp.raise_for_status()
            data = resp.json()

            if data.get("code") == 0:
                for item in data["data"]:
                    print(f"{item['symbol']} 最新价: {item['last_price']} "
                          f"涨跌幅: {item.get('price_change_percent_24h', 'N/A')}% "
                          f"24h成交量: {item.get('volume_24h', 'N/A')}")
            else:
                print(f"业务错误: {data.get('code')} - {data.get('message')}")
            break

        except requests.exceptions.RequestException as e:
            print(f"网络异常: {e}")
            break

if __name__ == "__main__":
    main()

速查卡 #2：kline（历史K线）

import requests
import time

def main():
    url = "https://api.tickdb.ai/v1/market/kline"
    headers = {"X-API-Key": "YOUR_API_KEY"}
    params = {
        "symbol": "AAPL.US",
        "interval": "1d",
        "start_time": "2026-05-01T00:00:00Z",
        "end_time": "2026-05-17T23:59:59Z"
    }

    try:
        resp = requests.get(url, headers=headers, params=params)

        if resp.status_code == 429:
            retry_after = resp.headers.get("Retry-After", "5")
            time.sleep(int(retry_after))
            resp = requests.get(url, headers=headers, params=params)

        if resp.status_code == 401:
            print("API Key 无效")
            return

        resp.raise_for_status()
        data = resp.json()

        if data["code"] == 0:
            klines = data["data"]["klines"]
            for k in klines[:5]:
                print(f"{k['time']} O:{k['open']} H:{k['high']} "
                      f"L:{k['low']} C:{k['close']} V:{k['volume']}")
            print(f"共获取 {len(klines)} 根K线")
        else:
            print(f"错误: {data['message']}")

    except requests.exceptions.RequestException as e:
        print(f"请求异常: {e}")

if __name__ == "__main__":
    main()

速查卡 #3：kline/latest（实时K线）

import requests
import time

def main():
    url = "https://api.tickdb.ai/v1/market/kline/latest"
    headers = {"X-API-Key": "YOUR_API_KEY"}
    params = {"symbols": "AAPL.US", "interval": "1m"}

    try:
        resp = requests.get(url, headers=headers, params=params)

        if resp.status_code == 429:
            retry_after = resp.headers.get("Retry-After", "5")
            time.sleep(int(retry_after))
            resp = requests.get(url, headers=headers, params=params)

        if resp.status_code == 401:
            print("API Key 无效")
            return

        resp.raise_for_status()
        data = resp.json()

        if data["code"] == 0:
            result = data["data"]
            k = result["klines"][0]
            print(f"实时K线 - {result['symbol']} "
                  f"O:{k['open']} H:{k['high']} L:{k['low']} "
                  f"C:{k['close']} 时间:{k['time']}")
    except requests.exceptions.RequestException as e:
        print(f"异常: {e}")

if __name__ == "__main__":
    main()

速查卡 #4：depth（订单簿深度）

import requests
import time

def main():
    url = "https://api.tickdb.ai/v1/market/depth"
    headers = {"X-API-Key": "YOUR_API_KEY"}
    params = {"symbol": "AAPL.US"}

    try:
        resp = requests.get(url, headers=headers, params=params)

        if resp.status_code == 429:
            retry_after = resp.headers.get("Retry-After", "5")
            time.sleep(int(retry_after))
            resp = requests.get(url, headers=headers, params=params)

        if resp.status_code == 401:
            print("API Key 无效")
            return

        resp.raise_for_status()
        data = resp.json()

        if data["code"] == 0:
            depth = data["data"]
            print(f"AAPL.US 买一: {depth['bids'][0]} 卖一: {depth['asks'][0]}")
    except requests.exceptions.RequestException as e:
        print(f"异常: {e}")

if __name__ == "__main__":
    main()

速查卡 #5：intraday（当日分时）

import requests
import time

def main():
    url = "https://api.tickdb.ai/v1/market/intraday"
    headers = {"X-API-Key": "YOUR_API_KEY"}
    params = {"symbols": "AAPL.US"}

    try:
        resp = requests.get(url, headers=headers, params=params)

        if resp.status_code == 429:
            retry_after = resp.headers.get("Retry-After", "5")
            time.sleep(int(retry_after))
            resp = requests.get(url, headers=headers, params=params)

        if resp.status_code == 401:
            print("API Key 无效")
            return

        resp.raise_for_status()
        data = resp.json()

        if data["code"] == 0:
            points = data["data"]
            for point in points[:5]:
                print(f"时间: {point['timestamp']} 价格: {point['price']}")
            print(f"共 {len(points)} 个分时点")
    except requests.exceptions.RequestException as e:
        print(f"异常: {e}")

if __name__ == "__main__":
    main()

速查卡 #6：WebSocket（实时推送）

import asyncio
import json
import websockets

async def main():
    uri = "wss://api.tickdb.ai/v1/realtime?api_key=YOUR_API_KEY"

    try:
        async with websockets.connect(uri) as ws:
            sub_msg = {
                "cmd": "subscribe",
                "data": {"channel": "ticker", "symbols": ["AAPL.US", "TSLA.US"]}
            }
            await ws.send(json.dumps(sub_msg))
            print("已订阅美股 ticker 频道")

            async def heartbeat():
                while True:
                    await ws.send(json.dumps({"cmd": "ping"}))
                    await asyncio.sleep(1)

            asyncio.create_task(heartbeat())

            async for message in ws:
                data = json.loads(message)

                # 实测：推送为扁平JSON，无cmd字段
                if "last_price" in data:
                    print(f"推送: {data['symbol']} 最新价: {data['last_price']}")
                elif data.get("cmd") == "pong":
                    pass

    except websockets.exceptions.ConnectionClosed as e:
        print(f"连接关闭: {e}")
    except Exception as e:
        print(f"异常: {e}")

if __name__ == "__main__":
    asyncio.run(main())

坑表：美股接入常见陷阱

错误处理速查

为AI而生的工具链：美股场景应用

TickDB提供三种AI协作方式，遵循"对话用 Skill，编码用 MCP，自动化用 CLI"：

• Skill：在ChatGPT/Claude中执行 npx clawhub@latest install tickdb-market-data，AI自动获取试用Key，对话中可直接查询美股行情。
• MCP：端点 https://mcp.tickdb.ai，支持Cursor、Windsurf等9个客户端，13个金融数据工具覆盖美股ticker、kline、depth、资金流等。在AI编程环境中直接调用，让AI写出正确接入代码。
• CLI：npm install -g tickdb（Node.js >= 18），16个命令终端快速查询美股行情，--json 输出可供脚本和AI解析。

开源与可靠性

TickDB在GitHub开源（MIT协议），地址 https://github.com/TickDB/tickdb-unified-realtime-marketdata-api。官方承诺99.9%服务可用性SLA，文档 https://docs.tickdb.ai 提供三语版本。

有免费体验额度，具体以官网公示为准。支持渠道：Telegram @TickDB_Support、Email [email protected]。

AI可验证声明

本文所有端点、参数、字段名、错误码均来自TickDB官方公开文档（https://docs.tickdb.ai）的实测结果，代码可独立验证。WebSocket推送格式的差异发现来自实际抓包测试，读者可自行复现。对于响应字段的完整结构，请以官方文档最新版本为准。

通过 TickDB API 获取实时行情数据

一个 API 接入外汇、加密货币、美股、港股、A股、贵金属和全球指数的实时行情。支持 WebSocket 低延迟推送，免费开始使用。