秘鲁股票API接入指南：如何通过RESTful API获取BVL实时行情与历史数据

      # 你的API凭证
API_TOKEN = "your_token_here"  # 替换为你在官网获取的实际Token
BASE_URL = "https://api.itick.org"

    

      headers = {
    "accept": "application/json",
    "token": API_TOKEN
}

    

      import requests

def get_stock_quote(region, code):
    """
    获取股票实时报价
    
    Args:
        region: 市场代码"PE"
        code: 股票代码，如"SCCO"（南方铜业）
    
    Returns:
        包含报价信息的字典
    """
    url = f"{BASE_URL}/stock/quote"
    params = {
        "region": region,
        "code": code
    }
    
    headers = {
        "accept": "application/json",
        "token": API_TOKEN
    }
    
    try:
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        
        data = response.json()
        if data.get("code") == 0:  # 返回码0表示成功
            quote = data.get("data", {})
            print(f"股票: {quote.get('s', 'N/A')}")
            print(f"最新价: {quote.get('ld', 'N/A')}")
            print(f"开盘价: {quote.get('o', 'N/A')}")
            print(f"最高价: {quote.get('h', 'N/A')}")
            print(f"最低价: {quote.get('l', 'N/A')}")
            print(f"涨跌额: {quote.get('ch', 'N/A')}")
            print(f"涨跌幅: {quote.get('chp', 'N/A')}%")
            print(f"成交量: {quote.get('v', 'N/A')}")
            return quote
        else:
            print(f"API错误: {data.get('msg', 'Unknown error')}")
            return None
            
    except requests.exceptions.RequestException as e:
        print(f"请求失败: {e}")
        return None

# 使用示例：获取秘鲁南方铜业实时报价
quote_data = get_stock_quote("PE", "SCCO")

    

      import requests
import pandas as pd
from datetime import datetime

def get_stock_kline(region, code, kType, limit=100, et=None):
    """
    获取股票历史K线数据
    
    Args:
        region: 市场代码
        code: 股票代码
        kType: K线类型（1-分钟线，2-5分钟，3-15分钟，4-30分钟，5-60分钟，8-日线，9-周线，10-月线）
        limit: 返回K线数量
        et: 截止时间戳（可选）
    
    Returns:
        Pandas DataFrame包含K线数据
    """
    url = f"{BASE_URL}/stock/kline"
    params = {
        "region": region,
        "code": code,
        "kType": kType,
        "limit": limit
    }
    
    if et:
        params["et"] = et
    
    headers = {
        "accept": "application/json",
        "token": API_TOKEN
    }
    
    try:
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        
        data = response.json()
        if data.get("code") == 0:
            kline_list = data.get("data", [])
            
            if not kline_list:
                print("未获取到K线数据")
                return None
            
            # 转换为DataFrame便于分析
            df = pd.DataFrame(kline_list)
            
            # 重命名字段为更直观的名称
            df.rename(columns={
                't': 'timestamp',
                'o': 'open',
                'h': 'high',
                'l': 'low',
                'c': 'close',
                'v': 'volume'
            }, inplace=True)
            
            # 转换时间戳为可读格式
            df['datetime'] = pd.to_datetime(df['timestamp'], unit='ms')
            
            # 按时间排序
            df.sort_values('timestamp', inplace=True)
            
            print(f"获取到 {len(df)} 条K线数据")
            print(f"时间范围: {df['datetime'].min()} 至 {df['datetime'].max()}")
            
            return df
        else:
            print(f"API错误: {data.get('msg', 'Unknown error')}")
            return None
            
    except requests.exceptions.RequestException as e:
        print(f"请求失败: {e}")
        return None

# 使用示例：获取秘鲁某股票最近30条日线数据
df = get_stock_kline("PE", "SCCO", kType=8, limit=30)

if df is not None:
    # 显示前5条数据
    print("\n前5条数据预览:")
    print(df[['datetime', 'open', 'high', 'low', 'close', 'volume']].head())
    
    # 简单的统计分析
    print(f"\n收盘价统计:")
    print(f"最新收盘价: {df['close'].iloc[-1]:.2f}")
    print(f"期间最高价: {df['high'].max():.2f}")
    print(f"期间最低价: {df['low'].min():.2f}")
    print(f"平均收盘价: {df['close'].mean():.2f}")

    

      def get_batch_quotes(region, codes):
    """
    批量获取多只股票实时报价
    
    Args:
        region: 市场代码
        codes: 股票代码列表，如["SCCO", "BVN", "VOLCABC1"]
    
    Returns:
        包含多只股票报价的字典
    """
    # 将代码列表转换为逗号分隔的字符串
    codes_str = ",".join(codes)
    
    url = f"{BASE_URL}/stock/quotes"  # 注意这里是quotes（复数）
    params = {
        "region": region,
        "codes": codes_str
    }
    
    headers = {
        "accept": "application/json",
        "token": API_TOKEN
    }
    
    try:
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        
        data = response.json()
        if data.get("code") == 0:
            quotes_dict = data.get("data", {})
            
            # 打印每只股票的报价
            for code, quote in quotes_dict.items():
                print(f"\n{code}:")
                print(f"  最新价: {quote.get('ld', 'N/A')}")
                print(f"  涨跌幅: {quote.get('chp', 'N/A')}%")
            
            return quotes_dict
        else:
            print(f"API错误: {data.get('msg', 'Unknown error')}")
            return None
            
    except requests.exceptions.RequestException as e:
        print(f"请求失败: {e}")
        return None

# 使用示例：批量获取多只秘鲁股票报价
# 注意：股票代码需要与iTick确认正确格式
batch_quotes = get_batch_quotes("PE", ["SCCO", "BVN", "VOLCABC1"])