[STEP6] Receiving Real-Time Data (For Mobile App Push)

Receiving Real-Time Data Using REST API

Waiker Dashboard > UX Solutions > Setting Up Widget > (Option 2) Enter Push Server Address

How to Receive Waiker Real-Time Data (Disclosures)

1. Waiker DashboardPlease enter the beta/real push server address for each widget of the product you purchased.
2. Once you save the settings, we will inform you via email or phone after the integration setup.
3. When Waiker data (disclosures) is generated, we will send the data in real-time to the server address you provided.
4. The information we send may vary by widget.

Transmission Information by Widget	Parameter	Description
Insider Transaction (POST: /...)
News (POST: /...)

Insider Transaction Widget Transmission Information (POST: /...)

{
  "id": 5713838,
  "aiTradeDetection": true,
  "buyOrSell": "SELL",
  "tradeType": "Stock Sell",
  "companyName": "JPMorgan Chase",
  "traderName": "Stacey Friedman",
  "companyImageUrl": "https://hub.waiker.ai/logo/square/JPM.png",
  "profileImageUrl": "https://waiker-data-log-s3.s3.ap-northeast-2.amazonaws.com/form4_image/Stacey_Friedman_profile_pic.jpg",
  "transactionDate": "2024-06-20T00:00:00Z",
  "ticker": "JPM",
  "cik": "1662926",
  "traderTitle": "Executive",
  "sharesTraded": 4415,
  "reportDate": "2024-06-20T00:00:00Z",
  "averagePrice": 273864.11329,
  "amountTraded": 1209110060.17535,
  "score": 2,
  "beforePrice": 273061.69999999995,
  "inspect": {
    "buyOrSell": "SELL",
    "targetDay": 10,
    "percent": -0.10279374091597962,
    "chartData": [
      1,
      0.976,
      0.9574,
      0.9679,
      0.9663,
      0.971,
      0.969,
      0.9662,
      0.9625,
      0.9608,
      0.9653,
      0.9603,
      0.9575,
      0.9524,
      0.9775,
      0.9846,
      0.9888,
      0.98,
      0.9724,
      0.9785,
      0.9801,
      0.9825,
      0.9765,
      0.9731,
      0.9693,
      0.9647,
      0.9649,
      0.9766,
      0.9815,
      0.9878,
      0.9883,
      0.9816,
      0.9818,
      0.9828,
      0.9725,
      0.9575,
      0.9397,
      0.934,
      0.9306,
      0.9303,
      0.9209,
      0.9111,
      0.9026,
      0.9256,
      0.9235,
      0.9291,
      0.9323,
      0.9301,
      0.9441,
      0.9432,
      0.9411,
      0.9308,
      0.9268,
      0.9119,
      0.8995
    ],
    "guideText": "If you sell, it dropped 0.1% after 10 days!"
  },
  "isClusterTransaction": true,
  "isCLevelTransaction": false,
  "isEtcTransaction": false
}

Field	Type	Description
id	Integer	Unique Identifier ID for Transaction History
tradeType	String	Transaction Type
ticker	String	Ticker Symbol
transactionDate	DateTime	Transaction Time: Date in DateTime format 'YYYY-MM-DDT00:00:00+0000'
reportDate	DateTime	Disclosure Time: Date in DateTime format 'YYYY-MM-DDT00:00:00+0000'
cik	String	CIK (Unique Identifier ID for Investors)
companyName	String	Company Name
traderName	String	Trader Name
traderTitle	String	Trader Classification (such as Executive, CEO, CFO, VP, etc.)
companyImageUrl	String	Company Image URL
profileImageUrl	String	Trader Image URL
buyOrSell	String	Buy/Sell Classification
sharesTraded	Integer	Number of Shares Traded
averagePrice	Double	Average Transaction Price
amountTraded	Double	Total Transaction Amount
score	Integer	Transaction Importance (0~2) (Neutral, Important, Very Important in order)
isCLevelTransaction	Boolean	Transactions with Traders in C-Level Positions
isClusterTransaction	Boolean	Whether Cluster Trading Occurred (Cases where 5 or more market transactions happened within a month)
isEtcTransaction	Boolean	Whether there are other types of transactions that are not on-exchange buying or selling
inspect		Exists when aiTradeDetection is true
> buyOrSell	String	Buy/Sell Classification
> targetDay	Integer	The field corresponding to n in "It increased or decreased after n days."
> percent	Double	Stock Price Change Rate After Transaction
> chartData	List::Double	Graph Data of the Analysis Area
> guideText	String	Guide Text for AI Analysis When aiTradeDetection is True

Receiving Real-Time Data Using WebSocket

If you have purchased a WebSocket type product (BDR), you can receive disclosure data in real-time without any additional settings.

Transmission Information by Widget	Websocket Data
Insider Transaction	Insider Transaction Websocket docs
News	AI News Websocket docs

Suggestions for Utilizing Push Messages

To send meaningful push messages to users, please follow the steps below.

(1) Setting the Target Stocks for Sending Push Messages

• Set as Target for All Stocks
• Alternatively, set based on the user's watched stocks, owned stocks, or recently viewed stocks ← Recommended Option

(2) Setting the Target Transactions for Sending Push Messages

• If push messages are sent for all insider transaction, the user's fatigue level can increase significantly. Try sending push messages only for the significant transactions suggested by Waiker.
• Sending Push Messages Only for Significant Transactions Suggested by Waiker (See Table Below) ← Recommended Option

Key Transaction Types	Message Example	Condition	Response field
AI Trade Analysis	🚨 [NVIDIA] Insider Transaction Detected 🚨 CEO Jensen Huang sold 132.9 billion KRW. Based on AI data analysis of past transactions, when Jensen Huang sells, there has been a 5.12% decline after 9 days.	aiTradeDetection = true	🚨 [NVIDIA] Insider Transaction Detected 🚨 {traderTitle} {traderName} has {buyOrSell} for {amountTraded} KRW. Based on AI data analysis of past transactions, if {traderName} {inspect>buyOrSell}, it declined by {inspect>percent}% after {inspect>targetDay} days.
C-Level Transactions	🚨 [NVIDIA] Insider Transaction Detected 🚨 CEO Jensen Huang sold 132.9 billion KRW.	isCLevelTransaction=true	🚨 [NVIDIA] Insider Transaction Detected 🚨 {traderTitle} {traderName} has sold {amountTraded} KRW.
Transactions Exceeding 0.01% of Market Capitalization	🚨 [NVIDIA] Insider Transaction Detected 🚨 CEO Jensen Huang sold 132.9 billion KRW in the past month. Transactions with large amounts can impact the market price.	isOverMarketCap=true	🚨 [NVIDIA] Insider Transaction Detected 🚨 {traderTitle} {traderName} has sold {amountTraded} in the past month. Transactions with large amounts can influence market prices.
Cluster Trading	🚨 [NVIDIA] Insider Transaction Detected 🚨 Ten instances of cluster trading occurred in the past month. Multiple transactions occurring over a short period can influence market prices.	isClusterTransaction=true	🚨 [NVIDIA] Insider Transaction Detected 🚨 {clusterTransactionCount} instances of cluster trading occurred in the past month. Multiple transactions occurring over a short period can influence market prices.