스왑

스왑 데이터 스트림입니다.

연결

websocat

websocat wss://api.datamaxiplus.com/ws/v1/dex/swap -H 'X-DTMX-APIKEY: $YOUR_API_KEY'

wscat

wscat -c wss://api.datamaxiplus.com/ws/v1/dex/swap -H 'X-DTMX-APIKEY: $YOUR_API_KEY'

구독

• method는 요청 유형을 지정합니다.

• params 리스트는 사용자가 구독하려는 거래소의 심볼 목록입니다. 파라미터 형식은 chain@exchange@pool입니다 (예: "kaia_mainnet@klayswap@0x12"). 지원되는 체인 목록은 /api/v1/dex/chains, 거래소 목록은 /api/v1/dex/exchanges, 풀 목록은 /api/v1/dex/pools 엔드포인트에서 조회할 수 있습니다.

• id는 구독 요청을 고유하게 식별합니다.

• chain은 필수 파라미터이며, exchange와 pool은 선택 파라미터입니다.

schema

{
  "method": "SUBSCRIBE",
  "params": [
    string
  ],
  "id": int32
}

example

kaia_mainnet 체인의 모든 풀 구독

{
  "method": "SUBSCRIBE",
  "params": [
    "kaia_mainnet"
  ],
  "id": 1
}

kaia_mainnet 체인의 klayswap 거래소 내 모든 풀 구독

{
  "method": "SUBSCRIBE",
  "params": [
    "kaia_mainnet@klayswap"
  ],
  "id": 1
}

kaia_mainnet 체인의 klayswap 거래소에서 0xB9a1b7A04B6bbF4C319B46583c41f84eDc6c9932 풀 구독

// subscribe for certain pool
{
  "method": "SUBSCRIBE",
  "params": [
    "kaia_mainnet@klayswap@0xB9a1b7A04B6bbF4C319B46583c41f84eDc6c9932"
  ],
  "id": 1
}

응답

필드 (JSON key)	설명
chain	Chain — 스왑 이벤트의 체인. 예시: kaia_mainnet
exchange	Exchange — 스왑 이벤트의 거래소. 예시: dragonswap
pool	Pool — 스왑 이벤트의 풀 주소. 예시: 0x123
txHash	TxHash — 스왑 이벤트의 트랜잭션 해시. 예시: 0xabc
base	Base — 스왑 이벤트의 기준 토큰. 예시: SLN
quote	Quote — 스왑 이벤트의 견적 토큰. 예시: USDT
tokenId	TokenId — 스왑 이벤트의 토큰 ID. 예시: sln
maker	Maker — 스왑 이벤트의 메이커 주소. 예시: 0xdef
type	Type — 스왑 이벤트 유형 (예: buy / sell). 예시: buy
baseQtySubUnit	BaseQtySubUnit — 서브 유닛 기준 기준 토큰 수량 (문자열 인코딩). 예시: 0.01594542081681406
quoteQtySubUnit	QuoteQtySubUnit — 서브 유닛 기준 견적 토큰 수량 (문자열 인코딩). 예시: 0.073019
timestamp	Timestamp — 스왑 이벤트의 타임스탬프 (UTC 초/ms). 예시: 1707927698
blockNumber	BlockNumber — 스왑 이벤트의 블록 번호. 예시: 147266718
baseQtyBaseUnit	BaseQtyBaseUnit — 베이스 유닛 기준 기준 토큰 수량. 예시: 0.01594542081681406
quoteQtyBaseUnit	QuoteQtyBaseUnit — 베이스 유닛 기준 견적 토큰 수량. 예시: 0.073019
basePrice	BasePrice — 기준 토큰의 견적 가격. 예시: 0.01594542081681406
logIndex	LogIndex — 트랜잭션 내 로그 인덱스. 예시: 21

schema

{
"chain": string,
"exchange": string,
"pool": string,
"txHash": string,
"base": string,
"quote": string,
"tokenId": string,
"maker": string,
"type": string,
"baseQtySubUnit": string,
"quoteQtySubUnit": string,
"timestamp": int,
"blockNumber": int,
"baseQtyBaseUnit": float,
"quoteQtyBaseUnit": float,
"basePrice": float,
"logIndex": int
}

example

{
"chain": "kaia_mainnet",
"exchange": "dragonswap",
"pool": "0x123",
"txHash": "0xabc",
"base": "SLN",
"quote": "USDT",
"tokenId": "sln",
"maker": "0xdef",
"type": "buy",
"baseQtySubUnit": "0.01594542081681406",
"quoteQtySubUnit": "0.073019",
"timestamp": 1707927698,
"blockNumber": 147266718,
"baseQtyBaseUnit": 0.01594542081681406,
"quoteQtyBaseUnit": 0.073019,
"basePrice": 0.01594542081681406,
"logIndex": 21
}