Wolfx WebSocket API Call Instructions

Introduction to WebSocket

  • The WebSocket API automatically pushes relevant information to all clients when the server receives an EEW

  • Heartbeat mechanism: The server sends a heartbeat packet every minute or after the connection is established to maintain the connection. The client can optionally reply with a ping packet (recommended).

WebSocket Call URLs

  • Receive all JSON API pushes:
    • wss://ws-api.wolfx.jp/all_eew

  • Sichuan Earthquake Early Warning JSON API:
    • wss://ws-api.wolfx.jp/sc_eew

  • JMA Earthquake Early Warning JSON API:
    • wss://ws-api.wolfx.jp/jma_eew

  • Fujian Earthquake Early Warning JSON API:
    • wss://ws-api.wolfx.jp/fj_eew

  • China Earthquake Networks Center Earthquake Information JSON API:
    • wss://ws-api.wolfx.jp/cenc_eqlist

  • JMA Earthquake Information JSON API:
    • wss://ws-api.wolfx.jp/jma_eqlist

  • For detailed JSON field parsing, refer to: https://api.wolfx.jp

WebSocket Manual Query Commands

  • Ping:
    • ping

  • Sichuan Earthquake Early Warning JSON:
    • query_sceew

  • JMA Earthquake Early Warning JSON:
    • query_jmaeew

  • Fujian Earthquake Early Warning JSON:
    • query_fjeew

  • China Earthquake Networks Center Earthquake Information JSON:
    • query_cenceqlist

  • JMA Earthquake Information JSON:
    • query_jmaeqlist

WebSocket JSON Data Explanation

  • Common JSON Field Parsing:

    • type Data type / provider (see API homepage)
  • WebSocket Heartbeat Packet JSON Field Parsing:

    • type heartbeat
    ver Server version number
    id Unique client connection ID
    timestamp Heartbeat packet timestamp (in milliseconds)
  • WebSocket Pong Packet JSON Field Parsing:

    • type pong
    timestamp Pong packet timestamp (in milliseconds)

Doc version: v20250322

Copyright © Wolfx Project. All Rights Reserved. Privacy Policy TOS