본문으로 건너뛰기

[STEP6] 실시간 데이터 수신하기(Mobile 앱 푸쉬 용)

REST API를 활용하여 실시간 데이터 수신하기​

웨이커 대시보드 > UX 솔루션 > 위젯 설정하기 > (선택2) 푸쉬 서버 주소 입력

웨이커 대시보드 > UX 솔루션 > 위젯 설정하기 > (선택2) 푸쉬 서버 주소 입력


웨이커 실시간 데이터(공시) 수신 방법​

  1. 웨이커 대시보드에 접속하셔서 구매하신 상품의 위젯 별로 베타/리얼 푸쉬 서버 주소를 입력 부탁드립니다.
  2. 설정을 저장하시면 연동 설정 후 메일 혹은 유선 상으로 안내드립니다.
  3. 웨이커 데이터(공시)가 발생하면 실시간으로 입력해 주신 서버 주소로 데이터를 발송해 드립니다.
  4. 발송해 드리는 정보는 위젯 별로 상이할 수 있습니다.
위젯 별 전송 정보파라미터설명
내부자거래(POST:/...)
뉴스(POST:/...)

내부자 거래 위젯 전송 정보(POST:/...)

{
  "id": 5713838,
  "aiTradeDetection": true,
  "buyOrSell": "SELL",
  "tradeType": "주식 매도",
  "companyName": "제이피모간 체이스",
  "traderName": "프리드먼 스테이시",
  "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": "경영진",
  "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": "매도하면 10일 뒤에 0.1% 하락했었어요!"
  },
  "isClusterTransaction": true,
  "isCLevelTransaction": false,
  "isEtcTransaction": false
}
FieldTypeDescription
idInteger거래내역 고유 식별 id
tradeTypeString거래 유형
tickerString종목 코드
transactionDateDateTime거래 시각 Date in DateTime format 'YYYY-MM-DDT00:00:00+0000'
reportDateDateTime공시 시각 Date in DateTime format 'YYYY-MM-DDT00:00:00+0000'
cikStringCIK(투자자 고유 식별 id)
companyNameString회사명
traderNameString거래자명
traderTitleString거래자 구분(경영진,CEO,CFO,VP 등의 구분)
companyImageUrlString회사 이미지 url
profileImageUrlString거래자 이미지 url
buyOrSellString매수/매도 구분
sharesTradedInteger거래 주식 수량
averagePriceDouble평균 거래 가격
amountTradedDouble거래 총금액
scoreInteger거래 중요도 (0~2) (중립,중요,매우중요 순서)
isCLevelTransactionBoolean거래자의 직책이 C-Level인 거래
isClusterTransactionBoolean군집 매매 (한 달 내 5건 이상의 시장 거래가 일어난 케이스) 여부
isEtcTransactionBoolean장내 매수, 매도가 아닌 기타 유형의 거래 유무
inspectaiTradeDetection이 true일때 존재
> buyOrSellString매수/매도 구분
> targetDayInteger"n일 뒤 상승or하락 했었어요" 의 n에 해당하는 필드
> percentDouble거래 후 주가 변화율
> chartDataList::Double분석 영역의 그래프 데이터
> guideTextStringaiTradeDetection 이 true일때 AI 분석 내용 가이드 텍스트

Websocket을 활용하여 실시간 데이터 수신하기​

Websocket 타입의 상품(BDR)을 구매하셨다면 별도의 설정없이 공시 데이터를 실시간으로 전달받으실 수 있습니다.

위젯 별 전송 정보Websocket 데이터
내부자거래내부자거래 Websocket docs
뉴스AI 뉴스 Websocket docs

푸쉬 메세지 활용 제안​

사용자에게 유의미한 푸쉬 메세지를 보내기 위하여 아래의 순서를 따라 해보세요.

(1) 푸쉬 메세지 발송 대상 종목 설정하기

  • 모든 종목을 대상으로 설정하기
  • 또는, 사용자의 관심 종목, 보유 종목, 최근 본 종목 등을 기준으로 설정하기 ← 추천하는 안

(2) 푸쉬 메세지 발송 대상 거래건 설정하기

  • 모든 내부자 거래에 대해서 푸쉬 메세지를 발송하다면, 사용자의 피로도가 매우 높아질 수 있습니다. 웨이커가 제안하는 유의미한 거래건에 한해서 푸쉬 메세지를 발송해 보세요.
  • 웨이커가 제안하는 유의미한 거래건(아래 테이블)에 한해서 푸쉬 메세지 발송하기 ← 추천하는 안
주요 거래 유형메세지 예시조건Response field
AI 거래 분석🚨 [엔비디아] 내부자 거래 포착 🚨
CEO 젠슨 황이 1,329억 원 매도했어요. 과거 거래에 대한 AI 데이터 분석 결과,
젠슨황이 매도하면 9일 뒤에 5.12 % 하락했었어요.		aiTradeDetection = true🚨 [엔비디아] 내부자 거래 포착 🚨
{traderTitle} {traderName}이 {amountTraded}원 {buyOrSell}했어요. 과거 거래에 대한 AI 데이터 분석 결과,
{traderName}이{inspect>buyOrSell}하면 {inspect>targetDay}일 뒤에 {inspect>percent} % 하락했었어요.
C-Level 거래🚨 [엔비디아] 내부자 거래 포착 🚨
CEO 젠슨 황이 1,329억 원 매도했어요.		isCLevelTransaction=true🚨 [엔비디아] 내부자 거래 포착 🚨
{traderTitle} {traderName}이 {amountTraded}원 매도했어요.
시총 0.01% 이상의 거래🚨 [엔비디아] 내부자 거래 포착 🚨
CEO 젠슨 황이 최근 한 달 동안 1,329억 원 매도했어요. 거래 금액이 큰 거래는 시세에 영향을 줄 수 있어요.		isOverMarketCap=true🚨 [엔비디아] 내부자 거래 포착 🚨
{traderTitle} {traderName}이 최근 한 달 동안 {amountTraded} 매도했어요. 거래 금액이 큰 거래는 시세에 영향을 줄 수 있어요.
군집매매🚨 [엔비디아] 내부자 거래 포착 🚨
최근 한 달 동안 10건의 군집 매매가 발생했어요.
단기간에 일어난 여러 건의 거래는 시세에 영향을 줄 수 있어요.		isClusterTransaction=true🚨 [엔비디아] 내부자 거래 포착 🚨
최근 한 달 동안 {clusterTransactionCount}건의 군집 매매가 발생했어요.
단기간에 일어난 여러 건의 거래는 시세에 영향을 줄 수 있어요.