秘魯股票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"])