MODA API Docs
GuidesAPI Reference
GuidesAPI Reference
  1. Stock
  • Order
    • 신규주문
      POST
    • TP/SL 주문
      POST
    • 정정주문
      POST
    • 청산주문
      POST
    • 취소주문
      POST
  • Trade
    • 청산 내역 조회
      GET
    • 주문내역 조회
      GET
    • 청산손익 조회
      GET
  • Stock
    • 주문 정보 조회
      GET
    • 스프레드 그룹 조회
      GET
    • 보유종목 조회
      GET
    • 주문잔고 조회
      GET
    • 주문종목 조회
      GET
  • Quote
    • 5단계 호가 조회
      GET
    • 틱 차트 데이터 조회
      GET
    • 일별 OHLC 데이터 조회
      GET
    • 캔들 차트 데이터 조회
      GET
  • Execution
    • 주문 체결 합계 조회
      GET
    • 미체결 내역 조회
      GET
    • 주문 체결 내역 조회
      GET
  • Asset
    • 보유 포지션 조회
      GET
    • 포지션증거금 조회
      GET
    • 주문증거금 조회
      GET
  • Account
    • 예탁자산 조회
    • 예수금/출금가능금액 조회
  1. Stock

주문잔고 조회

GET
/stocks/positions
종목별 보유 포지션의 잔고 상세 정보를 조회합니다.

인증 헤더#

헤더설명
AuthorizationBearer {JWT} 형식의 인증 토큰

포지션구분코드 (positionCd)#

값설명
LONG매수 포지션
SHORT매도 포지션

종목그룹코드 (stockGroupCd)#

값설명
ALL전체
FOREIGN외환
INDEX지수
COMMODITY상품
CRYPTO가상화폐

페이징#

nextKey — 초기 요청 시 빈 문자열, 이후 응답의 nextKey 값을 전송

요청

쿼리 파라미터

응답

🟢200
application/json
OK
본문

🟠400
요청요청 예시
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://dev.your-api-server.com/stocks/positions?stockCd=&nextKey='
응답응답 예시
200 - 예시 1
{
    "status": "success",
    "code": 200,
    "data": {
        "nextKey": "string",
        "symbols": [
            {
                "stockCd": "string",
                "tradeCurrencyCd": "string",
                "positionCd": "TOTAL",
                "purchaseDateTime": "2019-08-24T14:15:22.123Z",
                "accountBookQuantity": 0,
                "liquidationPossibleQuantity": 0,
                "accountBookPrice": 0,
                "currentPrice": 0,
                "assessmentProfitLoss": 0,
                "stockGroupCd": "ALL",
                "positionNo": "string"
            }
        ]
    }
}
수정일 2026-03-26 08:43:48
이전
보유종목 조회
다음
주문종목 조회
Built with