Wolfx Open API Usage

Wolfx Open API Usage Guidelines

Thank you for using the Wolfx Open API! We recommend reviewing the Privacy Policy and Terms of Service at the bottom of this page before getting started. If you have any questions, feel free to contact us at [email protected].

WebSocket API Usage Instructions

For more details, please visit: https://wolfx.jp/wsapi_en

JMA Earthquake Early Warning JSON API

Description: Real-time access to Earthquake Early Warnings issued by the Japan Meteorological Agency (JMA)

HTTP GET API Endpoint:

https://api.wolfx.jp/jma_eew.json

WebSocket API Endpoint:

wss://ws-api.wolfx.jp/jma_eew

JSON Field Descriptions (Data Types):

type	jma_eew (String)
Title	EEW message header (String)
CodeType	Type of EEW issuance (String)
Issue.Source	Issuing agency location (String)
Issue.Status	Status of the EEW message (String)
EventID	EEW Event ID (String)
Serial	EEW serial number (Number)
AnnouncedTime	Time of announcement (UTC+9) (String)
OriginTime	Time of the earthquake (UTC+9) (String)
Hypocenter	Epicenter (String)
Latitude	Epicenter latitude (Number)
Longitude	Epicenter longitude (Number)
Magunitude	Magnitude (Number)
Depth	Hypocenter depth (Number)
MaxIntensity	Maximum seismic intensity (e.g. Weak/Strong) (String)
Accuracy.Epicenter	Epicenter accuracy note (String)
Accuracy.Depth	Depth accuracy note (String)
Accuracy.Magnitude	Magnitude accuracy note (String)
MaxIntChange.String	Max intensity change note (String)
MaxIntChange.Reason	Reason for intensity change (String)
WarnArea.Chiiki	Warning area name (String)
WarnArea.Shindo1	Maximum intensity in area (Weak/Strong) (String)
WarnArea.Shindo2	Minimum intensity in area (Weak/Strong) (String)
WarnArea.Time	Time of area alert issuance (String)
WarnArea.Type	Type of area alert: "Forecast" or "Warning" (String)
WarnArea.Arrive	Whether seismic waves have arrived in the area (Boolean)
isSea	True if offshore earthquake (Boolean)
isTraining	True if training/test message (Boolean)
isAssumption	True if epicenter is estimated (PLUM/Level/IPF method) (Boolean)
isWarn	True if classified as a warning (Boolean)
isFinal	True if this is the final report (Boolean)
isCancel	True if this is a cancellation message (Boolean)
OriginalText	Original bulletin text from JMA (String)

Sichuan Earthquake Administration - Earthquake Early Warning JSON API

Description: Real-time access to earthquake early warnings issued by the Sichuan Earthquake Administration

HTTP GET API Endpoint:

https://api.wolfx.jp/sc_eew.json

WebSocket API Endpoint:

wss://ws-api.wolfx.jp/sc_eew

JSON Field Descriptions (Data Types):

type	sc_eew (String)
ID	EEW Report ID (Number)
EventID	EEW Event Identifier (String)
ReportTime	Time of EEW issuance (UTC+8) (String)
ReportNum	Report sequence number (Number)
OriginTime	Earthquake origin time (UTC+8) (String)
HypoCenter	Hypocenter location (String)
Latitude	Latitude of the hypocenter (Number)
Longitude	Longitude of the hypocenter (Number)
Magunitude	Magnitude (Number)
Depth	Depth of hypocenter (Not provided in source data) (Number)
MaxIntensity	Maximum seismic intensity (Number)

Fujian Earthquake Administration - Earthquake Early Warning JSON API

Description: Real-time access to earthquake early warnings issued by the Fujian Earthquake Administration

HTTP GET API Endpoint:

https://api.wolfx.jp/fj_eew.json

WebSocket API Endpoint:

wss://ws-api.wolfx.jp/fj_eew

JSON Field Descriptions (Data Types):

type	fj_eew (String)
ID	EEW Report ID (Number)
EventID	EEW Event Identifier (String)
ReportTime	Time of EEW issuance (UTC+8) (String)
ReportNum	Report sequence number (Number)
OriginTime	Earthquake origin time (UTC+8) (String)
HypoCenter	Hypocenter location (String)
Latitude	Latitude of the hypocenter (Number)
Longitude	Longitude of the hypocenter (Number)
Magunitude	Magnitude (Number)
isFinal	True if this is the final report (Boolean)

