REST API

사용자 및 계정

Markdown으로 보기

별도 명시가 없는 한, 다음 엔드포인트들은 JWT 또는 API Key 서명을 사용할 수 있습니다.

사용자 정보

1GET /v1/private/user/info

응답 필드:

필드유형설명
userInfo.userIdstring외부 사용자 ID
userInfo.usernamestring사용자 이름
userInfo.agentIdint64요원 ID
userInfo.vipLevelint64VIP 단계
userInfo.lastLoginAtint64마지막 로그인 시간
userInfo.lastLoginIpstring마지막 로그인 IP

사용자 자산

1GET /v1/private/user/asset

응답 필드:

필드유형설명
userAsset.userIdstring외부 사용자 ID
userAsset.assetTypestring자산 유형
userAsset.walletBalancestring지갑 잔액
userAsset.frozenMarginstring대기 명령으로 인한 마진이 동결되었습니다
userAsset.usedMarginstring포지션별 마진(margin)

listenKey 만들기

1POST /v1/private/user/listen-key

프라이빗 WebSocket 스트림에 대한 인증 키를 생성합니다.

갱신 listenKey

1PUT /v1/private/user/listen-key

listenKey 유효성을 확장합니다.

클로즈 listenKey

1DELETE /v1/private/user/listen-key

지정된 listenKey를 닫습니다.

계정 변경 기록

1GET /v1/private/user/account-change-log?assetType=USDT&page=1&pageSize=20

요청 매개변수:

매개변수유형필수설명
assetTypestring아니자산 유형, 예를 들어 USDT
changeTypestring아니유형 변경
startTimeint64아니시작 시간
endTimeint64아니종말
pageint32아니페이지 번호, 기본 1
pageSizeint32아니페이지당 항목 수, 기본 20

응답 필드:

필드유형설명
list[].assetTypestring자산 유형
list[].amountstring변경된 금액
list[].walletBalanceBeforestring잔돈 전 지갑 잔액
list[].walletBalanceAfterstring변경 후 지갑 잔액
list[].frozenBalanceBeforestring변화 전 동결 잔액
list[].frozenBalanceAfterstring변동 후 동결 잔액
list[].changeTypestring유형 변경
list[].referenceIdstring관련 사업자 ID
list[].createdAtint64생성 시간
totalint64총 집단

30일 볼륨 통계

1GET /v1/private/user/volume-stats

응답 필드:

필드유형설명
volume30dstring지난 30일간의 누적 거래량
feeTotal30dstring지난 30일간의 누적 수수료

밸런스 이력

1GET /v1/private/user/balance-history?period=1D&limit=30

요청 매개변수:

매개변수유형필수설명
periodstring네1D / 1W / 1M
limit지능아니반품된 항목 수, 기본 30

응답 필드:

필드유형설명
items[].datestring집계 날짜
items[].balancestring지갑 잔액
items[].pnlstring당시 실현된 PnL

무역 개요

1GET /v1/private/user/trade-overview?type=1M

요청 매개변수:

매개변수유형필수설명
typestring네추세 범위: 1D, 1W, 1M, 3M, 6M, 1Y

응답 필드:

필드유형설명
todayPnlstring오늘 실현된 PnL
todayVolumestring오늘의 계약 거래량
totalVolumestring누적 계약 거래량
totalPnlstring누적 실현 PnL
maxDrawdown30dstring지난 30일간의 최대 인출 금액
maxDrawdown30dRatestring지난 30일간의 최대 인출 속도, 소수점 순서로 0 부터 1
transferInstring누적 이체 자금
transferOutstring누적 이체 자금
items[]array자산 추세 데이터

자산 개요 요약

1GET /v1/private/user/asset/overview/summary

응답 필드는 거래 개요 요약 필드와 동일하며, items[]제외됩니다.

자산 개요 추세

1GET /v1/private/user/asset/overview/trend?type=1M

요청 매개변수:

매개변수유형필수설명
typestring네추세 범위: 1D, 1W, 1M, 3M, 6M, 1Y

응답 필드:

필드유형설명
items[].snapshotTimeint64스냅샷 시간
items[].balancestring경상수지 잔액
items[].pnlstring현재 시기의 PnL
items[].pnlRatestring현재 기간의 PnL 율
items[].totalPnlstring누적 PnL

좋아하는 상징

저장

1POST /v1/private/user/favorite-symbols
2Content-Type: application/json

요청 본문:

1{
2  "symbols": ["BTCUSDT", "ETHUSDT"]
3}

쿼리

1GET /v1/private/user/favorite-symbols

응답 필드:

필드유형설명
symbols끈[]좋아하는 심볼 목록