对接美国股票市场指南

原创已于 2026-01-03 11:24:17 修改 · 304 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#数据库 #区块链 #web3 #python

于 2026-01-03 09:42:06 首次发布

一、获取美股市场数据

1. 获取股票市场列表

通过StockTV的API，用户可以获取美股市场的股票列表。这对于了解市场中的股票概览非常有帮助。

获取数据的准备工作：通过https://xin.stocktv.top可以获取API key以及查看详细接口文档

API接口：https://api.stocktv.top/stock/stocks

主要参数：

countryId：国家ID，例如美国的国家ID为233
pageSize：每页显示数量，默认值为10
page：页码，默认值为1

使用场景：

获取美股市场概览
筛选感兴趣的股票进行深入分析
构建投资组合前的市场扫描

2. 查询单个股票信息

对于特定股票的深入分析，获取详细的股票信息是必要的。

API接口：https://api.stocktv.top/stock/queryStocks

主要参数：

id：股票PID（唯一标识符）
name：股票名称
symbol：股票代码

使用场景：

获取特定美股股票的详细信息
深入分析某只股票的基本面和技术面数据
为投资决策收集详细数据支持

3. 查询多个股票数据

同时获取多只股票的数据，便于进行比较分析。

API接口：https://api.stocktv.top/stock/stocksByPids

主要参数：

pids：多个股票PID，用逗号分隔

使用场景：

同时获取多只美股股票的数据
比较分析多只股票的表现
批量获取投资组合中股票的数据

4. 获取K线数据

获取股票的历史价格数据，用于技术分析和策略回测。

API接口：https://api.stocktv.top/stock/kline

主要参数：

pid：股票PID
interval：时间间隔，支持多种时间间隔，如5分钟、15分钟、1小时、1天、1周、1月等

使用场景：

进行技术分析
构建价格图表
回测交易策略
分析股票的历史价格走势

二、技术实现

1. API接入流程

获取API Key：通过StockTV获取访问密钥。
选择接口：根据需求选择合适的数据接口。
构造请求：按照接口文档构造HTTP请求。
处理响应：解析JSON格式的响应数据。
错误处理：处理可能的API错误和异常情况。

2. 代码实现示例（Python）

import requests
import pandas as pd

class USStockAPI:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = "https://api.stocktv.top"

    def get_market_list(self, country_id=233, page_size=10, page=1):
        """获取美股市场列表"""
        url = f"{self.base_url}/stock/stocks"
        params = {
            "countryId": country_id,
            "pageSize": page_size,
            "page": page,
            "key": self.api_key
        }
        response = requests.get(url, params=params)
        return response.json()

    def get_stock_data(self, stock_id=None, name=None, symbol=None):
        """获取单个股票数据"""
        url = f"{self.base_url}/stock/queryStocks"
        params = {"key": self.api_key}
        if stock_id:
            params["id"] = stock_id
        if name:
            params["name"] = name
        if symbol:
            params["symbol"] = symbol
        response = requests.get(url, params=params)
        return response.json()

    def get_multiple_stocks(self, pids):
        """获取多个股票数据"""
        url = f"{self.base_url}/stock/stocksByPids"
        params = {"pids": ",".join(map(str, pids)), "key": self.api_key}
        response = requests.get(url, params=params)
        return response.json()

    def get_kline_data(self, pid, interval="P1D"):
        """获取K线数据"""
        url = f"{self.base_url}/stock/kline"
        params = {"pid": pid, "interval": interval, "key": self.api_key}
        response = requests.get(url, params=params)
        return response.json()

# 使用示例
api_key = "YOUR_API_KEY"
us_stock_api = USStockAPI(api_key)

# 获取美股市场列表
market_data = us_stock_api.get_market_list(country_id=233)
print(market_data)

# 获取K线数据
kline_data = us_stock_api.get_kline_data(pid=12345, interval="P1D")  # 替换为实际的股票PID
print(kline_data)