X（旧ツイッター）リアルタイムAPI
取引ボット、ターミナル、AIエージェント向け

import asyncio, json
import websockets

URL = "wss://api.xanguard.tech/v1/dt/realtime/ws"
API_KEY = "dt_your_key"

async def main():
    async with websockets.connect(URL) as ws:
        # op 10 HELLO：ハートビート間隔（ms）を含む
        hello = json.loads(await ws.recv())
        interval = hello["d"]["heartbeat_interval"] / 1000

        # op 2 LOGIN：15秒以内にキーを送信
        await ws.send(json.dumps({"op": 2, "d": API_KEY}))
        ready = json.loads(await ws.recv())
        if ready["op"] != 4:  # 失敗時は op 3 DISCONNECT が届く
            raise SystemExit(ready["d"].get("reason"))
        print("接続しました:", ready["d"]["modules"])

        # 間隔に合わせてハートビート送信。90秒なしで切断
        async def heartbeat():
            while True:
                await asyncio.sleep(interval)
                await ws.send(json.dumps({"op": 1}))
        hb = asyncio.create_task(heartbeat())

        async for raw in ws:
            msg = json.loads(raw)
            if msg["op"] != 0:  # op 0 EVENT のみ処理
                continue
            ev, d = msg["d"]["event"], msg["d"]["data"]
            if ev == "twitter.post.new":
                print(d["author"]["handle"], d["text"])
            elif ev == "twitter.tweet.deleted":
                print("削除:", d["tweet_id"])
            elif ev == "twitter.profile.update":
                print("プロフィール変更:", d["field"], d["updated"])

asyncio.run(main())

const WebSocket = require('ws');
const URL = 'wss://api.xanguard.tech/v1/dt/realtime/ws';
const ws = new WebSocket(URL);
let hb;

ws.on('message', (raw) => {
  const msg = JSON.parse(raw.toString());
  switch (msg.op) {
    case 10: // HELLO：LOGIN を送信してハートビート開始
      ws.send(JSON.stringify({ op: 2, d: 'dt_your_key' }));
      hb = setInterval(
        () => ws.send(JSON.stringify({ op: 1 })),
        msg.d.heartbeat_interval
      );
      break;
    case 4: // READY：認証成功
      console.log('接続しました', msg.d.modules);
      break;
    case 3: // DISCONNECT：無効または期限切れのキーなど
      console.error('切断されました:', msg.d.reason);
      break;
    case 0: { // EVENT：リアルタイムイベント
      const { event, data } = msg.d;
      if (event === 'twitter.post.new') {
        console.log(data.author.handle, data.text);
      } else if (event === 'twitter.following.new') {
        console.log('新規フォロー:', data.handle);
      }
      break;
    }
  }
});

ws.on('close', () => clearInterval(hb));