본문으로 건너뛰기

오더북

오더북 데이터 조회​

특정 마켓 결과에 대한 오더북을 조회합니다.

OpenAPI xmarket-openapi

코드 예제​

// Get Orderbook Data
const API_KEY = 'YOUR_API_KEY'
const BASE_URL = 'https://engine.xmarket.app/api/v1';

async function getOrderbook(outcomeId) {
  const response = await fetch(
    `${BASE_URL}/orderbook/${outcomeId}`,
    {
      headers: {
        'x-api-key': API_KEY,
        'Content-Type': 'application/json'
      }
    }
  );

  const orderbook = await response.json();
  return orderbook;
}

스프레드 조회​

특정 마켓 결과에 대한 오더북 스프레드를 조회합니다.

OpenAPI xmarket-openapi

모범 사례​

  1. 폴링 빈도: 너무 자주 폴링하지 말고 요청 제한을 준수하세요
  2. 데이터 캐싱: 적절한 TTL로 오더북 데이터를 캐싱하세요
  3. 에러 처리: 네트워크 오류 및 유효하지 않은 응답을 우아하게 처리하세요
  4. 가격 검증: 가격이 유효 범위(0-1) 내에 있는지 검증하세요
  5. 깊이 분석: 대량 주문 시 시장 깊이를 고려하세요
  6. 실시간 업데이트: 고빈도 업데이트의 경우, WebSocket 연결이 가능하면 이를 활용하세요

성능 팁​

  • 응답 크기를 제한하기 위해 페이지네이션을 사용하세요
  • 최근 조회한 마켓의 오더북 데이터를 캐싱하세요
  • 재시도 로직에 지수 백오프를 구현하세요
  • 여러 결과의 오더북을 병렬로 집계하는 것을 고려하세요
  • 스로틀링을 피하기 위해 요청 제한 헤더를 모니터링하세요

관련 문서​