📈 Real-time OKX spot market data with GPT-4o & Telegram
⚡ 516 views · 📈 Crypto Trading & Stock Market
Description
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
-
A Telegram Trigger node listens for incoming user commands.
-
The User Authentication node validates the Telegram ID to allow only authorized users.
-
The workflow creates a Session ID from
chat.idto manage session memory. -
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)
- Latest Price (
-
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.
-
A message splitter ensures Telegram output stays under 4000 characters.
-
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 (
1m→1M). - 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
-
Create a Telegram Bot
- Use @BotFather to generate a bot token.
-
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.
- Import
- Add your OKX API key optional.
-
Deploy and Test
- Activate the workflow in n8n.
- Send a query like
BTC-USDTto your bot. - Instantly get structured OKX Spot data back in Telegram.
📺 Setup Video Tutorial
Watch the full setup guide 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
🔗 Nodes Used
Telegram, Telegram Trigger, AI Agent, OpenAI Chat Model, Simple Memory, Calculator
📥 Import
Download workflow.json and import into n8n:
Workflow menu → Import from File