get_orders¶

TossDomesticStock.get_orders(cano: str, params: dict | None = None)[source]¶

주문 내역 조회

API 응답에는 국내/해외 주식 주문이 함께 내려오지만, 해외(USD) 주문은 제외하고 국내(KRW) 주문만 반환한다. 필터로 페이지가 비더라도 nextCursor/hasNext 는 원본 그대로 유지되므로 커서 페이지네이션은 정상 동작한다.

Parameters:

cano (str) – 계좌번호
params (dict) –
조회 필터 쿼리 파라미터
- status (str): 필수. “OPEN”(진행 중 주문 전량 반환, limit/cursor 무시) 또는 “CLOSED”(종료 주문, 페이지네이션 적용)
- symbol (str): 종목코드 필터
- from / to (str): 주문 생성일(orderedAt, KST) 범위 필터 (YYYY-MM-DD, inclusive)
- cursor (str): CLOSED 페이지네이션 커서 (응답의 nextCursor)
- limit (int): CLOSED 페이지 크기 (기본 20, 최대 100)

Returns:

주문 내역 (orders 목록은 국내 주문만, 다음 페이지 커서 nextCursor, hasNext)

Return type:

dict

Raises:

ValueError – API 에러 발생시