China Earthquake Networks Center - Earthquake Information JSON API

Description: Retrieves the latest 50 earthquake reports published by the China Earthquake Networks Center (CENC)

HTTP GET API Endpoint:

https://api.wolfx.jp/cenc_eqlist.json

WebSocket API Endpoint:

wss://ws-api.wolfx.jp/cenc_eqlist

JSON Field Descriptions (Data Types):

type	cenc_eqlist (String)
No (1~50)	Entry number of the earthquake record (ordered by publication time) (String)
type	Type of report: either "automatic" or "reviewed" (String)
time	Origin time of the earthquake (UTC+8) (String)
location	Epicenter (String)
magnitude	Magnitude (String)
depth	Depth of the hypocenter (String)
latitude	Latitude of the epicenter (String)
longitude	Longitude of the epicenter (String)
intensity	Maximum intensity (String)
md5	MD5 hash used to check for data updates (String)

JMA Earthquake Information JSON API

Description: Retrieves the latest 50 earthquake reports issued by the Japan Meteorological Agency (JMA)

HTTP GET API Endpoint:

https://api.wolfx.jp/jma_eqlist.json

WebSocket API Endpoint:

wss://ws-api.wolfx.jp/jma_eqlist

JSON Field Descriptions (Data Types):

type	jma_eqlist (String)
Title	Message header (String)
No (1~50)	Entry number of the earthquake report (in order of publication time) (String)
time	Origin time of the earthquake (UTC+9) (String)
location	Epicenter location (String)
magnitude	Magnitude (String)
shindo	Maximum seismic intensity (with ± qualifiers) (String)
depth	Hypocenter depth (String)
latitude	Epicenter latitude (String)
longitude	Epicenter longitude (String)
info	Tsunami information (only available in the first entry) (String)
md5	Hash for earthquake report update verification (String)

China Real-Time Weather Ranking JSON API

Description: Provides hourly rankings of temperature, precipitation, and wind speed from national-level weather observation stations across China

HTTP GET API Endpoint:

https://api.wolfx.jp/weather_rank.json

JSON Field Descriptions (Data Types):

YYYYMMDDHH00	Weather ranking data for each of the past 8 hours (UTC+8) (String)
tempRank	Top 10 highest temperatures nationwide (String)
rainRank	Top 10 highest precipitation amounts nationwide (String)
windSRank	Top 10 highest wind speeds nationwide (String)
md5	Checksum for verifying data updates (String)

IP Address Information Lookup JSON API

Description: Retrieve information about the requester’s IP address or a specified IP address

HTTP GET API Endpoint:

https://api.wolfx.jp/geoip.php

https://api.wolfx.jp/geoip.php?ip=<IP address>

JSON Field Descriptions (Data Types):

ip	Queried IP address (String)
country_code	Country or region code (String)
country_name	Country or region name (String)
country_name_zh	Country or region name (in Chinese) (String)
province_code	Province or state code (String)
province_name	Province or state name (String)
province_name_zh	Province or state name (in Chinese) (String)
city	City name (String)
city_zh	City name (in Chinese) (String)
latitude	Latitude (may be unavailable) (Number)
longitude	Longitude (may be unavailable) (Number)

Latest Server Time JSON API

Description: Provides the latest accurate server time for synchronization purposes

HTTP GET API Endpoint:

https://api.wolfx.jp/ntp.json

JSON Field Descriptions (Data Types):

JST	Japan Standard Time (UTC+9) (String)
CST	China Standard Time (UTC+8) (String)
str	Current date and time (String)
int	Current date and time (as a number) (Number)
timestamp	Current UNIX timestamp (Number)

Public IP Address Retrieval PLAIN API

Description: Retrieve the public IP address of the requester in plain text format.

HTTP GET API URL:

https://api.wolfx.jp/ip.php

Random Anime Image Retrieval JPEG API

Description: Retrieve a random anime image.

HTTP GET API URL:

https://api.wolfx.jp/img.php

https://api.wolfx.jp/img.php?return=<img/json>

API Status

Active WebSocket clients: 0

Nginx Requests

Network Traffic

Count data updated at