REST API

공개 엔드포인트

Markdown으로 보기

기지 URL

https://api.6mm.com

서비스 버전

1GET /v1/version

서비스 버전 정보를 확인하세요.

서버 타임

1GET /v1/time

서버 시간을 쌓으세요. 이 엔드포인트는 서명 전에 클라이언트 시간을 보정하는 데 API Key 수 있습니다.

사용자 로그인

1POST /v1/public/user/login

요청 매개변수:

매개변수유형필수설명
usernamestring네사용자 이름, 길이 3 - 32
passwordstring네비밀번호, 길이 1 - 64
deviceIdstring아니장치 지문, 최대 64자
deviceNamestring아니장치 이름, 최대 128자

요청 예시:

$curl -X POST https://api.6mm.com/v1/public/user/login \
>  -H "Content-Type: application/json" \
>  -d '{
>    "username": "alice",
>    "password": "yourPassword",
>    "deviceId": "device-001",
>    "deviceName": "server-001"
>  }'

응답 예시:

1{
2  "code": 0,
3  "message": "success",
4  "data": {
5    "accessToken": "YOUR_ACCESS_TOKEN",
6    "accessExpire": 1769676656
7  },
8  "requestId": "req-login"
9}

새로고침 토큰

1POST /v1/public/user/refresh-token

일반적인 통합 시나리오에서는 로그인 상태가 쿠키를 통해 새로고침됩니다. 로그인 응답으로 쿠키를 반환하세요.

응답 필드:

필드유형설명
accessTokenstring새로운 접근 토큰
accessExpireint64액세스 토큰 만료 시간

요원 SSO

티켓 교환

1POST /v1/public/agent-sso/exchange-ticket

요청 매개변수:

매개변수유형필수설명
ticketstring네대리점 서비스에서 발급한 일회성 티켓
deviceIdstring아니장치 지문, 최대 64자

응답 필드:

필드유형설명
accessTokenstring접근 토큰
accessExpireint64액세스 토큰 만료 시간
redirectPathstring제안된 리다이렉트 경로

임베드 토큰 교환

1POST /v1/public/agent-sso/exchange-embed-token

요청 매개변수:

매개변수유형필수설명
embedTokenstring네에이전트 서비스에서 발행한 단명한 임베디드 트레이딩 토큰
channelIdstring네내장 iframe 채널 ID, 최대 128자
deviceIdstring아니장치 지문, 최대 64자

응답 필드:

필드유형설명
accessTokenstring접근 토큰
accessExpireint64액세스 토큰 만료 시간

PnL 리더보드

1GET /v1/public/leaderboard/pnl?period=30d

요청 매개변수:

매개변수유형필수설명
periodstring네7d / 30d / 90d

응답 필드:

필드유형설명
list[].rankint32계급
list[].userIdstring외부 사용자 ID
list[].traderstring가면 상인 이름
list[].volumestring창 내 거래량
list[].pnlAmountstring창에서 실현된 PnL
list[].pnlPctstringPnL 비율, 0에서 1까지의 소수점
myRankint32현재 사용자 등급. 인증되지 않았거나 순위가 매겨지지 않은 경우 반품이 0