Developer

문서 검색

엔드포인트, 개념, 에러 코드 검색

API 레퍼런스
주문/거래 내역 조회

거래 내역 조회

인증된 사용자의 체결 완료된 거래 내역을 조회합니다. Authorization 헤더에 JWT가 필요합니다.

GEThttps://api.inexcoin.com/v1/trades/history

요청 파라미터

symbolstring선택

조회 대상을 특정 마켓으로 한정합니다. 생략하면 모든 마켓의 거래 내역을 조회합니다.

예시 BTC-KRW

pageint선택

조회할 페이지 번호입니다. 1부터 시작하며 생략하면 1페이지가 조회됩니다.

예시 1

pageSizeint선택

한 페이지에 포함할 항목 수입니다. 생략하면 기본값 20건이 반환됩니다.

예시 20

응답 필드

uuidstring

체결된 거래의 고유 ID입니다.

예시 3e7b1a20-9c44-4f0e-9b1a-6d2f0c7b8e12

symbolstring

체결이 발생한 마켓 코드입니다.

예시 BTC-KRW

sideenum

체결된 주문의 방향입니다. BUY는 매수 체결, SELL은 매도 체결입니다.

예시 BUY

pricestring

체결된 가격입니다.

예시 158000000

volumestring

체결된 기준 통화 수량입니다.

예시 0.0042

feestring

이 체결에 대해 부과된 수수료입니다.

예시 331.8

created_atstring

체결이 발생한 시각입니다. ISO 8601 형식의 타임존 포함 문자열입니다.

예시 2026-07-28T11:32:00+09:00

응답 예제 200 OK

{
    "success": true,
    "code": 200,
    "message": "OK",
    "data": [
        {
            "uuid": "3e7b1a20-9c44-4f0e-9b1a-6d2f0c7b8e12",
            "symbol": "BTC-KRW",
            "side": "BUY",
            "price": "158000000",
            "volume": "0.0042",
            "fee": "331.8",
            "created_at": "2026-07-28T11:32:00+09:00"
        }
    ]
}