빠른 시작

Xmarket API 문서에 오신 것을 환영합니다. 이 가이드는 Xmarket 거래 API를 애플리케이션에 통합하는 데 도움이 됩니다.

개요

Xmarket API는 다음에 대한 프로그래매틱한 접근을 제공합니다:

  • 실시간 오더북 데이터

  • 주문 생성 및 관리

  • 마켓 정보

  • 포지션 추적

  • 거래 운영

기본 URL

API는 엔드포인트 유형에 따라 두 가지 기본 URL을 사용합니다:

  • 퍼블릭 엔드포인트 (읽기 전용, 인증 불필요):

    https://engine.xmarket.app/api/v1

    사용 용도: 마켓, 오더북 데이터

  • 인증된 엔드포인트 (API 키 필요):

    https://engine.xmarket.app/openapi/v1

    사용 용도: 주문, 포지션, 거래 운영

사전 요구 사항

시작하기 전에 다음이 필요합니다:

  1. Xmarket 계정

  2. 인증을 위한 API 키

API 키 얻기

1단계: 계정 등록

방문 Xmarketarrow-up-right 및 아직 계정이 없다면 계정을 생성하세요.

2단계: API 키 생성

  1. 계정으로 이동 설정 페이지

  2. 다음을 찾으세요 API 관리 섹션

  3. 클릭 새 API 키 생성

  4. API 키를 안전하게 보관하세요!

triangle-exclamation

인증

모든 API 요청은 x-api-key 헤더에 API 키를 사용한 인증을 요구합니다:

첫 요청 만들기

간단한 요청으로 오더북 데이터를 가져오는 것부터 시작해봅시다:

오류 처리

API는 성공 또는 실패를 표시하기 위해 표준 HTTP 상태 코드를 사용합니다:

상태 코드
설명

200

성공

201

리소스 생성됨

400

잘못된 요청 - 잘못된 매개변수

401

권한 없음 - 잘못되었거나 누락된 API 키

404

찾을 수 없음 - 리소스가 존재하지 않음

500

내부 서버 오류

오류 응답에는 무엇이 잘못되었는지 설명하는 메시지가 포함됩니다:

요청 제한

공정한 사용과 시스템 안정성을 보장하기 위해 API는 레이트 리미팅을 구현합니다:

  • 기본 제한: API 키당 분당 100 요청

레이트 한도를 초과하면 다음을 받게 됩니다 429 Too Many Requests 응답.

다음 단계

이제 설정이 완료되었으니 자세한 API 문서를 살펴보세요:

지원

문제가 발생하거나 질문이 있는 경우:

마지막 업데이트

도움이 되었나요?