如何利用 iTick API 接入尼日利亞股票市場：即時報價與歷史 K 線數據

iTick
2026-01-20
教程

在全球金融市場日益互聯的今天，尼日利亞作為非洲最大的經濟體，其股票市場（Nigerian Stock Exchange, NSE）正吸引著越來越多投資者的目光。NSE 上市公司涵蓋能源、金融、消費品等多個領域，例如 Dangote Cement (DANGCEM) 和 Zenith Bank (ZENITHBANK)，這些股票的即時數據與歷史趨勢分析對投資決策至關重要。然而，接入這些數據往往面臨技術門檻高、數據來源不穩定等問題。

iTick API 提供了一個簡單高效的解決方案！iTick 作為專業的金融數據提供商，支援全球多個市場，包括尼日利亞（region=NG），通過 RESTful API 接口，您可以輕鬆獲取即時股票報價與歷史 K 線數據。iTick 的優勢在於數據即時性強、覆蓋全面、接口友好，並提供免費階梯計劃支持開發者快速上手。無論您是個人投資者、量化交易者還是金融 App 開發者，都能從中受益。本文將帶您逐步了解如何使用 iTick API 接入尼日利亞股票，並提供 Python 代碼範例。讓我們開始吧！

一、為什麼選擇 iTick API 接入尼日利亞股票？

全球市場覆蓋：iTick 支援包括 NG（尼日利亞）在內的多個新興市場數據，確保您能獲取準確的本地化資訊。
即時與歷史數據：從即時報價到多週期 K 線應有盡有，幫助您分析市場走勢。
易於整合：REST API 設計簡潔，僅需幾行程式碼即可調用，支援 Python、Java 等多種語言。
可靠與免費：數據直連交易所，品質高；免費計劃適合初學者，付費版針對機構用戶。
新興市場機遇：尼日利亞股市正處於成長期，iTick 幫助您把握投資機會，避免數據孤島。

如果您是首次使用，請先前往 iTick 官網註冊帳號，取得 API Token。這是所有調用的必要條件。

二、API 接口詳解

iTick 提供豐富的股票 API，這裡重點介紹兩個核心接口：即時報價（Stock Quote）與歷史 K 線（Stock Kline）。這些接口均使用 GET 方法，參數簡潔明瞭。

1. 即時股票報價 API（Stock Quote）

此接口用於獲取指定股票的最新價格、漲跌幅、成交量等資訊，非常適合監控市場動態。

端點：GET https://api.itick.org/stock/quote
必填參數：
- region：市場代碼，對於尼日利亞使用「NG」。
- code：股票代碼，例如「DANGCEM」（Dangote Cement）。

響應範例：

      {
  "code": 0,
  "msg": null,
  "data": {
    "s": "DANGCEM",
    "ld": 500.00,        // 最新價
    "o": 495.00,         // 開盤價
    "p": 490.00,         // 昨收價
    "h": 505.00,         // 最高價
    "l": 490.00,         // 最低價
    "t": 1765526889000,  // 時間戳
    "v": 1000000,        // 成交量
    "tu": 500000000.00,  // 成交額
    "ts": 0,             // 交易狀態
    "ch": 10.00,         // 變動額
    "chp": 2.04          // 變動百分比
  }
}

    

2. 歷史 K 線數據 API（Stock Kline）

此接口返回指定週期的 K 線數據，包括開高低收、成交量等，可用於技術分析與回測策略。

端點：GET https://api.itick.org/stock/kline
必填參數：
- region：「NG」。
- code：股票代碼，如「DANGCEM」。
- kType：K 線類型（1: 1分鐘, 2: 5分鐘, ..., 8: 日K, 9: 週K, 10: 月K）。
- limit：返回 K 線條數。
可選參數：
- et：截止時間戳（毫秒），預設當前時間。

響應範例：

      {
  "code": 0,
  "msg": null,
  "data": [
    {
      "t": 1741239000000,  // 時間戳
      "o": 495.00,         // 開盤
      "h": 505.00,         // 最高
      "l": 490.00,         // 最低
      "c": 500.00,         // 收盤
      "v": 1000000,        // 成交量
      "tu": 500000000.00   // 成交額
    }
    // 更多記錄...
  ]
}

    

三、Python 代碼範例：接入尼日利亞股票

以下是使用 Python 的 requests 庫調用這些 API 的範例代碼。記得替換「your_token」為您的實際 API Token。代碼假設您想查詢 Dangote Cement 的數據。

      import requests
import json

# API 基礎 URL
BASE_URL = "https://api.itick.org"

# 您的 API Token
TOKEN = "your_token"

# 公共 headers
headers = {
    "accept": "application/json",
    "token": TOKEN
}

def get_stock_quote(region, code):
    """獲取即時股票報價"""
    url = f"{BASE_URL}/stock/quote"
    params = {
        "region": region,
        "code": code.upper()  # 代碼通常大寫
    }
    response = requests.get(url, params=params, headers=headers)
    if response.status_code == 200:
        return response.json()
    else:
        print(f"Error: {response.status_code}")
        return None

def get_stock_kline(region, code, ktype, limit=10):
    """獲取歷史 K 線數據"""
    url = f"{BASE_URL}/stock/kline"
    params = {
        "region": region,
        "code": code.upper(),
        "kType": ktype,  # 如 8 為日K
        "limit": limit
    }
    response = requests.get(url, params=params, headers=headers)
    if response.status_code == 200:
        return response.json()
    else:
        print(f"Error: {response.status_code}")
        return None

# 範例：查詢尼日利亞股票 DANGCEM 的即時報價
quote_data = get_stock_quote("NG", "DANGCEM")
if quote_data:
    print("即時報價：")
    print(json.dumps(quote_data, indent=4))

# 範例：查詢 DANGCEM 的最近 10 條日 K 線
kline_data = get_stock_kline("NG", "DANGCEM", 8, 10)
if kline_data:
    print("歷史 K 線：")
    print(json.dumps(kline_data, indent=4))

    