2026 French Stock API: Real-Time Quotes, Historical Data & Financials

      import requests
from datetime import datetime

# Replace with your actual token
API_TOKEN = "your_api_token_here"
BASE_URL = "https://api.itick.org"

def get_french_stock_quote(symbol: str):
    """
    Fetch real-time quote for a French-listed equity
    :param symbol: local ticker (e.g. "MC" for LVMH)
    """
    url = f"{BASE_URL}/stock/quote"
    params = {
        "region": "FR",
        "code": symbol
    }
    headers = {
        "accept": "application/json",
        "token": API_TOKEN
    }

    try:
        resp = requests.get(url, params=params, headers=headers, timeout=5)
        resp.raise_for_status()
        result = resp.json()

        if result.get("code") == 0:
            data = result["data"]
            print(f"Name:        {data.get('n', 'N/A')}")
            print(f"Symbol:      {data.get('s', 'N/A')}")
            print(f"Last:        {data.get('ld', 'N/A')} EUR")
            print(f"Open:        {data.get('o', 'N/A')} EUR")
            print(f"High:        {data.get('h', 'N/A')} EUR")
            print(f"Low:         {data.get('l', 'N/A')} EUR")
            print(f"Volume:      {data.get('v', 'N/A')} shares")
            print(f"Change %:    {data.get('chp', 'N/A')}%")

            ts = data.get('t', 0) / 1000
            dt = datetime.fromtimestamp(ts)
            print(f"Timestamp:   {dt.strftime('%Y-%m-%d %H:%M:%S')}")
            return data
        else:
            print(f"API Error: {result.get('msg', 'Unknown')}")
            return None

    except Exception as e:
        print(f"Request failed: {e}")
        return None


# Example usage
quote = get_french_stock_quote("MC")

    

      import requests
import pandas as pd
import matplotlib.pyplot as plt

def get_french_stock_kline(symbol: str, ktype: int = 8, limit: int = 100):
    """
    Fetch historical bars
    ktype: 1=1min, 2=5min, ..., 8=daily, 9=weekly, 10=monthly
    """
    url = f"{BASE_URL}/stock/kline"
    params = {
        "region": "FR",
        "code": symbol,
        "kType": str(ktype),
        "limit": str(limit)
    }
    headers = {"accept": "application/json", "token": API_TOKEN}

    try:
        resp = requests.get(url, params=params, headers=headers)
        result = resp.json()

        if result.get("code") == 0:
            bars = result.get("data", [])
            if not bars:
                print("No data returned")
                return None

            df = pd.DataFrame(bars)
            df['datetime'] = pd.to_datetime(df['t'], unit='ms')
            df.set_index('datetime', inplace=True)

            df.rename(columns={
                'o': 'open', 'h': 'high', 'l': 'low',
                'c': 'close', 'v': 'volume'
            }, inplace=True)

            for col in ['open','high','low','close','volume']:
                df[col] = pd.to_numeric(df[col], errors='coerce')

            print(f"Retrieved {len(df)} bars")
            print(df[['open','high','low','close','volume']].head())

            # Quick visualization
            df['close'].plot(figsize=(12,6), title=f"{symbol} Closing Price")
            plt.grid(True)
            plt.show()

            return df
        else:
            print(f"API Error: {result.get('msg')}")
            return None

    except Exception as e:
        print(f"Exception: {e}")
        return None


# Download last 100 daily bars of TotalEnergies
df_total = get_french_stock_kline("TTE", ktype=8, limit=100)

    

      def get_french_stock_fundamentals(symbol: str):
    url = f"{BASE_URL}/stock/info"
    params = {"region": "FR", "code": symbol, "type": "stock"}
    headers = {"accept": "application/json", "token": API_TOKEN}

    try:
        resp = requests.get(url, params=params, headers=headers)
        result = resp.json()

        if result.get("code") == 0:
            items = result.get("data", [])
            print(f"Financials for {symbol}")
            for item in items[:3]:   # show most recent 3 periods
                print(f"Market Cap: {item.get('mcb')}")
                print(f"Shares Out: {item.get('tso')}")
                print(f"P/E Ratio:  {item.get('pet')}")
                print("-" * 40)
            return items
        else:
            print(f"API Error: {result.get('msg')}")
            return None

    except Exception as e:
        print(f"Exception: {e}")
        return None


# Example: L'Oréal fundamentals
fundamentals_or = get_french_stock_fundamentals("OR")

    

      import websocket
import json
import threading
import time

WS_URL = "wss://api.itick.org/stock"
API_TOKEN = "your_api_token_here"

def on_message(ws, message):
    data = json.loads(message)
    if "data" in data:
        payload = data["data"]
        symbol = payload.get("s")
        msg_type = payload.get("type")

        if msg_type == "quote":
            print(f"[{symbol}] Last: {payload.get('ld')} EUR | Chg: {payload.get('chp')}%")
        elif msg_type == "depth":
            bids = payload.get("b", [])[:3]
            asks = payload.get("a", [])[:3]
            print(f"[{symbol}] Bid: {bids} | Ask: {asks}")

def on_open(ws):
    print("WebSocket connected")
    sub = {
        "ac": "subscribe",
        "params": "MC$FR,OR$FR",      # LVMH + L'Oréal
        "types": "quote,depth"
    }
    ws.send(json.dumps(sub))
    print(f"Subscribed to: {sub['params']}")

def on_error(ws, error):
    print(f"WS Error: {error}")

def on_close(ws, code, reason):
    print(f"WS Closed: {reason}")

def heartbeat(ws):
    while True:
        time.sleep(30)
        ws.send(json.dumps({
            "ac": "ping",
            "params": str(int(time.time() * 1000))
        }))
        print("Heartbeat sent")

# Initialize & run
ws = websocket.WebSocketApp(
    WS_URL,
    header={"token": API_TOKEN},
    on_open=on_open,
    on_message=on_message,
    on_error=on_error,
    on_close=on_close
)

threading.Thread(target=heartbeat, args=(ws,), daemon=True).start()
ws.run_forever()