Back to Templates

Real-time OKX Spot Market Data with GPT-4o & Telegram

Created by

Created by: Don Jayamaha Jr || don-the-gem-dealer

Don Jayamaha Jr

Last update

Last update 23 days ago

Share


Instantly access live OKX Spot Market data directly in Telegram!

This workflow integrates the OKX REST v5 API with Telegram and optional GPT-4.1-mini formatting, delivering real-time insights such as latest prices, order book depth, candlesticks, trades, and mark prices — all in clean, structured reports.


🔎 How It Works

  1. A Telegram Trigger node listens for incoming user commands.

  2. The User Authentication node validates the Telegram ID to allow only authorized users.

  3. The workflow creates a Session ID from chat.id to manage session memory.

  4. The OKX AI Agent orchestrates data retrieval via HTTP requests to OKX endpoints:

    • Latest Price (/api/v5/market/ticker?instId=BTC-USDT)
    • 24h Stats (/api/v5/market/ticker?instId=BTC-USDT)
    • Order Book Depth (/api/v5/market/books?instId=BTC-USDT&sz=50)
    • Best Bid/Ask (book ticker snapshot)
    • Candlesticks / Klines (/api/v5/market/candles?instId=BTC-USDT&bar=15m)
    • Average / Mark Price (/api/v5/market/mark-price?instType=SPOT&instId=BTC-USDT)
    • Recent Trades (/api/v5/market/trades?instId=BTC-USDT&limit=100)
  5. Utility tools refine the data:

    • Calculator → spreads, % change, normalized volumes.
    • Think → reshapes raw JSON into clean text.
    • Simple Memory → stores sessionId, symbol, and state for multi-turn interactions.
  6. A message splitter ensures Telegram output stays under 4000 characters.

  7. Final results are sent to Telegram in structured, human-readable format.


✅ What You Can Do with This Agent

  • Get latest price and 24h stats for any Spot instrument.
  • Retrieve order book depth with configurable size (up to 400 levels).
  • View best bid/ask snapshots instantly.
  • Fetch candlestick OHLCV data across intervals (1m1M).
  • Monitor recent trades (up to 100).
  • Check the mark price as a fair average reference.
  • Receive clean, Telegram-ready reports (auto-split if too long).

🛠️ Setup Steps

  1. Create a Telegram Bot

  2. Configure in n8n

    • Import OKX AI Agent v1.02.json.
    • Replace the placeholder in User Authentication node with your Telegram ID.
    • Add Telegram API credentials (bot token).
    • Add your OpenAI API key for GPT-4.1-mini.
  1. Deploy and Test

    • Activate the workflow in n8n.
    • Send a query like BTC-USDT to your bot.
    • Instantly get structured OKX Spot data back in Telegram.

📺 Setup Video Tutorial

Watch the full setup guide on YouTube:

Watch on YouTube


Unlock real-time OKX Spot Market insights directly in Telegram — no private API keys required!


🧾 Licensing & Attribution

© 2025 Treasurium Capital Limited Company
Architecture, prompts, and trade report structure are IP-protected.

No unauthorized rebranding permitted.

🔗 For support: Don Jayamaha – LinkedIn