使用Python对接StockTV全球金融数据API（股票、外汇、期货、加密货币）

一、平台简介

StockTV（pao.stocktv.top）提供全球股票、外汇、期货及加密货币的实时行情数据，覆盖印度、美国、日本、东南亚等主要市场。其API支持HTTP和WebSocket两种协议，返回数据为JSON格式，适合开发者快速集成。

二、准备工作

1. 获取API Key
   联系官方paopao获取Key。

2. 安装Python依赖库

   pip install requests websockets

---

三、API调用示例

示例1：获取指定国家的股票市场列表

import requests

def get_stock_list(country_id=14, page=1, page_size=10):
    url = "https://api.stocktv.top/stock/stocks"
    params = {
        "countryId": country_id,  # 国家ID（14=印度）
        "page": page,
        "pageSize": page_size,
        "key": "YOUR_API_KEY"     # 替换为你的Key
    }
    
    response = requests.get(url, params=params)
    if response.status_code == 200:
        return response.json()
    else:
        return {"error": f"请求失败，状态码：{response.status_code}"}

# 调用示例
data = get_stock_list()
print(data["data"]["records"][0]["name"])  # 输出第一个股票名称

示例2：获取加密货币实时价格（如BTC/USDT）

python

def get_crypto_price(symbols="BTCUSDT,ETHUSDT"):
    url = "https://api.stocktv.top/crypto/lastPrice"
    params = {
        "symbols": symbols,
        "key": "YOUR_API_KEY"
    }
    
    response = requests.get(url, params=params)
    if response.status_code == 200:
        return response.json()["data"]
    else:
        return None

# 调用示例
prices = get_crypto_price()
for item in prices:
    print(f"{item['symbol']} 最新价：{item['price']}")

示例3：WebSocket实时股票数据订阅

python

import asyncio
import websockets

async def subscribe_stock_ws():
    uri = "wss://ws-api.stocktv.top/connect?key=YOUR_API_KEY"
    
    async with websockets.connect(uri) as websocket:
        # 发送心跳保持连接（示例）
        while True:
            await asyncio.sleep(30)  # 每30秒发送一次心跳
            await websocket.send("ping")
            
            # 接收实时数据
            response = await websocket.recv()
            print("实时数据:", response)

# 运行WebSocket客户端
asyncio.get_event_loop().run_until_complete(subscribe_stock_ws())

---

四、关键API说明

1. 通用参数

• key: 必填，身份验证密钥

• countryId: 国家代码（例如14=印度，42=马来西亚）

• interval: K线间隔（如PT15M表示15分钟）

2. 高频接口

分类	接口功能	地址
股票	K线数据	/stock/kline?pid=7310
外汇	实时汇率列表	/market/currency
期货	最新行情	/futures/querySymbol
加密货币	历史K线	/crypto/getKlines

---

五、注意事项

1. 频率限制：未公开说明限制，建议控制请求频率（如股票数据每秒不超过10次）

2. 数据缓存：本地缓存高频数据以减少API调用

3. 错误处理：检查HTTP状态码，捕获requests.exceptions异常

4. WebSocket：需定期发送心跳包维持连接